iMemory.

Visão geral

O iMemory é uma interface web para o ai-memory, o servidor MCP open source de Fabio Akita para memória local e persistente entre agentes de código. Em vez de dar a cada agente um contexto isolado, o ai-memory permite que o Claude Code e outros agentes compatíveis com MCP reutilizem as mesmas memórias, handoffs de sessão e conhecimento de projeto na sua própria máquina. O iMemory transforma esse motor em um painel prático: um lugar para ver o que os agentes lembram, buscar entre projetos, revisar sessões anteriores e gerenciar a memória que eles compartilham. Ele não é um fork nem substitui o ai-memory. O servidor continua sendo a fonte da verdade e monta o iMemory como sua interface web via --web-ui-dir.

O que faz

• Mostra projetos, memórias recentes e busca em uma só visão geral.
• Permite inspecionar as memórias de cada projeto.
• Torna visíveis as sessões e os handoffs dos agentes, em vez de deixá-los escondidos nas ferramentas.
• Oferece limpeza com prévia antes de aplicar mudanças.
• Permite excluir com desfazer.
• Permite salvar explicitamente a sessão atual quando você quer preservar o contexto de um agente.

Por que construí

Quando comecei a usar vários agentes de código, o principal problema não era gerar código. Era manter o contexto consistente entre eles. Uma decisão tomada em uma sessão podia sumir na ferramenta seguinte, e reconstruí-la gasta tempo e tokens e torna os handoffs menos confiáveis.

O ai-memory resolve armazenamento e recuperação. Construí o iMemory para tornar essa memória compartilhada observável e gerenciável: ver o que está sendo lembrado, quais sessões criaram cada memória e limpar tudo sem mexer diretamente em arquivos internos ou bancos de dados.

Como foi construído

A interface é propositalmente enxuta.

• A leitura usa a API REST pública do ai-memory em /api/v1.
• As operações de escrita usam as mesmas ferramentas MCP expostas aos agentes, em vez de criar um caminho de escrita privado.
• A interface é HTML, CSS e JavaScript puros, sem etapa de build no frontend.
• O próprio servidor do ai-memory serve a interface via --web-ui-dir.
• O repositório também pode funcionar como diretório de dados local do ai-memory.

Esse último ponto exigiu tratar os dados locais como sensíveis por padrão. Um .gitignore que nega tudo por padrão só deixa entrar no Git a interface, a documentação e os arquivos públicos, enquanto o banco de memória, a wiki, a configuração, os logs, os backups e os dados locais dos projetos ficam na máquina.

Decisão de design

O iMemory não é um fork, de propósito. O servidor, os hooks, o motor de memória e a implementação MCP continuam vindo de akitaonrails/ai-memory. Isso mantém o projeto pequeno e permite que a interface evolua sem duplicar o sistema de memória por baixo.