Documentación

Instalar y conectar

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

Antes de empezar

macOS, Linux o Windows con WSL. Windows nativo no es compatible.
python3 y curl en ese ordenador.
Claude Code, Codex o los dos, con tu propio plan y la sesión iniciada.
Una cuenta de Memo. Crea una si aún no la tienes.

Instalación

1. Consigue tu línea de instalación

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

2. Pégala y confirma

Pega la línea en un terminal del ordenador que quieres conectar, o en Claude Code o Codex abiertos en él. Tiene este aspecto, 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. Un 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 este ordenador a tu cuenta y le da su propia clave. Todos los ficheros que descarga aparecen con su suma de comprobación SHA-256 en /kit/SHA256SUMS.

Actualizaciones

Cuando cambian los hooks o las instrucciones de Memo, tu agente te lo dice en una línea y te pregunta. Di que sí e instalará la actualización. También puedes ejecutarla tú:

~/.memo/bin/memo update

La actualización conserva la clave de este ordenador y solo sustituye los ficheros propios de Memo. La nueva versión funciona desde la siguiente 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 escribir sus pasos en el mapa. Abre el panel para seguirla y definir el pasaporte.

El pasaporte manda. 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, nombre del dueño, zona horaria y versión del kit.
`~/.memo/token`	La clave de este ordenador. Solo tu usuario puede leer el fichero 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 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 tus ajustes se queda como está.
`~/.codex/hooks.json`	Hooks de Memo para Codex.
`~/.claude/skills/memo/` `~/.codex/skills/memo/`	La skill memo: cómo trabaja una sesión con su rama.
`~/.claude/CLAUDE.md` `~/.codex/AGENTS.md`	Un bloque corto de Memo entre marcadores; el fichero de Codex, solo si Codex está instalado. El resto de cada fichero se queda como está.
Servidores MCP de Claude Code, ámbito de usuario	Un servidor llamado `memo`; se añade solo si `claude` está en tu PATH.

MCP

Si claude está en tu PATH, el instalador lo ejecuta por ti, con la clave de este ordenador 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 directa a Claude Code y no se muestra en pantalla. Para Codex, el instalador muestra el ajuste que tienes que añadir 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 aún no ha recogido.
`memo_log`	El historial de cambios de la rama.

El comando memo

Los agentes también acceden 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 el ordenador se ha revocado: consigue un código nuevo en Cuenta y vuelve a ejecutar el instalador.
El plan no está activo: suscríbete en Cuenta. Mientras tanto, el panel sigue funcionando.

Desconectar un ordenador

En Cuenta, pulsa Revocar junto al ordenador. Su clave deja de funcionar al momento. Tu grafo y tus otros ordenadores no se ven afectados.

Desinstalación

Para quitar los ficheros y ajustes de Memo de un ordenador, 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 tus ajustes desde las copias de seguridad que hizo al instalar.

Si después Claude Code sigue mostrando el servidor MCP memo, quítalo:

claude mcp remove --scope user memo

Después revoca el ordenador en Cuenta para que su clave deje de funcionar.