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

Iniciar sesión

lyrelog login aprueba este ordenador en el navegador. Por SSH, pegas un código. La sesión dura lo mismo que la de un navegador.

La herramienta de línea de comandos no tiene contraseña ni clave propia. La apruebas desde el panel, donde ya tienes la sesión iniciada. Eso le da a este ordenador una sesión, igual que la de un navegador.

lyrelog login

lyrelog login
  1. Se abre app.lyrelog.com/cli/authorize en tu navegador. La página muestra el nombre de este ordenador y la cuenta con la que actuará, y lista lo que la herramienta puede y no puede hacer.
  2. Elige Approve. El navegador devuelve el inicio de sesión a la terminal de este ordenador y la página dice You're signed in. Puedes cerrar la pestaña.
  3. La terminal te dice con qué cuenta has iniciado sesión. Si solo puedes ver un proyecto, pasa a ser el predeterminado; si puedes ver más, ejecuta lyrelog use <project>.
Approve MacBook-Pro in the browser window that opened.
If none did, open:
  https://app.lyrelog.com/cli/authorize?...
On another computer? Press Enter to get a code to paste instead.

Aprueba solo un inicio de sesión que hayas empezado tú. Cancel en la página deja la herramienta sin sesión. Si el navegador no devuelve el inicio de sesión en 5 minutos, la terminal te pide un código en su lugar.

El inicio de sesión usa el authorization code de OAuth con PKCE, como hace Claude Code. El navegador solo puede devolverlo a una dirección de este ordenador (127.0.0.1), y solo la terminal que lo empezó puede usarlo.

Por SSH, o sin navegador

En un servidor al que accedes por SSH, o en Linux sin pantalla, lyrelog login no intenta abrir un navegador. Tampoco lo hace lyrelog login --no-browser. En su lugar, imprime la dirección de la página:

Open this page, approve server-1, and paste the code it shows:

  https://app.lyrelog.com/cli/authorize?...

Paste the code:

Abre esa dirección en cualquier navegador, elige Approve y copia en la terminal el código que muestra la página. El código funciona una sola vez, durante los 5 minutos siguientes, y solo para la terminal que lo pidió. Nunca lo pegues en ningún otro sitio ni se lo des a nadie: con él, podrían iniciar sesión como tú.

La herramienta tampoco abre el navegador cuando está definido BROWSER=none. Cuando sí abre uno, usa $BROWSER si está definido.

Solo una persona puede iniciar sesión

lyrelog login se niega a ejecutarse bajo un agente de programación, en CI o sin una terminal en la que escribir. Una persona inicia sesión una vez, en una terminal de ese ordenador, y el agente usa esa sesión. Consulta Para agentes y scripts.

La sesión

Una sesión de la CLI es el mismo tipo de sesión que la de un navegador:

  • Termina tras 14 días sin usarse, y como mucho a los 30 días, salvo que la conserves. lyrelog whoami muestra cuándo termina como muy tarde. Después, el siguiente comando te pide que ejecutes lyrelog login.
  • Crear una clave de servidor, de lectura o de administración requiere un inicio de sesión reciente: en los 10 minutos siguientes a la aprobación. Si ha pasado más tiempo, el comando se detiene con "This needs a recent sign-in" (código de salida 4). Vuelve a ejecutar lyrelog login y reinténtalo.
  • Una sesión de la CLI no puede aprobar otra. La aprobación siempre se hace en el navegador.

La sesión se guarda en el archivo de ajustes de la herramienta. La herramienta nunca la imprime.

Conservar una sesión más tiempo

En tu propio ordenador quizá no quieras volver a iniciar sesión cada mes. Pide conservar la sesión:

lyrelog login --keep 90d     # or 30d, 1y, never

La página de aprobación muestra tu elección y te deja cambiarla antes de aprobar: Like a browser (la predeterminada), 30 days, 90 days, 1 year o Never expires. Una sesión conservada dura ese tiempo tanto si la usas como si no, y solo termina antes si la cierras. Conservar una requiere que hayas iniciado sesión en el panel en los últimos 10 minutos; si no, la página te pide que inicies sesión primero.

Una sesión que nunca caduca funciona para cualquiera que copie el archivo de ajustes de este ordenador, hasta que la cierres. Elígela solo en un ordenador de confianza. La página de la cuenta la marca como Never expires, y lyrelog whoami también lo indica.

Ver y cerrar tus sesiones

