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

Projekte, Schlüssel und Organisationen

Wähle ein Projekt, ändere seine Einstellungen, erstelle und widerrufe Schlüssel, lade Personen ein und sieh dir dein Konto an, alles im Terminal.

Einstellungen, Schlüssel und Personen ändern funktioniert wie im Dashboard, mit denselben Regeln. Was nur Inhabern vorbehalten ist, erledigen auch hier nur Inhaber. Für einen Server-, Lese- oder Admin-Schlüssel brauchst du eine kürzliche Anmeldung. Alles, was sich nicht rückgängig machen lässt, fragt vorher nach.

Ein Projekt oder dein Konto löschen und ändern, wie du dich anmeldest, geht nur im Dashboard (siehe Ein Projekt löschen und Dein Konto löschen). Lyrelog lehnt das über die CLI ab, auch über lyrelog api, mit 403 und "browser_only": true.

Projekte

lyrelog projects listet die Projekte auf, die du sehen kannst, mit ihren Events, Personen und Fehlern der letzten 24 Stunden, wie der Projektwechsler im Dashboard.

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

Jeder Befehl nimmt -p (--project) mit dem Slug, dem Namen oder der ID eines Projekts (die 12 Zeichen in der Adresse des Dashboards).

use

Wählt das Projekt, das Befehle verwenden, wenn kein -p angegeben ist. Es wird für diesen Server in der Einstellungsdatei gespeichert.

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

projects show

Die Einstellungen eines Projekts. Gib ein Projekt an, sonst zeigt es das Standardprojekt.

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

Ändert die Einstellungen eines Projekts, wie seine Einstellungsseite. Nur Inhaber. Es ändert sich nur, was du per Flag übergibst. Eine Liste ersetzt, was da ist, und "" leert sie.

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
FlagWas
--nameDer Name des Projekts
--retention-daysEvents so viele Tage aufbewahren, bis zu dem, was der Plan erlaubt (siehe Aufbewahrungsdauer)
--default-envDie Umgebung, mit der das Dashboard öffnet (all für alle)
--peopleWie das Projekt seine Personen nennt, singular,plural: player,players
--platformWas es hauptsächlich ist: ios, android, web, api oder other
--platformsWoraus es besteht: ios, android, macos, web, api, durch Kommas getrennt
--require-verifiedPlattformen, von denen es nur verifizierte Events annimmt; "" nimmt alles an
--attest-app-idsDie App IDs, als die sich seine Apps mit Apple App Attest ausweisen (TEAMID.bundle.id); "" schaltet es ab

projects create

Legt ein Projekt in einer deiner Organisationen an. Nur Inhaber der Organisation. Es gibt den ersten Ingest-Schlüssel des Projekts einmal aus: Trag ihn in deine App ein.

lyrelog projects create --name "Tilefall web" --slug tilefall-web
FlagWas
--nameDer Name des Projekts
--slugEin Kurzname für URLs: Kleinbuchstaben, Ziffern und Bindestriche
--orgDie Organisation, nach ID oder Name. Standard: deine einzige oder die des Standardprojekts.

projects platform

Fügt eine der Plattformen, aus denen ein Projekt besteht, mit ihren Details hinzu oder entfernt sie. Nur Inhaber.

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
FlagWas
--urlweb: die Adresse der Website
--packageandroid: das Google-Play-Paket
--runtimeapi: die Sprache des Servers

Die Plattformen sind ios, android, macos, web und api.

Schlüssel

lyrelog keys (oder keys list) listet die API-Schlüssel des Projekts auf, einschließlich der widerrufenen. Die Typen sind die aus Schlüssel:

TypBeginnt mitWas er ist
ingestlyr_ing_Öffentlich und nur zum Schreiben: Er wird mit deiner App ausgeliefert
serverlyr_srv_Geheim: sendet verifizierte Events von deinen Servern
readlyr_read_Geheim: liest jedes Event des Projekts
adminlyr_adm_Geheim: liest und verwaltet das Projekt über die API (Full access im Dashboard)
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

Erstellt einen Schlüssel. Nur Inhaber. Sein Geheimnis wird einmal ausgegeben, weil nur ein Hash davon gespeichert wird.

lyrelog keys create --type ingest --name "iOS app"
lyrelog keys create --type server --name tilefall-api --json | jq -r .secret
FlagWas
--typeingest (Standard), server, read oder admin
--nameWo der Schlüssel verwendet wird

