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.
| Flag | Qué |
|---|---|
-p, --project | El proyecto: su id, su slug o su nombre. Por defecto, el elegido con lyrelog use. |
--url | La dirección del panel. Por defecto, https://app.lyrelog.com, o LYRELOG_URL. |
--json | Escribe JSON, incluso en una terminal |
--human | Escribe tablas y colores, incluso hacia un pipe |
--no-color | Sin colores (también NO_COLOR=1) |
-h, --help | Ayuda del comando, con ejemplos |
Variables de entorno
| Variable | Qué |
|---|---|
LYRELOG_TOKEN | Un 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_URL | La dirección del panel. --url tiene prioridad sobre ella. |
LYRELOG_CONFIG_DIR | La carpeta del archivo de ajustes |
LYRELOG_THEME | dark o light, cuando el fondo de la terminal se detecta mal |
LYRELOG_AGENT | Cualquier valor: escribe JSON, como para un agente de programación |
NO_COLOR | Cualquier valor: sin colores |
BROWSER | El 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 sistema | LYRELOG_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:
| Campo | Qué |
|---|---|
url | El servidor que se usa cuando ni --url ni LYRELOG_URL indican otro: el último en el que iniciaste sesión |
hosts | Una entrada por servidor, con su dirección como clave |
hosts.*.token | La sesión. La herramienta nunca la imprime. |
hosts.*.expires_at | Cuándo termina la sesión como muy tarde (segundos Unix) |
hosts.*.user_email, hosts.*.user_name | A quién pertenece |
hosts.*.project, hosts.*.project_name | El 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 shellEl autocompletado necesita autoload -U compinit; compinit en tu ~/.zshrc. Abre un shell nuevo
después.
Versión
lyrelog versionlyrelog 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"}.