EN Instalar

Cómo funciona la sala, sin magia.

Qué pasa en tu computadora cuando hablas con tus agentes, contado para cualquiera y con el detalle que busca quien programa. Cada afirmación de esta página corresponde a código del repositorio, y ese código tiene su prueba.

Basado en docs/INTERNALS.md · MADRE 0.4.1

El mapa

Todo pasa en tu computadora.

MADRE es un pequeño servidor que corre en tu computadora. Tu navegador le habla a él, él les habla a los agentes, y cada agente le habla a su proveedor con tu cuenta.

Tu computadora

  1. Tu navegadorLa sala, en 127.0.0.1
  2. MADREEl registro, la memoria y los permisos
  3. Los agentesCodex, Claude Code, Gemini CLI y OpenCode, cada uno en su caja
@madre · opcionalUn modelo local con Ollama: no sale de tu máquina

Fuera

Los proveedoresOpenAI, Anthropic, Google y el de OpenCode, con tu cuenta y tus límites

El registro

Una sola fuente de verdad.

Cada proyecto tiene su sala, y todo lo que pasa en ella se anota en un archivo, una línea por cosa. Nada se borra: solo se agrega.

  • Se reconstruye solo. Si MADRE se reinicia, o abres la sala desde otro editor (IDE), la conversación se vuelve a armar desde ese archivo.

  • Sin choques. Si abres la misma sala en dos editores, nunca se pisan: cada escritura espera su turno con un candado en disco.

  • Relevos que quedan. Cuando cambia el agente que responde, se registra de quién a quién y qué tramo de la conversación se entregó.

  • En vivo, en todas tus pestañas. Las páginas abiertas se alimentan del registro: lo que escribe otro proceso también llega, y al reconectar siguen donde se quedaron.

  • GHOST no deja rastro. Sus eventos llegan a las páginas abiertas y nunca al registro.

  • Límites claros. Cada agente recibe hasta 16 000 caracteres de conversación, lo reciente primero. Un mensaje de más de 20 000 se rechaza sin llamar al agente.

La memoria

Lo que se dice, se destila.

La memoria se arma a partir de ese archivo, así que si se pierde se vuelve a armar. Un agente «archivista» resume lo importante en notas, y cada turno recibe las que le sirven.

  1. Se registra

    Todo mensaje fuera de GHOST entra al índice con su número.

  2. Se destila

    Cada tantos intercambios, o en reposo, el archivista escribe hasta cinco notas con tipo: decisión, hecho, preferencia o pregunta.

  3. Se busca

    Cuando la conversación ya no cabe, cada turno recibe, dentro del mismo presupuesto, las notas y los intercambios que coinciden con la petición.

  4. Se asocia

    Las notas que llegan juntas una y otra vez quedan enlazadas: al traer una, viene la otra.

NOSTROMO, el archivo de memoria de MADRE: un núcleo rojo y, a su lado, las memorias enlazadas entre sí. Arriba: 5 memorias, 10 enlaces, 12 intercambios detrás.
NOSTROMO dibuja ese archivo. Cada estrella es una nota, enlazada con las que comparten tema. MADRE 0.4.0 en local · 26 sep 2026
  • El archivista más barato. En este orden: Ollama, Gemini, OpenCode, Codex, Claude. Una sola llamada por lote, y nunca durante un turno.

  • Sin hacerte esperar. La búsqueda por significado (embeddings) se prepara en segundo plano: un turno nunca la espera.

  • Medida contra un control. MU/TH/UR prueba si el archivo contesta, si se contradice y si el modelo local ya sirve. La primera medición dio 30 de 30; contra un control, 40 %. Un número que sí dice algo.

Los agentes

Cada agente, en su propia caja.

Cada agente corre por separado, en un espacio aislado que solo tiene las sesiones que ya tenías. Si deja de responder a tiempo, MADRE lo detiene por completo, junto con lo que haya abierto.

Codex
En solo lectura para consultar; con permiso de escritura acotado en CREATE y sobre el proyecto en CONTROL.
Claude Code
Herramientas locales de lectura, sesiones que no persisten y solo los servidores MCP de MADRE.
Gemini CLI
Modo plan y una política temporal de solo lectura, con un hogar propio: sus tokens sí; sus hooks, extensiones y memoria, no.
OpenCode
Permisos que se inyectan en cada corrida, sin tocar tu configuración global.
@madre
No es un programa aparte: es un modelo local de Ollama que recibe la conversación reciente y lo que la memoria recuerda, nunca el documento que reciben los demás agentes.
El lanzamiento: el comando exacto de Codex, con --sandbox read-only, y las variables de entorno mostradas solo por su nombre, «set for this turn, not shown».
El lanzamiento de un turno de Codex. --sandbox read-only, y las variables de entorno solo por su nombre. MADRE 0.4.0 en local · 26 sep 2026

CONTROL por dentro

Fotografía, turno, diferencia, UNDO.

Así edita un agente tu proyecto sin que pierdas nada.

  1. Fotografía

    Un commit real bajo refs/madre/checkpoints/, con los archivos sin seguimiento y respetando .gitignore. Tu rama, tu índice y tu stash no se tocan.

  2. Turno

    Los archivos protegidos quedan en solo lectura mientras el agente trabaja.

  3. Diferencia

    La comparación contra la fotografía da la lista de cambios; cualquier escritura en una zona prohibida se revierte y se nombra.

  4. UNDO

    Restaura la fotografía completa.

CREATE toma la misma fotografía, sin exclusividad: varios turnos pueden correr a la vez. Lo nuevo se queda; lo que ya existía y cambió, se restaura.

Límites de uso

Un medidor por agente, sin adivinar.

  • Cuando el proveedor lo publica. Codex deja sus ventanas de uso en tu disco y MADRE las lee, sin red. Claude Code publica su uso y MADRE lo consulta solo si lo activas.

  • Cuando no. Gemini y OpenCode muestran una ventana local: un presupuesto blando de 500 000 tokens por agente en cinco horas rodantes.

  • Avisos a tiempo. Al 80, 90 y 100 % la sala avisa y sugiere otro agente. MADRE nunca inventa la cuota del proveedor a partir de sus propias cuentas.

Si algo se cae

Hecha para recuperarse.

  • Un arranque que sana. Si MADRE se detuvo a mitad de un turno, al volver lo registra como fallido en vez de dejarlo colgado.

  • Un apagado limpio. Con Ctrl+C interrumpe los agentes en curso, avisa a las páginas abiertas y cierra.

  • Todo plan termina. Los pasos corren en secuencia y los delegados no delegan. STOPALL corta cualquier cosa.

  • Probada antes de salir. Ninguna prueba llama a un modelo. Antes de cada versión se empaqueta, se instala en una carpeta vacía y se arranca el servidor.

Pruébala en un proyecto que ya conoces.

npx @jossuealcala/madre start

Volver a MADRE