deja-vu

La única memoria que comparten tus agentes de codificación, construida a partir del historial que ya está en tu disco.

Tu agente está a punto de volver a depurar algo que arreglaste en marzo — en un agente diferente. deja indexa las sesiones que Claude Code, Codex, Cursor y cualquier otro agente en esta máquina ya escribieron en el disco, y entrega la correcta a cualquier agente que la pida.

_{Nadie buscó nada — el agente llamó a deja por sí mismo. Cada línea está citada de dos sesiones reales.}

Cada herramienta de memoria empieza vacía y registra hacia adelante. deja empieza llena.

Y nadie tiene que pedirlo: el recuerdo llega al inicio de la sesión, en cada mensaje, antes de que se edite un archivo o se ejecute un comando, y después de que uno falle. Las claves y tokens se eliminan mientras se construye el índice, así que lo que llega al modelo es seguro de enviar.

85.3% hit@1 en LongMemEval-S · 69.7% retrieval hit@1 en LoCoMo · búsquedas en milisegundos sobre gigabytes de historial
_{Ambos harnesses se incluyen en este repositorio y se ejecutan en los conjuntos de datos públicos en minutos · comprueba los números tú mismo}

English | 中文

Docs · Benchmarks · Cómo se compara · Integrarlo en tu herramienta

_{¿Te resultó útil? Dale una estrella a deja-vu en GitHub para que otros desarrolladores puedan encontrarlo.}

Instalación

curl -fsSL https://raw.githubusercontent.com/vshulcz/deja-vu/main/install.sh | sh
deja install --auto

Diez segundos para instalar, unos diez para indexar, y ya es útil. El segundo comando conecta el recuerdo MCP a cada agente que encuentre, activa el recuerdo al inicio de sesión donde el agente lo soporte, y construye el primer índice para que la próxima sesión no tenga que pagar por ello.

Inicia una nueva sesión de agente y pregúntale algo en lo que trabajaste hace meses:

¿hemos tratado la rotación de refresco de JWT antes? revisa tu memoria

Tampoco tiene que ser preguntado — con el auto-recuerdo el agente ya sabe lo que resolviste en ese proyecto cuando la sesión se abre.

claude plugin marketplace add vshulcz/deja-vu && claude plugin install deja-vu@deja-vu

scoop install deja-vu

Lo que obtienes

Resuélvelo en Codex. Claude lo recuerda. Treinta y cuatro agentes de codificación escriben cada conversación en archivos locales, y deja convierte esos archivos en una capa de memoria que todos leen.

Tu propio trabajo, envuelto

deja stats --card lo dibuja en la terminal; dale un nombre de archivo y escribe un SVG para un README de perfil. Para publicarlo en cualquier otro lugar, conviértelo en un PNG — esa página lo convierte en tu propio navegador.

La referencia completa de funciones vive en los docs.

Privacidad

La indexación y la búsqueda son locales. La red se usa solo por deja update, deja sync ssh, y la verificación de versión en deja doctor.

Las credenciales se redactan al indexar: claves AWS, asignaciones de api_key= y token=, tokens bearer y JWTs crudos, bloques de claves privadas PEM, tokens de proveedores, URLs de scheme://user:pass@host, valores de alta entropía para formas que ningún patrón conoce, y una contraseña declarada en prosa — "la contraseña de administrador es …", donde no hay delimitador para que las otras reglas la encuentren. El valor se convierte en [redacted:<kind>] y el texto circundante permanece buscable. deja share y deja sync export re-aplican la redacción a la salida.

deja forget elimina sesiones de un índice reconstruido y escribe tombstones, así que un deja index posterior no puede restaurarlas desde el historial fuente. --unforget levanta un tombstone. Las exclusiones de proyecto son un patrón por línea en ~/.config/deja/exclude; una línea con prefijo harness: nombra un almacén en su lugar — harness:opencode — y deja ni lo recorre ni pide la herramienta que lo leería.

