Integrações
Seus agentes, seu SO, seus provedores
25 agentes de código e editores, quatro alvos de sistema operacional e uma lista de provedores de LLM e embeddings que você pode ignorar, porque tudo funciona sem nenhum.
Muitos agentes, uma memória
Cada agente se conecta ao mesmo servidor. O que o Claude Code aprendeu de manhã está lá quando você abre o Codex à tarde.
Agentes e editores
Filtre por status e escolha uma linha para ver os comandos de instalação.
Claude Code Suportado
# as ferramentas de memória, via MCP
ai-memory install-mcp --client claude-code --apply
# captura automática, pelos hooks de ciclo de vida
ai-memory install-hooks --agent claude-code --apply
# ou abra no modo gerenciado; os dois se configuram sozinhos
ai-memory run claude
Hooks e MCP. Roteamento por sessão opcional. Tire o --apply para imprimir a mudança sem gravar.
Codex Suportado
# as ferramentas de memória, via MCP
ai-memory install-mcp --client codex --apply
# captura automática, pelos hooks de ciclo de vida
ai-memory install-hooks --agent codex --apply
# ou abra no modo gerenciado; os dois se configuram sozinhos
ai-memory run codex
Hooks e MCP. O fim de sessão funciona a partir do Codex CLI 0.145.0. Tire o --apply para imprimir a mudança sem gravar.
Cursor Suportado
# as ferramentas de memória, via MCP
ai-memory install-mcp --client cursor --apply
# captura automática, pelos hooks de ciclo de vida
ai-memory install-hooks --agent cursor --apply
Config de MCP e hooks de ciclo de vida. Tire o --apply para imprimir a mudança sem gravar.
Gemini CLI Suportado
# as ferramentas de memória, via MCP
ai-memory install-mcp --client gemini-cli --apply
# captura automática, pelos hooks de ciclo de vida
ai-memory install-hooks --agent gemini-cli --apply
Config de MCP e hooks de ciclo de vida. Tire o --apply para imprimir a mudança sem gravar.
OpenCode Suportado
# as ferramentas de memória, via MCP
ai-memory install-mcp --client opencode --apply
# captura automática, pelos hooks de ciclo de vida
ai-memory install-hooks --agent opencode --apply
# ou abra no modo gerenciado; os dois se configuram sozinhos
ai-memory run opencode
MCP remoto e um plugin TypeScript gerado. Tire o --apply para imprimir a mudança sem gravar.
OpenCode 2 beta Suportado
# as ferramentas de memória, via MCP
ai-memory install-mcp --client opencode2 --apply
# captura automática, pelos hooks de ciclo de vida
ai-memory install-hooks --agent opencode2 --apply
# ou abra no modo gerenciado; os dois se configuram sozinhos
ai-memory run opencode2
Plugin para a API beta. Espere mudanças frequentes no upstream. Tire o --apply para imprimir a mudança sem gravar.
Grok Build CLI Suportado
# as ferramentas de memória, via MCP
ai-memory install-mcp --client grok --apply
# captura automática, pelos hooks de ciclo de vida
ai-memory install-hooks --agent grok --apply
# ou abra no modo gerenciado; os dois se configuram sozinhos
ai-memory run grok
A captura funciona. Os handoffs chegam via MCP. Tire o --apply para imprimir a mudança sem gravar.
Devin CLI Suportado
# as ferramentas de memória, via MCP
ai-memory install-mcp --client devin --apply
# captura automática, pelos hooks de ciclo de vida
ai-memory install-hooks --agent devin --apply
Hooks e MCP, incluindo captura pós-compactação. Tire o --apply para imprimir a mudança sem gravar.
Kimi Code Suportado
# as ferramentas de memória, via MCP
ai-memory install-mcp --client kimi-code --apply
# captura automática, pelos hooks de ciclo de vida
ai-memory install-hooks --agent kimi-code --apply
# ou abra no modo gerenciado; os dois se configuram sozinhos
ai-memory run kimi
Dez eventos de hook. Handoffs entram no primeiro prompt. Tire o --apply para imprimir a mudança sem gravar.
Kiro CLI Suportado
# as ferramentas de memória, via MCP
ai-memory install-mcp --client kiro-cli --apply
# captura automática, pelos hooks de ciclo de vida
ai-memory install-hooks --agent kiro-cli --apply
# ou abra no modo gerenciado; os dois se configuram sozinhos
ai-memory run kiro
Tanto a engine v2 quanto a v3. Tire o --apply para imprimir a mudança sem gravar.
Command Code Suportado
# as ferramentas de memória, via MCP
ai-memory install-mcp --client command-code --apply
# captura automática, pelos hooks de ciclo de vida
ai-memory install-hooks --agent command-code --apply
# ou abra no modo gerenciado; os dois se configuram sozinhos
ai-memory run command-code
MCP e quatro eventos de hook, com resume nativo. Tire o --apply para imprimir a mudança sem gravar.
Antigravity CLI Suportado
# as ferramentas de memória, via MCP
ai-memory install-mcp --client antigravity-cli --apply
# captura automática, pelos hooks de ciclo de vida
ai-memory install-hooks --agent antigravity-cli --apply
# ou abra no modo gerenciado; os dois se configuram sozinhos
ai-memory run antigravity
As sessões fecham com finalize-session. Tire o --apply para imprimir a mudança sem gravar.
Pi Suportado
# as ferramentas de memória, via MCP
ai-memory install-mcp --client pi --apply
# captura automática, pelos hooks de ciclo de vida
ai-memory install-hooks --agent pi --apply
Uma extensão gerada faz a captura e a ponte com MCP. Tire o --apply para imprimir a mudança sem gravar.
Oh My Pi Suportado
# as ferramentas de memória, via MCP
ai-memory install-mcp --client omp --apply
# captura automática, pelos hooks de ciclo de vida
ai-memory install-hooks --agent omp --apply
MCP nativo e uma extensão TypeScript. Tire o --apply para imprimir a mudança sem gravar.
OpenClaw Suportado
# as ferramentas de memória, via MCP
ai-memory install-mcp --client openclaw --apply
# captura automática, pelos hooks de ciclo de vida
ai-memory install-hooks --agent openclaw --apply
Config de MCP e hooks nativos de plugin. Tire o --apply para imprimir a mudança sem gravar.
Zero Suportado
# as ferramentas de memória, via MCP
ai-memory install-mcp --client zero --apply
# captura automática, pelos hooks de ciclo de vida
ai-memory install-hooks --agent zero --apply
A captura inclui eventos de subagentes. Tire o --apply para imprimir a mudança sem gravar.
ZCode Suportado
# as ferramentas de memória, via MCP
ai-memory install-mcp --client zcode --apply
# captura automática, pelos hooks de ciclo de vida
ai-memory install-hooks --agent zcode --apply
Seis triggers. A injeção de handoff funciona. Tire o --apply para imprimir a mudança sem gravar.
Crush Só gerenciado
# abra pelo ai-memory
ai-memory run crush
Abra com ai-memory run crush.
Pool Só hooks
# prepara os scripts de hook e imprime um trecho para colar nas configurações do agente
ai-memory install-hooks --agent pool --apply
Cole nas configurações dele um snippet de hooks gerado.
Claude Desktop Só MCP
# as ferramentas de memória, via MCP
ai-memory install-mcp --client claude-desktop --apply
Conecta via mcp-remote. Tire o --apply para imprimir a mudança sem gravar.
VS Code Copilot Só MCP
# as ferramentas de memória, via MCP
ai-memory install-mcp --client vscode-copilot --apply
O Copilot ainda não expõe hooks de ciclo de vida. Tire o --apply para imprimir a mudança sem gravar.
Zed Só MCP
# as ferramentas de memória, via MCP
ai-memory install-mcp --client zed --apply
Registrado como context server. Tire o --apply para imprimir a mudança sem gravar.
Swival CLI Só MCP
# as ferramentas de memória, via MCP
ai-memory install-mcp --client swival --apply
Config de MCP por projeto. Tire o --apply para imprimir a mudança sem gravar.
Muse Code Só MCP
# as ferramentas de memória, via MCP
ai-memory install-mcp --client muse --apply
Config de MCP por usuário. Tire o --apply para imprimir a mudança sem gravar.
Hermes Agent Comunidade
O ai-memory não traz instalador para este. O servidor reconhece os eventos de hook dele, e o plugin é mantido pela comunidade. Revise antes de instalar: ai-memory-hermes-plugin no GitHub.
Plugin da comunidade, por MrLuciano.
| Agente | Status | Notas | ai-memory run |
|---|---|---|---|
| Suportado | Hooks e MCP. Roteamento por sessão opcional. | Gerenciado | |
| Suportado | Hooks e MCP. O fim de sessão funciona a partir do Codex CLI 0.145.0. | Gerenciado | |
| Suportado | Config de MCP e hooks de ciclo de vida. | Abertura direta | |
| Suportado | Config de MCP e hooks de ciclo de vida. | Abertura direta | |
| Suportado | MCP remoto e um plugin TypeScript gerado. | Gerenciado | |
| Suportado | Plugin para a API beta. Espere mudanças frequentes no upstream. | Gerenciado | |
| Suportado | A captura funciona. Os handoffs chegam via MCP. | Gerenciado | |
| Suportado | Hooks e MCP, incluindo captura pós-compactação. | Abertura direta | |
| Suportado | Dez eventos de hook. Handoffs entram no primeiro prompt. | Gerenciado | |
| Suportado | Tanto a engine v2 quanto a v3. | Gerenciado | |
| Suportado | MCP e quatro eventos de hook, com resume nativo. | Gerenciado | |
| Suportado | As sessões fecham com finalize-session. | Gerenciado | |
| Suportado | Uma extensão gerada faz a captura e a ponte com MCP. | Gerenciado | |
| Suportado | MCP nativo e uma extensão TypeScript. | Gerenciado | |
| Suportado | Config de MCP e hooks nativos de plugin. | Abertura direta | |
| Suportado | A captura inclui eventos de subagentes. | Abertura direta | |
| Suportado | Seis triggers. A injeção de handoff funciona. | Abertura direta | |
| Só gerenciado | Abra com ai-memory run crush. | Gerenciado | |
| Só hooks | Cole nas configurações dele um snippet de hooks gerado. | Abertura direta | |
| Só MCP | Conecta via mcp-remote. | Abertura direta | |
| Só MCP | O Copilot ainda não expõe hooks de ciclo de vida. | Abertura direta | |
| Só MCP | Registrado como context server. | Abertura direta | |
| Só MCP | Config de MCP por projeto. | Abertura direta | |
| Só MCP | Config de MCP por usuário. | Abertura direta | |
| Comunidade | Plugin da comunidade, por MrLuciano. | Abertura direta |
O que cada status significa
- Suportado
- Captura automática pelos hooks de ciclo de vida, mais as ferramentas de memória via MCP.
- Só MCP
- O agente consegue buscar e escrever na memória. Ele não expõe hooks de ciclo de vida, então nada é capturado automaticamente.
- Só hooks
- As sessões são capturadas automaticamente. O agente não tem cliente MCP para consultar a memória.
- Só gerenciado
- Funciona quando aberto via
ai-memory run. Não existe instalador de hooks separado. - Comunidade
- Plugin mantido pela comunidade. O ai-memory em si não faz a instalação dele.
- Experimental
- Já vem na release e funciona, mas espere algumas arestas.
Detalhes por agente, locais dos arquivos de configuração e peculiaridades conhecidas estão na matriz de suporte e no guia de instalação do MCP.
Hooks capturam, MCP responde
São duas conexões separadas, e um agente com suporte completo tem as duas. Os status acima dizem quais o seu agente recebe.
Hooks
Os eventos de ciclo de vida do agente disparam um comando pequeno que registra prompts, chamadas de ferramenta e os limites da sessão. Você não faz nada, e o agente não gasta tokens com isso. Segredos são removidos antes de qualquer coisa ser armazenada.
MCP
O agente ganha ferramentas de memória que pode chamar quando a conversa pede: buscar, ler uma página, escrever uma página, aceitar um handoff. Agentes que só têm MCP usam a memória por completo, mas nada é capturado a menos que eles escrevam.
Sistemas operacionais
Um binário Rust por plataforma. No Windows, o WSL2 é o caminho suportado e a build nativa é experimental.
| Plataforma | Status | Como instala | Notas |
|---|---|---|---|
| Linux | Suportado | Tarball da release, imagem Docker ou Podman, ou um pacote do AUR | x86_64 e ARM64. Binário nativo, Docker ou Podman, pacotes no AUR com units do systemd. |
| macOS | Suportado | Tarball da release com um agente launchd, Docker, ou o app de barra de menus compilado do código-fonte | Apple Silicon e Intel. Binário nativo com agente launchd, Docker, ou um app de barra de menus que você compila do código-fonte. |
| Windows via WSL2 | Suportado | O binário de Linux, dentro do WSL2 | Siga o caminho do Linux dentro do WSL2 e abra seu agente de lá. |
| Windows nativo | Experimental | Zip da release, wrapper para Docker Desktop, ou build a partir do código-fonte | Zip da release com ai-memory.exe, o wrapper para Docker Desktop ou build a partir do código-fonte. |
Provedores de LLM e embeddings
Os dois são opcionais. Sem nenhum, os hooks continuam capturando, a busca continua funcionando, e toda sessão continua terminando com uma página de resumo e um handoff.
Embeddings: locais por padrão
Desde a 2.0, a busca vetorial roda in-process com um modelo aberto pequeno. Não precisa de chave de API nem de GPU. O modelo tem cerca de 87 MB, é baixado em background na primeira inicialização, e a busca híbrida liga no próximo restart. Se o download falhar, a busca continua funcionando em full-text.
- Local, in-process (o padrão)
- OpenAI
- Voyage
- Google Gemini
- GitHub Copilot
- Ollama, LM Studio, vLLM
Desative com embedding_provider = "none". Um provedor que você mesmo configurou nunca é sobrescrito.
LLM: desligado por padrão
Adicione um quando quiser consolidação escrita por LLM, ai-memory bootstrap, linting mais rico, auto-improve ou reranking. Um modelo pequeno e rápido é do tamanho certo para esse trabalho, quando o provedor deixa você escolher. Com login do Codex ou do ChatGPT, mantenha o modelo padrão do provedor, porque esse backend rejeita outros nomes de modelo. Logins de assinatura funcionam, então não é preciso ter uma chave de API paga de plataforma.
- Anthropic
- OpenAI
- OpenAI OAuth / login do Codex CLI
- GitHub Copilot
- Google Gemini
- OpenCode Go e Zen
- Ollama
- LM Studio
- vLLM
- Qualquer endpoint compatível com OpenAI
Teste um provedor com ai-memory llm-test. Cadeias de fallback são suportadas.
Modelos, padrões e custos estão no guia de provedores de LLM e no guia de embeddings locais.
Seu agente não está na lista?
Qualquer coisa que fale MCP já pode usar as ferramentas de memória hoje.
Registre um servidor MCP HTTP remoto neste endereço nas configurações do seu agente. Busca, leitura e escrita de páginas e handoffs funcionam. A captura automática precisa dos hooks de ciclo de vida, então sem eles o agente só lembra do que ele mesmo escreve.
Quer suporte completo para ele? O guia de contribuição de harness gerenciado descreve o que um adapter precisa provar, e a página de contribuição diz para onde vão issues e pull requests.
# o servidor local padrão
http://127.0.0.1:49374/mcp
Perguntas e respostas
Com quais agentes de código o ai-memory funciona?
A lista tem 25 agentes e editores, incluindo Claude Code, Codex, Cursor, Gemini CLI, OpenCode. 17 deles têm tanto a captura automática pelos hooks de ciclo de vida quanto as ferramentas de memória via MCP.
Qual é a diferença entre hooks e MCP?
Os hooks capturam as sessões automaticamente: prompts, chamadas de ferramenta e limites de sessão são registrados sem o agente fazer nada. O MCP dá ao agente ferramentas que ele pode chamar para buscar e escrever na memória. Um agente com suporte completo tem os dois.
Meu agente não está na lista. Dá para usar mesmo assim?
Dá, se ele falar MCP. Aponte para http://127.0.0.1:49374/mcp e ele consegue buscar e escrever na memória. Sem hooks de ciclo de vida, nada é capturado automaticamente.
Preciso de um LLM ou de um provedor de embeddings?
Não. Os dois são opcionais. Desde a 2.0 os embeddings padrão rodam in-process com um modelo de cerca de 87 MB, baixado na primeira inicialização, e nenhuma chave de API entra na história.
O ai-memory roda no Windows?
Sim. O WSL2 é suportado pelo caminho do Linux. O Windows nativo é experimental e vem como um zip da release com o ai-memory.exe.
Dê memória aos seus agentes hoje.
Gratuito e open source sob a licença MIT. Sem conta e sem chave de API.