Terraforma Memory
Una memoria privada y local compartida por Claude Code y Codex. Un solo binario, sin red, diario a prueba de manipulaciones.
Documentación
Terraforma Memory
Una memoria privada para Claude Code y Codex. Tus asistentes guardan decisiones, convenciones y soluciones difíciles de conseguir, y las encuentran de nuevo en la próxima sesión, o desde el otro asistente. Todo permanece en tu máquina, en un diario que te pertenece.
- Compartida entre asistentes. Claude Code y Codex pueden usar la misma memoria al mismo tiempo; cada llamada mantiene el bloqueo solo mientras se ejecuta.
- Local y privada. Un único binario sin dependencias de ejecución. El servidor MCP se comunica a través de stdio y no realiza conexiones de red. Sin cuenta, sin telemetría.
- Historial a prueba de manipulaciones. Cada guardado es una entrada de diario encadenada por hash. Actualizar una memoria conserva sus versiones anteriores.
- Tuya para conservar. Exporta, respalda y restaura con el mismo binario. Desinstalar nunca elimina tus memorias.
La memoria integrada del asistente suele estar vinculada a una herramienta y un proyecto. Terraforma Memory es un solo lugar donde ambos asistentes leen y escriben.
Instalación (macOS arm64, Linux x86-64)
Un comando, ejecutado dentro de la carpeta de tu proyecto:
curl -fsSL https://raw.githubusercontent.com/janus-ubos-republic/terraforma-memory/main/lander.sh | sh
El Lander inspecciona la máquina (sistema, chip, herramientas, qué asistentes están presentes),
descarga el archivo correcto, lo verifica contra los checksums fijados en el script,
instala en ~/.terraforma/terraforma-local-core y comprueba que el programa responde.
No usa sudo ni inicia ningún servicio. En una terminal, luego pregunta si deseas conectar
Claude Code y Codex; cambia su configuración solo si dices que sí, a través de sus
propios comandos mcp add. Para mirar primero: descarga lander.sh, léelo y ejecuta
sh lander.sh --dry-run. Opciones: --connect claude,codex|all|none, --project NAME.
Instalación manual
Descarga el archivo para tu plataforma desde la página de versiones, luego:
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
El instalador verifica el checksum de cada archivo antes de instalar en
~/.terraforma/terraforma-local-core, no inicia ningún servicio y no edita ninguna configuración.
Imprime los comandos exactos para conectar tus asistentes. Descargar con curl
(no un navegador) evita el aviso de cuarentena de macOS para este binario sin firmar.
Linux necesita glibc 2.30 o más reciente (Ubuntu 20.04+, Debian 11+).
Conectar
Usa un directorio de memoria por proyecto. Se crea en el primer uso, privado para tu usuario.
# 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"]
Apunta ambos al mismo directorio para compartir una memoria.
Lo que obtiene tu asistente
| Herramienta | Uso |
|---|---|
remember | Guardar o actualizar una memoria (título + texto, hasta 16 KB). Mismo título = nueva versión. |
recall | Buscar memorias por palabras. Pon nombres, rutas, mensajes de error e identificadores en la consulta. |
read_memory | Leer una memoria completa. |
recent | Listar las memorias más recientes: un buen comienzo para una sesión. |
memory_status | Contar, límites y el resumen de integridad del diario. |
Resumen opcional de sesión (Markdown de las memorias más recientes):
terraforma-local-core briefing ~/.terraforma/memory/my-project 10
Límites honestos
- La búsqueda coincide con palabras, no con significado: una pregunta reformulada puede no encontrar una memoria que usa palabras diferentes. Pregunta con los términos específicos que esperas en ella.
- Hasta 5,000 memorias por directorio, 16 KB cada una. Guardar una a la vez es rápido (aproximadamente 0.1–0.25 s por llamada a 5,000); importar miles en bloque es lento.
- Solo macOS arm64 y Linux x86-64. El binario de macOS aún no está firmado.
Apoya el proyecto
Terraforma Memory es gratuito y de código abierto, y cada función funciona sin pagar. Si te ahorra tiempo, las licencias de fundador se abren pronto: €19 de pago único para los primeros 100 seguidores, luego €29. Financian el desarrollo de un creador independiente.
Licencia
Apache-2.0. Ver LICENSE. Notas de compilación y calificación: docs/DEVELOPMENT.md.