Tutorial 8: Gerenciamento de Sessões

Já fechou seu terminal e perdeu uma ótima conversa com o Hermes? Ou quis retomar exatamente de onde parou naquele bug complicado de ontem? Boa notícia: o Hermes lembra de tudo. Cada conversa é salva automaticamente como uma sessão, e neste tutorial vamos mostrar como usar esse superpoder.

Como Funcionam as Sessões

Pense em uma sessão como um histórico de chat com uma etiqueta de nome. Esteja você falando com o Hermes pela CLI, Telegram, Discord, Slack, WhatsApp ou qualquer uma das outras 20+ plataformas suportadas, sua conversa é armazenada com histórico completo.

Tudo isso fica em um banco de dados SQLite em ~/.hermes/state.db. Para cada sessão, o Hermes registra:

Um título único e legível
Qual plataforma você usou (CLI, Telegram, etc.)
O modelo e a configuração
Histórico completo de mensagens com chamadas de ferramentas e resultados
Contagem de tokens e timestamps
ID da sessão pai (para quando conversas longas são divididas)

O Que Realmente Entra no Contexto

Aqui vai um equívoco comum: o Hermes não relê todos os arquivos ou imagens que você já compartilhou. Mídia é processada por turno. Se você enviar uma imagem e pedir um meme, o Hermes pode analisá-la uma vez com visão computacional, mas nas próximas interações ele carrega apenas uma descrição em texto ou um caminho local — não o JPEG bruto.

Os verdadeiros vilões do contexto são textos verbosos: transcrições coladas, logs gigantes, diffs enormes. A documentação tem uma dica excelente: prefira resumos, caminhos de arquivo e trechos focados em vez de copiar artefatos grandes para o chat.

Retomando Conversas pela CLI

É aqui que a mágica acontece. Vamos ver as três formas de retomar de onde parou.

1. Continuar a última sessão:

hermes --continue
# ou de forma abreviada
hermes -c

Isso pega sua sessão CLI mais recente e carrega o histórico completo.

2. Continuar por terminal (isso é novo e incrível):

Um -c simples agora é consciente do terminal. O Hermes cria um pequeno arquivo de rastro para cada sessão de terminal. Então, se você tem dois painéis de terminal lado a lado, cada um retoma sua própria conversa em vez de ambos brigarem pela mesma. Chega de interferência entre painéis!

Se não houver rastro (primeiro uso, ou se for mais antigo que 30 dias), ele volta para a sessão mais recente. Você pode desativar isso com session.terminal_continue: false no config.yaml.

3. Retomar pelo nome:

Dê títulos significativos às suas sessões e você poderá voltar direto para elas:

hermes -c "meu projeto"

Se houver variações como “meu projeto”, “meu projeto #2”, etc., o Hermes automaticamente pega a mais recente.

Retomando uma Sessão Específica

Precisa voltar a uma conversa específica? Use o ID da sessão:

hermes --resume 20250305_091523_a1b2c3d4
# ou pelo título
hermes --resume "refatorando auth"
# ou apenas a mais recente
hermes --resume latest

Dicas de Especialista da Documentação

/compress — use quando uma sessão ficar longa demais. Reduz o contexto ativo (mas atenção: não é uma exclusão por privacidade).
/new payments-refactor — inicie um novo tópico já com um título, facilitando encontrá-lo depois com /resume.
hermes sessions prune — apenas quando quiser excluir sessões antigas já encerradas.
hermes sessions optimize — se o state.db estiver grande, isso mescla índices de busca e limpa sem tocar nos seus dados. Comece por aqui!

Concluindo

O gerenciamento de sessões é o seu superpoder de memória. Esteja você lidando com vários projetos em terminais diferentes ou retomando uma sessão de depuração da semana passada, o Hermes cuida de tudo. O principal aprendizado: use /compress para conversas longas, nomeie suas sessões com /new <nome> e deixe o -c consciente do terminal manter seus painéis organizados.

Boa conversa!