Documentação

Instalar e conectar

O Memo conecta o Claude Code e o Codex do seu computador ao seu grafo no nosso servidor. Basta um comando por computador.

Antes de começar

macOS, Linux ou Windows com WSL. Windows nativo não tem suporte.
python3 e curl nesse computador.
Claude Code, Codex ou os dois, logados com seu próprio plano.
Uma conta Memo. Crie uma se ainda não tiver.

Instalação

1. Pegue sua linha de instalação

Abra Conta e aperte Conectar um computador. Você recebe uma linha com um código de uso único. O código vale uma vez e expira em 15 minutos.

2. Cole e confirme

Cole a linha num terminal do computador que você quer conectar, ou no Claude Code ou no Codex rodando nele. Ela fica assim, com o seu código:

curl -fsSL https://memo.example/kit/install.py -o memo-install.py && python3 memo-install.py --server https://memo.example --code ABCD-EFGH

Depois é só confirmar. O terminal pergunta uma vez: Continue? [Y/n]. O Claude Code ou o Codex pede para rodar o comando. O Memo funciona a partir da sua próxima sessão do Claude Code ou do Codex.

O instalador conecta este computador à sua conta e dá a ele uma chave própria. Cada arquivo que ele baixa está listado com o checksum SHA-256 em /kit/SHA256SUMS.

Atualizações

Quando os hooks ou as instruções do Memo mudam, seu agente avisa em uma linha e pergunta. Diga sim, e ele instala a atualização. Você também pode rodar por conta própria:

~/.memo/bin/memo update

A atualização mantém a chave deste computador e substitui só os arquivos do próprio Memo. A nova versão vale a partir da próxima sessão.

Se o memo update não funcionar numa instalação mais antiga, rode isto uma vez no lugar dele:

curl -fsSL https://memo.example/kit/install.py -o memo-install.py && python3 memo-install.py --update

Conectar uma sessão

Inicie o Claude Code ou o Codex como sempre e peça para ele se conectar ao Memo. No Claude Code, digite /memo; no Codex, digite $memo.

A sessão se registra como ramo, recebe seu passaporte e começa a escrever suas etapas no mapa. Abra o painel para acompanhar e definir o passaporte.

O passaporte vem primeiro. Os agentes o leem a cada turno. Onde ele diz não, o ramo prepara o trabalho e pergunta a você na caixa de entrada.

O que o instalador muda

Onde	O quê
`~/.memo/config.json`	Seu endereço do Memo, nome do dono, fuso horário e versão do kit.
`~/.memo/token`	A chave deste computador. Só o seu usuário pode ler o arquivo, e nenhuma ferramenta do Memo a exibe.
`~/.memo/bin/memo`	O comando `memo` que seus agentes usam para ler e escrever o grafo.
`~/.memo/memo-hook.py`	O hook que o Claude Code e o Codex rodam nos eventos da sessão.
`~/.claude/settings.json`	Hooks do Memo para o Claude Code e permissão para rodar o comando memo e as ferramentas MCP do Memo sem perguntar toda vez. Suas outras configurações ficam como estão.
`~/.codex/hooks.json`	Hooks do Memo para o Codex.
`~/.claude/skills/memo/` `~/.codex/skills/memo/`	A skill memo: como uma sessão trabalha com o seu ramo.
`~/.claude/CLAUDE.md` `~/.codex/AGENTS.md`	Um bloco curto do Memo entre marcadores; o arquivo do Codex só se o Codex estiver instalado. O resto de cada arquivo fica como está.
Servidores MCP do Claude Code, escopo do usuário	Um servidor chamado `memo`, adicionado só se o `claude` estiver no seu PATH.

MCP

Se o claude estiver no seu PATH, o instalador roda isto para você, com a chave deste computador no lugar do marcador:

claude mcp add --scope user --transport http memo https://memo.example/mcp --header "Authorization: Bearer <this computer's key>"

A chave vai direto para o Claude Code e não aparece na tela. Para o Codex, o instalador mostra a configuração para você adicionar.

Ferramentas para seus agentes:

Ferramenta	O que faz
`memo_list`	Lista seus ramos.
`memo_brief`	Um resumo curto de um ramo.
`memo_show`	Um ramo inteiro ou um dos nós dele.
`memo_register`	Cria um ramo.
`memo_apply`	Grava alterações nos nós de um ramo.
`memo_pending_answers`	Suas respostas que o ramo ainda não recebeu.
`memo_log`	O histórico de alterações do ramo.

O comando memo

Os agentes também acessam o grafo pelo ~/.memo/bin/memo. Você pode usá-lo também:

~/.memo/bin/memo list

Quando algo dá errado, ele diz o que fazer em uma linha:

A chave não é aceita, por exemplo porque o computador foi revogado: gere um novo código em Conta e rode o instalador de novo.
O plano está inativo: assine em Conta. Enquanto isso, o painel continua funcionando.

Desconectar um computador

Em Conta, aperte Revogar ao lado do computador. A chave dele para de funcionar na hora. Seu grafo e seus outros computadores não são afetados.

Desinstalar

Para remover os arquivos e as configurações do Memo de um computador, baixe o instalador de novo e rode com --uninstall:

curl -fsSL https://memo.example/kit/install.py -o memo-install.py && python3 memo-install.py --uninstall

Ele remove só o bloco do Memo de CLAUDE.md e AGENTS.md e restaura suas configurações a partir dos backups feitos na instalação.

Se depois o Claude Code ainda listar o servidor MCP memo, remova-o:

claude mcp remove --scope user memo

Depois revogue o computador em Conta, para a chave dele parar de funcionar.