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

Referencia

Los flags globales de la herramienta de línea de comandos, sus variables de entorno, el archivo de ajustes, el autocompletado del shell y la versión.

Flags globales

Todos los comandos los aceptan.

FlagQué
-p, --projectEl proyecto: su id, su slug o su nombre. Por defecto, el elegido con lyrelog use.
--urlLa dirección del panel. Por defecto, https://app.lyrelog.com, o LYRELOG_URL.
--jsonEscribe JSON, incluso en una terminal
--humanEscribe tablas y colores, incluso hacia un pipe
--no-colorSin colores (también NO_COLOR=1)
-h, --helpAyuda del comando, con ejemplos

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. Consulta Scripts y CI.
LYRELOG_URLLa dirección del panel. --url tiene prioridad sobre ella.
LYRELOG_CONFIG_DIRLa carpeta del archivo de ajustes
LYRELOG_THEMEdark o light, cuando el fondo de la terminal se detecta mal
LYRELOG_AGENTCualquier valor: escribe JSON, como para un agente de programación
NO_COLORCualquier valor: sin colores
BROWSEREl navegador que usan lyrelog login y lyrelog open; none para ninguno

La herramienta también lee las variables que definen los agentes de programación y los CI, para decidir entre JSON y tablas. Consulta JSON o tablas.

Archivo de ajustes

La herramienta guarda sus ajustes en un único archivo JSON, config.json, en:

Carpeta
macOS y Linux~/.config/lyrelog, o $XDG_CONFIG_HOME/lyrelog cuando está definida
Windows%AppData%\lyrelog
Cualquier sistemaLYRELOG_CONFIG_DIR, cuando está definida

Solo tú puedes leer el archivo (modo 0600, en una carpeta 0700), y se escribe de una sola vez, así que nunca queda a medio escribir. Contiene:

CampoQué
urlEl servidor que se usa cuando ni --url ni LYRELOG_URL indican otro: el último en el que iniciaste sesión
hostsUna entrada por servidor, con su dirección como clave
hosts.*.tokenLa sesión. La herramienta nunca la imprime.
hosts.*.expires_atCuándo termina la sesión como muy tarde (segundos Unix)
hosts.*.user_email, hosts.*.user_nameA quién pertenece
hosts.*.project, hosts.*.project_nameEl id del proyecto predeterminado, y su nombre para los mensajes
{
  "url": "https://app.lyrelog.com",
  "hosts": {
    "https://app.lyrelog.com": {
      "token": "…",
      "expires_at": 1797714620,
      "user_email": "alex@example.com",
      "user_name": "Alex Rivera",
      "project": "e8bc11c6e22f",
      "project_name": "Tilefall"
    }
  }
}

El token es una sesión, como la cookie de un navegador: quien lo copie actúa como tú hasta que termine. lyrelog logout la termina en el servidor y la quita del archivo.

Códigos de salida

0 significa hecho; cualquier otro dice qué falló (2 un flag incorrecto, 3 sin sesión iniciada, 4 hace falta un inicio de sesión reciente, 6 no encontrado...). La tabla completa está en Para agentes y scripts.

Autocompletado del shell

lyrelog completion imprime un script de autocompletado para bash, zsh, fish o powershell. El --help de cada uno dice dónde ponerlo. Para zsh:

source <(lyrelog completion zsh)                                            # this shell only
lyrelog completion zsh > "$(brew --prefix)/share/zsh/site-functions/_lyrelog"   # macOS, every shell
lyrelog completion zsh > "${fpath[1]}/_lyrelog"                             # Linux, every shell

El autocompletado necesita autoload -U compinit; compinit en tu ~/.zshrc. Abre un shell nuevo después.

Versión

lyrelog version
lyrelog v0.1.0 (4678ef1, built 2026-11-19, go1.27.4, darwin/arm64)

Muestra la versión (la de la release, o la que descargó go install), el commit y la fecha de build cuando la build los conoce, y la versión de Go y el sistema para el que se compiló. Una build sin versión dice dev. En JSON: {"version","commit","date","go","os","arch"}.