Agent Chat Reader
alik-git/agent-chat-reader
Busque e releia históricos de chat de AI agents do terminal
Ver no GitHubAgente que lê e busca histórico de conversas do Codex CLI e Claude Code diretamente do terminal. Útil para agents que precisam recuperar discussões e decisões de sessões passadas sem fazer parsing manual de arquivos JSONL barulhentos.
Instalação
npx convez-ai alik-git/agent-chat-reader1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Agents recuperarem contexto de conversas anteriores
- Pesquisar decisões e discussões em múltiplas sessões
- Filtrar conversas por fonte (Codex ou Claude Code)
- Analisar histórico de interações sem ruído de metadados
Veredito

Ferramenta focada e bem executada para um nicho específico: agents que precisam acessar histórico de chat de forma programática. Reduz significativamente o atrito de parsing JSONL bruto com filtros inteligentes para Codex e Claude Code.
README
A tradução para o português deste README ainda está na fila.
agent-chat-reader
Read and search Codex CLI and Claude Code chat history from the terminal.
Useful for AI agents that need to recall what was discussed or decided in past sessions, without manually parsing noisy JSONL files.
Install
uv tool install agent-chat-reader
Or for development:
git clone https://github.com/alik-git/agent-chat-reader
cd agent-chat-reader
uv sync --extra dev
uv run agent-chat-reader --help
Usage
List recent sessions (both Codex and Claude Code, sorted by recency):
agent-chat-reader --list
Search across all sessions for a keyword:
agent-chat-reader --find "sim2sim"
agent-chat-reader --find "policy_interface" --source codex
Read a specific session by UUID prefix:
agent-chat-reader 019eaecb
agent-chat-reader 1bfc739b --verbose # include tool call summaries
agent-chat-reader 019eaecb --tail 5 # last 5 user turns only
What it filters out
The raw JSONL files are very noisy. This tool extracts only:
- Codex:
user_messageevents,agent_messageevents, and fullresponse_itemassistant text. Guardian/subagent sessions (auto-approval bots) are hidden by default. - Claude Code: real user turns (not tool-result carriers), and assistant text blocks (not thinking blocks or tool calls). Sidechain sub-agent turns are hidden by default.
Use --include-subagents to see everything.
Options
| Flag | Description |
|---|---|
--list / -l | List recent sessions from both sources |
--find KEYWORD / -f | Search all sessions for a keyword |
--source codex|claude | Filter to one source |
--verbose / -v | Include brief tool call summaries (Claude sessions) |
--tail N / -n N | Show only the last N user turns of a session |
--include-subagents | Include guardian/subagent sessions |
--limit N | Max sessions shown by --list (default: 40) |
Session storage locations
| Agent | Path |
|---|---|
| Codex CLI | ~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl |
| Claude Code | ~/.claude/projects/*/*.jsonl |
Development
uv run ruff format --check .
uv run ruff check .
uv run mypy
uv run pytest
uv build