O Hermes Agent é mais do que um chatbot. Ele combina sessões, snapshots, comandos de CLI, cron e gateways em um único sistema, mas isso também significa que muitos usuários usam apenas a superfície. Aqui estão 12 dicas práticas que melhorarão imediatamente seu fluxo de trabalho, desde o gerenciamento de sessões e o handoff entre plataformas até o rollback rápido e a automação autônoma.

1. Nomeie sessões com /new para encontrá-las facilmente

Uma sessão sem nome acaba se tornando uma lista de IDs e “me ajuda com isso”. Dar um nome permite retomá-la mais tarde com /resume ou hermes -c.

/new payment-refactor

Isso define o título da sessão imediatamente. Você pode então usar /resume payment-refactor em qualquer plataforma. Os títulos devem ser únicos, então prefira nomes de projeto específicos em vez de “teste 1”.

2. Escolha o comando de retomada correto

Cenário	Comando	Notas
Retomar a última sessão CLI	hermes --continue ou hermes -c	Seleciona a sessão cli mais recente
Retomar por nome	hermes -c "payment-refactor"	Suporta lineage; escolhe a mais recente automaticamente
Retomar por ID exato	hermes -r 20260721_143022_a1b2c3	Copie de hermes sessions list

Se você continuou a sessão no Telegram, pode trazê-la de volta para o desktop com o mesmo comando.

3. Transfira entre CLI e Telegram com /handoff

O Hermes suporta /handoff <plataforma> para migrar uma sessão ativa para uma plataforma de mensagens. Suponha que você iniciou uma tarefa no CLI e queira continuar no celular ao sair do escritório:

/handoff telegram

A plataforma de destino deve estar habilitada e configurada com /sethome. Após o handoff, o CLI é encerrado e exibe uma dica para retomar mais tarde com /resume <título>.

4. Controle sessões longas com /compress

Conversas longas podem se desviar e ficar caras. O /compress resume os turnos anteriores em um resumo compacto, liberando espaço de contexto enquanto mantém as informações essenciais.

/compress
/compress focus payment-refactor
/compress here 20

A primeira forma comprime globalmente; a segunda ao redor de um tema; a terceira mantém os últimos 20 turnos. Combine com /new para nomear a sessão comprimida e facilitar o acompanhamento do lineage.

5. Use /undo em vez de editar o contexto manualmente

Se a última entrada do usuário ou a resposta do assistente desviaram a conversa, o /undo remove a última troca usuário+assistente em uma etapa.

/undo

Isso não apaga tudo o que o modelo aprendeu antes; apenas dá um passo atrás. Útil para experimentos rápidos, ajuste de prompts e edições iterativas de código.

6. Ative checkpoints antes de trabalhos destrutivos

Inicie o CLI com --checkpoints, ou ative-os globalmente em ~/.hermes/config.yaml:

checkpoints:
  enabled: true

Uma vez ativados, o Hermes cria snapshots automaticamente antes de write_file, patch e comandos de terminal arriscados como rm, cp, mv e sed -i. Em seguida, /rollback lista os checkpoints e os restaura. Você pode até restaurar um único arquivo com /rollback 1 src/main.py.

7. Navegue pelas sessões regularmente com hermes sessions list

hermes sessions list --limit 50
hermes sessions list --source telegram

Sessões nomeadas exibem título, visualização e hora da última atividade. Sessões sem nome exibem apenas visualização e origem. O hábito de nomear vale a pena quando você precisa encontrar algo uma semana depois.

8. Recupere contexto anterior com session_search

O Hermes tem uma ferramenta integrada session_search baseada no FTS5 do SQLite. Se você discutiu um tópico antes, mas esqueceu os detalhes, deixe a sessão atual procurar:

Encontre a refatoração do módulo auth que discutimos antes.

O agente é instruído a usar session_search quando suspeita de contexto anterior. Você também pode perguntar diretamente: “Como implantamos no VPS da última vez?”

9. Exporte sessões para backup ou compartilhamento

O Hermes suporta vários formatos de exportação:

# Fazer backup de todas as sessões
hermes sessions export backup.jsonl

# Exportar uma sessão como página HTML autônoma
hermes sessions export --format html --session-id 20260721_143022_a1b2c3d4

# Exportar como trace do Hugging Face Agent e fazer upload
hermes sessions export --format trace --session-id 20260721_143022_a1b2c3d4 --upload

Adicione --redact ao compartilhar para remover API keys, tokens e credenciais.

10. Use no_agent: true para cron jobs estáveis

Para scripts programados previsíveis, como monitoramento, scraping ou relatórios, defina no_agent: true no cron job:

no_agent: true
script: /path/to/script.py

Isso entrega a stdout do script diretamente sem interpretação do LLM, eliminando a imprevisibilidade. Ótimo para watchdogs, alertas de limite e heartbeats.

11. Limpe sessões antigas com hermes sessions prune

O banco de dados de sessões cresce com o tempo, especialmente com gateways ou cargas de cron. Use hermes sessions prune para limpar:

hermes sessions prune --older-than 30
hermes sessions prune --source cron --older-than 7

Por padrão, mantém apenas sessões ended com mais de 90 dias. Adicione --dry-run para visualizar. Sessões ativas nunca são excluídas.

12. Faça backup de ~/.hermes/state.db

Todo o histórico de sessões, mensagens, contadores de tokens e snapshots de system prompt vivem neste arquivo SQLite. Faça backup regularmente:

cp ~/.hermes/state.db ~/.hermes/state.db.$(date +%Y%m%d).bak

Ao migrar de máquina ou reinstalar, copie o arquivo de volta e use hermes -c para restaurar a maior parte do seu contexto de trabalho.

Resumo

Essas 12 dicas cobrem as áreas de maior fricção no uso diário do Hermes: nomear mantém as sessões localizáveis, comprimir mantém conversas longas gerenciáveis, checkpoints tornam as alterações reversíveis, handoff permite que os fluxos de trabalho se movam entre plataformas, e cron + export tornam a automação confiável. Não são recursos novos, mas combinados eliminam muita fricção.

Se você é novo no Hermes, comece com /new <tarefa> e /compress. Se já executa gateways ou cron jobs, concentre-se em checkpoints e sessions prune para evitar que as coisas saiam do controle.