Référence
Les options globales de l'outil en ligne de commande, ses variables d'environnement, son fichier de réglages, la complétion du shell et la version.
Options globales
Toutes les commandes les acceptent.
| Option | Rôle |
|---|---|
-p, --project | Le projet : son identifiant, son slug ou son nom. Par défaut : celui choisi avec lyrelog use. |
--url | L'adresse du tableau de bord. Par défaut https://app.lyrelog.com, ou LYRELOG_URL. |
--json | Écrire du JSON, même dans un terminal |
--human | Écrire des tableaux et des couleurs, même dans un pipe |
--no-color | Pas de couleurs (aussi NO_COLOR=1) |
-h, --help | L'aide de la commande, avec des exemples |
Variables d'environnement
| Variable | Rôle |
|---|---|
LYRELOG_TOKEN | Un jeton d'accès (lyr_tok_..., de lyrelog tokens create ou de votre page de compte) ou un jeton de session CLI. Il l'emporte sur la connexion enregistrée. Voir Scripts et CI. |
LYRELOG_URL | L'adresse du tableau de bord. --url l'emporte sur elle. |
LYRELOG_CONFIG_DIR | Le dossier du fichier de réglages |
LYRELOG_THEME | dark ou light, quand le fond du terminal est mal deviné |
LYRELOG_AGENT | N'importe quelle valeur : écrire du JSON, comme pour un agent de code |
NO_COLOR | N'importe quelle valeur : pas de couleurs |
BROWSER | Le navigateur qu'utilisent lyrelog login et lyrelog open ; none pour aucun navigateur |
L'outil lit aussi les variables que définissent les agents de code et la CI, pour choisir entre JSON et tableaux. Voir JSON ou tableaux.
Fichier de réglages
L'outil garde ses réglages dans un seul fichier JSON, config.json, dans :
| Dossier | |
|---|---|
| macOS et Linux | ~/.config/lyrelog, ou $XDG_CONFIG_HOME/lyrelog quand elle est définie |
| Windows | %AppData%\lyrelog |
| Partout | LYRELOG_CONFIG_DIR, quand elle est définie |
Le fichier n'est lisible que par vous (mode 0600, dans un dossier 0700), et il est écrit en une seule étape, si bien qu'il n'est jamais laissé à moitié écrit. Il contient :
| Champ | Rôle |
|---|---|
url | Le serveur utilisé quand ni --url ni LYRELOG_URL n'en indiquent un autre : le dernier auquel vous vous êtes connecté |
hosts | Une entrée par serveur, indexée par son adresse |
hosts.*.token | La session. L'outil ne l'affiche jamais. |
hosts.*.expires_at | Quand la session se termine au plus tard (secondes Unix) |
hosts.*.user_email, hosts.*.user_name | À qui elle appartient |
hosts.*.project, hosts.*.project_name | L'identifiant du projet par défaut, et son nom pour les messages |
{
"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"
}
}
}Le jeton est une session, comme le cookie d'un navigateur : quiconque le copie agit en votre nom
jusqu'à ce qu'elle se termine. lyrelog logout la termine sur le serveur et la retire du fichier.
Codes de sortie
0 signifie terminé ; tout autre code nomme ce qui n'a pas marché (2 une option incorrecte, 3 non connecté, 4 connexion récente nécessaire, 6 introuvable...). Le tableau complet se trouve dans Pour les agents et les scripts.
Complétion du shell
lyrelog completion affiche un script de complétion pour bash, zsh, fish ou powershell.
Le --help de chacun indique où le placer. Pour 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 shellLa complétion a besoin de autoload -U compinit; compinit dans votre ~/.zshrc. Ouvrez ensuite
un nouveau shell.
Version
lyrelog versionlyrelog v0.1.0 (4678ef1, built 2026-11-19, go1.27.4, darwin/arm64)La commande affiche la version (celle de la release, ou celle qu'a récupérée go install), le commit et
la date de build quand le build les connaît, ainsi que la version de Go et le système pour lequel
il a été compilé. Un build sans version indique dev. En JSON :
{"version","commit","date","go","os","arch"}.