ai-memory: troque do Claude Code pro Codex sem explicar o projeto de novo

Comentou AKITA? Aqui está o link e o passo a passo. O ai-memory é uma ferramenta grátis e de código aberto que dá memória pros agentes de IA que programam (Claude Code, Codex, Cursor, Gemini CLI e mais de 20 outros). Enquanto você trabalha, ele anota sozinho o que foi pedido, o que deu erro e o que ficou aberto. Aí, se o limite do Claude acabar no meio da tarefa, o Codex começa sabendo onde você parou, em vez de você explicar tudo de novo.

Logo oficial do projeto (README, licença MIT, Fabio Akita).

Antes de tudo, cinco verdades:

• O ai-memory é grátis, a IA não. Ele é grátis e de código aberto (licença MIT). O Claude Code e o Codex continuam com o plano de cada um: o limite e a cobrança do seu plano continuam valendo.
• Não é “lembra de tudo”. O próximo agente recebe uma passagem de bastão: onde você parou, o que falhou e o que ficou aberto, e pode pesquisar o resto. O próprio site avisa que o que volta pode vir incompleto ou desatualizado (aimemory.sh, 30/10/2026).
• É pra quem já usa um agente de código (Claude Code, Codex e cia.). Se você só usa o ChatGPT ou o Claude no navegador, ele não faz nada por você ainda.
• A instalação é pelo Terminal. No Mac e no Linux são dois comandos de copiar e colar. No Windows, o caminho recomendado é o WSL2; o Windows “normal” é experimental (README, 30/10/2026). Não funciona no celular.
• Os passos vêm da documentação oficial e NÃO FORAM TESTADOS POR NÓS. As imagens são capturas de páginas públicas e uma imagem do próprio README.

Como funciona, em palavras simples

Pense no ai-memory como um caderno de obra que se preenche sozinho:

1. Um gravador que liga sozinho. Quando você usa o agente, uns “gatilhos” (hooks) anotam os seus pedidos, os comandos que o agente rodou e o início e o fim de cada sessão. Você não precisa pedir “lembra disso” (README).
2. Vira um arquivo de texto que é seu. No fim da sessão, essas anotações viram uma página de texto (markdown) na “wiki” do projeto, guardada no seu computador. Dá pra abrir, ler, buscar e até editar na mão.
3. O próximo agente começa sabendo. Quando você abre outro agente na mesma pasta, ele recebe um resumo curto de onde você parou, o que falhou e o que ficou aberto, e pode pesquisar o resto quando precisar.
4. Sem chave de API. Esse caminho padrão não chama nenhuma IA pra funcionar. A IA que pensa continua sendo a do seu plano.

As quatro etapas no site oficial: gravar, organizar, lembrar e passar o bastão. Capturado em 30/10/2026.

O caminho mais simples

Passo da documentação, não testado por nós. Você não precisa programar, mas vai copiar e colar comandos no Terminal. Cada comando tem um botão de copiar.

curl -fsSL https://github.com/akitaonrails/ai-memory/releases/latest/download/install.sh | sh

Instale o ai-memory pra mim seguindo exatamente as instruções de https://cauhi.com/learn/ai-memory/INSTALL_FOR_AGENTS.md e me mostre cada comando antes de rodar.

ai-memory setup

ai-memory run claude

ai-memory run codex

Continua de onde a gente parou: me diz o que já foi tentado, o que falhou e qual é o próximo passo antes de mexer em qualquer arquivo.

O que é verdade (e o que o vídeo simplificou)

• “Grátis”: o ai-memory é grátis (MIT). O Claude Code e o Codex continuam com o plano de cada um, com o limite e a cobrança de sempre.
• “Ele vai pegar um resumo de onde você parou”: sim, uma passagem de bastão com onde você parou, o que falhou e o que ficou aberto. Não é “lembra de tudo”, e o que volta pode vir incompleto.
• “Uma semana depois ele voltou atrás”: no blog de 23/05/2026, o Akita conta que tinha recomendado outra ferramenta de memória cinco dias antes e voltou atrás depois de uma semana usando, por causa de uma janela de perda de dados e de anotações que sumiam em silêncio. Foi aí que ele começou o ai-memory.
• “Mais de 20 agentes”: o README diz “more than twenty” e a tabela de suporte lista cerca de 35. Não é “qualquer agente”.
• As telas do Claude e do Codex no vídeo (o pedido do freela, as soluções que falham, o selo de limite, a barra de uso e a página de sessão) são ilustração de um uso possível. A tela da memória na web é a imagem real do README. Não testamos a ferramenta.

Para quem quer ir além

Opcional. Passo da documentação, não testado por nós (README, INSTALL_FOR_AGENTS.md, docs/windows.md, docs/install.md e docs/managed-workstreams.md, commit 8cb9722, 30/10/2026).

Instalar como plugin (Claude Code ou Codex)

O binário continua sendo instalado como no passo 2; o plugin só conecta o agente:

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

O Codex depois pede pra você confiar nos gatilhos em /hooks.

Windows

• Dentro do WSL2 (recomendado): use os comandos de Linux do passo 2 e 3 e abra o agente também dentro do WSL2. Não misture: se o agente roda no WSL2, o ai-memory tem que estar no WSL2 (docs/windows.md).
• Windows nativo (experimental), no PowerShell, sem admin:

