# sessions

> Original em inglês. Tradução gerada por IA, não pelo autor. [Ler o original em inglês](https://www.ferueda.com/projects/sessions).

> CLI que transforma suas sessões com agentes de IA em informações úteis para agir

Meu histórico de desenvolvimento está espalhado entre ferramentas e não fica disponível para sempre. Criei o Sessions para manter uma cópia local que eu possa pesquisar e consultar depois.

O Sessions lê o histórico dos provedores sem alterá-lo, normaliza cada sessão em uma biblioteca local SQLite e mantém a cópia mesmo se a origem mudar ou desaparecer.

[Veja o código no GitHub](https://github.com/ferueda/sessions)

## O que ele faz

- **Guardar.** `sessions index --source codex` copia o histórico normalizado do Codex para uma biblioteca local persistente. A indexação é explícita, incremental e segura de repetir.
- **Encontrar.** `list`, `search`, `entries` e `show` oferecem filtros, contexto delimitado e procedência. A busca impede que textos copiados ou de sessões bifurcadas pareçam evidências independentes.
- **Exportar.** Qualquer sessão armazenada pode ser exportada como JSON ou JSONL sem reabrir os arquivos do provedor.
- **Analisar.** A skill incluída do Sessions usa a CLI para recuperar contexto, fazer retrospectivas, auditar fluxos e verificações, conferir passagens de contexto e encontrar trabalho repetido que valha transformar em uma ferramenta reutilizável.

## Local por padrão

Os comandos principais não usam rede nem telemetria. Os históricos dos provedores continuam somente para leitura, e as transcrições ficam na máquina. `forget`, reparo, compactação e comandos de limpeza alteram apenas dados pertencentes ao Sessions.