El modelo de seguridad documenta flujos de datos, límites de redacción, supuestos de confianza y verificación de lanzamientos.

CLI

$ deja "jwt refresh token"
[claude] api        · Jul 8 · 8f31c0a9 — 2 matches
  login started failing after refresh token rotation; jwt kid mismatch in tests
  fixed by reloading jwks cache after rotateKey and adding a clock-skew test
[codex]  web        · Jul 1 · b77d91e2 — 1 match
  refresh token cookie needed SameSite=Lax in local callback flow

Pregunta a tu historial

Referencia completa: comandos y salida JSON.

Herramientas MCP

El servidor expone una herramienta, deja, con un mode. deja install la conecta, así que esto solo se necesita para configurar un agente manualmente. Los seis nombres de herramientas más antiguos (recall, recall_context, blame, fix, how, remember) todavía responden para cualquier cosa ya conectada a ellos.

Entornos compatibles

Con el auto-recuperación instalado, Claude Code y Codex entregan a deja la transcripción cuando comienza una compactación, y conserva lo que el resumen está a punto de descartar: la tarea, las conclusiones, los archivos, los comandos con lo que hizo cada uno, y lo que quedó abierto. El siguiente hook para la misma sesión y espacio de trabajo lo devuelve una vez, dentro de un presupuesto de 4 KB, con una línea que indica si el repositorio se movió desde entonces. deja stats cuenta las llamadas a herramientas antes de la primera edición después de una compactación, que es el número contra el que se mide esto. Consulta recuperación automática de compactación para ver qué se lee, qué se almacena y dónde están los límites.

aider · Amp · Antigravity · Claude Code · Cline · Codex CLI · Copilot CLI · VS Code Copilot Chat · Cursor · DeepSeek Harness · Gemini CLI · Goose · Grok Build · Hermes · Kimi Code · omp (Oh My Pi) · OpenClaw · opencode · Continue · Crush · pi · prime-agent (PrimeIntellect) · Qwen Code · Cherry Studio · Senpi · gajae-code · Kimchi Coding · Command Code · ZCode · Kiro · Kilo Code · Roo Code · Zed · CodeWhale.

Las ubicaciones de almacenamiento personalizadas pasan por variables DEJA_*_ROOT, y la variable de reubicación de cada agente también se respeta. El registro de formato de sesión documenta las rutas observadas, los esquemas de registro y el mapeo de roles por entorno, con fixtures sintéticos que mantienen esas descripciones verificadas contra los analizadores.

Entornos con un paquete propio

deja install --auto conecta los seis como cualquier otro entorno, y esa sigue siendo la ruta más corta. También tienen un paquete en su propio ecosistema, para personas que instalan extensiones allí en lugar de desde un CLI:

Cualquiera de las dos rutas es suficiente por sí sola, y tener ambas no es un problema: los paquetes de opencode, dsh, Kimi, Grok y Codex leen lo que deja install escribió y contribuyen solo lo que falta, y en Zed ambas mitades usan un solo id de servidor, así que no hay nada que tener dos veces en cualquier orden que instales.

Cada uno usa el deja que ya tienes; la copia que incluye es solo el respaldo.

La misma búsqueda también es una habilidad, para cualquier agente que cargue un SKILL.md:

npx skills add https://github.com/vshulcz/deja-vu --skill deja-search   # skills CLI: Claude Code, Cursor, Goose, Copilot…
openclaw skills install @vshulcz/deja-search                            # ClawHub
hermes skills install vshulcz/deja-vu/skills/deja-search                # Hermes

La habilidad impulsa el binario deja del paso de instalación anterior; no incluye uno.

Recuperación semántica (opcional)

Apunta deja embed a un endpoint local de Ollama, LM Studio o compatible con OpenAI con DEJA_EMBED_URL y las consultas reformuladas aún aciertan. Sin un runtime alcanzable, la búsqueda léxica y la recuperación MCP continúan sin cambios. OpenAI Platform funciona con su clave estándar:

