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 itprojects show
Die Einstellungen eines Projekts. Gib ein Projekt an, sonst zeigt es das Standardprojekt.
lyrelog projects showTilefall 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, 2026projects 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| Flag | Was |
|---|---|
--name | Der Name des Projekts |
--retention-days | Events so viele Tage aufbewahren, bis zu dem, was der Plan erlaubt (siehe Aufbewahrungsdauer) |
--default-env | Die Umgebung, mit der das Dashboard öffnet (all für alle) |
--people | Wie das Projekt seine Personen nennt, singular,plural: player,players |
--platform | Was es hauptsächlich ist: ios, android, web, api oder other |
--platforms | Woraus es besteht: ios, android, macos, web, api, durch Kommas getrennt |
--require-verified | Plattformen, von denen es nur verifizierte Events annimmt; "" nimmt alles an |
--attest-app-ids | Die 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| Flag | Was |
|---|---|
--name | Der Name des Projekts |
--slug | Ein Kurzname für URLs: Kleinbuchstaben, Ziffern und Bindestriche |
--org | Die 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| Flag | Was |
|---|---|
--url | web: die Adresse der Website |
--package | android: das Google-Play-Paket |
--runtime | api: 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:
| Typ | Beginnt mit | Was er ist |
|---|---|---|
ingest | lyr_ing_ | Öffentlich und nur zum Schreiben: Er wird mit deiner App ausgeliefert |
server | lyr_srv_ | Geheim: sendet verifizierte Events von deinen Servern |
read | lyr_read_ | Geheim: liest jedes Event des Projekts |
admin | lyr_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 agokeys 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| Flag | Was |
|---|---|
--type | ingest (Standard), server, read oder admin |
--name | Wo 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-50c444f40372Widerruft 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 showAlex Rivera 4 · Free plan · you're owner
Name Email Role Since Last sign-in
Alex Rivera alex@example.com owner Nov 19, 2026 3m agoDie 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.
| Befehl | Was |
|---|---|
orgs rename <name> | Die Organisation umbenennen |
orgs invite | Einen 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 ownerDer 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| Befehl | Was |
|---|---|
account set --name <name> | Deinen Namen ändern |
account sessions | Wo 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| Befehl | Was |
|---|---|
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