Acceso anticipadoSolo por invitación, y los SDK aún no están publicados.Pedir una invitación
Ir al contenido
Docs

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 it

projects show

Los ajustes de un proyecto. Pasa un proyecto, o muestra el predeterminado.

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

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
FlagQué
--nameEl nombre del proyecto
--retention-daysGuarda los eventos este número de días, hasta lo que permita el plan (consulta Retención)
--default-envEl entorno con el que se abre el panel (all para todos)
--peopleCómo llama el proyecto a sus personas, singular,plural: player,players
--platformLo que es principalmente: ios, android, web, api u other
--platformsDe qué está hecho: ios, android, macos, web, api, separados por comas
--require-verifiedLas plataformas de las que solo acepta eventos verificados; "" lo acepta todo
--attest-app-idsLos 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
FlagQué
--nameEl nombre del proyecto
--slugUn nombre corto para las URL: letras minúsculas, dígitos y guiones
--orgLa 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
FlagQué
--urlweb: la dirección de la web
--packageandroid: el paquete de Google Play
--runtimeapi: 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:

TipoEmpieza porQué es
ingestlyr_ing_Pública y de solo escritura: va dentro de tu app
serverlyr_srv_Secreta: envía eventos verificados desde tus servidores
readlyr_read_Secreta: lee todos los eventos del proyecto
adminlyr_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 ago

keys 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
FlagQué
--typeingest (por defecto), server, read o admin
--nameDó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-50c444f40372

Revoca 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 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

Los 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.

ComandoQué
orgs rename <name>Cambia el nombre de la organización
orgs inviteCrea 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 owner

El 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
ComandoQué
account set --name <name>Cambia tu nombre
account sessionsDó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
ComandoQué
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