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

Herramienta de línea de comandos

Lyrelog desde tu terminal. Busca y sigue eventos, consulta errores, sesiones y personas, y gestiona proyectos, claves y organizaciones.

lyrelog es el panel en una terminal. Busca eventos con los filtros del explorador, los sigue en directo y muestra errores, sesiones, personas, versiones, insights y uso. También gestiona proyectos, claves, organizaciones y tu cuenta. Borrar tu cuenta o un proyecto, y cambiar cómo inicias sesión (passkeys, cuentas vinculadas, verificación en dos pasos), se hacen solo en el panel: Lyrelog los rechaza desde la CLI, para que una sesión de la CLI copiada no pueda dejarte fuera ni borrar tus datos.

Está pensada para dos tipos de usuario. Una persona obtiene tablas y colores. Un programa o un agente de programación obtiene JSON y nada más. La herramienta detecta quién la está ejecutando (consulta Cómo cambia la salida).

Aún no publicada

Igual que los SDK, la herramienta de línea de comandos no se publica durante el acceso anticipado. Hasta entonces, el go install de abajo falla: el repositorio es privado y todavía no tiene ninguna versión publicada.

Instalación

Necesitas Go 1.26 o posterior:

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

Esto deja lyrelog en $(go env GOPATH)/bin, así que asegúrate de que esa carpeta esté en tu PATH. Todavía no se publican binarios precompilados; Homebrew (brew install GonzaloFuentes28/tap/lyrelog) llegará con la primera versión.

Primeros pasos

Inicia sesión

lyrelog login

Se abre el panel en tu navegador. Aprueba este ordenador y la terminal recoge el inicio de sesión. Hay otra forma por SSH; consulta Iniciar sesión.

Elige un proyecto

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

Los comandos usan este proyecto salvo que pases -p <project>. Si solo puedes ver un proyecto, lyrelog login lo elige por ti.

Mira los eventos

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

Después, prueba lyrelog errors para ver los problemas agrupados, los peores primero. O lyrelog events -f para ver los eventos a medida que llegan.

Qué hace

Consultar tus datos
eventsBusca eventos como el explorador; -f sigue los nuevos. events get, summary, values, attributes
errorsProblemas agrupados por área y nombre de evento, los peores primero
sessionsSesiones: quién, cuánto duraron, qué pasó, errores
peopleLas personas del proyecto, con la palabra que usa el proyecto
personUna persona: totales, sesiones y eventos recientes; exportar o borrar sus datos
releasesLa salud de cada versión de la app
insightsTendencias, tasas y embudos
usageLos eventos de este mes frente a tu plan
Configurar y más
projects, useListar, mostrar, cambiar y crear proyectos, y elegir el predeterminado
keysListar, crear y revocar claves de API
orgsOrganizaciones, sus miembros e invitaciones
accountTu nombre y dónde tienes la sesión iniciada
tokensTokens de acceso para CI: listar, crear, cambiar la caducidad, revocar
login, logout, whoamiIniciar y cerrar sesión
openAbrir la misma página en el panel
apiLlamar a cualquier ruta de la API del panel, con la sesión iniciada

Todos los comandos tienen --help, con ejemplos.

Cómo cambia la salida

En una terminal, lyrelog dibuja tablas con los colores de Lyrelog. En su lugar escribe JSON cuando:

  • su salida va a un pipe o a un archivo (lyrelog errors | jq), o
  • la ejecuta un agente de programación o un CI (Claude Code, Cursor, Codex y otros, detectados por las variables de entorno que definen).

--json y --human fuerzan uno u otro. En modo JSON, stdout lleva solo los datos, los errores son una línea JSON en stderr y el código de salida dice qué falló. Consulta Para agentes y scripts.

Los colores se adaptan a terminales claras y oscuras. Define LYRELOG_THEME=dark o light si la suposición es incorrecta. NO_COLOR=1 o --no-color los desactivan.