Proyectos, claves y organizaciones
Elige un proyecto, cambia sus ajustes, crea y revoca claves, invita a personas y consulta tu cuenta, desde la terminal.
Cambiar ajustes, claves y personas funciona igual que en el panel, con las mismas reglas. Los propietarios hacen lo que solo pueden hacer los propietarios. Crear una clave de servidor, de lectura o de administración requiere un inicio de sesión reciente. Todo lo que no se puede deshacer pide confirmación antes.
Borrar un proyecto o tu cuenta, y cambiar cómo inicias sesión, se hacen solo en el panel
(consulta Eliminar un proyecto y Eliminar tu cuenta).
Lyrelog los rechaza desde la CLI, incluso a través de lyrelog api, con 403 y
"browser_only": true.
Proyectos
lyrelog projects lista los proyectos que puedes ver, con sus eventos, personas y errores de las
últimas 24 horas, como hace el selector de proyectos del panel.
Project Slug Events People Errors Last event 24 hours
● Tilefall tilefall 5,593 177 103 50m ago █▆▂▂▁▂▂▂▁▆▇▇▇▆▇█▆██▁ ▁▁Cualquier comando acepta -p (--project) con el slug de un proyecto, su nombre o su id (los 12
caracteres de la dirección del panel).
use
Elige el proyecto que usan los comandos cuando no se indica -p. Se guarda para este servidor en
el archivo de ajustes.
lyrelog use tilefall
lyrelog use e8bc11c6e22f
lyrelog use # show the current one
lyrelog use --clear # forget itprojects show
Los ajustes de un proyecto. Pasa un proyecto, o muestra el predeterminado.
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
Cambia los ajustes de un proyecto, como su página de ajustes. Solo
propietarios. Solo cambian los flags que pases. Una lista sustituye lo que hay, y "" la vacía.
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 | Qué |
|---|---|
--name | El nombre del proyecto |
--retention-days | Guarda los eventos este número de días, hasta lo que permita el plan (consulta Retención) |
--default-env | El entorno con el que se abre el panel (all para todos) |
--people | Cómo llama el proyecto a sus personas, singular,plural: player,players |
--platform | Lo que es principalmente: ios, android, web, api u other |
--platforms | De qué está hecho: ios, android, macos, web, api, separados por comas |
--require-verified | Las plataformas de las que solo acepta eventos verificados; "" lo acepta todo |
--attest-app-ids | Los App ID con los que sus apps se acreditan mediante App Attest de Apple (TEAMID.bundle.id); "" lo desactiva |
projects create
Crea un proyecto en una de tus organizaciones. Solo propietarios de la organización. Imprime una sola vez la primera clave de ingesta del proyecto: ponla en tu app.
lyrelog projects create --name "Tilefall web" --slug tilefall-web| Flag | Qué |
|---|---|
--name | El nombre del proyecto |
--slug | Un nombre corto para las URL: letras minúsculas, dígitos y guiones |
--org | La organización, por id o por nombre. Por defecto, la única que tienes, o la del proyecto predeterminado. |
projects platform
Añade o quita una de las plataformas de las que está hecho un proyecto, con sus detalles. Solo propietarios.
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 | Qué |
|---|---|
--url | web: la dirección de la web |
--package | android: el paquete de Google Play |
--runtime | api: el lenguaje del servidor |
Las plataformas son ios, android, macos, web y api.
Claves
lyrelog keys (o keys list) lista las claves de API del proyecto, incluidas las revocadas. Los
tipos son los de Claves:
| Tipo | Empieza por | Qué es |
|---|---|---|
ingest | lyr_ing_ | Pública y de solo escritura: va dentro de tu app |
server | lyr_srv_ | Secreta: envía eventos verificados desde tus servidores |
read | lyr_read_ | Secreta: lee todos los eventos del proyecto |
admin | lyr_adm_ | Secreta: lee y gestiona el proyecto a través de la API (Full access en el panel) |
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
Crea una clave. Solo propietarios. Su secreto se imprime una sola vez, porque solo se guarda un hash.
lyrelog keys create --type ingest --name "iOS app"
lyrelog keys create --type server --name tilefall-api --json | jq -r .secret| Flag | Qué |
|---|---|
--type | ingest (por defecto), server, read o admin |
--name | Dónde se usa la clave |
Una clave server, read o admin requiere un inicio de sesión de los últimos 10 minutos. Si el
tuyo es más antiguo, el comando se detiene con "This needs a recent sign-in". Ejecuta
lyrelog login y luego crea la clave. Un proyecto tiene como máximo 20 claves activas.
keys revoke
lyrelog keys revoke 9c81961c-3b29-47ac-b580-50c444f40372Revoca una clave. Solo propietarios. Lo que la use deja de funcionar. Pide confirmación antes;
-y (--yes) se salta la pregunta, y el modo JSON lo necesita.
Organizaciones
lyrelog orgs lista tus organizaciones, tu rol en cada una y su plan.
lyrelog orgs show lista los miembros y las invitaciones abiertas de una.
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 agoLos comandos de abajo son para propietarios. Todos aceptan --org con un id o un nombre. Sin él,
usan tu única organización, o la del proyecto predeterminado.
| Comando | Qué |
|---|---|
orgs rename <name> | Cambia el nombre de la organización |
orgs invite | Crea un enlace de invitación (7 días, un solo uso). --role owner o member (por defecto); --email lo envía por email. |
orgs revoke-invite <invite-id> | Cancela una invitación abierta |
orgs role <member> <owner|member> | Cambia el rol de alguien. El miembro es su email o su id de usuario. |
orgs remove <member> | Quita a alguien. Cualquiera puede quitarse a sí mismo, para irse. Pide confirmación antes; --yes se la salta. |
lyrelog orgs invite --role member --email ana@example.com
lyrelog orgs role ana@example.com ownerEl enlace de una invitación se imprime una sola vez. Cualquiera que lo tenga puede unirse a la organización con ese rol. Una organización siempre conserva un propietario, así que se rechaza cualquier cambio que la dejaría sin ninguno.
Cuenta
lyrelog account muestra tu cuenta como la página de la cuenta: tu email, tus passkeys y la
verificación en dos pasos.
Alex Rivera alex@example.com
Email ✓ confirmed
Passkeys none
Two-step off| Comando | Qué |
|---|---|
account set --name <name> | Cambia tu nombre |
account sessions | Dónde tienes la sesión iniciada: navegadores y ordenadores con la CLI (no los tokens de acceso) |
account sign-out <session-id> | Cierra una de esas sesiones |
Añadir passkeys o métodos de inicio de sesión y activar la verificación en dos pasos se hacen en
el navegador (lyrelog open account). Para las sesiones, consulta
Iniciar sesión.
Tokens de acceso
Un token de acceso (lyr_tok_...) permite que un CI o un script use la CLI o la API como tú, a
través de LYRELOG_TOKEN (consulta Scripts y CI). La sección
Access tokens de la página de la cuenta hace lo mismo que estos comandos.
lyrelog tokens (o tokens list) lista los tuyos:
Name ID Expires Last used
GitHub Actions, deploy 45 Feb 3, 2027 1h ago
nightly export 46 ⚠ never Oct 1| Comando | Qué |
|---|---|
tokens create --name <name> | Crea un token. --expires 30d, 90d (por defecto), 1y o never. Se imprime una sola vez. |
tokens expiry <id> --expires <when> | Cambia cuándo caduca, contando desde ahora: 30d, 90d, 1y o never |
tokens revoke <id> | Lo revoca. Lo que lo use deja de funcionar. Pide confirmación antes; -y (--yes) se la salta. |
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.Crear un token, y hacer que uno dure más o no caduque nunca, requieren un inicio de sesión de los
últimos 10 minutos: justo después de lyrelog login. Si no, el comando se detiene con "This needs
a recent sign-in" (salida 4). Acortar su duración se puede siempre. Un token de acceso no puede
crear ni cambiar tokens, así que estos comandos se niegan a ejecutarse con LYRELOG_TOKEN
definido con uno (salida 5, browser_only).
Un token que nunca caduca recibe un aviso, y en modo JSON --expires never necesita --yes. En
modo JSON, tokens create imprime {"token","session","never_expires"}:
lyrelog tokens create --name ci --expires 90d --json | jq -r .token