Early AccessNur auf Einladung, und die SDKs sind noch nicht veröffentlicht.Einladung anfragen
Zum Inhalt springen
Docs

Kommandozeilen-Tool

Lyrelog im Terminal. Events suchen und verfolgen, Fehler, Sessions und Personen lesen, Projekte, Schlüssel und Organisationen verwalten.

lyrelog ist das Dashboard im Terminal. Es sucht Events mit den Filtern des Explorers, verfolgt sie live und zeigt Fehler, Sessions, Personen, Releases, Insights und Nutzung. Außerdem verwaltet es Projekte, Schlüssel, Organisationen und dein Konto. Dein Konto oder ein Projekt löschen und ändern, wie du dich anmeldest (Passkeys, verknüpfte Konten, Anmeldung in zwei Schritten), bleibt dem Dashboard vorbehalten: Lyrelog lehnt das über die CLI ab, damit eine kopierte CLI-Session dich nicht aussperren oder deine Daten löschen kann.

Es ist für zwei Arten von Nutzern gemacht. Ein Mensch bekommt Tabellen und Farben. Ein Programm oder ein Coding-Agent bekommt JSON und sonst nichts. Das Tool merkt, wer es ausführt (siehe Wie die Ausgabe umschaltet).

Noch nicht veröffentlicht

Wie die SDKs ist auch das Kommandozeilen-Tool während des Early Access nicht veröffentlicht. Bis dahin schlägt das go install unten fehl: Das Repository ist privat und hat noch kein Release.

Installation

Du brauchst Go 1.26 oder neuer:

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

Das legt lyrelog in $(go env GOPATH)/bin ab, achte also darauf, dass dieser Ordner in deinem PATH liegt. Vorgefertigte Binaries gibt es noch nicht; Homebrew (brew install GonzaloFuentes28/tap/lyrelog) kommt mit dem ersten Release.

Erste Schritte

Anmelden

lyrelog login

Dein Browser öffnet das Dashboard. Gib diesen Computer frei, und das Terminal übernimmt die Anmeldung. Über SSH gibt es einen anderen Weg; siehe Anmelden.

Projekt wählen

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      ▂▄▃▅▃▄▅▆▆▇██▆▃▁▂▁▁▁▁▂▃▅▂

Befehle verwenden dieses Projekt, außer du übergibst -p <project>. Siehst du nur ein Projekt, wählt lyrelog login es für dich aus.

Events ansehen

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

Probier als Nächstes lyrelog errors für gruppierte Probleme, die schlimmsten zuerst. Oder lyrelog events -f, um Events zu sehen, sobald sie ankommen.

Was es kann

Deine Daten ansehen
eventsEvents suchen wie im Explorer; -f verfolgt neue. events get, summary, values, attributes
errorsProbleme, gruppiert nach Bereich und Event-Name, die schlimmsten zuerst
sessionsSessions: wer, wie lange, was passiert ist, Fehler
peopleDie Personen des Projekts, mit dem Wort, das das Projekt für sie verwendet
personEine Person: Summen, letzte Sessions und Events; ihre Daten exportieren oder löschen
releasesDer Zustand jeder App-Version
insightsTrends, Raten und Funnels
usageDie Events dieses Monats im Vergleich zu deinem Plan
Einrichten und mehr
projects, useProjekte auflisten, anzeigen, ändern und anlegen und das Standardprojekt wählen
keysAPI-Schlüssel auflisten, erstellen und widerrufen
orgsOrganisationen, ihre Personen und Einladungen
accountDein Name und wo du angemeldet bist
tokensAccess Tokens für CI: auflisten, erstellen, Ablauf ändern, widerrufen
login, logout, whoamiAn- und abmelden
openDieselbe Seite im Dashboard öffnen
apiJede API-Route des Dashboards aufrufen, angemeldet

Jeder Befehl hat --help, mit Beispielen.

Wie die Ausgabe umschaltet

Im Terminal zeichnet lyrelog Tabellen in den Farben von Lyrelog. Stattdessen schreibt es JSON, wenn:

  • seine Ausgabe in eine Pipe oder eine Datei geht (lyrelog errors | jq), oder
  • ein Coding-Agent oder CI es ausführt (Claude Code, Cursor, Codex und andere, erkannt an den Umgebungsvariablen, die sie setzen).

--json und --human erzwingen das eine oder das andere. Im JSON-Modus enthält stdout nur die Daten, Fehler sind eine JSON-Zeile auf stderr, und der Exit-Code sagt, was schiefgelaufen ist. Siehe Für Agenten und Skripte.

Die Farben passen sich an helle und dunkle Terminals an. Setze LYRELOG_THEME=dark oder light, wenn die Erkennung danebenliegt. NO_COLOR=1 oder --no-color schaltet sie ab.