Accès anticipéSur invitation, et les SDK ne sont pas encore publiés.Demander une invitation
Aller au contenu
Docs

Projets, clés et organisations

Choisissez un projet, modifiez ses paramètres, créez et révoquez des clés, invitez des personnes et consultez votre compte, depuis le terminal.

Modifier les paramètres, les clés et les membres fonctionne comme dans le tableau de bord, avec les mêmes règles. Les propriétaires font ce que seuls les propriétaires peuvent faire. Créer une clé serveur, de lecture ou d'administration demande une connexion récente. Tout ce qui est irréversible demande d'abord confirmation.

Supprimer un projet ou votre compte, et changer votre façon de vous connecter, ne se font que dans le tableau de bord (voir Supprimer un projet et Supprimer votre compte). Lyrelog les refuse depuis le CLI, même via lyrelog api, avec 403 et "browser_only": true.

Projets

lyrelog projects liste les projets que vous voyez, avec leurs événements, personnes et erreurs des 24 dernières heures, comme le sélecteur de projet du tableau de bord.

   Project   Slug      Events  People  Errors  Last event  24 hours
●  Tilefall  tilefall   5,593     177     103  50m ago     █▆▂▂▁▂▂▂▁▆▇▇▇▆▇█▆██▁ ▁▁

Toutes les commandes acceptent -p (--project) avec le slug d'un projet, son nom ou son identifiant (les 12 caractères de l'adresse du tableau de bord).

use

Choisit le projet qu'utilisent les commandes quand -p n'est pas donné. Il est enregistré pour ce serveur dans le fichier de réglages.

lyrelog use tilefall
lyrelog use e8bc11c6e22f
lyrelog use              # show the current one
lyrelog use --clear      # forget it

projects show

Les paramètres d'un projet. Passez un projet, sinon la commande affiche celui par défaut.

lyrelog projects show
Tilefall e8bc11c6e22f

  Slug                 tilefall
  Your role            owner
  Keeps events for     7 days (your plan keeps up to 7)
  Opens on             production
  Platforms            ios
  Its people are       player / players
  App Attest App IDs   ABCDE12345.com.example.tilefall
  Verified events      everything is accepted
  Created              Nov 19, 2026

projects set

Modifie les paramètres d'un projet, comme sa page de paramètres. Propriétaires uniquement. Seules les options que vous passez changent. Une liste remplace ce qui s'y trouve, et "" la vide.

lyrelog projects set --retention-days 30 --default-env production
lyrelog projects set --people player,players
lyrelog projects set --require-verified ios,android
lyrelog projects set --attest-app-ids ABCDE12345.com.example.tilefall
OptionRôle
--nameLe nom du projet
--retention-daysGarder les événements pendant ce nombre de jours, dans la limite de ce que garde l'offre (voir Durée de conservation)
--default-envL'environnement sur lequel s'ouvre le tableau de bord (all pour tous)
--peopleComment le projet appelle ses personnes, singular,plural : player,players
--platformCe qu'il est principalement : ios, android, web, api ou other
--platformsCe qui le compose : ios, android, macos, web, api, séparés par des virgules
--require-verifiedLes plateformes dont il n'accepte que des événements vérifiés ; "" accepte tout
--attest-app-idsLes App IDs sous lesquels ses apps s'attestent avec Apple App Attest (TEAMID.bundle.id) ; "" le désactive

projects create

Crée un projet dans l'une de vos organisations. Propriétaires de l'organisation uniquement. La commande affiche une seule fois la première clé d'ingestion du projet : mettez-la dans votre app.

lyrelog projects create --name "Tilefall web" --slug tilefall-web
OptionRôle
--nameLe nom du projet
--slugUn nom court pour les URL : lettres minuscules, chiffres et tirets
--orgL'organisation, par identifiant ou par nom. Par défaut : votre seule organisation, ou celle du projet par défaut.

projects platform

Ajoute ou retire l'une des plateformes qui composent un projet, avec ses détails. Propriétaires uniquement.

lyrelog projects platform add web --url https://tilefall.example
lyrelog projects platform add android --package com.example.tilefall
lyrelog projects platform add api --runtime python
lyrelog projects platform remove web
OptionRôle
--urlweb : l'adresse du site web
--packageandroid : le package Google Play
--runtimeapi : le langage du serveur

Les plateformes sont ios, android, macos, web et api.

Clés

lyrelog keys (ou keys list) liste les clés d'API du projet, y compris les clés révoquées. Les types sont ceux de Clés :

TypeCommence parCe que c'est
ingestlyr_ing_Publique et en écriture seule : elle est livrée dans votre app
serverlyr_srv_Secrète : envoie des événements vérifiés depuis vos serveurs
readlyr_read_Secrète : lit tous les événements du projet
adminlyr_adm_Secrète : lit et gère le projet via l'API (Full access dans le tableau de bord)
ID                                    Name           Type    Starts with    Created  Last used  Status
0d5c55e6-d922-4cd2-af90-3fff4e8709b7  tilefall-ser…  server  lyr_srv_7GLL…  51m ago  51m ago    active
d3c65585-ab3f-427f-abee-13893f96c53a  tilefall-ing…  ingest  lyr_ing_ptD_…  1h ago   1h ago     active
9c81961c-3b29-47ac-b580-50c444f40372  x              read    lyr_read_Dg7…  3m ago   never      revoked 2m ago

