Grepathy es una herramienta de línea de comandos escrita en TypeScript, sin dependencias en tiempo de ejecución, que resuelve un problema concreto del trabajo con agentes de programación: las decisiones que el agente toma por su cuenta y que nadie aprobó de forma explícita. Cuando un revisor pregunta "¿por qué se hizo así?", la respuesta suele estar perdida en una transcripción de chat que Claude Code borra a los 30 días.
El funcionamiento es automático. Grepathy lee las transcripciones de sesión en local, extrae las decisiones tomadas por el agente y las vuelca en un archivo Markdown (.ai/why/<rama>.md) que se confirma junto al código. Cada entrada indica el estado (por ejemplo, "agent-initiated — not requested in plan or prompts"), los archivos afectados y el razonamiento inferido. Se ejecuta mediante hooks de Git y no bloquea los pushes ni modifica el área de staging.
Los agentes futuros encuentran esta información por dos vías: un puntero en CLAUDE.md, que se carga en cada sesión, y un hook PreToolUse que inyecta las entradas relevantes justo antes de que el agente edite un archivo con historial. La privacidad está protegida: la transcripción nunca sale de la máquina del usuario, el resumen en Markdown nunca cita mensajes del usuario, describe dudas ni incluye datos de negocio, y aplica un escáner de secretos y otra información sensible. Antes de subir el archivo, el usuario lo revisa.
Grepathy es compatible con múltiples agentes y worktrees, admite backfill de sesiones antiguas y permite editar o borrar entradas de forma permanente. La escritura requiere hoy Claude Code; está previsto un adaptador para Codex. La lectura funciona con cualquier herramienta, ya que los archivos son Markdown estándar. La evaluación cieba y pre-registrada está publicada, incluidas las partes en las que la herramienta pierde frente a la línea base.