EN Instalar

Qué pueden hacer los agentes en tu proyecto, y qué no.

MADRE corre en tu compu. No usa una nube propia y no guarda tus claves. En esta página te cuento qué pueden hacer los agentes, cómo deshaces lo que cambian en tus archivos, qué límites tiene todavía la beta y cómo avisarme si encuentras un fallo.

Basado en SECURITY.md · MADRE 1.1.3

En corto

  • MADRE corre en tu computadora, sin nube propia, y no guarda tus claves.
  • Cada mensaje lleva un permiso. Si no dices nada, los agentes solo leen.
  • En #3 Editar, MADRE guarda una copia antes del turno y Deshacer regresa todo.
  • Ves cada conexión que MADRE puede hacer y un registro de las que hizo. Abajo están también los límites que todavía tiene la beta.

Lo básico

Primero, lo que MADRE no hace.

Permisos

Tú decides hasta dónde llega cada agente.

Cada mensaje lleva un nivel de permiso (un modo). Nada de lo que arranque ese mensaje se puede pasar de ese nivel. Si no dices nada, los agentes solo leen.

  • #0

    Incógnito

    Fuera de registro. No se guarda nada y se pierde al recargar.

  • #1

    Solo conversar Predeterminado

    Lee el proyecto y habla de él. No escribe nada.

  • #2

    Crear

    Crea archivos nuevos donde les toca en el proyecto. Los que ya existen no se tocan.

  • #3

    Editar

    Edita el proyecto, sin aprobar acción por acción. Te pide confirmar.

  • #4

    Acceso total

    Ejecuta comandos, hace push y despliega. Lo que sale de la máquina no regresa. Te pide confirmar dos veces.

Menú de permisos de MADRE 1.1 para un mensaje a @opencode, con permiso máximo #2: #0 Incógnito, #1 Solo conversar (activo), #2 Crear, y #3 Editar y #4 Acceso total con «Subir a #3» y «Subir a #4».
El menú real de modos
  • #3 Editar te pide confirmar. Para que un agente edite, lo confirmas en una hoja que dice qué va a poder hacer. Si prefieres, en Ajustes › Permisos pones una frase tuya y MADRE te la pide en lugar de la confirmación.

  • #4 Acceso total te pide confirmar dos veces. De entrada lo confirmas dos veces seguidas, o escribes tu frase dos veces. Y además, ese agente tiene que tener permiso de llegar tan alto, cosa que también decides tú.

  • Un agente no se da permisos. Ningún agente puede subirse el permiso solo, ni aunque lo ponga en su respuesta.

MADRE 1.1, la hoja «Desbloquear #3 Editar para @opencode»: @opencode edita los archivos del proyecto directamente, sin que apruebes cada acción; antes se toma un punto de restauración y «Deshacer» está a un clic. Con Cancelar y Desbloquear.
La hoja para desbloquear #3 Editar. Dice qué va a poder hacer el agente y que antes se guarda un punto de restauración. Para esta página la abrí y cancelé.

Deshacer

Antes de que un agente edite, MADRE guarda una copia.

En #3 Editar, MADRE guarda tu proyecto antes del turno. Al terminar te enseña qué cambió, y con Deshacer regresa todo a como estaba.

La copia es un commit de git.
Se guarda en refs/madre/checkpoints/ y no toca tu rama, tu índice ni tu stash. Si tu carpeta no usa git, la copia se guarda aparte, fuera del proyecto, en una carpeta que solo tú puedes abrir.
Zonas protegidas.
Mientras dura el turno, tus .env, .pulse/, .madre/ y .claude/settings.local.json quedan en solo lectura.
Lo ves al terminar.
El turno te dice qué archivos cambiaron, y su botón Deshacer regresa el proyecto al punto de restauración.
MADRE 1.1, un turno real de @opencode en #3 Editar: agregó una sección «Cupones» al README de mi-tienda. Debajo, la tarjeta «Editar · @opencode cambió 1 archivo»: README.md modificado, «1 file changed, 4 insertions(+), 1 deletion(-)» y el botón «Deshacer · volver al punto de restauración».
Un turno real en #3 Editar. OpenCode cambió el README; la tarjeta dice qué cambió y Deshacer lo regresa. Para esta página le di a Deshacer y el proyecto quedó como estaba.

