Commande hermes logs — Référence Complète & Exemples

Vue d’ensemble

hermes logs affiche, suit en temps réel et filtre les fichiers de logs d’Hermes Agent — agent.log, errors.log, gateway.log, gui.log et desktop.log. Vous pouvez choisir le log à lire, limiter le nombre de lignes, le suivre en temps réel et filtrer par niveau, ID de session, temps ou composant.

Utilisation

hermes logs [-h] [-n LINES] [-f] [--level LEVEL] [--session ID] [--since TIME] [--component NAME] [log_name]

Noms de logs

log_name est optionnel et sélectionne le log à afficher :

Nom	Fichier de log
`agent` (défaut)	`agent.log` — activité de l’agent
`errors`	`errors.log` — entrées d’erreurs
`gateway`	`gateway.log` — activité de la passerelle/plateformes
`gui`	`gui.log` — activité de l’interface graphique
`desktop`	`desktop.log` — démarrage/backend de l’app Electron
`list`	Liste les fichiers de logs disponibles avec leurs tailles

Options

Option	Description
`-n LINES, --lines LINES`	Nombre de lignes à afficher (défaut : 50)
`-f, --follow`	Suivre le log en temps réel (comme `tail -f`)
`--level LEVEL`	Niveau de log minimal à afficher (DEBUG, INFO, WARNING, ERROR)
`--session ID`	Filtrer les lignes contenant cette sous-chaîne d’ID de session
`--since TIME`	Afficher les lignes depuis TIME (p. ex. 1h, 30m, 2d)
`--component NAME`	Filtrer par composant : gateway, agent, tools, cli, cron, gui

Exemples

# Afficher les 50 dernières lignes d'agent.log
hermes logs

# Suivre agent.log en temps réel
hermes logs -f

# Afficher les 50 dernières lignes d'errors.log
hermes logs errors

# Afficher les 100 dernières lignes de gateway.log
hermes logs gateway -n 100

# Suivre gui.log en temps réel
hermes logs gui -f

# Suivre desktop.log (démarrage/backend de l'app Electron)
hermes logs desktop -f

# N'afficher que WARNING et au-dessus
hermes logs --level WARNING

# Filtrer par ID de session
hermes logs --session abc123

# N'afficher que les lignes liées aux outils
hermes logs --component tools

# Lignes de la dernière heure
hermes logs --since 1h

# Suivre, en commençant il y a 30 min
hermes logs --since 30m -f

# Lister les fichiers de logs disponibles avec leurs tailles
hermes logs list

Astuces

Combinez les filtres : par ex. hermes logs gateway --level ERROR --since 2h pour voir les erreurs récentes de la passerelle.
Utilisez hermes logs list pour voir quels fichiers de logs existent et leur taille.
--follow est idéal pour le débogage en direct — exécutez-le dans une fenêtre de terminal séparée pendant que vous reproduisez le problème.
--session est pratique pour tracer une seule conversation à travers les logs.
Les fichiers de logs se trouvent dans ~/.hermes/logs/, vous pouvez donc aussi les inspecter directement.