Integraciones
Tus agentes, tu sistema, tus proveedores
35 agentes de programación y editores, cuatro plataformas de sistema operativo y proveedores opcionales de modelos. Captura, traspasos y búsqueda funcionan sin un proveedor de modelos en la nube.
Los hooks capturan, MCP responde
Los hooks registran eventos de sesión automáticamente. MCP, el Model Context Protocol, da a tu agente herramientas para buscar y usar la memoria. Un agente con soporte completo tiene ambas conexiones.
Hooks
Tu agente
Memoria
Captura automática
MCP
Tu agente
Memoria
Herramientas del agente
Hooks
Los eventos de sesión activan un pequeño comando que registra prompts y observaciones limitadas de las herramientas. Las credenciales reconocidas se ocultan antes de almacenarlas; el filtrado es best effort.
MCP
Mediante MCP, el agente puede buscar, leer o escribir una página y aceptar un traspaso. Los agentes con solo MCP pueden usar estas herramientas, pero la captura automática de sesiones necesita hooks.
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.
Claude Code
Codex
Cursor
Una memoria
Gemini CLI
OpenCode
Zed
Agentes y editores
Filtra por estado y luego elige una fila para ver sus comandos de instalación.
Claude Code Con soporte
# lánzalo a través de ai-memory; el primer lanzamiento instala sus hooks y la entrada de MCP
ai-memory run claude
# o conéctalo a mano, para un harness que nunca lanzas así
ai-memory install-mcp --client claude-code --apply
ai-memory install-hooks --agent claude-code --apply
Hooks y MCP. Enrutamiento por sesión opcional. Omite --apply para imprimir el cambio sin escribirlo.
Codex Con soporte
# lánzalo a través de ai-memory; el primer lanzamiento instala sus hooks y la entrada de MCP
ai-memory run codex
# o conéctalo a mano, para un harness que nunca lanzas así
ai-memory install-mcp --client codex --apply
ai-memory install-hooks --agent codex --apply
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
# lánzalo a través de ai-memory; el primer lanzamiento instala sus hooks y la entrada de MCP
ai-memory run opencode
# o conéctalo a mano, para un harness que nunca lanzas así
ai-memory install-mcp --client opencode --apply
ai-memory install-hooks --agent opencode --apply
V1 o V2, detectado a partir del ejecutable. Omite --apply para imprimir el cambio sin escribirlo.
Grok Build CLI Con soporte
# lánzalo a través de ai-memory; el primer lanzamiento instala sus hooks y la entrada de MCP
ai-memory run grok
# o conéctalo a mano, para un harness que nunca lanzas así
ai-memory install-mcp --client grok --apply
ai-memory install-hooks --agent grok --apply
La captura funciona. El traspaso llega con la primera llamada a una herramienta. Omite --apply para imprimir el cambio sin escribirlo.
GitHub Copilot CLI Con soporte
# lánzalo a través de ai-memory; el primer lanzamiento instala sus hooks y la entrada de MCP
ai-memory run copilot
# o conéctalo a mano, para un harness que nunca lanzas así
ai-memory install-mcp --client copilot-cli --apply
ai-memory install-hooks --agent copilot-cli --apply
Diez eventos de hook y MCP. El traspaso llega en el contexto adicional de Copilot al iniciar la sesión. Omite --apply para imprimir el cambio sin escribirlo.
Factory Droid Con soporte
# las herramientas de memoria, por MCP
ai-memory install-mcp --client droid --apply
# captura automática, mediante hooks de ciclo de vida
ai-memory install-hooks --agent droid --apply
MCP y siete eventos de hook en los archivos propios de Droid. Droid cierra la sesión por sí mismo. 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
# lánzalo a través de ai-memory; el primer lanzamiento instala sus hooks y la entrada de MCP
ai-memory run kimi
# o conéctalo a mano, para un harness que nunca lanzas así
ai-memory install-mcp --client kimi-code --apply
ai-memory install-hooks --agent kimi-code --apply
Diez eventos de hook. Los traspasos se inyectan en el primer prompt. Omite --apply para imprimir el cambio sin escribirlo.
Kiro CLI Con soporte
# lánzalo a través de ai-memory; el primer lanzamiento instala sus hooks y la entrada de MCP
ai-memory run kiro
# o conéctalo a mano, para un harness que nunca lanzas así
ai-memory install-mcp --client kiro-cli --apply
ai-memory install-hooks --agent kiro-cli --apply
Los motores v2 y v3. Se cierra al salir bajo ai-memory run. Omite --apply para imprimir el cambio sin escribirlo.
Command Code Con soporte
# lánzalo a través de ai-memory; el primer lanzamiento instala sus hooks y la entrada de MCP
ai-memory run command-code
# o conéctalo a mano, para un harness que nunca lanzas así
ai-memory install-mcp --client command-code --apply
ai-memory install-hooks --agent command-code --apply
MCP y cuatro eventos de hook, con resume nativo. Se cierra al salir bajo ai-memory run. Omite --apply para imprimir el cambio sin escribirlo.
Antigravity CLI Con soporte
# lánzalo a través de ai-memory; el primer lanzamiento instala sus hooks y la entrada de MCP
ai-memory run antigravity
# o conéctalo a mano, para un harness que nunca lanzas así
ai-memory install-mcp --client antigravity-cli --apply
ai-memory install-hooks --agent antigravity-cli --apply
Inicio de sesión, prompts leídos de la transcripción de la conversación y un checkpoint al final de cada turno. finalize-session cierra la conversación al momento. 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. En la configuración global del sandbox de Zero, permite la red y la escritura en el directorio de datos de ai-memory, o envía los eventos pendientes con ai-memory hook-drain desde una terminal normal. 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.
GrizzyBot Con soporte
# nada que instalar: habla con /hook y /mcp por sí mismo
Una app de agente nativa de macOS con su propio puente a ai-memory. No hay nada que instalar. Omite --apply para imprimir el cambio sin escribirlo.
Prime Agent Solo MCP
# las herramientas de memoria, por MCP
ai-memory install-mcp --client prime-agent --apply
Solo MCP. Prime Agent solo muestra el servidor al modelo si AI_MEMORY_AUTH_TOKEN está exportado. Omite --apply para imprimir el cambio sin escribirlo.
DeepSeek Harness Hooks + MCP
# imprime un bloque para pegar en la propia configuración del agente
ai-memory install-mcp --client dsh
# captura automática, mediante hooks de ciclo de vida
ai-memory install-hooks --agent dsh
Hooks y MCP, los dos impresos como fragmentos de parche de Cordis para fusionar. Sin evento de fin de sesión, así que ciérrala con finalize-session.
Cline CLI Hooks + MCP
# las herramientas de memoria, por MCP
ai-memory install-mcp --client cline --apply
# captura automática, mediante hooks de ciclo de vida
ai-memory install-hooks --agent cline --apply
Nueve archivos de evento de la CLI y una entrada Streamable HTTP, los dos escritos por ti. Los hooks de tarea arrancan en segundo plano, así que el handoff llega por MCP. El modo yolo desactiva los hooks. Omite --apply para imprimir el cambio sin escribirlo.
FreeBuff Solo MCP
# las herramientas de memoria, por MCP
ai-memory install-mcp --client freebuff --apply
Solo MCP. Una entrada de bridge stdio en ~/.agents/mcp.json, el archivo que FreeBuff ya busca. Omite --apply para imprimir el cambio sin escribirlo.
Crush Solo gestionado
# lánzalo a través de ai-memory; el primer lanzamiento instala sus hooks y la entrada de MCP
ai-memory run crush
Lánzalo con ai-memory run crush.
IBM Bob Con soporte
# las herramientas de memoria, por MCP
ai-memory install-mcp --client ibm-bob --apply
# captura automática, mediante hooks de ciclo de vida
ai-memory install-hooks --agent ibm-bob --apply
MCP y hooks nativos para Bob IDE y Shell. Sin lanzador gestionado ni importación de transcripciones anteriores. Tras el último turno, ejecuta ai-memory finalize-session --agent ibm-bob; Stop solo delimita un turno. Omite --apply para imprimir el cambio sin escribirlo.
CodeBuddy Code 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 codebuddy --apply
Hooks nativos y handoffs al iniciar la sesión. Sin instalador MCP, lanzador gestionado ni importación de transcripciones anteriores. Verificado con payloads documentados; falta la validación integral en el cliente.
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
Chat usa mcp-remote en macOS, Windows y Linux (beta). Las sesiones locales de la pestaña Code usan los hooks de Claude Code; instálalos con ai-memory install-hooks --agent claude-code --apply. La captura en Cowork no está verificada. 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.
Meta Muse Code Con soporte
# las herramientas de memoria, por MCP
ai-memory install-mcp --client muse --apply
# captura automática, mediante hooks de ciclo de vida
ai-memory install-hooks --agent muse --apply
Ocho eventos de hook y un puente MCP con reconocimiento de sesión, fusionados en el archivo de configuración propio de Muse. Omite --apply para imprimir el cambio sin escribirlo.
Qwen Code Con soporte
# las herramientas de memoria, por MCP
ai-memory install-mcp --client qwen-code --apply
# captura automática, mediante hooks de ciclo de vida
ai-memory install-hooks --agent qwen-code --apply
Diez eventos de ciclo de vida y una entrada Streamable HTTP en ~/.qwen/settings.json. Qwen emite un fin de sesión real, así que no hay nada que finalizar. Omite --apply para imprimir el cambio sin escribirlo.
Qoder Con soporte
# las herramientas de memoria, por MCP
ai-memory install-mcp --client qoder --apply
# captura automática, mediante hooks de ciclo de vida
ai-memory install-hooks --agent qoder --apply
Qoder CLI e IDE: ocho eventos de hooks de ciclo de vida y un puente MCP sin sesión en su archivo de configuración. Reinicia Qoder tras instalarlo; no hay lanzador gestionado ni importación de transcripciones. Omite --apply para imprimir el cambio sin escribirlo.
Hermes Agent Con soporte
# imprime un bloque para pegar en la propia configuración del agente
ai-memory install-mcp --client hermes
ai-memory install-hooks --agent hermes --server-url http://127.0.0.1:49374
Imprime bloques para ~/.hermes/config.yaml: seis eventos de ciclo de vida y una entrada MCP. Con el plugin de la comunidad instalado, solo los dos eventos de herramienta. Omite --apply para imprimir el cambio sin escribirlo.
| 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 | V1 o V2, detectado a partir del ejecutable. | Gestionado | |
| Con soporte | La captura funciona. El traspaso llega con la primera llamada a una herramienta. | Gestionado | |
| Con soporte | Diez eventos de hook y MCP. El traspaso llega en el contexto adicional de Copilot al iniciar la sesión. | Gestionado | |
| Con soporte | MCP y siete eventos de hook en los archivos propios de Droid. Droid cierra la sesión por sí mismo. | Lanzamiento directo | |
| 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. Se cierra al salir bajo ai-memory run. | Gestionado | |
| Con soporte | MCP y cuatro eventos de hook, con resume nativo. Se cierra al salir bajo ai-memory run. | Gestionado | |
| Con soporte | Inicio de sesión, prompts leídos de la transcripción de la conversación y un checkpoint al final de cada turno. finalize-session cierra la conversación al momento. | 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. En la configuración global del sandbox de Zero, permite la red y la escritura en el directorio de datos de ai-memory, o envía los eventos pendientes con ai-memory hook-drain desde una terminal normal. | Lanzamiento directo | |
| Con soporte | Seis triggers. La inyección de traspasos funciona. | Lanzamiento directo | |
| Con soporte | Una app de agente nativa de macOS con su propio puente a ai-memory. No hay nada que instalar. | Lanzamiento directo | |
| Solo MCP | Solo MCP. Prime Agent solo muestra el servidor al modelo si AI_MEMORY_AUTH_TOKEN está exportado. | Lanzamiento directo | |
| Hooks + MCP | Hooks y MCP, los dos impresos como fragmentos de parche de Cordis para fusionar. Sin evento de fin de sesión, así que ciérrala con finalize-session. | Lanzamiento directo | |
| Hooks + MCP | Nueve archivos de evento de la CLI y una entrada Streamable HTTP, los dos escritos por ti. Los hooks de tarea arrancan en segundo plano, así que el handoff llega por MCP. El modo yolo desactiva los hooks. | Lanzamiento directo | |
| Solo MCP | Solo MCP. Una entrada de bridge stdio en ~/.agents/mcp.json, el archivo que FreeBuff ya busca. | Lanzamiento directo | |
| Solo gestionado | Lánzalo con ai-memory run crush. | Gestionado | |
| Con soporte | MCP y hooks nativos para Bob IDE y Shell. Sin lanzador gestionado ni importación de transcripciones anteriores. Tras el último turno, ejecuta ai-memory finalize-session --agent ibm-bob; Stop solo delimita un turno. | Lanzamiento directo | |
| Solo hooks | Hooks nativos y handoffs al iniciar la sesión. Sin instalador MCP, lanzador gestionado ni importación de transcripciones anteriores. Verificado con payloads documentados; falta la validación integral en el cliente. | Lanzamiento directo | |
| Solo hooks | Pega en su configuración un fragmento de hooks generado. | Lanzamiento directo | |
| Solo MCP | Chat usa mcp-remote en macOS, Windows y Linux (beta). Las sesiones locales de la pestaña Code usan los hooks de Claude Code; instálalos con ai-memory install-hooks --agent claude-code --apply. La captura en Cowork no está verificada. | 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 | |
| Con soporte | Ocho eventos de hook y un puente MCP con reconocimiento de sesión, fusionados en el archivo de configuración propio de Muse. | Lanzamiento directo | |
| Con soporte | Diez eventos de ciclo de vida y una entrada Streamable HTTP en ~/.qwen/settings.json. Qwen emite un fin de sesión real, así que no hay nada que finalizar. | Lanzamiento directo | |
| Con soporte | Qoder CLI e IDE: ocho eventos de hooks de ciclo de vida y un puente MCP sin sesión en su archivo de configuración. Reinicia Qoder tras instalarlo; no hay lanzador gestionado ni importación de transcripciones. | Lanzamiento directo | |
| Con soporte | Imprime bloques para ~/.hermes/config.yaml: seis eventos de ciclo de vida y una entrada MCP. Con el plugin de la comunidad instalado, solo los dos eventos de herramienta. | 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.
- Hooks + MCP
- La captura y las herramientas de memoria funcionan las dos. Una de ellas te pide fusionar un archivo de configuración a mano, o al agente le falta un evento que los demás sí emiten.
- 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.
Claude Code y Codex: un plugin del marketplace
Los mismos hooks, herramientas MCP y skills también se distribuyen como plugin. El binario se instala primero; el plugin solo lo conecta.
claude plugin marketplace add akitaonrails/ai-memory && claude plugin install ai-memory@ai-memory
codex plugin marketplace add akitaonrails/ai-memory && codex plugin add ai-memory@ai-memory
Codex te pide confiar una vez en los hooks desde /hooks, y esa confianza se mantiene tras las actualizaciones. Si hay a la vez un plugin y hooks en el archivo de configuración, ganan los hooks del archivo de configuración.
Deja que Claude Code se ejecute solo, dentro de un sandbox
Incluso con --dangerously-skip-permissions, Claude Code sigue preguntando, así que alguien tiene que quedarse vigilándolo. Desactivar todos los avisos es un riesgo real. ai-memory run --yolo dice qué está a punto de desarmar, y cuando ai-jail está disponible, ofrece volver a ejecutar la sesión dentro de él. --true-yolo añade encima el modo bypass de Claude Code; tus propias reglas «ask» y sus comprobaciones de seguridad de comandos se siguen aplicando.
El aviso dice qué cambia
Sin aviso, el agente puede borrar archivos, ejecutar cualquier comando y acceder a la red. Lees eso antes de decir que sí.
ai-jail encierra la sesión
bubblewrap con Landlock y seccomp en Linux, sandbox-exec en macOS. Si dices que sí, un checklist elige qué credenciales del equipo anfitrión puede ver el jail. Si dices que no, la sesión se ejecuta igual, fuera de esa caja.
Solo se pregunta a una persona
Las preguntas aparecen en una terminal real. Los hooks, la CI y las ejecuciones sin terminal real nunca se interrumpen, y a una sesión que ya está dentro de ai-jail no se le pregunta dos veces.
❯ ai-memory run --true-yolo claudeINFO ai_memory_cli: ai-memory starting version="3.4.0" bind=127.0.0.1:49374⚠ --yolo runs every tool call with no confirmation. An agent can delete files, run any command, and reach the network unsupervised.Proceed? [Y/n] yai-jail is installed. Re-run this session inside it? [Y/n] y
Linux o macOS con ai-jail instalado. --jail entra directamente con valores predeterminados razonables y no necesita --yolo; --no-jail conserva el aviso pero omite la oferta.
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, un paquete del AUR o un RPM de Fedora | 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. El zip se actualiza solo con ai-memory upgrade. |
| NixOS | Con soporte | Paquete de flake, o el módulo de NixOS como servicio del sistema | Paquete de flake y un módulo de NixOS con una unidad de systemd reforzada. Los secretos van con agenix, sops-nix o un archivo de entorno. |
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
- Anthropic OAuth (los tokens de suscripción de Claude se rechazan actualmente en aplicaciones de terceros)
- OpenAI
- OpenAI OAuth / login de Codex CLI
- GitHub Copilot
- Cursor (una suscripción de Cursor, a través de su CLI de agente)
- Google Gemini
- OpenCode Go y Zen
- Ollama
- LM Studio
- vLLM
- OpenRouter y cualquier endpoint compatible con OpenAI
Comprueba un proveedor con ai-memory llm-test. Se admiten cadenas de fallback. La consolidación, el bootstrap, el rerank, las respuestas a consultas y las demás tareas de LLM pueden indicar cada una su propio proveedor y su cadena.
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.
Para Warp, Cline, Kilo Code, Goose, Qwen Code y OpenHuman, la guía de instalación trae una receta escrita que sigue la documentación de cada cliente; ninguna se ha ejecutado todavía de principio a fin.
¿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 35 agentes y editores en la lista, entre ellos Claude Code, Codex, Cursor, Gemini CLI, OpenCode. 24 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.
Gratuito y de código abierto bajo la licencia MIT. Las funciones de memoria por defecto no necesitan una clave de API de modelo; tu agente de programación puede requerir su propia cuenta.