EN Instalar

Qué hace MADRE en tu compu, pieza por pieza.

Te cuento qué pasa en tu compu cada vez que le hablas a tus agentes. Todo lo que digo aquí sale de código del repositorio, y ese código tiene su prueba.

Basado en docs/INTERNALS.md · MADRE 1.1.3

En corto

  • MADRE es un servidor pequeño en tu computadora: tu navegador le habla a MADRE, MADRE a tus agentes y cada agente a su proveedor, con tu cuenta.
  • Todo lo que pasa en un proyecto se escribe en un archivo, una línea por cada cosa. Nada se borra, y la memoria se arma desde ahí.
  • Cada agente trabaja en su propia caja, solo con las sesiones que ya tenías. Si no contesta a tiempo, MADRE lo detiene.
  • Antes de que un agente edite en #3, MADRE guarda una copia, y con Deshacer regresas todo.

El mapa

Qué corre en tu compu y qué no.

MADRE es un servidor chiquito que corre en tu compu. Tu navegador habla con MADRE, MADRE habla con los agentes y cada agente habla con su proveedor usando tu cuenta. En Windows, todo esto corre dentro de WSL2, y tu navegador de Windows lo abre igual.

Tu compu

  1. Tu navegadorTus proyectos, en 127.0.0.1
  2. MADREEl registro, la memoria y los permisos
  3. Los agentesCodex, Claude Code, Gemini CLI, Cursor y OpenCode, cada uno en su caja
@madre · opcionalUn modelo local con Ollama. No sale de tu compu.

Afuera

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

El registro

Todo lo que pasa en un proyecto queda en un archivo.

Cada proyecto tiene el suyo. Lo que pasa ahí se escribe en ese archivo, una línea por cada cosa que pasa (un evento). Lo nuevo se agrega al final y nada se borra.

  • Se vuelve a armar solo. Si MADRE se reinicia, o abres el proyecto desde otro editor (IDE), la conversación se arma otra vez leyendo ese archivo.

  • Dos editores a la vez. Si abres el mismo proyecto en dos editores, cada escritura espera su turno gracias a un candado en el disco, y ninguna pisa a la otra.

  • Los relevos quedan anotados. Cuando cambia el agente que contesta, queda anotado de quién a quién pasó y qué pedazo de la conversación se le entregó.

  • Todas tus pestañas al día. Las páginas abiertas leen del registro, así que también ven lo que escribe otro proceso. Si se desconectan, al volver siguen donde iban.

  • #0 Incógnito no deja rastro. Lo que pasa en Incógnito se ve en las páginas abiertas, pero nunca llega al registro.

  • Cuánto le toca a cada agente. Cada agente recibe hasta 16 000 caracteres de la conversación, empezando por lo más reciente. Si un mensaje pasa de 20 000, se rechaza sin siquiera llamar al agente.

La memoria

De dónde sale la memoria.

La memoria sale de ese mismo archivo. Si se pierde, se vuelve a armar desde ahí. Un agente «archivista» resume lo importante en notas, y a cada turno le llegan las que le sirven.

  1. Se anota

    Cada mensaje que no va en Incógnito entra al índice con su número.

  2. Se resume

    Cada cierto número de intercambios, o cuando no hay movimiento, el archivista escribe hasta cinco notas. Cada una es de un tipo: decisión, hecho, preferencia o pregunta.

  3. Se busca

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

  4. Se enlaza

    Las notas que llegan juntas una y otra vez quedan enlazadas. Cuando se trae una, viene la otra.