export OPENAI_API_KEY='sk-...'
export DEJA_EMBED_URL='https://api.openai.com/v1/embeddings'
export DEJA_EMBED_MODEL='text-embedding-3-small'
deja embed

Sin DEJA_EMBED_URL configurado, deja sondea localhost:11434 y localhost:1234, así que una máquina que ya ejecuta Ollama o LM Studio se detecta sin que se le pregunte. DEJA_EMBED_OFF=1, o DEJA_EMBED_URL=off, desactiva esa sonda — cualquier otro DEJA_EMBED_URL configurado aún gana.

Para otro endpoint autenticado compatible con OpenAI, configura DEJA_EMBED_KEY explícitamente:

export DEJA_EMBED_URL='https://example.com/v1/embeddings'
export DEJA_EMBED_MODEL='embedding-model'
export DEJA_EMBED_KEY='...'
deja embed

DEJA_EMBED_KEY tiene prioridad. OPENAI_API_KEY se usa automáticamente solo para una URL api.openai.com HTTPS; nunca se envía implícitamente a endpoints locales o de terceros.

Prueba

deja bench recall     # ranking floor: 100 queries, half Russian, CI fails if recall drops
deja bench context    # 30 seeded task chains plus five negative controls
deja bench block      # does the answer survive into what deja hands over
deja bench prompt     # what the per-prompt hook fires on, and what it fires on wrongly
deja bench ingest     # what an update costs: unchanged, a turn, a new transcript, a rename, a rewrite
deja bench read       # what it costs to read a database-backed store, and what one long value does to it

bench block hace la pregunta que los otros tres no pueden: con la sesión correcta en mano, ¿el bloque lleva lo que esa sesión resolvió? Ocho sesiones discuten cada tema y una de ellas lo resuelve, en medio de su propia transcripción en lugar de al final — así que el brazo base, los turnos más nuevos del mejor resultado, puntúa cero y un brazo por encima de cero tuvo que elegir.

El experimento de contexto compara deja-recall contra historial completo, grep ingenuo y contexto frío. Con la semilla predeterminada:

Misma cobertura de hechos que hacer grep de los registros crudos por aproximadamente 250x menos tokens, y aproximadamente 70x menos que reproducir las sesiones coincidentes en su totalidad, mientras no inyecta nada en las cadenas donde ningún hecho previo es relevante. El generador de corpus y las etiquetas de relevancia son Go ordinario revisado. Audita qué significa "relevante" antes de confiar en cualquier cifra, incluidas las nuestras.

Medido en un almacén real de 2,419 sesiones y 179k mensajes, 1.9 GB de transcripciones:

El índice es incremental. Cuando un archivo de sesión crece, solo ese archivo se vuelve a leer.

Cómo funciona

Índice invertido local en ~/.cache/deja: analiza los almacenes JSONL y SQLite, redacta credenciales, escribe records.bin más cubos de tokens, y rastrea el estado por archivo en manifest.gob para que las ejecuciones repetidas solo ingieran lo que cambió. El servidor MCP, estadísticas, compartir y sincronizar leen ese único índice. Detalles en docs/ARCHITECTURE.md.

Preguntas frecuentes

¿Sale algo de mi máquina? No, a menos que lo pidas. Consulta los flujos de datos. ¿Qué pasa con los secretos que ya están en mis registros? Permanecen en los archivos originales del harness, que son los datos de tu agente. Las formas conocidas — claves de AWS, asignaciones de api_key=/token=, tokens de portador y JWTs simples, bloques PEM, tokens de proveedores, valores de alta entropía — se eliminan al construir el índice, por lo que no llegan a resúmenes, comparticiones o exportaciones de sincronización. La coincidencia de patrones no es detección de secretos: una forma que no conoce puede pasar. Consulta el modelo de seguridad.

