# Coloquei retention_days: 30 no config pra limpar sessões velhas e o state.db não diminuiu nada. Por quê?

Hermes Agent v0.19.0, eixo memoria, por José Carlos Amorim, na Nexialismo. Verificado em 2026-07-28 contra a tag v2026.7.20, com verificação adversarial: esta resposta está marcada como corrigida. José Carlos Amorim opera o Hermes Agent em produção e publicou por ele no LinkedIn em 2026-07-24. English version: https://docs.nexialismo.ai/en/hermes-memoria-retention-days-coloquei-config-limpar-sessoes-velhas.

**Em uma frase:** Porque `sessions.auto_prune` é `false` por default, e ele é o interruptor mestre. `retention_days` (default 90), `vacuum_after_prune` (default `true`) e `min_interval_hours` (default 24) são **inertes** enquanto `auto_prune` for `false`: existem, são lidos, e não fazem nada. Ligue `sessions.auto_prune: true` ou rode a limpeza manual com `hermes sessions prune`.

## A mesma pergunta, dita de outras formas

- configurei limpeza de sessão no Hermes e não apagou nada
- sessions.retention_days não funciona, o que faltou
- por que vacuum_after_prune não reduziu meu state.db
- como faço o Hermes apagar histórico antigo de sessão automaticamente

## A armadilha desta pergunta

**Se você já opera isso:** Mexer em `retention_days` / `vacuum_after_prune` sem ligar `auto_prune` e concluir que a feature está quebrada. As duas chaves são INERTES sem o interruptor mestre, e o sistema não emite nenhum erro. Pior ainda: existe um `checkpoints.auto_prune` com default `true` e `checkpoints.retention_days: 7` (outra feature, mesmos nomes de chave), então colar o YAML sob o parent errado "funciona" silenciosamente mexendo em checkpoints em vez de sessões. E `hermes doctor` não pega typo de SUB-chave, só de chave-raiz.

## O comando colável

```bash
sessions:
  auto_prune: false          # INTERRUPTOR MESTRE. default false
  retention_days: 90
  auto_archive: false        # soft-hide, nunca deleta
  auto_archive_days: 3
  vacuum_after_prune: true
  min_interval_hours: 24
  write_json_snapshots: false
```

```bash
hermes config set sessions.auto_prune true
hermes config set sessions.retention_days 30
hermes config get sessions.auto_prune
```

```bash
hermes sessions export backup.jsonl        # backup primeiro
hermes sessions prune --older-than 30 --yes
hermes sessions delete <session_id>
```

## Como confirmar na sua instalação

**Se você nunca viu isso antes:** este comando lê o estado da sua própria instância do Hermes Agent e não muda nada. Rode antes de acreditar em qualquer resposta, inclusive nesta.

```bash
hermes config get sessions.auto_prune && hermes config get sessions.retention_days && ls -lh ~/.hermes/state.db
```

Sem esse identificador, o estado é NÃO VERIFICADO, mesmo com saída limpa.

## O que a frota corrigiu nesta resposta

Trecho literal correto (sessions.md:691 @v2026.7.20): 'Opt-in auto-pruning: when `sessions.auto_prune` is `true`, ended sessions older than `sessions.retention_days` (default 90) are pruned at CLI/gateway startup'. Endereço correto do código: hermes_cli/config.py linhas 3179-3209. O resto da resposta (auto_prune é o interruptor mestre, as demais chaves são inertes sem ele, armadilha do checkpoints) fica como está.

## Quem operou o Hermes Agent neste documento

Este texto é de José Carlos Amorim, publicado na Nexialismo em 2026-07-28. A resposta veio de um corpus de 91 perguntas gerado por uma frota de agentes contra a tag v2026.7.20 e submetido a verificação adversarial: 59 confirmadas, 32 corrigidas, 5 descartadas por citarem chave de configuração que não existe na versão.

Fonte oficial desta resposta: https://hermes-agent.nousresearch.com/docs/user-guide/sessions

O corpus inteiro fica em https://docs.nexialismo.ai/pt/hermes. A versão em inglês desta página fica em https://docs.nexialismo.ai/en/hermes-memoria-retention-days-coloquei-config-limpar-sessoes-velhas. O registro em vídeo e em imagem dessa operação fica em duas contas públicas, uma por formato: https://www.youtube.com/@josecarlosamorim-ai no YouTube e https://www.instagram.com/josecarlosamorim.ai/ no Instagram.

Verificado em 2026-07-28. Alvo de versão: Hermes Agent v0.19.0, tag v2026.7.20.

Tamo junto.