Documentación

Instalar y conectar

Memo conecta Claude Code y Codex de tu computadora con tu grafo en nuestro servidor. Basta un comando por computadora.

Antes de empezar

macOS, Linux o Windows con WSL. Windows nativo no es compatible.
python3 y curl en esa computadora.
Claude Code, Codex o ambos, con la sesión iniciada en tu propio plan.
Una cuenta de Memo. Crea una si no la tienes.

Instalación

1. Obtén tu línea de instalación

Abre Cuenta y presiona Conectar una computadora. Recibes una línea con un código de un solo uso. El código sirve una vez y vence a los 15 minutos.

2. Pégala y confirma

Pega la línea en una terminal de la computadora que quieres conectar, o en Claude Code o Codex abiertos en ella. Se ve así, con tu propio 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

Luego solo confirma. Una terminal pregunta una vez: Continue? [Y/n]. Claude Code o Codex piden permiso para ejecutar el comando. Memo funciona desde tu próxima sesión de Claude Code o Codex.

El instalador conecta esta computadora a tu cuenta y le da su propia clave. Cada archivo que descarga aparece con su suma de verificación SHA-256 en /kit/SHA256SUMS.

Actualizaciones

Cuando cambian los hooks o las instrucciones de Memo, tu agente te avisa en una línea y te pregunta. Si dices que sí, instala la actualización. También puedes ejecutarla tú:

~/.memo/bin/memo update

La actualización conserva la clave de esta computadora y solo reemplaza los archivos propios de Memo. La nueva versión funciona desde la próxima sesión.

Si memo update no funciona en una instalación antigua, ejecuta esto una vez:

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

Conectar una sesión

Abre Claude Code o Codex como siempre y pídele que se conecte a Memo. En Claude Code, escribe /memo; en Codex, escribe $memo.

La sesión se registra como rama, recibe su pasaporte y empieza a anotar sus pasos en el mapa. Abre el panel para seguirla y definir el pasaporte.

El pasaporte va primero. Los agentes lo leen en cada turno. Donde dice que no, la rama prepara el trabajo y te pregunta en la bandeja.

Qué cambia el instalador

Dónde	Qué
`~/.memo/config.json`	Tu dirección de Memo, el nombre del dueño, la zona horaria y la versión del kit.
`~/.memo/token`	La clave de esta computadora. Solo tu usuario puede leer el archivo, y ninguna herramienta de Memo la muestra.
`~/.memo/bin/memo`	El comando `memo` que usan tus agentes para leer y escribir el grafo.
`~/.memo/memo-hook.py`	El hook que Claude Code y Codex ejecutan en los eventos de la sesión.
`~/.claude/settings.json`	Hooks de Memo para Claude Code y permiso para ejecutar el comando memo y las herramientas MCP de Memo sin preguntar cada vez. El resto de tu configuración queda igual.
`~/.codex/hooks.json`	Hooks de Memo para Codex.
`~/.claude/skills/memo/` `~/.codex/skills/memo/`	La skill de memo: cómo trabaja una sesión con su rama.
`~/.claude/CLAUDE.md` `~/.codex/AGENTS.md`	Un bloque corto de Memo entre marcadores; el archivo de Codex, solo si Codex está instalado. El resto de cada archivo queda igual.
Servidores MCP de Claude Code, ámbito de usuario	Un servidor llamado `memo`; se agrega solo si `claude` está en tu PATH.

MCP

Si claude está en tu PATH, el instalador ejecuta esto por ti, con la clave de esta computadora en lugar del marcador:

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

La clave va directo a Claude Code y no se muestra en pantalla. Para Codex, el instalador muestra el ajuste que debes agregar tú.

Herramientas que reciben tus agentes:

Herramienta	Qué hace
`memo_list`	Lista tus ramas.
`memo_brief`	Un resumen breve de una rama.
`memo_show`	Una rama completa o uno de sus nodos.
`memo_register`	Crea una rama.
`memo_apply`	Escribe cambios en los nodos de una rama.
`memo_pending_answers`	Tus respuestas que la rama todavía no tomó.
`memo_log`	El historial de cambios de la rama.

El comando memo

Los agentes también llegan al grafo con ~/.memo/bin/memo. Tú también puedes usarlo:

~/.memo/bin/memo list

Cuando algo falla, te dice qué hacer en una línea:

La clave no se acepta, por ejemplo porque se revocó la computadora: obtén un código nuevo en Cuenta y vuelve a ejecutar el instalador.
El plan está inactivo: suscríbete en Cuenta. Mientras tanto, el panel sigue funcionando.

Desconectar una computadora

En Cuenta, presiona Revocar junto a la computadora. Su clave deja de funcionar al instante. Tu grafo y tus otras computadoras no se ven afectados.

Desinstalar

Para quitar los archivos y la configuración de Memo de una computadora, vuelve a descargar el instalador y ejecútalo con --uninstall:

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

Solo quita el bloque de Memo de CLAUDE.md y AGENTS.md, y restaura tu configuración con las copias de seguridad que hizo al instalar.

Si después Claude Code todavía muestra el servidor MCP memo, quítalo:

claude mcp remove --scope user memo

Luego revoca la computadora en Cuenta para que su clave deje de funcionar.