keys create

Crée une clé. Propriétaires uniquement. Son secret ne s'affiche qu'une fois, car seul un hash en est conservé.

lyrelog keys create --type ingest --name "iOS app"
lyrelog keys create --type server --name tilefall-api --json | jq -r .secret
OptionRôle
--typeingest (par défaut), server, read ou admin
--nameOù la clé est utilisée

Une clé server, read ou admin demande une connexion datant de moins de 10 minutes. Si la vôtre est plus ancienne, la commande s'arrête avec « This needs a recent sign-in ». Lancez lyrelog login, puis créez la clé. Un projet a au plus 20 clés actives.

keys revoke

lyrelog keys revoke 9c81961c-3b29-47ac-b580-50c444f40372

Révoque une clé. Propriétaires uniquement. Tout ce qui l'utilise cesse de fonctionner. La commande demande d'abord confirmation ; -y (--yes) saute la question, et le mode JSON l'exige.

Organisations

lyrelog orgs liste vos organisations, votre rôle dans chacune et son offre. lyrelog orgs show liste les membres et les invitations en cours de l'une d'elles.

lyrelog orgs show
Alex Rivera 4 · Free plan · you're owner

Name         Email             Role   Since         Last sign-in
Alex Rivera  alex@example.com  owner  Nov 19, 2026  3m ago

Les commandes ci-dessous sont réservées aux propriétaires. Chacune accepte --org avec un identifiant ou un nom. Sans cette option, elles utilisent votre seule organisation, ou celle du projet par défaut.

CommandeRôle
orgs rename <name>Renommer l'organisation
orgs inviteCréer un lien d'invitation (7 jours, valable une fois). --role owner ou member (par défaut) ; --email l'envoie par e-mail.
orgs revoke-invite <invite-id>Annuler une invitation en cours
orgs role <member> <owner|member>Changer le rôle de quelqu'un. Le membre est désigné par son e-mail ou son identifiant utilisateur.
orgs remove <member>Retirer quelqu'un. Chacun peut se retirer lui-même, pour partir. Demande d'abord confirmation ; --yes la saute.
lyrelog orgs invite --role member --email ana@example.com
lyrelog orgs role ana@example.com owner

Le lien d'une invitation ne s'affiche qu'une fois. Quiconque le détient peut rejoindre l'organisation avec ce rôle. Une organisation garde toujours un propriétaire : un changement qui la laisserait sans propriétaire est refusé.

Compte

lyrelog account affiche votre compte comme la page du compte : votre e-mail, vos passkeys et la validation en deux étapes.

Alex Rivera alex@example.com

  Email            ✓ confirmed
  Passkeys         none
  Two-step         off
CommandeRôle
account set --name <name>Changer votre nom
account sessionsOù vous êtes connecté : navigateurs et ordinateurs avec le CLI (pas les jetons d'accès)
account sign-out <session-id>Déconnecter l'une de ces sessions

Ajouter des passkeys ou des méthodes de connexion et activer la validation en deux étapes se font dans le navigateur (lyrelog open account). Voir Se connecter pour les sessions.

Jetons d'accès

Un jeton d'accès (lyr_tok_...) permet à une CI ou à un script d'utiliser le CLI ou l'API en votre nom, via LYRELOG_TOKEN (voir Scripts et CI). La section Access tokens de la page du compte fait la même chose que ces commandes.

lyrelog tokens (ou tokens list) liste les vôtres :

Name                    ID  Expires      Last used
GitHub Actions, deploy  45  Feb 3, 2027  1h ago
nightly export          46  ⚠ never      Oct 1
CommandeRôle
tokens create --name <name>Créer un jeton. --expires 30d, 90d (par défaut), 1y ou never. Il ne s'affiche qu'une fois.
tokens expiry <id> --expires <when>Changer sa date d'expiration, comptée à partir de maintenant : 30d, 90d, 1y ou never
tokens revoke <id>Le révoquer. Tout ce qui l'utilise cesse de fonctionner. Demande d'abord confirmation ; -y (--yes) la saute.
lyrelog login
lyrelog tokens create --name "GitHub Actions, deploy"
✓ Made the access token GitHub Actions, deploy, it expires Feb 17, 2027

  Token:

    lyr_tok_…

  Copy it now: Lyrelog shows it only once. It's a secret: store it in your CI's secrets as LYRELOG_TOKEN.

Créer un jeton, allonger sa durée ou le rendre permanent demande une connexion datant de moins de 10 minutes : juste après lyrelog login. Sinon, la commande s'arrête avec « This needs a recent sign-in » (code 4). Raccourcir un jeton est toujours possible. Un jeton d'accès ne peut ni créer ni modifier de jetons : ces commandes refusent donc de s'exécuter quand LYRELOG_TOKEN contient un jeton d'accès (code 5, browser_only).

Un jeton qui n'expire jamais déclenche un avertissement, et en mode JSON --expires never exige --yes. En mode JSON, tokens create affiche {"token","session","never_expires"} :

lyrelog tokens create --name ci --expires 90d --json | jq -r .token