Magnemo

Magnemo

Ferramentas deram mãos ao seu agente. MCP deu a ele um sistema nervoso. Magnemo dá a ele um cérebro.

Memória governada para agentes de IA. Cada entrada com um recibo. Seu agente escreve o rascunho; nada é mantido até que você diga sim.

A única colagem

Abra sua IA (Claude Code, Cursor, Windsurf, ou qualquer coisa que fale MCP) em qualquer uma das suas pastas de projeto e cole isto:

Set up Magnemo in this project:
1. Install it: pip install magnemo. It needs Python 3.11 or newer. If pip can't find it, install uv (curl -LsSf https://astral.sh/uv/install.sh | sh) and then run: uv tool install magnemo
2. Initialize the vault: magnemo init
3. Register the MCP server: run magnemo mount — it writes this project's MCP config itself.
4. Verify: run magnemo doctor and confirm everything passes.
5. Stage the first memory: one line on what this project is, using magnemo stage. Show me the note id.
6. Then tell me the exact command to approve it. After I approve, run magnemo bootpack and tell me what you remember — then remind me to restart you, so the memory mounts for every session after this one.
If anything fails, show me what went wrong and fix it if you can.

Você saberá que funcionou — sua IA dirá quem ela é agora.

Para construtores. Magnemo é um servidor MCP com quatro ferramentas — retrieve, stage, bootpack, handoff — e uma CLI para o seu lado: revisar, promover, rejeitar. Ele roda na sua máquina, em arquivos Markdown simples que você possui, com zero chamadas de rede (a linha doctor prova isso). Cada promoção é um clique de uma pessoa, registrado com quem escreveu a entrada, quando e por qual porta — memória com uma testemunha. A confiança é calculada a partir desse registro, nunca presumida. Ele se monta ao lado de qualquer memória que você já execute (uma pasta de notas, Obsidian, uma pilha de RAG). Python 3.11+, zero dependências, Apache-2.0.

Cofre novo? A seção THE CHARTER dirá que ainda não foi promovido — isso é a governança falando: Magnemo nunca fabrica cânone. Prepare uma carta, revise-a, promova-a, e a partir de então cada inicialização a devolve verbatim. (magnemo não encontrado após a instalação? A pasta de scripts do pip não está no PATH — python3 -m magnemo sempre funciona.)

Beta aberto — leia KNOWN_LIMITS.md antes de confiar a ele qualquer coisa que você não pode perder. Ressalvas honestas, sem letras miúdas.

Instale no seu cliente

Um servidor, dito de dez maneiras. Cada bloco abaixo é a mesma coisa: uvx magnemo-mcp com MAGNEMO_VAULT apontando para a pasta onde sua memória vive (crie uma com magnemo init ./vault). Testado neste Mac onde isso é indicado; o restante vem da documentação de cada cliente e está marcado como não testado — correções são bem-vindas, abra uma issue.

Claude Code — testado.

claude mcp add magnemo -e MAGNEMO_VAULT=/absolute/path/to/vault -- uvx magnemo-mcp

(claude mcp list mostra magnemo … ✔ Connected. Adicione -s project para gravá-lo no .mcp.json do repositório para sua equipe.) Só tem o aplicativo de desktop? claude pode não ser um comando no seu shell. Em um Mac, o aplicativo mantém sua própria cópia em ~/Library/Application Support/Claude/claude-code/<version>/claude.app/Contents/MacOS/claude; execute isso no lugar de claude.

Claude Desktop — testado. Baixe a extensão do lançamento mais recente — magnemo-0.6.7.mcpb — e abra-a; o Claude Desktop pede a pasta do cofre e faz o resto. (A listagem do diretório de conectores segue assim que for aceita.)

Cursor — não testado aqui (não instalado neste Mac); o link e o bloco seguem a documentação do Cursor. Ou ~/.cursor/mcp.json (ou .cursor/mcp.json no projeto):

{
  "mcpServers": {
    "magnemo": {
      "command": "uvx",
      "args": ["magnemo-mcp"],
      "env": { "MAGNEMO_VAULT": "/absolute/path/to/vault" }
    }
  }
}

VS Code / Copilot — não testado aqui; conforme a documentação do VS Code. Ou .vscode/mcp.json no workspace:

{
  "servers": {
    "magnemo": {
      "type": "stdio",
      "command": "uvx",
      "args": ["magnemo-mcp"],
      "env": { "MAGNEMO_VAULT": "/absolute/path/to/vault" }
    }
  }
}

