Comando hermes logs — Referência Completa e Exemplos

Visão Geral

hermes logs exibe, acompanha em tempo real e filtra os arquivos de log do Hermes Agent — agent.log, errors.log, gateway.log, gui.log e desktop.log. Você pode escolher qual log ler, limitar o número de linhas, acompanhar em tempo real e filtrar por nível, ID de sessão, tempo ou componente.

Uso

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

Nomes de Log

log_name é opcional e seleciona qual log exibir:

Nome	Arquivo de log
`agent` (padrão)	`agent.log` — atividade do agente
`errors`	`errors.log` — entradas de erro
`gateway`	`gateway.log` — atividade do gateway/plataformas
`gui`	`gui.log` — atividade da GUI
`desktop`	`desktop.log` — inicialização/backend do app Electron
`list`	Lista os arquivos de log disponíveis com tamanhos

Opções

Opção	Descrição
`-n LINES, --lines LINES`	Número de linhas a exibir (padrão: 50)
`-f, --follow`	Acompanha o log em tempo real (como `tail -f`)
`--level LEVEL`	Nível mínimo de log a exibir (DEBUG, INFO, WARNING, ERROR)
`--session ID`	Filtra linhas contendo esta substring de ID de sessão
`--since TIME`	Exibe linhas desde TIME atrás (ex.: 1h, 30m, 2d)
`--component NAME`	Filtra por componente: gateway, agent, tools, cli, cron, gui

Exemplos

# Exibir as últimas 50 linhas do agent.log
hermes logs

# Acompanhar agent.log em tempo real
hermes logs -f

# Exibir as últimas 50 linhas do errors.log
hermes logs errors

# Exibir as últimas 100 linhas do gateway.log
hermes logs gateway -n 100

# Acompanhar gui.log em tempo real
hermes logs gui -f

# Acompanhar desktop.log (inicialização/backend do app Electron)
hermes logs desktop -f

# Exibir apenas WARNING e acima
hermes logs --level WARNING

# Filtrar por ID de sessão
hermes logs --session abc123

# Exibir apenas linhas relacionadas a ferramentas
hermes logs --component tools

# Linhas da última hora
hermes logs --since 1h

# Acompanhar, começando de 30 min atrás
hermes logs --since 30m -f

# Listar arquivos de log disponíveis com tamanhos
hermes logs list

Dicas

Combine filtros: ex. hermes logs gateway --level ERROR --since 2h para ver erros recentes do gateway.
Use hermes logs list para ver quais arquivos de log existem e seus tamanhos.
--follow é ideal para depuração ao vivo — execute-o em uma janela de terminal separada enquanto reproduz o problema.
--session é útil para rastrear uma única conversa entre logs.
Os arquivos de log ficam em ~/.hermes/logs/, então você também pode inspecioná-los diretamente.