La sección Where you're signed in de la página de la cuenta lista tus navegadores y todos los ordenadores donde la CLI tiene la sesión iniciada, como CLI on y el nombre del ordenador. Desde ahí puedes cerrar la sesión de cualquiera de ellos. Su siguiente comando pedirá entonces volver a ejecutar lyrelog login.

Desde la terminal:

lyrelog account sessions
ID  Where            Kind          Signed in  Last used  Ends
11  MacBook-Pro      command line  3m ago     15s ago                           this one
 9  Chrome on macOS  browser       4h ago     3m ago
10  build-box        command line  25m ago    25m ago    kept to Feb 17, 2027

Ends muestra cuándo termina una sesión conservada, o kept, never ends. Las demás terminan tras 14 días sin usarse. Los tokens de acceso no están en esta lista: los muestra lyrelog tokens.

lyrelog account sign-out 10     # the ID from the list

lyrelog logout

lyrelog logout

Esto termina la sesión en el servidor, así que el token deja de funcionar en todas partes, y lo quita de los ajustes de este ordenador.

lyrelog whoami

Con qué cuenta has iniciado sesión, en qué servidor, cuándo termina la sesión, el proyecto predeterminado y tus organizaciones. lyrelog status es el mismo comando.

✓ Signed in as Alex Rivera <alex@example.com>
  Server         app.lyrelog.com
  Session        ends by Dec 19, 22:10 at the latest (14 days unused ends it sooner, unless you kept it)
  Project        Tilefall e8bc11c6e22f
  Organizations  Alex Rivera · owner · Free

Variables de entorno

VariableQué
LYRELOG_TOKENUn token de acceso (lyr_tok_..., de lyrelog tokens create o de la página de tu cuenta) o un token de sesión de la CLI. Tiene prioridad sobre la sesión guardada.
LYRELOG_URLLa dirección del panel. Por defecto, https://app.lyrelog.com. --url tiene prioridad sobre ella.

Cada servidor tiene su propia sesión en el archivo de ajustes, así que lyrelog login --url <address> inicia sesión en otro sin afectar al primero. El último servidor en el que iniciaste sesión pasa a ser el predeterminado.

Scripts y CI

Usa un token de acceso (lyr_tok_...). Crea uno desde la terminal, justo después de iniciar sesión (requiere un inicio de sesión de los últimos 10 minutos):

lyrelog login
lyrelog tokens create --name "GitHub Actions, deploy"   # --expires 30d, 90d (default), 1y or never

O en el panel: abre la página de tu cuenta, Access tokens. Ahí también necesitas haber iniciado sesión en los últimos 10 minutos. En ambos casos:

  1. Ponle el nombre de lo que lo va a usar ("GitHub Actions, deploy") y elige cuándo caduca: 30 días, 90 días (lo predeterminado), un año o nunca.
  2. Cópialo: se muestra una sola vez. Guárdalo en los secretos de tu CI como LYRELOG_TOKEN, nunca en un repositorio.

lyrelog tokens los lista, y Tokens de acceso tiene los demás comandos.

# GitHub Actions
env:
  LYRELOG_TOKEN: ${{ secrets.LYRELOG_TOKEN }}
run: lyrelog errors --since 24h --json

Un token actúa como tú, igual que la CLI después de lyrelog login, con dos diferencias: no termina por falta de uso, solo cuando caduca o lo revocas (en la página de la cuenta o con lyrelog tokens revoke), y cuenta como inicio de sesión reciente solo durante sus primeros 10 minutos, así que después ya no puede crear claves de servidor, de lectura ni de administración. Igual que una sesión de la CLI, no puede borrar la cuenta ni un proyecto, ni cambiar cómo inicias sesión, ni crear otro token.

Un token que nunca caduca funciona para cualquiera que se haga con él hasta que lo revoques. La página de la cuenta marca esos tokens como Never expires, y lyrelog tokens muestra ⚠ never. Mejor ponles caducidad, y revoca los tokens que no uses.

Puedes cambiar la caducidad de un token más tarde, contada desde ese momento, en la página de la cuenta o con lyrelog tokens expiry <id> --expires 30d (o 90d, 1y, never). Acortarla se puede siempre; alargarla, o quitarla, requiere un inicio de sesión de los últimos 10 minutos.

¿Solo vas a leer eventos desde un script? La API de lectura con una clave de lectura (lyr_read_...) también sirve, y está limitada a un proyecto.