Terraforma Memory

Terraforma Memory

Uma memória privada para Claude Code e Codex. Seus assistentes salvam decisões, convenções e correções conquistadas com esforço, e as encontram novamente na próxima sessão, ou a partir do outro assistente. Tudo permanece na sua máquina, em um diário que você possui.

• Compartilhada entre assistentes. Claude Code e Codex podem usar a mesma memória ao mesmo tempo; cada chamada mantém o bloqueio apenas enquanto executa.
• Local e privada. Um único binário sem dependências de runtime. O servidor MCP fala via stdio e não faz conexões de rede. Sem conta, sem telemetria.
• Histórico à prova de adulteração. Cada salvamento é uma entrada de diário encadeada por hash. Atualizar uma memória mantém suas versões anteriores.
• Sua para guardar. Exporte, faça backup e restaure com o mesmo binário. Desinstalar nunca exclui suas memórias.

A memória integrada do assistente geralmente está vinculada a uma ferramenta e um projeto. Terraforma Memory é um único lugar onde ambos os assistentes leem e escrevem.

Instalação (macOS arm64, Linux x86-64)

Um comando, executado dentro da pasta do seu projeto:

curl -fsSL https://raw.githubusercontent.com/janus-ubos-republic/terraforma-memory/main/lander.sh | sh

O Lander inspeciona a máquina (sistema, chip, ferramentas, quais assistentes estão presentes), baixa o arquivo correto, verifica-o contra checksums fixados no script, instala em ~/.terraforma/terraforma-local-core e prova que o programa responde. Ele não usa sudo e não inicia nenhum serviço. Em um terminal, ele então pergunta se deseja conectar Claude Code e Codex; ele altera a configuração deles apenas se você disser sim, através dos próprios comandos mcp add. Para inspecionar primeiro: baixe lander.sh, leia-o e execute sh lander.sh --dry-run. Opções: --connect claude,codex|all|none, --project NAME.

Instalação manual

Baixe o arquivo para sua plataforma na página de releases e então:

curl -fsSLO https://github.com/janus-ubos-republic/terraforma-memory/releases/download/v0.3.0/terraforma-local-core-0.3.0-macos-arm64.tar.gz   # or ...-linux-x86-64.tar.gz
tar -xzf terraforma-local-core-0.3.0-*.tar.gz
sh terraforma-local-core-0.3.0-*/install.sh

O instalador verifica o checksum de cada arquivo antes de instalar em ~/.terraforma/terraforma-local-core, não inicia nenhum serviço e não edita nenhuma configuração. Ele imprime os comandos exatos para conectar seus assistentes. Baixar com curl (não um navegador) evita o prompt de quarentena do macOS para este binário não assinado. Linux requer glibc 2.30 ou mais recente (Ubuntu 20.04+, Debian 11+).

Conectar

Use um diretório de memória por projeto. Ele é criado no primeiro uso, privado para o seu usuário.

# Claude Code (run inside your project)
claude mcp add --scope local terraforma-memory -- \
  ~/.terraforma/terraforma-local-core/bin/terraforma-local-core mcp ~/.terraforma/memory/my-project

# Codex: ~/.codex/config.toml, then restart Codex
[mcp_servers.terraforma-memory]
command = "/Users/you/.terraforma/terraforma-local-core/bin/terraforma-local-core"
args = ["mcp", "/Users/you/.terraforma/memory/my-project"]

Aponte ambos para o mesmo diretório para compartilhar uma memória.

O que seu assistente recebe

Ferramenta	Uso
remember	Salvar ou atualizar uma memória (título + texto, até 16 KB). Mesmo título = nova versão.
recall	Pesquisar memórias por palavras. Coloque nomes, caminhos, mensagens de erro e identificadores na consulta.
read_memory	Ler uma memória por completo.
recent	Listar as memórias mais recentes: um bom começo para uma sessão.
memory_status	Contagem, limites e o resumo de integridade do diário.

Briefing opcional de sessão (Markdown das memórias mais recentes): terraforma-local-core briefing ~/.terraforma/memory/my-project 10

Limites honestos

• A pesquisa corresponde a palavras, não a significado: uma pergunta reformulada pode não encontrar uma memória que usa palavras diferentes. Pergunte com os termos específicos que você espera nela.
• Até 5.000 memórias por diretório, 16 KB cada. Salvar uma por vez é rápido (aproximadamente 0,1–0,25 s por chamada em 5.000); importar milhares em massa é lento.
• Apenas macOS arm64 e Linux x86-64. O binário do macOS ainda não está assinado.

Apoie o projeto

Terraforma Memory é gratuito e de código aberto, e todos os recursos funcionam sem pagar. Se economizar seu tempo, as licenças de apoiador fundador abrem em breve: €19 únicos para os primeiros 100 apoiadores, depois €29. Elas financiam o desenvolvimento por um construtor independente.

Licença

Apache-2.0. Veja LICENSE. Notas de build e qualificação: docs/DEVELOPMENT.md.