irm https://github.com/akitaonrails/ai-memory/releases/latest/download/install.ps1 | iex

Depois rode ai-memory setup. No Windows ele liga o servidor quando você entra na conta, sem janela de console.

Outros jeitos de instalar

• Arch Linux (AUR): yay -S ai-memory-bin (binário pronto) ou yay -S ai-memory (compila), depois ai-memory setup.
• Fedora: baixe o RPM da última release e rode sudo dnf install ./ai-memory-*.rpm, depois ai-memory setup.
• Mac, app de barra de menu, Docker e NixOS: existem, mas exigem compilar ou mais configuração. Estão no README do projeto (link nos créditos).

Opções do setup

Comandos do dia a dia com ai-memory run

Dentro do agente, dá pra perguntar coisas como “onde a gente parou?”, “a gente já falou sobre X?” ou “me atualiza” (README, “Everyday use”).

Detalhes que valem saber:

• A cópia do histórico do Claude só existe no mesmo computador. Em outra máquina, vai só a passagem de bastão do servidor.
• Se o seu claude é um alias do shell, o ai-memory run não enxerga; use um script com o mesmo nome no PATH ou --executable.
• Pra não gravar uma pasta, use [capture] ignore_paths no arquivo .ai-memory.toml do projeto.
• IA opcional: com uma chave de API configurada, os resumos ficam melhores e liga a busca por significado. Sem chave, tudo continua funcionando (README, “LLM providers”).
• Equipe: dá pra rodar um servidor só pra todo mundo, com login, autoria e registro de auditoria, sem plano pago (README, “Teams and multiple machines”).

Instruções oficiais pra agentes, aqui no site (MIT, Fabio Akita, sem alterações, em inglês): INSTALL_FOR_AGENTS.md.

Perguntas rápidas

Precisa saber programar?

Não pra instalar: são dois comandos de copiar e colar. Mas o ai-memory só serve pra quem já usa um agente de código (Claude Code, Codex, Cursor…). O site oficial diz: “é uma ferramenta pra quem já usa IA pra trabalhar em código”.

É grátis?

O ai-memory é grátis e de código aberto (MIT), sem cadastro e sem chave de API no modo padrão. Os agentes não: o Claude Code e o Codex continuam com o plano de cada um (ou API paga), com o mesmo limite e a mesma cobrança. A ferramenta não aumenta o seu limite: ela só evita recomeçar do zero quando você troca.

Funciona no meu computador? E no celular?

Mac e Linux: sim. Windows: pelo WSL2 (recomendado); o Windows nativo é experimental. Celular: não, é uma ferramenta de computador.

É seguro?

• O código é aberto (MIT) e o servidor, por padrão, escuta só no seu computador, com senha criada na instalação. Não tem cadastro, e o projeto diz que não manda telemetria (DATA_HANDLING.md).
• Mas os gatilhos gravam os seus pedidos. Senhas e chaves reconhecidas são apagadas antes de salvar, mas o filtro pode deixar passar texto sensível (aimemory.sh). Não cole senhas nem dados de clientes no chat.
• Não é “100% offline”: na primeira vez, o servidor baixa um modelo pequeno de busca (~87 MB) do Hugging Face. Nenhum conteúdo seu vai junto (DATA_HANDLING.md). E o que você manda pro Claude ou pro Codex continua indo pra eles, como sempre.
• Não há criptografia em disco na versão 1: a proteção é a permissão de arquivos do seu computador (DATA_HANDLING.md).
• É um projeto ativo e que muda rápido (várias versões por semana): comece num projeto de teste.

Funciona em português?

Ele grava o que você escreve, em qualquer língua. Os comandos e a documentação estão em inglês.

Limites honestos

• Não deixa a IA grátis nem aumenta o limite do seu plano.
• Não é “lembra de tudo”: é uma passagem de bastão, e a memória pode vir incompleta ou desatualizada. Confira decisões importantes.
• Mais de 20 agentes, não “qualquer agente”.
• Histórico completo do Claude só no mesmo computador.
• Terminal obrigatório; no Windows, o recomendado é o WSL2. Não tem app de celular.
• Pode gravar texto sensível que escapar do filtro.
• Os números (versão, quantidade de agentes) foram consultados em 30/10/2026 e mudam. Não testamos a ferramenta nem medimos nada.

Créditos e fonte

• Projeto: ai-memory, de Fabio Akita (“Copyright (c) 2026 Fabio Akita”), licença MIT. O logo, a imagem da tela na web e o INSTALL_FOR_AGENTS.md vêm do repositório no commit 8cb9722 (30/10/2026), sem alterações de conteúdo.
• Por que ele criou: I Built a Memory System for Coding Agents: ai-memory (blog do Akita, 23/05/2026) e a troca de agente com ai-memory run (20/07/2026).
• Sobre o autor: akitaonrails.com/about e o canal Akitando.
• Fonte oficial: o site aimemory.sh e o código em github.com/akitaonrails/ai-memory.
• Guia da comunidade em português: LinuxPro (cobre a versão 2.6.3, mais antiga).
• Este guia não é afiliado ao Fabio Akita, à Anthropic nem à OpenAI.

O post do Akita explicando por que criou o ai-memory, capturado em 30/10/2026.

Página pública do projeto no GitHub, capturada em 30/10/2026.