Ojo con #4 Acceso total. Los archivos regresan con Deshacer, pero un git push o una publicación ya salieron de tu compu y eso no se puede deshacer. Actívalo solo si le prestarías tu terminal a ese agente.

Transparencia

Tú ves cada conexión que hace MADRE.

En MADRE tienes la lista de todas las direcciones de internet a las que MADRE se puede conectar, y un registro de cada conexión que hizo.

MADRE 1.1, «Lo que se envía › A dónde se conecta»: cada dirección a la que MADRE puede llegar, con su estado. Los agentes hacia OpenAI, Anthropic, Google, el proveedor de OpenCode y Cursor, encendido y marcado «No pasa por MADRE»; la búsqueda y las imágenes de Gemini, apagadas; el registro de npm y GitHub, para buscar versiones nuevas.
A dónde se conecta MADRE. Cada destino dice qué lleva, cuándo sale y dónde lo apagas. Lo abres al tocar el núcleo del Mapa de memoria.
  • Cada dirección, a la vista. Cada una te dice qué lleva, cuándo sale y dónde la apagas. Los errores anónimos (qué falló y cuánto se usa, sin lo que escribes) los apagas en Ajustes › Actualizaciones y errores.

  • Un registro que puedes comprobar. Ahí está cada conexión que hizo MADRE, a dónde fue y cuándo. Lo que se mandó nunca se guarda: ni el contenido, ni los encabezados, ni los valores.

  • Tus claves nunca se muestran. Puedes leer el comando exacto de cada turno. Tus claves y variables de entorno salen solo con su nombre, nunca con su valor.

Privacidad

Tus datos privados se ocultan solos.

  • Se ocultan antes de guardarse. Las claves, los tokens, los correos y las rutas personales se ocultan antes de llegar al registro, al archivista que resume la memoria, a los demás agentes y al dataset.

  • Términos privados. Apunta los nombres que nunca deben aparecer, como tu organización o un cliente, y MADRE los cambia por un marcador en cada salto.

  • Incógnito para lo que no debe quedar. Lo que dices fuera de #0 Incógnito se queda en la memoria del proyecto y les llega a todos sus agentes. Si algo no se debe recordar, mándalo en Incógnito.

Límites de la beta

Lo que todavía no te protege.

Son tres límites de la beta. Mejor conócelos antes de darle permisos a un agente.

#3 Editar deshace, pero no impide.
Los archivos protegidos quedan en solo lectura y se restauran desde el checkpoint. En .git/ se puede seguir escribiendo porque los agentes lo necesitan, y se restaura al terminar. Si un agente cambia los permisos a propósito, la restauración lo atrapa después, pero nada se lo impide antes.
#4 Acceso total es tu terminal.
Corre comandos con las CLIs y las sesiones de tu compu, como pruebas, builds, git push o despliegues. Los archivos regresan con Deshacer. Lo que ya salió de tu compu, no.
La memoria es de todo el proyecto.
Lo que dices fuera de Incógnito les llega a todos los agentes de ese proyecto.

Reportar

¿Encontraste un fallo de seguridad? Avísame en privado.

Si un agente escribe fuera de su permiso, se queda con #3 Editar cuando no debería, llega a la memoria de otro proyecto o hace que MADRE mande algo que no autorizaste, avísame primero a mí, en privado.

Abrir un aviso privado en GitHub Usar el formulario privado

Qué mandarme.
La versión (madre doctor --json), tu sistema, qué agente y qué modo usabas, y la serie de mensajes más corta con la que se repite el fallo.
Qué pasa después.
El arreglo sale en una versión de parche, y el aviso se publica cuando ese arreglo ya está disponible. Si el problema es del CLI mismo (Codex, Claude Code, Gemini CLI u OpenCode), se lo paso a su proyecto.

Abre MADRE en tu proyecto.

npx @jossuealcala/madre

Volver a MADRE