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

Outil en ligne de commande

Lyrelog depuis votre terminal. Cherchez et suivez les événements, consultez erreurs, sessions et personnes, gérez projets, clés et organisations.

lyrelog, c'est le tableau de bord dans un terminal. Il cherche les événements avec les filtres de l'explorateur, les suit en direct, et affiche erreurs, sessions, personnes, versions, insights et utilisation. Il gère aussi les projets, les clés, les organisations et votre compte. Supprimer votre compte ou un projet, et changer votre façon de vous connecter (passkeys, comptes liés, validation en deux étapes), restent dans le tableau de bord : Lyrelog les refuse depuis le CLI, pour qu'une session CLI copiée ne puisse ni vous verrouiller dehors ni effacer vos données.

Il est fait pour deux sortes d'utilisateurs. Une personne obtient des tableaux et des couleurs. Un programme ou un agent de code obtient du JSON, et rien d'autre. L'outil détecte qui le lance (voir Comment la sortie bascule).

Pas encore publié

Comme les SDK, l'outil en ligne de commande n'est pas publié pendant l'accès anticipé. D'ici là, le go install ci-dessous échoue : le dépôt est privé et n'a encore aucune release.

Installation

Il vous faut Go 1.26 ou plus récent :

go install go.lyrelog.com/cli/cmd/lyrelog@latest

Cela place lyrelog dans $(go env GOPATH)/bin : vérifiez que ce dossier est dans votre PATH. Aucun binaire précompilé n'est encore publié ; Homebrew (brew install GonzaloFuentes28/tap/lyrelog) arrivera avec la première release.

Premiers pas

Se connecter

lyrelog login

Votre navigateur ouvre le tableau de bord. Approuvez cet ordinateur, et le terminal récupère la connexion. Il existe une autre méthode via SSH ; voir Se connecter.

Choisir un projet

lyrelog projects
lyrelog use tilefall          # its slug, its name or its id
   Project   Slug      Events  People  Errors  Last event  24 hours
●  Tilefall  tilefall   7,291     205     187  7m ago      ▂▄▃▅▃▄▅▆▆▇██▆▃▁▂▁▁▁▁▂▃▅▂

Les commandes utilisent ce projet, sauf si vous passez -p <project>. Si vous ne voyez qu'un seul projet, lyrelog login le choisit pour vous.

Regarder les événements

lyrelog events --level error --since 7d
Tilefall · production · last 7 days

10:30:07 ▌error    cloud_save_failed  sync  reason=schema_mismatch record=progress status=422
10:27:43 ▌error    cloud_save_failed  sync  reason=schema_mismatch record=progress status=422
10:24:48 ▌error    cloud_save_failed  sync  reason=schema_mismatch record=progress status=422

Ensuite, essayez lyrelog errors pour voir les problèmes regroupés, les pires d'abord. Ou lyrelog events -f pour regarder les événements à mesure qu'ils arrivent.

Ce qu'il fait

Consulter vos données
eventsCherche les événements comme l'explorateur ; -f suit les nouveaux. events get, summary, values, attributes
errorsLes problèmes regroupés par domaine et nom d'événement, les pires d'abord
sessionsLes sessions : qui, combien de temps, ce qui s'est passé, les erreurs
peopleLes personnes du projet, avec le mot qu'il a choisi
personUne personne : totaux, sessions et événements récents ; exporter ou supprimer ses données
releasesLa santé de chaque version de l'app
insightsTendances, taux et entonnoirs
usageLes événements de ce mois par rapport à votre offre
Configurer et plus encore
projects, useLister, afficher, modifier et créer des projets, et choisir celui par défaut
keysLister, créer et révoquer les clés d'API
orgsLes organisations, leurs membres et leurs invitations
accountVotre nom, et où vous êtes connecté
tokensLes jetons d'accès pour la CI : lister, créer, changer l'expiration, révoquer
login, logout, whoamiSe connecter et se déconnecter
openOuvrir la même page dans le tableau de bord
apiAppeler n'importe quelle route de l'API du tableau de bord, avec votre connexion

Chaque commande a un --help, avec des exemples.

Comment la sortie bascule

Dans un terminal, lyrelog dessine des tableaux aux couleurs de Lyrelog. Il écrit du JSON à la place quand :

  • sa sortie part dans un pipe ou un fichier (lyrelog errors | jq), ou
  • un agent de code ou une CI le lance (Claude Code, Cursor, Codex et d'autres, détectés par les variables d'environnement qu'ils définissent).

--json et --human forcent l'un ou l'autre. En mode JSON, stdout ne porte que les données, les erreurs tiennent sur une ligne JSON dans stderr, et le code de sortie dit ce qui n'a pas marché. Voir Pour les agents et les scripts.

Les couleurs s'adaptent aux terminaux clairs et sombres. Définissez LYRELOG_THEME=dark ou light si l'outil se trompe. NO_COLOR=1 ou --no-color les désactive.