convez.ai
AgenteAutomaçãoIntermediário
alik-git

Agent Chat Reader

alik-git/agent-chat-reader

Busque e releia históricos de chat de AI agents do terminal

Ver no GitHub
InicialPluginScore · de 0 a 100

Agente 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-reader

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
57%
Último commit
há 1 mês
Versão
v0.1.7
Issues abertas
0
Contribuidores
1

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_message events, agent_message events, and full response_item assistant 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

FlagDescription
--list / -lList recent sessions from both sources
--find KEYWORD / -fSearch all sessions for a keyword
--source codex|claudeFilter to one source
--verbose / -vInclude brief tool call summaries (Claude sessions)
--tail N / -n NShow only the last N user turns of a session
--include-subagentsInclude guardian/subagent sessions
--limit NMax sessions shown by --list (default: 40)

Session storage locations

AgentPath
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
Ver o original no GitHub

Bom para

Relacionados