Ein server-, read- oder admin-Schlüssel braucht eine Anmeldung aus den letzten 10 Minuten. Ist deine älter, bricht der Befehl mit „This needs a recent sign-in“ ab. Führe lyrelog login aus und erstelle dann den Schlüssel. Ein Projekt hat höchstens 20 aktive Schlüssel.

keys revoke

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

Widerruft einen Schlüssel. Nur Inhaber. Was ihn verwendet, funktioniert nicht mehr. Es fragt vorher nach; -y (--yes) überspringt die Frage, und im JSON-Modus ist es Pflicht.

Organisationen

lyrelog orgs listet deine Organisationen auf, deine Rolle in jeder und ihren Plan. lyrelog orgs show listet die Personen und offenen Einladungen einer Organisation auf.

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

Die folgenden Befehle sind für Inhaber. Jeder nimmt --org mit einer ID oder einem Namen. Ohne das verwenden sie deine einzige Organisation oder die des Standardprojekts.

BefehlWas
orgs rename <name>Die Organisation umbenennen
orgs inviteEinen Einladungslink erstellen (7 Tage gültig, einmal verwendbar). --role owner oder member (Standard); --email verschickt ihn per E-Mail.
orgs revoke-invite <invite-id>Eine offene Einladung zurückziehen
orgs role <member> <owner|member>Die Rolle von jemandem ändern. Das Mitglied gibst du mit E-Mail oder Nutzer-ID an.
orgs remove <member>Jemanden entfernen. Jeder kann sich selbst entfernen, um auszutreten. Fragt vorher nach; --yes überspringt das.
lyrelog orgs invite --role member --email ana@example.com
lyrelog orgs role ana@example.com owner

Der Link einer Einladung wird einmal ausgegeben. Wer ihn hat, kann der Organisation mit dieser Rolle beitreten. Eine Organisation behält immer einen Inhaber, daher wird eine Änderung abgelehnt, die sie ohne einen zurücklassen würde.

Konto

lyrelog account zeigt dein Konto wie die Kontoseite: deine E-Mail, Passkeys und Anmeldung in zwei Schritten.

Alex Rivera alex@example.com

  Email            ✓ confirmed
  Passkeys         none
  Two-step         off
BefehlWas
account set --name <name>Deinen Namen ändern
account sessionsWo du angemeldet bist: Browser und Computer mit der CLI (keine Access Tokens)
account sign-out <session-id>Eine dieser Sessions abmelden

Passkeys oder Anmeldemethoden hinzufügen und die Anmeldung in zwei Schritten einschalten geht im Browser (lyrelog open account). Zu Sessions siehe Anmelden.

Access Tokens

Mit einem Access Token (lyr_tok_...) können CI oder ein Skript die CLI oder die API als du verwenden, über LYRELOG_TOKEN (siehe Skripte und CI). Der Bereich Access tokens auf der Kontoseite leistet dasselbe wie diese Befehle.

lyrelog tokens (oder tokens list) listet deine auf:

Name                    ID  Expires      Last used
GitHub Actions, deploy  45  Feb 3, 2027  1h ago
nightly export          46  ⚠ never      Oct 1
BefehlWas
tokens create --name <name>Einen Token erstellen. --expires 30d, 90d (Standard), 1y oder never. Er wird einmal ausgegeben.
tokens expiry <id> --expires <when>Ändern, wann er abläuft, gerechnet ab jetzt: 30d, 90d, 1y oder never
tokens revoke <id>Ihn widerrufen. Was ihn verwendet, funktioniert nicht mehr. Fragt vorher nach; -y (--yes) überspringt das.
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.

Einen Token zu erstellen und ihn länger oder unbegrenzt gültig zu machen, braucht eine Anmeldung aus den letzten 10 Minuten: direkt nach lyrelog login. Sonst bricht der Befehl mit „This needs a recent sign-in“ ab (Exit 4). Kürzer machen geht jederzeit. Ein Access Token kann keine Tokens erstellen oder ändern, daher verweigern diese Befehle die Ausführung, wenn LYRELOG_TOKEN auf einen gesetzt ist (Exit 5, browser_only).

Ein Token, der nie abläuft, bekommt eine Warnung, und im JSON-Modus braucht --expires never ein --yes. Im JSON-Modus gibt tokens create {"token","session","never_expires"} aus:

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