MADRE 1.1, «Lo que se envía › Lo que lee el agente»: el documento de un turno para @codex en 13 partes (el proyecto, quién escribe, cómo responder, privacidad, herramientas de memoria, modo de permiso, contexto reciente…), cada una con su tamaño y cuándo entra.
Lo que lee el agente, parte por parte. MADRE arma este documento en cada turno con lo que hace falta de la memoria; lo ves al tocar el núcleo del Mapa de memoria. Se arma al abrirlo y no se guarda.
  • Quién hace el resumen. El primero que esté disponible, en este orden: Ollama, Gemini, OpenCode, Codex y Claude. Hace una sola llamada por tanda y nunca durante un turno.

  • La búsqueda no frena los turnos. La búsqueda por significado (embeddings) se prepara en segundo plano, y ningún turno se queda esperándola.

  • Medida contra un control. Diagnóstico revisa 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 %.

Los agentes

Cada agente trabaja en su propia caja.

Cada agente corre por su lado, en un espacio aislado donde solo están las sesiones que ya tenías. Si no contesta a tiempo, MADRE lo para por completo, con todo lo que haya abierto.

Codex
Solo lectura cuando consultas. En #2 Crear escribe con un permiso acotado, y en #3 Editar, sobre el proyecto.
Claude Code
Herramientas locales para leer, sesiones que no se quedan guardadas y, de servidores MCP, solo los de MADRE.
Gemini CLI
Modo plan y una política temporal de solo lectura. Corre con un hogar propio que se lleva sus tokens, pero no sus hooks, extensiones ni memoria.
OpenCode
MADRE le pasa los permisos en cada corrida, sin tocar tu configuración global.
@madre
Es un modelo local de Ollama, no un programa aparte. Le llega la conversación reciente y lo que recuerda la memoria, pero nunca el documento que reciben los demás agentes.
MADRE 1.1, «Lo que se envía › Cómo arranca»: el comando exacto con el que MADRE lanzaría a Codex, con --sandbox read-only y las variables de entorno mostradas solo por su nombre, «set for this turn, not shown».
Cómo arranca un turno de Codex. --sandbox read-only, y las variables de entorno solo por su nombre.

Editar por dentro

Qué pasa cuando un agente trabaja en #3 Editar.

Antes de que el agente trabaje, MADRE guarda una copia. Cuando termina, ves qué cambió y, si quieres, lo deshaces.

  1. Copia

    Es un commit de verdad, guardado en refs/madre/checkpoints/. Incluye los archivos que git no sigue y respeta tu .gitignore. Tu rama, tu índice y tu stash no se tocan.

  2. Turno

    Mientras el agente trabaja, los archivos protegidos quedan en solo lectura.

  3. Cambios

    Se compara con la copia y sale la lista de lo que cambió. Si el agente escribió donde no debía (una zona prohibida), se revierte y MADRE te avisa.

  4. Deshacer

    Regresa todo el proyecto a como estaba en la copia.

En #2 Crear también se guarda la copia, pero ahí pueden trabajar varios agentes a la vez. Lo nuevo se queda. Lo que ya existía y cambió, se restaura.

Límites de uso

Cuánto te queda de cada plan.

  • Si el proveedor lo publica. Codex deja sus ventanas de uso en tu disco y MADRE las lee ahí mismo, sin conectarse a internet. Claude Code publica su uso, y MADRE lo consulta solo si tú lo activas.

  • Si no lo publica. Gemini y OpenCode muestran una ventana local. Es un presupuesto blando de 500 000 tokens por agente, contado sobre las últimas cinco horas.

  • Avisos a tiempo. Al llegar a 80, 90 y 100 %, MADRE te avisa y te sugiere otro agente. MADRE nunca se inventa la cuota del proveedor sacando sus propias cuentas.

Si algo falla

Qué pasa si algo truena.

  • Turnos a medias. Si MADRE se detuvo a la mitad de un turno, al volver lo marca como fallido en vez de dejarlo colgado.

  • Al cerrar con Ctrl+C. MADRE para a los agentes que estén trabajando, les avisa a las páginas abiertas y se cierra.

  • Los planes siempre terminan. Los pasos van uno tras otro, y un agente al que le delegaron algo ya no puede delegar. STOPALL para lo que esté corriendo.

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

Abre MADRE en tu proyecto.

npx @jossuealcala/madre

Volver a MADRE