¿Hará más lento a mi agente? Una recuperación es una búsqueda léxica contra un índice local: mediana de ~0.7 ms, y nada espera a un modelo. Un hook añade el inicio del proceso y una verificación de frescura sobre tus almacenes además de eso — decenas de milisegundos en un almacén de unos pocos gigabytes.

¿Tengo que cambiar mi forma de trabajar? No. El agente llama a la recuperación por sí mismo, y con la recuperación automática ya conoce las decisiones previas del proyecto cuando se abre la sesión.

¿En qué se diferencia de las otras herramientas de memoria?

engram es la más sólida de las herramientas de registro hacia adelante y vale la pena si ese modelo se ajusta a ti; aún así comienza vacía y solo conoce lo que un agente eligió guardar. La comparación completa cubre once de ellas.

¿Dónde se almacena el historial de sesiones de Claude Code y puedo buscarlo? En ~/.claude/projects, un archivo JSONL por sesión; Codex mantiene ~/.codex/sessions, Cursor una SQLite state.vscdb. deja search los lee todos en su lugar, deja last lista las sesiones recientes de cada agente, y deja view abre todo el historial como una página local. Rutas para cada agente: dónde se almacenan las sesiones.

Mi historial de sesiones de Claude Code desapareció. ¿Se ha ido? Claude Code elimina transcripciones de más de 30 días (cleanupPeriodDays en ~/.claude/settings.json), y claude --resume lista solo lo que queda. Una sesión indexada por deja antes de la limpieza sigue siendo buscable después de que el archivo desaparezca. Detalles: archivos de sesión en disco.

¿Qué pasa con Windows? Existen builds y CI ejecuta la suite allí. macOS y Linux son las rutas probadas en batalla. Informes de campo bienvenidos en #9.

¿Cómo borro todo?

deja uninstall --all
rm -rf ~/.cache/deja

Guías

Escritas para la situación más que para la característica:

• ¿Tu agente recuerda conversaciones anteriores? — qué conserva cada agente entre sesiones y qué descarta
• Archivos de sesión en disco — cuánto crece ~/.claude/projects y qué cuesta eliminarlo
• El agente perdió el contexto que tenías — después de un bloqueo, una limpieza o una sesión que volvió vacía
• La ventana de contexto está llena — qué conserva la compactación, medido, y qué hacer en su lugar
• Reanudar la sesión de ayer — encuéntrala en cada agente, reábrela en el que la posee
• El agente repite un error que ya corregiste
• Encontrar la sesión donde lo resolviste
• Por qué los agentes olvidan entre sesiones · Dónde guarda cada agente su historial
• Qué descarta la compactación · Cambiar de agente · Auditar un agente · Exportar una conversación · Entre máquinas · Cuánto cuesta la memoria

Por harness: opencode · DeepSeek Harness · Kimi Code · Zed · Grok Build · Gemini CLI · Qwen Code · OpenClaw · Goose · Cline · pi y omp · Hermes

Pruébalo con tu propio historial

curl -fsSL https://raw.githubusercontent.com/vshulcz/deja-vu/main/install.sh | sh
deja install --auto

Diez segundos para instalar, unos diez para indexar. En la próxima sesión que abra tu agente, ya sabrá lo que resolviste en ese proyecto — incluyendo todo lo anterior a la instalación de esto.

Contribuciones

make build test lint, luego CONTRIBUTING.md. Añadir un harness comienza en el registro de parsers. Prioridades y no-objetivos están en ROADMAP.md. Las buenas primeras issues están etiquetadas.

Soporte

Errores y preguntas van a issues. Cualquier cosa que creas explotable va a través del enlace de aviso privado en SECURITY.md en su lugar. Lo que deja lee, lo que nunca envía a ningún lugar, y cómo excluir un proyecto u olvidar una sesión está en Privacidad.

Licencia

MIT © Vladislav Shulcz