Documentación
Una memoria que tu agente conserva.
Corvusmem le da a tu agente de código una memoria de verdad — local, determinista y offline. Se engancha a Claude Code y Codex, escribe lo que tu agente aprende en un archivo que es tuyo, y te lo recuerda sesión tras sesión y proyecto tras proyecto. Sin embeddings, sin servidor, sin API key.
Qué es
Tu agente, con memoria propia — y que nunca sale de tu máquina. Los agentes se olvidan de todo entre sesiones; Corvusmem es la memoria que te recuerda a ti y a tus proyectos, en un único archivo local que tú controlas.
Es determinista (misma entrada, mismo resultado), offline (sin red) ysin dependencias. A diferencia de las memorias en la nube, la tuya sigue siendo tuya.
Instalación
Un comando. Sin cuenta, sin nube, sin API key — el hook escribe en un archivo local que es tuyo. Elige dónde vive la memoria: solo este proyecto, o todos tus proyectos a la vez.
Este proyecto
Por proyecto
Para un repo de equipo: los hooks se registran en./.claude/settings.jsony la memoria del proyecto en.corvusmem/. Commitea ambos y tus compañeros tienen memoria al clonar.
Todos los proyectos · recomendado
Global
Lo más sencillo: --globalregistra los hooks en tu home (~/.claude/settings.json), y así cada proyecto tiene memoria. Tu memoria personal vive en~/.config/corvusmem/, y la de cada proyecto sigue en su propio .corvusmem/.
Más opciones
--codex— instala para Codex (vía plugin); la misma memoria por debajo.--dry-run— enseña exactamente lo que haría, sin escribir nada.npx corvusmem uninstall— quita los hooks y deja tu memoria y todo lo demás intacto.
El modo solo decide dónde se enciende Corvus — no dónde vive la memoria. Los hechos de un proyecto caen SIEMPRE en el.corvusmem/de ese repo, con cualquiera de las dos instalaciones — así que no necesitas instalar por proyecto solo para que la memoria viva en el repo. Para un equipo: commitea.corvusmem/(la memoria compartida) y, con instalación por proyecto,.claude/settings.jsonpara que tus compañeros tengan los hooks al clonar. Nunca commitees~/.config/corvusmem/ — esa es tu memoria privada.
Funciona con Claude Code y Codex · el comando exacto para tu anfitrión se muestra durante la instalación
Cómo usarlo
Una vez instalado, tu agente captura y recuerda la memoria solo — no tienes que hacer nada. Cuando quieras verla odirigirla, estos comandos funcionan desde cualquier proyecto:
Ver tu memoria — el Cortex
Dibuja toda tu memoria como un cerebro HTML local y te imprime la ruta. Ábrelo en el navegador — funciona sin red.
Preguntar qué ya sabe
El mismo recuerdo que recibe tu agente, desde la terminal.
Listar todo, u olvidar un hecho
Añadir un hecho tú mismo
Rara vez hace falta — lo hace el agente — pero puedes. Usa--scope userpara guardarlo en tu memoria personal en vez de la del proyecto.
Los flags están en inglés con alias en español (--save/--guardar,--recall/--recordar). Claves y valores funcionan en cualquier idioma — la memoria es agnóstica al idioma.
¿Ya tienes notas? Tráelas
Si tu proyecto ya lleva memoria — un CLAUDE.md, un AGENTS.md, reglas de Cursor o Copilot, o notas sueltas en docs/ — no empiezas de cero. Corvus las encuentra y absorbe lo que importa, para que quien lo adopte conserve todo lo ya escrito.
1 · Mira qué hay
Un escaneo determinista y de solo lectura. Lista los archivos de memoria de agente conocidos y cualquier otro markdown en subcarpetas que pudiera ser memoria, dejando fuera el boilerplate (README, CHANGELOG, LICENSE).
2 · Absórbelo
Dentro de Claude Code, ejecuta el comando de abajo. Tu agente lee lo que encontró el escaneo, decide qué es memoria duradera, te pregunta — en tu idioma — lo que no tenga claro, y lo guarda. Tus archivos originales se quedan intactos.
Cómo funciona
Captura
El hook escucha
Un hook PostToolUselee cada intercambio y saca los hechos — decisiones, rutas de archivo, contexto del proyecto.
Guarda
Hechos, no vectores
Cada hecho cae en un grafo local ligero con su nombre, su fecha y sus enlaces. Todo el Cortex es un único archivo que es tuyo.
Recupera
Activación a dos saltos
Una consulta enciende el nodo que coincide y se extiende un salto, sacando los hechos relacionados — sin búsqueda semántica, sin modelo de embeddings. Al instante.
La memoria
Piénsalo como un cuaderno que tu agente lleva para ti — pero solo apunta lo que esestable: decisiones, el stack del proyecto, quién eres, tus preferencias, tus objetivos. La charla de paso se ignora. Cuando algo cambia, el valor nuevosustituye al viejo y el viejo se guarda, fechado, en el histórico — así tu agente nunca trabaja con algo que ya cambiaste.
Hay dos tipos de memoria, y no se mezclan nunca:
Proyecto
Sobre el proyecto
El stack, el cliente, decisiones, plazos. Vive en la carpeta del proyecto (.corvusmem/), así tu equipo — y Codex — lo comparten. «El stack es Next» es verdad lo diga quien lo diga.
Tú
Sobre ti
Quién eres y cómo te gusta trabajar — te acompaña en todos tus proyectos. Vive en tu máquina (~/.config/corvusmem/), privada, nunca se commitea. Tu agente recuerda ambas a la vez.
Huella
La memoria apenas toca la ventana de contexto de tu agente — y no crece. Un tope duro de cinco hechos por mensaje mantiene la huella plana: unos 413 tokens por mensaje (mediana) tengas 10 hechos o 10.000. O(1), no O(n). Ycero tokens de API — sin embeddings, sin red.
Ver el benchmark de huellaEquipos — un proyecto, muchas personas
Cuando varias personas trabajan en el mismo proyecto, la memoria compartida mantiene separados los hechos personales de cada una. Si Ana prefiere Vim y Bob prefiere Emacs, se guardan los dos — ninguno pisa al otro. Los hechos que describen elproyecto en sí (stack, decisiones) siguen compartidos y sin dueño, justo como debe ser.
No configuras nada: Corvusmem lee el autor de tu email de git(o tu usuario del sistema), sin red. Para quien trabaja solo es invisible — simplemente funciona.
El Cortex
El Cortex dibuja todo lo que tu agente sabe como un cerebro vivo de puntos — un brillo por hecho. Cada tipo de memoria se asienta en su zona: decisiones, objetivos, hechos del proyecto, quién eres, lo vivido.
Busca un hecho y solo se encienden su nodo y sus conexiones, como una neurona disparándose. No es un dibujo — es una radiografía de la memoria que tu agente de verdad usa.
Abre tu propio Cortex desde cualquier carpeta de proyecto — sin configurar nada:
Escribe un archivo HTML autocontenido (offline, sin red) e imprime la ruta — ábrelo en tu navegador.
--client— una vista para compartir sin nada privado, para enseñar a un cliente o compañero.--output <dir>— escribe el HTML en otro sitio;--lang en|es|…— elige el idioma.
Anfitriones
El motor detecta dónde corre y se adapta; la memoria es la misma por debajo.
Claude Code
Los hooks se registran en los ajustes de tu proyecto; los hechos se capturan después de cada llamada a herramienta.
Codex
Corre por la vía de plugin; el mismo cerebro, el mismo archivo local.
Independiente
Una CLI simple para cualquier proyecto — lee, escribe y busca la memoria directamente.
Licencia
Gratis para uso personal y no comercial bajoPolyForm Noncommercial. Cero telemetría — tu memoria vive en archivos locales que son tuyos.
Usar Corvusmem dentro de una empresa o un producto de pago necesita una licencia comercial.
Preguntas frecuentes
¿Mis datos salen alguna vez de mi máquina?
No. La memoria es un archivo local que es tuyo. Sin servidor, sin nube, sin API key, sin telemetría. Corvusmem funciona entero sin red.
¿En qué se diferencia de mem0 o Zep?
Esos guardan tu memoria en su nube detrás de una API. Corvusmem lo mantiene todo local y determinista — misma entrada, mismo resultado, sin embeddings ni base de datos vectorial.
¿Necesito un modelo de embeddings o una base vectorial?
No. Los hechos se guardan en un grafo local ligero y se recuperan por nombre, fecha y relevancia con activación a dos saltos. Sin embeddings, sin base vectorial.
¿Con qué agentes funciona?
Claude Code y Codex hoy, más una CLI independiente. El motor detecta su anfitrión y se adapta; la memoria es la misma por debajo.
¿Qué pasa con un equipo en el mismo proyecto?
Los hechos del proyecto (stack, decisiones) son comunes a todos. Los hechos personales (tus preferencias, quién eres) se guardan por autor, así que dos compañeros nunca se pisan. El autor se lee de tu email de git, sin configurar nada y sin red.
¿Es gratis?
Gratis para uso personal y no comercial bajo PolyForm Noncommercial. Usarlo dentro de una empresa o un producto de pago necesita una licencia comercial.