Integraciones
Tus agentes, tu sistema, tus proveedores
25 agentes de programación y editores, cuatro sistemas operativos de destino y una lista de proveedores de LLM y embeddings que puedes ignorar, porque todo funciona sin ninguno.
Muchos agentes, una memoria
Todos los agentes se conectan al mismo servidor. Lo que Claude Code aprendió esta mañana está ahí cuando abres Codex por la tarde.
Agentes y editores
Filtra por estado y luego elige una fila para ver sus comandos de instalación.
Claude Code Con soporte
# las herramientas de memoria, por MCP
ai-memory install-mcp --client claude-code --apply
# captura automática, mediante hooks de ciclo de vida
ai-memory install-hooks --agent claude-code --apply
# o lánzalo gestionado; las dos formas se conectan solas
ai-memory run claude
Hooks y MCP. Enrutamiento por sesión opcional. Omite --apply para imprimir el cambio sin escribirlo.
Codex Con soporte
# las herramientas de memoria, por MCP
ai-memory install-mcp --client codex --apply
# captura automática, mediante hooks de ciclo de vida
ai-memory install-hooks --agent codex --apply
# o lánzalo gestionado; las dos formas se conectan solas
ai-memory run codex
Hooks y MCP. El fin de sesión está conectado desde Codex CLI 0.145.0. Omite --apply para imprimir el cambio sin escribirlo.
Cursor Con soporte
# las herramientas de memoria, por MCP
ai-memory install-mcp --client cursor --apply
# captura automática, mediante hooks de ciclo de vida
ai-memory install-hooks --agent cursor --apply
Configuración de MCP y hooks de ciclo de vida. Omite --apply para imprimir el cambio sin escribirlo.
Gemini CLI Con soporte
# las herramientas de memoria, por MCP
ai-memory install-mcp --client gemini-cli --apply
# captura automática, mediante hooks de ciclo de vida
ai-memory install-hooks --agent gemini-cli --apply
Configuración de MCP y hooks de ciclo de vida. Omite --apply para imprimir el cambio sin escribirlo.
OpenCode Con soporte
# las herramientas de memoria, por MCP
ai-memory install-mcp --client opencode --apply
# captura automática, mediante hooks de ciclo de vida
ai-memory install-hooks --agent opencode --apply
# o lánzalo gestionado; las dos formas se conectan solas
ai-memory run opencode
MCP remoto y un plugin de TypeScript generado. Omite --apply para imprimir el cambio sin escribirlo.
OpenCode 2 beta Con soporte
# las herramientas de memoria, por MCP
ai-memory install-mcp --client opencode2 --apply
# captura automática, mediante hooks de ciclo de vida
ai-memory install-hooks --agent opencode2 --apply
# o lánzalo gestionado; las dos formas se conectan solas
ai-memory run opencode2
Plugin para la API beta. Espera cambios frecuentes en upstream. Omite --apply para imprimir el cambio sin escribirlo.
Grok Build CLI Con soporte
# las herramientas de memoria, por MCP
ai-memory install-mcp --client grok --apply
# captura automática, mediante hooks de ciclo de vida
ai-memory install-hooks --agent grok --apply
# o lánzalo gestionado; las dos formas se conectan solas
ai-memory run grok
La captura funciona. Los traspasos se recogen por MCP. Omite --apply para imprimir el cambio sin escribirlo.
Devin CLI Con soporte
# las herramientas de memoria, por MCP
ai-memory install-mcp --client devin --apply
# captura automática, mediante hooks de ciclo de vida
ai-memory install-hooks --agent devin --apply
Hooks y MCP, incluida la captura tras la compactación. Omite --apply para imprimir el cambio sin escribirlo.
Kimi Code Con soporte
# las herramientas de memoria, por MCP
ai-memory install-mcp --client kimi-code --apply
# captura automática, mediante hooks de ciclo de vida
ai-memory install-hooks --agent kimi-code --apply
# o lánzalo gestionado; las dos formas se conectan solas
ai-memory run kimi
Diez eventos de hook. Los traspasos se inyectan en el primer prompt. Omite --apply para imprimir el cambio sin escribirlo.
Kiro CLI Con soporte
# las herramientas de memoria, por MCP
ai-memory install-mcp --client kiro-cli --apply
# captura automática, mediante hooks de ciclo de vida
ai-memory install-hooks --agent kiro-cli --apply
# o lánzalo gestionado; las dos formas se conectan solas
ai-memory run kiro
Los motores v2 y v3. Omite --apply para imprimir el cambio sin escribirlo.
Command Code Con soporte
# las herramientas de memoria, por MCP
ai-memory install-mcp --client command-code --apply
# captura automática, mediante hooks de ciclo de vida
ai-memory install-hooks --agent command-code --apply
# o lánzalo gestionado; las dos formas se conectan solas
ai-memory run command-code
MCP y cuatro eventos de hook, con resume nativo. Omite --apply para imprimir el cambio sin escribirlo.
Antigravity CLI Con soporte
# las herramientas de memoria, por MCP
ai-memory install-mcp --client antigravity-cli --apply
# captura automática, mediante hooks de ciclo de vida
ai-memory install-hooks --agent antigravity-cli --apply
# o lánzalo gestionado; las dos formas se conectan solas
ai-memory run antigravity
Las sesiones se cierran con finalize-session. Omite --apply para imprimir el cambio sin escribirlo.
Pi Con soporte
# las herramientas de memoria, por MCP
ai-memory install-mcp --client pi --apply
# captura automática, mediante hooks de ciclo de vida
ai-memory install-hooks --agent pi --apply
Una extensión generada aporta la captura y un puente MCP. Omite --apply para imprimir el cambio sin escribirlo.
Oh My Pi Con soporte
# las herramientas de memoria, por MCP
ai-memory install-mcp --client omp --apply
# captura automática, mediante hooks de ciclo de vida
ai-memory install-hooks --agent omp --apply
MCP nativo y una extensión de TypeScript. Omite --apply para imprimir el cambio sin escribirlo.
OpenClaw Con soporte
# las herramientas de memoria, por MCP
ai-memory install-mcp --client openclaw --apply
# captura automática, mediante hooks de ciclo de vida
ai-memory install-hooks --agent openclaw --apply
Configuración de MCP y hooks nativos de plugin. Omite --apply para imprimir el cambio sin escribirlo.
Zero Con soporte
# las herramientas de memoria, por MCP
ai-memory install-mcp --client zero --apply
# captura automática, mediante hooks de ciclo de vida
ai-memory install-hooks --agent zero --apply
La captura incluye eventos de subagentes. Omite --apply para imprimir el cambio sin escribirlo.
ZCode Con soporte
# las herramientas de memoria, por MCP
ai-memory install-mcp --client zcode --apply
# captura automática, mediante hooks de ciclo de vida
ai-memory install-hooks --agent zcode --apply
Seis triggers. La inyección de traspasos funciona. Omite --apply para imprimir el cambio sin escribirlo.
Crush Solo gestionado
# lánzalo a través de ai-memory
ai-memory run crush
Lánzalo con ai-memory run crush.
Pool Solo hooks
# prepara los scripts de los hooks e imprime un fragmento para pegar en la configuración del agente
ai-memory install-hooks --agent pool --apply
Pega en su configuración un fragmento de hooks generado.
Claude Desktop Solo MCP
# las herramientas de memoria, por MCP
ai-memory install-mcp --client claude-desktop --apply
Se conecta mediante mcp-remote. Omite --apply para imprimir el cambio sin escribirlo.
VS Code Copilot Solo MCP
# las herramientas de memoria, por MCP
ai-memory install-mcp --client vscode-copilot --apply
Copilot todavía no expone hooks de ciclo de vida. Omite --apply para imprimir el cambio sin escribirlo.
Zed Solo MCP
# las herramientas de memoria, por MCP
ai-memory install-mcp --client zed --apply
Registrado como context server. Omite --apply para imprimir el cambio sin escribirlo.
Swival CLI Solo MCP
# las herramientas de memoria, por MCP
ai-memory install-mcp --client swival --apply
Configuración de MCP a nivel de proyecto. Omite --apply para imprimir el cambio sin escribirlo.
Muse Code Solo MCP
# las herramientas de memoria, por MCP
ai-memory install-mcp --client muse --apply
Configuración de MCP a nivel de usuario. Omite --apply para imprimir el cambio sin escribirlo.
Hermes Agent Comunidad
ai-memory no trae instalador para este. El servidor reconoce sus eventos de hooks, y el plugin lo mantiene la comunidad. Revísalo antes de instalarlo: ai-memory-hermes-plugin en GitHub.
Plugin de la comunidad, por MrLuciano.
| Agente | Estado | Notas | ai-memory run |
|---|---|---|---|
| Con soporte | Hooks y MCP. Enrutamiento por sesión opcional. | Gestionado | |
| Con soporte | Hooks y MCP. El fin de sesión está conectado desde Codex CLI 0.145.0. | Gestionado | |
| Con soporte | Configuración de MCP y hooks de ciclo de vida. | Lanzamiento directo | |
| Con soporte | Configuración de MCP y hooks de ciclo de vida. | Lanzamiento directo | |
| Con soporte | MCP remoto y un plugin de TypeScript generado. | Gestionado | |
| Con soporte | Plugin para la API beta. Espera cambios frecuentes en upstream. | Gestionado | |
| Con soporte | La captura funciona. Los traspasos se recogen por MCP. | Gestionado | |
| Con soporte | Hooks y MCP, incluida la captura tras la compactación. | Lanzamiento directo | |
| Con soporte | Diez eventos de hook. Los traspasos se inyectan en el primer prompt. | Gestionado | |
| Con soporte | Los motores v2 y v3. | Gestionado | |
| Con soporte | MCP y cuatro eventos de hook, con resume nativo. | Gestionado | |
| Con soporte | Las sesiones se cierran con finalize-session. | Gestionado | |
| Con soporte | Una extensión generada aporta la captura y un puente MCP. | Gestionado | |
| Con soporte | MCP nativo y una extensión de TypeScript. | Gestionado | |
| Con soporte | Configuración de MCP y hooks nativos de plugin. | Lanzamiento directo | |
| Con soporte | La captura incluye eventos de subagentes. | Lanzamiento directo | |
| Con soporte | Seis triggers. La inyección de traspasos funciona. | Lanzamiento directo | |
| Solo gestionado | Lánzalo con ai-memory run crush. | Gestionado | |
| Solo hooks | Pega en su configuración un fragmento de hooks generado. | Lanzamiento directo | |
| Solo MCP | Se conecta mediante mcp-remote. | Lanzamiento directo | |
| Solo MCP | Copilot todavía no expone hooks de ciclo de vida. | Lanzamiento directo | |
| Solo MCP | Registrado como context server. | Lanzamiento directo | |
| Solo MCP | Configuración de MCP a nivel de proyecto. | Lanzamiento directo | |
| Solo MCP | Configuración de MCP a nivel de usuario. | Lanzamiento directo | |
| Comunidad | Plugin de la comunidad, por MrLuciano. | Lanzamiento directo |
Qué significa cada estado
- Con soporte
- Captura automática mediante hooks de ciclo de vida, más las herramientas de memoria por MCP.
- Solo MCP
- El agente puede buscar y escribir en la memoria. No expone hooks de ciclo de vida, así que nada se captura automáticamente.
- Solo hooks
- Las sesiones se capturan automáticamente. El agente no tiene un cliente MCP con el que consultar la memoria.
- Solo gestionado
- Funciona cuando se lanza con
ai-memory run. No hay un instalador de hooks aparte. - Comunidad
- Un plugin que mantiene la comunidad. ai-memory no lo instala.
- Experimental
- Se publica y funciona, con asperezas que debes esperar.
Los detalles por agente, la ubicación de los archivos de configuración y las rarezas conocidas están en la matriz de soporte y en la guía de instalación de MCP.
Los hooks capturan, MCP responde
Son dos conexiones separadas, y un agente con soporte completo tiene las dos. Las etiquetas de estado de arriba dicen cuáles recibe tu agente.
Hooks
Los eventos de ciclo de vida del agente disparan un comando pequeño que registra prompts, llamadas a herramientas y límites de sesión. Tú no haces nada, y el agente no gasta tokens en ello. Los secretos se eliminan antes de guardar nada.
MCP
El agente recibe herramientas de memoria que puede llamar cuando la conversación las necesita: buscar, leer una página, escribir una página, aceptar un traspaso. Los agentes con solo MCP pueden usar la memoria por completo, pero no se captura nada salvo que ellos lo escriban.
Sistemas operativos
Un binario en Rust por plataforma. En Windows, WSL2 es la ruta con soporte y la compilación nativa es experimental.
| Plataforma | Estado | Cómo se instala | Notas |
|---|---|---|---|
| Linux | Con soporte | Tarball de la versión, imagen de Docker o Podman, o un paquete del AUR | x86_64 y ARM64. Binario nativo, Docker o Podman, paquetes del AUR con unidades de systemd. |
| macOS | Con soporte | Tarball de la versión con un agente de launchd, Docker, o la app de barra de menús compilada desde el código fuente | Apple Silicon e Intel. Binario nativo con un agente de launchd, Docker, o una app de barra de menús que compilas desde el código fuente. |
| Windows con WSL2 | Con soporte | El binario de Linux, dentro de WSL2 | Sigue la ruta de Linux dentro de WSL2 y lanza tu agente desde ahí. |
| Windows nativo | Experimental | Zip de la versión, wrapper para Docker Desktop o una compilación desde el código fuente | Zip de la versión con ai-memory.exe, el wrapper para Docker Desktop o una compilación desde el código fuente. |
Proveedores de LLM y embeddings
Los dos son opcionales. Sin ninguno, los hooks siguen capturando, la búsqueda sigue funcionando y cada sesión sigue terminando con una página de resumen y un traspaso.
Embeddings: locales por defecto
Desde la 2.0, la búsqueda vectorial corre dentro del proceso con un modelo abierto pequeño. No necesita clave de API ni GPU. El modelo pesa unos 87 MB, se descarga en segundo plano en el primer arranque, y la búsqueda híbrida se activa en el siguiente reinicio. Si la descarga falla, la búsqueda sigue funcionando con texto completo.
- Local, en el mismo proceso (por defecto)
- OpenAI
- Voyage
- Google Gemini
- GitHub Copilot
- Ollama, LM Studio, vLLM
Desactívalo con embedding_provider = "none". Un proveedor que hayas configurado tú nunca se sobrescribe.
LLM: desactivado por defecto
Añade uno cuando quieras consolidación escrita por un LLM, ai-memory bootstrap, un linting más rico, auto-improve o rerank. Un modelo pequeño y rápido es el tamaño adecuado para este trabajo, cuando el proveedor te deja elegir. Con un inicio de sesión de Codex o ChatGPT, mantén el modelo por defecto del proveedor, porque ese backend rechaza otros nombres de modelo. Los inicios de sesión por suscripción funcionan, así que no hace falta una clave de API de pago de ninguna plataforma.
- Anthropic
- OpenAI
- OpenAI OAuth / login de Codex CLI
- GitHub Copilot
- Google Gemini
- OpenCode Go y Zen
- Ollama
- LM Studio
- vLLM
- Cualquier endpoint compatible con OpenAI
Comprueba un proveedor con ai-memory llm-test. Se admiten cadenas de fallback.
Los modelos, los valores por defecto y los costes están en la guía de proveedores de LLM y en la guía de embeddings locales.
¿Tu agente no está en la lista?
Todo lo que hable MCP puede usar hoy las herramientas de memoria.
Registra un servidor MCP remoto por HTTP con esta dirección en la configuración de tu agente. La búsqueda, la lectura y escritura de páginas y los traspasos funcionan. La captura automática necesita hooks de ciclo de vida, así que sin ellos el agente solo recuerda lo que escribe.
¿Quieres soporte completo para él? La guía de contribución de harness gestionados describe lo que tiene que demostrar un adaptador, y la página de contribución dice adónde van los issues y los pull requests.
# el servidor local por defecto
http://127.0.0.1:49374/mcp
Preguntas y respuestas
¿Con qué agentes de programación funciona ai-memory?
Hay 25 agentes y editores en la lista, entre ellos Claude Code, Codex, Cursor, Gemini CLI, OpenCode. 17 de ellos tienen tanto captura automática mediante hooks de ciclo de vida como las herramientas de memoria por MCP.
¿Qué diferencia hay entre los hooks y MCP?
Los hooks capturan las sesiones automáticamente: los prompts, las llamadas a herramientas y los límites de sesión se registran sin que el agente haga nada. MCP le da al agente herramientas que puede llamar para buscar y escribir en la memoria. Un agente con soporte completo tiene los dos.
Mi agente no está en la lista. ¿Puedo usarlo igualmente?
Sí, si habla MCP. Apúntalo a http://127.0.0.1:49374/mcp y podrá buscar y escribir en la memoria. Sin hooks de ciclo de vida, nada se captura automáticamente.
¿Necesito un LLM o un proveedor de embeddings?
No. Los dos son opcionales. Desde la 2.0, los embeddings por defecto corren dentro del proceso con un modelo de unos 87 MB que se descarga en el primer arranque, y no interviene ninguna clave de API.
¿ai-memory funciona en Windows?
Sí. WSL2 tiene soporte a través de la ruta de Linux. Windows nativo es experimental y se distribuye como un zip de la versión con ai-memory.exe.
Dale memoria a tus agentes hoy.
Gratis y de código abierto bajo la licencia MIT. No necesitas cuenta ni clave de API.