Comando hermes logs — Referencia Completa y Ejemplos

Descripción General

hermes logs visualiza, sigue y filtra los archivos de log de Hermes Agent — agent.log, errors.log, gateway.log, gui.log y desktop.log. Puedes elegir qué log leer, limitar el número de líneas, seguirlo en tiempo real y filtrar por nivel, ID de sesión, tiempo o componente.

Uso

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

Nombres de Log

log_name es opcional y selecciona qué log ver:

Nombre	Archivo de log
`agent` (predeterminado)	`agent.log` — actividad del agente
`errors`	`errors.log` — entradas de error
`gateway`	`gateway.log` — actividad del gateway/plataformas
`gui`	`gui.log` — actividad de la GUI
`desktop`	`desktop.log` — arranque/backend de la app Electron
`list`	Lista los archivos de log disponibles con sus tamaños

Opciones

Opción	Descripción
`-n LINES, --lines LINES`	Número de líneas a mostrar (por defecto: 50)
`-f, --follow`	Sigue el log en tiempo real (como `tail -f`)
`--level LEVEL`	Nivel mínimo de log a mostrar (DEBUG, INFO, WARNING, ERROR)
`--session ID`	Filtra líneas que contengan este subcadena de ID de sesión
`--since TIME`	Muestra líneas desde hace TIME (p. ej. 1h, 30m, 2d)
`--component NAME`	Filtra por componente: gateway, agent, tools, cli, cron, gui

Ejemplos

# Mostrar las últimas 50 líneas de agent.log
hermes logs

# Seguir agent.log en tiempo real
hermes logs -f

# Mostrar las últimas 50 líneas de errors.log
hermes logs errors

# Mostrar las últimas 100 líneas de gateway.log
hermes logs gateway -n 100

# Seguir gui.log en tiempo real
hermes logs gui -f

# Seguir desktop.log (arranque/backend de la app Electron)
hermes logs desktop -f

# Solo mostrar WARNING y superiores
hermes logs --level WARNING

# Filtrar por ID de sesión
hermes logs --session abc123

# Solo mostrar líneas relacionadas con herramientas
hermes logs --component tools

# Líneas de la última hora
hermes logs --since 1h

# Seguir, comenzando desde hace 30 min
hermes logs --since 30m -f

# Listar archivos de log disponibles con sus tamaños
hermes logs list

Consejos

Combina filtros: p. ej. hermes logs gateway --level ERROR --since 2h para ver errores recientes del gateway.
Usa hermes logs list para ver qué archivos de log existen y su tamaño.
--follow es ideal para depurar en vivo — ejecútalo en una ventana de terminal aparte mientras reproduces el problema.
--session es útil para rastrear una sola conversación a través de los logs.
Los archivos de log viven en ~/.hermes/logs/, así que también puedes inspeccionarlos directamente.