Windsurf — não testado; ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "magnemo": {
      "command": "uvx",
      "args": ["magnemo-mcp"],
      "env": { "MAGNEMO_VAULT": "/absolute/path/to/vault" }
    }
  }
}

Cline — não testado; Cline → MCP Servers → Configure → cline_mcp_settings.json:

{
  "mcpServers": {
    "magnemo": {
      "command": "uvx",
      "args": ["magnemo-mcp"],
      "env": { "MAGNEMO_VAULT": "/absolute/path/to/vault" },
      "disabled": false
    }
  }
}

Continue — não testado; ~/.continue/config.yaml (ou um arquivo em .continue/mcpServers/):

mcpServers:
  - name: magnemo
    command: uvx
    args: ["magnemo-mcp"]
    env:
      MAGNEMO_VAULT: /absolute/path/to/vault

Gemini CLI — não testado; ~/.gemini/settings.json:

{
  "mcpServers": {
    "magnemo": {
      "command": "uvx",
      "args": ["magnemo-mcp"],
      "env": { "MAGNEMO_VAULT": "/absolute/path/to/vault" }
    }
  }
}

Codex CLI — não testado; ~/.codex/config.toml:

[mcp_servers.magnemo]
command = "uvx"
args = ["magnemo-mcp"]
env = { MAGNEMO_VAULT = "/absolute/path/to/vault" }

Zed — não testado; settings.json → context_servers:

{
  "context_servers": {
    "magnemo": {
      "source": "custom",
      "command": "uvx",
      "args": ["magnemo-mcp"],
      "env": { "MAGNEMO_VAULT": "/absolute/path/to/vault" }
    }
  }
}

Após a instalação, o ciclo é o mesmo em todos os lugares: seu agente escreve para o staging, você revisa.

magnemo yes             # promote the top of the queue (yes <id-fragment> · yes --all)
magnemo no <id> --reason "…"   # reject one — the reason is required; rejections teach
magnemo review          # the interactive queue, when you want to read first
magnemo doctor          # python, vault, config, ledger, and the mount — proves the zero-network line too

Qualquer coisa que fale MCP via stdio se monta da mesma forma. A porta remota (ChatGPT e clientes hospedados) está a caminho na versão 0.7.0.

Agentes rascunham, pessoas mantêm — a única regra

Agentes recebem quatro ferramentas MCP. Promoção não é uma delas.

Ator	Porta	Pode fazer
Agentes	Servidor MCP (stdio)	retrieve memória canônica · stage → somente staging, a única ferramenta de escrita · bootpack ao acordar · handoff na fronteira
Você	CLI + git (qualquer editor)	revisar a fila · promover / rejeitar · editar qualquer coisa · possuir tudo

O cofre

vault/
  dev/      knowledge/ playbooks/ decisions/ debt/        ← example: a dev team's partition
  ops/      knowledge/ playbooks/ clients/ decisions/ style/  ← example: an ops team's partition
  shared/   tickets/ changelog/                            ← interop bus (gated)
  _staging/   agent writes await review here
  _index/     machine-managed
  _ledger/    trust_ledger.jsonl — append-only, never forgets

Cada nota é Markdown com frontmatter de proveniência (autor, escrito, fonte, status, revisado_por, substitui, força). Proveniência é o formato do arquivo.

Privacidade

Sua memória vive no seu computador, em arquivos simples que você pode abrir. O mecanismo não faz chamadas de rede, e magnemo doctor verifica isso toda vez que roda. A página completa: https://magnemo.ai/privacy

Garantias (Fase 1 — Recuperação Governada)

• Escritas de agentes NUNCA alcançam armazenamentos canônicos diretamente — somente staging, sempre.
• A busca retorna apenas notas canônicas (aprovadas pelo guardião de chaves). Alegações em staging são invisíveis.
• Muros de partição são aplicados por agente (MAGNEMO_PARTITIONS); partição cruzada = NEGADO.
• Substituição é explícita: notas antigas são arquivadas com um link de encaminhamento. Nada é excluído.
• Rejeições são mantidas e registradas — rejeições ensinam.
• Cada promover/rejeitar cai no Livro de Confiança somente-anexação com ator + motivo.

Testes

python -m unittest discover -s tests -v     # incl. full MCP round-trips (legacy + four-verb)
# or: pip install -e ".[test]" && pytest

Tudo o que foi lançado

Versão por versão, com as notas de design que costumavam viver aqui: CHANGELOG.md.

— Silver Valley Technologies Inc. · Fase 1 de 3 · A memória que aprende é a memória que é governada.

---

mcp-name: ai.magnemo/magnemo · Fonte · Segurança · Privacidade