No fue la primera vez · 12 de noviembre
La noche anterior, al continuar un vídeo en otra sesión, bastó una frase del borrador para recuperar el guion entero. Búsqueda: 748 ms. Ampliación: 135 ms.
Ver la medición del segundo caso →Empieza aquí
Una decisión, un arreglo, un guion. Agent History Search los busca en tus chats anteriores y devuelve el fragmento con su fuente, para que puedas seguir trabajando.
Recupera el comando con el que publicamos la web de marketing.
Encontrado en 226 ms
wrangler pages deploy dist-marketing --project-name alvaropastor-marketing --branch main
I · El problema
Cada conversación con tu agente empieza de cero. El comando de ayer, la decisión de la semana pasada, el guion que ya escribisteis: todo sigue en tu disco, pero tu agente no lo ve. Así que se lo vuelves a explicar.
II · Lo encontró en 226 ms
13 de noviembre de 2026, por la noche.
Tenía que volver a publicar la web de marketing. Estaba en Claude Code y me faltaba el comando exacto: el proyecto, la carpeta, la rama.
Sabía que lo había resuelto el día anterior. No sabía en qué chat.
El día anterior…
En una sesión de Pi Pocket, el agente había comprobado el proyecto de Cloudflare Pages y había publicado la web. La respuesta seguía guardada en el historial. Solo había que encontrarla.
Así que le pedí a Claude que la buscara.
Lo que recuperó
wrangler pages deploy dist-marketing --project-name alvaropastor-marketing --branch main
Búsqueda: 226 ms. Ampliación: 150 ms. Calculados entre la llamada y su respuesta emparejada en el registro de Claude Code.
Caso real en mi equipo, no un promedio ni una garantía. No incluye la reflexión del agente ni el tiempo total de respuesta. Se amplió la referencia elegida con context: 500.
Ver extracto de evidencia →Sin identificadores de chats, rutas locales ni conversaciones completas.
No fue la primera vez · 12 de noviembre
La noche anterior, al continuar un vídeo en otra sesión, bastó una frase del borrador para recuperar el guion entero. Búsqueda: 748 ms. Ampliación: 135 ms.
Ver la medición del segundo caso →La pregunta natural es cómo. Eso es lo que cuenta el resto de la página.
III · Dile lo que recuerdas
«Recupera el comando con el que publicamos la web de marketing. Creo que usamos wrangler. Muéstrame el comando y su fuente.»
No necesitas escribir los parámetros de la herramienta.
{ "action": "search",
"query": "wrangler pages deploy",
"query_variants": ["Deployment complete",
"alvaropastor-marketing"],
"limit": 5 }Devuelve cinco fragmentos breves, cada uno con su agente, fecha y referencia.
{ "action": "expand",
"ref": "<referencia elegida de la búsqueda>",
"context": 500 }Lee lo justo alrededor de ese fragmento y te enseña de dónde sale, para que lo compruebes.
IV · Qué lee y qué no
Lee los mensajes sin modificarlos ni borrar tus conversaciones.
Solo lee el historial de otro agente si lo autorizas y se lo pides. Nunca cambia de fuente por su cuenta, ni tras un error.
Declara sus huecos. Que algo no aparezca no significa que no pasara.
La herramienta no usa la red. Lo que encuentra se lo entrega a tu agente, así que llega a su modelo como cualquier otro texto que le enseñes.
Todavía no lo sé. Está probado en Windows y no depende de paquetes externos, pero no lo he validado en otros sistemas.
V · Gratis, con un prompt
Requisitos: Windows 10/11 y Python 3.10 o superior.
Configura Agent History Search en este equipo. Repositorio: https://github.com/alvaropas17/agent-history-search Carpeta del paquete: [RUTA ABSOLUTA] Agente que usaré: [codex / claude / opencode / pi / omp / pocket] Historiales que autorizo a leer: [FUENTES Y RUTAS] Lee el README y la documentación de instalación de la versión descargada. Comprueba Python 3.10+, sqlite3, la ayuda del CLI y las pruebas offline. Para Codex o Claude Code, configura el MCP incluido history_mcp.py con un host fijo y solo los historiales autorizados. Para el resto, configura el helper history_search.py y su skill o instrucciones locales. Antes de editar configuración, muestra los cambios propuestos y haz una copia de seguridad. No sustituyas archivos completos ni toques otros MCP. Si faltan rutas o autorizaciones, pregúntame. No cambies de fuente tras un error o un resultado vacío. No modifiques historiales ni borres WAL. Verifica la conexión real con una lectura mínima autorizada y dime cómo comprobarla en una sesión nueva. Si falta alguna prueba, indícalo.
En PowerShell, desde la carpeta descargada. Las pruebas no leen tus conversaciones; si fallan, resuelve el error antes de seguir.
py -3 --version py -3 -c "import sqlite3; print(sqlite3.sqlite_version)" py -3 -B history_search.py --help py -3 -B -m unittest discover -s tests
Rutas habituales en Windows; comprueba las de tu instalación. El agente solo lee otra fuente si se lo pides.
Claude Code --host claude $HOME/.claude/projects Codex --host codex $HOME/.codex/sessions Pi --host pi $HOME/.pi/agent/sessions omp --host omp $HOME/.omp/agent/sessions OpenCode --host opencode $HOME/.local/share/opencode/opencode.db Pi Pocket --host pocket $HOME/.pi-pocket/pocket.sqlite
--plan valida los argumentos, pero no abre el historial ni demuestra que la ruta exista.
py -3 -B history_search.py list --host claude --store "$HOME/.claude/projects" --plan
Claude Code (supone el paquete en C:/Tools/agent-history-search):
claude mcp add agent-history-search --scope user -- py -3 -B C:/Tools/agent-history-search/history_mcp.py --host claude
Codex: añade este bloque a tu config.toml sin sustituir el archivo. Las rutas deben ser absolutas.
[mcp_servers.agent_history_search] command = "py" args = ["-3", "-B", "C:/Tools/agent-history-search/history_mcp.py", "--host", "codex", "--store", "codex=C:/Users/YOUR_USER/.codex/sessions"] startup_timeout_sec = 30
OpenCode, Pi, omp y Pi Pocket usan history_search.py con su skill. Con OpenCode o Pi Pocket abiertos y un archivo WAL, usa la herramienta de snapshot incluida o cierra la aplicación. No borres el WAL.
En una sesión nueva, pide que liste tu conversación más reciente con su fuente e ID, sin mostrar el contenido, y comprueba que llama a la herramienta del MCP (o al script). Después busca una palabra que sepas que existe. Si configuraste MCP, una prueba con el script no demuestra que MCP funcione.
Buscar una frase literal en conversaciones pasadas. Listar y leer sesiones recientes, o una por su ID exacto. Inspeccionar llamadas con --tool-calls: comandos, argumentos y resultados, con fallos marcados solo si el historial lo prueba.
py -3 -B history_search.py search --host claude --store "$HOME\.claude\projects" --query "portfolio-anterior" --limit 1 --context 120 py -3 -B history_search.py expand --host claude --store "$HOME\.claude\projects" --session <id> --entry <id> --context 400 py -3 -B history_search.py search --host claude --store "$HOME\.claude\projects" --tool-calls --state failure --since 2026-10-25 --limit 1
Gracias por leer hasta aquí. Si lo pruebas, cuéntame en X qué recuperó tu agente.