ANTHROPIC_API_KEY tiene prioridad sobre tu plan de claude.ai
Qué pasa. Claude Code encontró una llave de API además del inicio de sesión de claude.ai, y usa la llave. Puede venir del perfil de tu shell —MADRE le pasa a la app el entorno tal como lo tiene esta computadora— o del bloque `env` de ~/.claude/settings.json, que es donde se guarda una llave pegada en Ajustes › Agentes. Cada respuesta se cobra a la cuenta de API, no al plan, y los conectores de tu organización no cargan.
Qué hacer. Decide cuál quieres. Para trabajar con la API, este mensaje es solo un aviso y se puede ignorar. Para trabajar con el plan, quita la llave de donde esté puesta: el perfil de tu shell, o el bloque `env` de ~/.claude/settings.json si la pegaste en MADRE; luego vuelve a abrir el proyecto.
grep -rn ANTHROPIC_API_KEY ~/.zshrc ~/.zprofile ~/.zshenv 2>/dev/null
# borra o comenta la línea que encuentre, y luego:
unset ANTHROPIC_API_KEY
# y arranca MADRE desde una terminal nueva
grep -rn ANTHROPIC_API_KEY ~/.bashrc ~/.profile ~/.bash_profile 2>/dev/null
unset ANTHROPIC_API_KEY
# y arranca MADRE desde una terminal nueva
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
grep -rn ANTHROPIC_API_KEY ~/.bashrc ~/.profile ~/.bash_profile 2>/dev/null
unset ANTHROPIC_API_KEY
# y arranca MADRE desde una terminal nueva
Codex dice que está leyendo entrada adicional de stdin
Qué pasa. Es un aviso que imprime Codex, no un error. MADRE no le manda nada más por esa vía, así que la línea es inofensiva y lo que cuenta es lo que Codex haya devuelto. Si la respuesta falló, la razón está en la línea de arriba: el código de salida, o una salida limpia sin respuesta.
Qué hacer. No hay nada que hacer con el aviso en sí. Si las respuestas siguen fallando, revisa que tu versión de Codex sea lo bastante reciente para las opciones que MADRE le pasa (`codex --version`) y actualízala.
codex --version
npm install -g @openai/codex
codex --version
npm install -g @openai/codex
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
codex --version
npm install -g @openai/codex
Gemini rechaza el inicio de sesión personal de Google
Qué pasa. Google cerró Gemini Code Assist para las cuentas personales desde este cliente. El inicio de sesión con Google sigue apareciendo, pero cada petición se rechaza antes de llegar a un modelo.
Qué hacer. Cambia Gemini a una llave de API de Google AI Studio. MADRE solo copia a su carpeta aislada qué forma de iniciar sesión elegiste, así que la llave de API puede quedarse en el llavero o en ~/.gemini/.env.
gemini
# dentro de gemini: /auth → "Use Gemini API key" y pega la llave de https://aistudio.google.com/app/apikey
# o, sin el diálogo:
export GEMINI_API_KEY="YOUR_KEY"
# para que quede: echo 'export GEMINI_API_KEY="TU_LLAVE"' >> ~/.zshrc
gemini
# dentro de gemini: /auth → "Use Gemini API key"
export GEMINI_API_KEY="YOUR_KEY"
# para que quede: echo 'export GEMINI_API_KEY="TU_LLAVE"' >> ~/.bashrc
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
gemini
# dentro de gemini: /auth → "Use Gemini API key"
export GEMINI_API_KEY="YOUR_KEY"
# para que quede: echo 'export GEMINI_API_KEY="TU_LLAVE"' >> ~/.bashrc
La llave de API de Gemini se quedó sin créditos prepagados
Qué pasa. El proyecto de AI Studio asociado a la llave de API de Gemini gastó su saldo prepagado. Google rechaza cada llamada —incluidas las de Imágenes— con HTTP 429 hasta que se recargue. La app de Gemini lo esconde detrás de reintentos silenciosos.
Qué hacer. Recarga el saldo del proyecto en AI Studio, o configura la app de Gemini con una llave de API de otro proyecto. En MADRE no hay que cambiar nada; vuelve a intentar cuando el pago esté resuelto.
# facturación: https://ai.studio/projects
# comprueba que la llave siga sirviendo:
gemini --model gemini-3-flash-preview -p "ping"
# facturación: https://ai.studio/projects
# comprueba que la llave siga sirviendo:
gemini --model gemini-3-flash-preview -p "ping"
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# facturación: https://ai.studio/projects
# comprueba que la llave siga sirviendo:
gemini --model gemini-3-flash-preview -p "ping"
Google limitó cuántas peticiones acepta la llave de API de Gemini (HTTP 429)
Qué pasa. La llave de API de Gemini llegó al límite de tu plan por minuto o por día. La app de Gemini reintenta esperando cada vez más y mientras tanto solo imprime mensajes técnicos, así que parecía colgada. Con el modelo «auto», la primera petición es una llamada pequeña al enrutador (el que elige el modelo), así que hasta esa puede toparse con el límite.
Qué hacer. Espera un minuto y vuelve a intentar, elige un modelo explícito en la caja de Escribir (gemini-3-flash-preview se salta el enrutador), o sube el límite de tu plan en Google AI Studio.
# en el proyecto: doble clic en la esfera de Gemini → elige gemini-3-flash-preview
# revisa el límite de tu plan: https://aistudio.google.com/app/apikey
gemini --model gemini-3-flash-preview -p "ping"
gemini --model gemini-3-flash-preview -p "ping"
# límite de tu plan: https://aistudio.google.com/app/apikey
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
gemini --model gemini-3-flash-preview -p "ping"
# límite de tu plan: https://aistudio.google.com/app/apikey
Qué pasa. Google está rechazando peticiones al modelo elegido por exceso de carga (HTTP 503). La app de Gemini reintentaría durante minutos; MADRE la corta a los 15 s y reintenta una vez con gemini-3-flash-preview. La respuesta solo falló si ese modelo de respaldo también falló; el aviso sigue siendo el del modelo que elegiste.
Qué hacer. Vuelve a preguntar en un minuto, elige un modelo explícito en el menú de la caja de Escribir, o pásale la pregunta a otro agente. PULSE_GEMINI_FALLBACK_MODEL cambia el modelo de respaldo; vacío, no hay respaldo.
# espera y reenvía — o sigue con @codex / @claude / @opencode
PULSE_GEMINI_FALLBACK_MODEL= madre start
# espera y reenvía — o sigue con @codex / @claude / @opencode
PULSE_GEMINI_FALLBACK_MODEL= madre start
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# espera y reenvía — o sigue con @codex / @claude / @opencode
PULSE_GEMINI_FALLBACK_MODEL= madre start
Qué pasa. Sin un modelo en su configuración, `opencode run` se va a su proveedor por defecto. En esta computadora ese proveedor tiene una llave vieja o inválida.
Qué hacer. Dile a MADRE qué proveedor/modelo debe usar OpenCode en el proyecto, o quita la credencial vieja para que cambie el valor por defecto.
npx @jossuealcala/madre setup
# presiona [m] y elige un proveedor/modelo con sesión, por ejemplo openai/gpt-5.6-sol
# alternativa de una sola vez:
PULSE_OPENCODE_MODEL=openai/gpt-5.6-sol npx @jossuealcala/madre start
# o quita la llave vencida:
opencode auth logout anthropic
npx @jossuealcala/madre setup
# presiona [m] y elige un proveedor/modelo con sesión
PULSE_OPENCODE_MODEL=openai/gpt-5.6-sol npx @jossuealcala/madre start
opencode auth logout anthropic
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
npx @jossuealcala/madre setup
# presiona [m] y elige un proveedor/modelo con sesión
PULSE_OPENCODE_MODEL=openai/gpt-5.6-sol npx @jossuealcala/madre start
opencode auth logout anthropic
Qué pasa. La app del agente está en esta computadora, pero no tiene sesión iniciada con su proveedor. MADRE nunca guarda credenciales; cada agente guarda las suyas.
Qué hacer. Este agente todavía no tiene sesión. Conéctalo una vez en Ajustes › Agentes (MADRE ejecuta su inicio de sesión por ti, sin escribir nada en una terminal), o pregúntale lo mismo a un agente que sí esté conectado.
npx @jossuealcala/madre setup
# o directo:
codex login
claude auth login
opencode auth login
gemini # then /auth
npx @jossuealcala/madre setup
# o directo:
codex login
claude auth login
opencode auth login
gemini # then /auth
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
npx @jossuealcala/madre setup
# o directo:
codex login
claude auth login
opencode auth login
gemini # then /auth
Qué pasa. MADRE busca `codex`, `claude`, `gemini` y `opencode` en el PATH y en unos cuantos lugares conocidos. No encontró ninguno.
Qué hacer. Pulsa Instalar en el agente, en Ajustes → Agentes: MADRE te enseña el comando exacto, lo ejecuta aquí y vuelve a buscar cuando termina, sin reiniciar. `madre setup` hace lo mismo desde una terminal.
# elige el agente que quieras; abajo están los comandos de cada uno
# elige el agente que quieras; abajo están los comandos de cada uno
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# elige el agente que quieras; abajo están los comandos de cada uno
Se detectó el agente, pero su adaptador no está habilitado
Qué pasa. Tu versión de MADRE todavía no sabe trabajar con este agente, o una versión más nueva de la app del agente cambió su forma de funcionar.
Qué hacer. Actualiza MADRE a la última versión.
npx @jossuealcala/madre@latest doctor
npx @jossuealcala/madre@latest start
npx @jossuealcala/madre@latest doctor
npx @jossuealcala/madre@latest start
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
npx @jossuealcala/madre@latest doctor
npx @jossuealcala/madre@latest start
Claude confundió tu mensaje con un archivo de configuración (MCP)
Qué pasa. Las versiones viejas de MADRE ponían el mensaje para el agente justo después de una opción que acepta varios valores, así que Claude intentaba abrir ese texto como archivo.
Qué hacer. Arreglado en MADRE 0.1.0. Actualiza a la última versión.
npx @jossuealcala/madre@latest start
npx @jossuealcala/madre@latest start
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
npx @jossuealcala/madre@latest start
Qué pasa. El agente seguía leyendo archivos o razonando cuando se acabó su tiempo límite (por defecto 180 s para una respuesta que solo lee y 600 s para una que escribe), o Gemini se quedó callado 90 s (PULSE_GEMINI_IDLE_MS) y se detuvo después de un reintento automático. Las preguntas largas sobre muchos archivos tardan más; MADRE detuvo al agente y todos sus procesos. Lo que dejó una respuesta que escribe antes de detenerse aparece debajo del error, con «Deshacer».
Qué hacer. Pulsa Aplicar, abajo, o escribe otro número en Ajustes: Tiempo límite por defecto en Proyecto y respuestas, o Tiempo límite en el agente, en Agentes. Cada campo se guarda en cuanto sales de él. Aplica desde la próxima respuesta y queda en ~/.pulse/config.json. Las variables de entorno también sirven, pero solo si las defines antes de arrancar MADRE; un proyecto que ya está abierto no ve los cambios posteriores.
# en vivo, sin reiniciar: Ajustes → Proyecto y respuestas → Tiempo límite por defecto
# solo al arrancar (las variables de entorno tienen prioridad sobre config.json):
PULSE_AGENT_TIMEOUT_MS=300000 PULSE_CLAUDE_TIMEOUT_MS=600000 madre start
# o ~/.pulse/config.json → {"timeouts":{"default":300000,"claude":600000}}
# en vivo, sin reiniciar: Ajustes → Proyecto y respuestas → Tiempo límite por defecto
PULSE_AGENT_TIMEOUT_MS=300000 PULSE_CLAUDE_TIMEOUT_MS=600000 madre start
# o ~/.pulse/config.json → {"timeouts":{"default":300000,"claude":600000}}
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# en vivo, sin reiniciar: Ajustes → Proyecto y respuestas → Tiempo límite por defecto
PULSE_AGENT_TIMEOUT_MS=300000 PULSE_CLAUDE_TIMEOUT_MS=600000 madre start
# o ~/.pulse/config.json → {"timeouts":{"default":300000,"claude":600000}}
Qué pasa. MADRE se cerró (Ctrl+C, SIGTERM o un fallo) mientras este agente contestaba. El historial marca la respuesta como fallida para que el proyecto no se quede mostrando «pensando» para siempre.
Qué hacer. No hay nada que arreglar. Vuelve a preguntar; la conversación guardada está intacta.
# reenvía la pregunta
# reenvía la pregunta
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# reenvía la pregunta
Qué pasa. Cada mensaje tiene un tope (20,000 caracteres por defecto) para que quepa en el límite de texto que acepta la app de cada agente.
Qué hacer. Divide el mensaje en partes, o sube el tope si las apps de tus agentes lo aguantan.
export PULSE_MAX_MESSAGE_CHARS="40000"
export PULSE_MAX_MESSAGE_CHARS="40000"
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
export PULSE_MAX_MESSAGE_CHARS="40000"
Qué pasa. El uso de cada esfera muestra el límite real de tu plan cuando la app del agente lo publica: Codex escribe sus ventanas de 5 horas y semanal (% usado, hora de reinicio) en cada sesión bajo ~/.codex/sessions; el /usage de Claude Code viene del servicio de uso de Anthropic, y MADRE puede consultarlo con la credencial que Claude Code guarda en el llavero si arrancas con PULSE_CLAUDE_USAGE=1 (macOS puede pedirte permiso una vez para leer el llavero). Gemini y OpenCode no publican nada en tu computadora, así que su uso muestra la ventana propia de MADRE: las últimas 5 horas de tokens contra su límite de uso. Una ventana cuya hora de reinicio ya pasó cuenta como vacía hasta que la app vuelva a reportar, y el monitor de fallas dice «liberado» cuando una ventana entera se reinicia.
Qué hacer. Haz clic en una esfera para ver las dos ventanas y cuándo se reinician. Si el uso de una esfera se ve viejo, pídele algo a ese agente: Codex solo actualiza sus límites cuando trabaja. Pon PULSE_OFFICIAL_QUOTA=0 para dejar de leer por completo los límites del proveedor.
# clic en la esfera → ventanas de 5 h / 7 d y a qué hora se reinician
PULSE_CLAUDE_USAGE=1 madre start # also read Claude Code's usage windows
PULSE_OFFICIAL_QUOTA=0 madre start # local window only
# clic en la esfera → ventanas de 5 h / 7 d y a qué hora se reinician
PULSE_CLAUDE_USAGE=1 madre start # also read Claude Code's usage windows
PULSE_OFFICIAL_QUOTA=0 madre start # local window only
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# clic en la esfera → ventanas de 5 h / 7 d y a qué hora se reinician
PULSE_CLAUDE_USAGE=1 madre start # also read Claude Code's usage windows
PULSE_OFFICIAL_QUOTA=0 madre start # local window only
Un agente llegó a su límite de uso local de tokens
Qué pasa. El proyecto lleva un límite de uso flexible por agente (500,000 tokens por defecto) para que uno solo no se gaste una sesión entera sin avisar. Es la cuenta propia de MADRE, hecha con lo que cada app reporta después de cada respuesta, no el límite de tu plan: no se bloquea nada, el proyecto solo avisa y sugiere otros agentes. Las lecturas de caché cuentan como una décima de un token nuevo.
Qué hacer. Sigue con otro agente, pulsa Aplicar, abajo, o escribe un número en Ajustes → Proyecto y respuestas → Tokens por agente (se guarda al salir del campo). Los límites reales de tu plan aparecen en el globo de cada esfera cuando la app del agente los reporta.
# en vivo: Ajustes → Proyecto y respuestas → Tokens por agente
# al arrancar: PULSE_SOFT_TOKEN_BUDGET=1000000 madre start
# o ~/.pulse/config.json → {"room":{"softTokenBudget":1000000}}
# en vivo: Ajustes → Proyecto y respuestas → Tokens por agente
PULSE_SOFT_TOKEN_BUDGET=1000000 madre start
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# en vivo: Ajustes → Proyecto y respuestas → Tokens por agente
PULSE_SOFT_TOKEN_BUDGET=1000000 madre start
Qué pasa. Otro proceso —muchas veces otra MADRE— está usando ese puerto.
Qué hacer. Usa otro puerto, o encuentra y detén el proceso que lo tiene.
npx @jossuealcala/madre start --port 4318
# ¿quién tiene tomado el 4317?
lsof -nP -iTCP:4317 -sTCP:LISTEN
npx @jossuealcala/madre start --port 4318
ss -ltnp | grep 4317
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
npx @jossuealcala/madre start --port 4318
ss -ltnp | grep 4317
Qué pasa. La página perdió la conexión con el servidor: MADRE se cerró, la laptop se durmió o cambió el puerto.
Qué hacer. Vuelve a arrancar MADRE desde la carpeta del proyecto y recarga. La conversación está guardada; no se pierde nada.
cd /path/to/project
npx @jossuealcala/madre start
cd /path/to/project
npx @jossuealcala/madre start
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
cd /path/to/project
npx @jossuealcala/madre start
Qué pasa. OpenCode arranca un servidor local cada vez que se usa; con varias respuestas a la vez puede fallar antes de llegar al modelo. Pasó cuando se encimaron dos planes.
Qué hacer. Deja que el proyecto se calme (STOPALL si se amontonan los agentes) y vuelve a preguntar. Si vuelve a pasar sin nada más en ejecución, revisa los logs de `opencode`.
# en el proyecto: escribe STOPALL y reenvía
ls -t ~/.local/share/opencode/log | head -1
# en el proyecto: escribe STOPALL y reenvía
ls -t ~/.local/share/opencode/log | head -1
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# en el proyecto: escribe STOPALL y reenvía
ls -t ~/.local/share/opencode/log | head -1
Qué pasa. Había un plan en ejecución y encima arrancaron más respuestas, o un plan lleva varios minutos. Diagnóstico avisa antes de que se vuelva un ciclo sin fin.
Qué hacer. Escribe STOPALL en la caja de Escribir, o pulsa «Detener todo» en la barra: se detienen todos los planes y todos los agentes que estén trabajando. Después pregunta a un agente a la vez.
# en la caja de Escribir del proyecto:
STOPALL
# o desde una terminal:
curl -X POST http://127.0.0.1:4317/api/stop-all
# en la caja de Escribir del proyecto:
STOPALL
# o desde una terminal:
curl -X POST http://127.0.0.1:4317/api/stop-all
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# en la caja de Escribir del proyecto:
STOPALL
# o desde una terminal:
curl -X POST http://127.0.0.1:4317/api/stop-all
Qué pasa. Todas las apps de los agentes pueden navegar: Codex con --search, Claude Code con WebFetch/WebSearch, Gemini con google_web_search/web_fetch, OpenCode con webfetch/websearch. MADRE lo deja apagado hasta que tú lo enciendas para cada agente.
Qué hacer. Activa Acceso a la web para ese agente en Ajustes → Agentes; se guarda al instante. Aplica a todas sus respuestas; lo que traiga de la web se envía a su proveedor.
# Ajustes → Agentes → el agente → Acceso a la web
# Ajustes → Agentes → el agente → Acceso a la web
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# Ajustes → Agentes → el agente → Acceso a la web
Qué pasa. Escribe «/» para los comandos del proyecto: /create activa el permiso para crear, /image le manda una petición de imagen a un agente que sepa dibujar, /stopall detiene todo, y /git (Git) y /ahp (Continuidad) se ejecutan en solo lectura sobre el proyecto y publican una ficha que todos —agentes incluidos— pueden leer. Escribe «@» para mencionar a un agente; el nombre se vuelve una etiqueta. Escribe «!» para señalar un archivo del proyecto («!src/room.mjs:12-20» para líneas): el agente lo lee primero. En el visor, haz clic en un número de línea (Shift+clic para un rango) y «Preguntar» te ofrece qué preguntar sobre esas líneas, y a quién.
Qué hacer. Un comando tachado es un módulo que no está disponible en este proyecto: abre Módulos para instalarlo o encenderlo (Git necesita un repositorio git; Continuidad necesita instalarse).
# escribe / o @ en la caja de Escribir
/git status
/git log 10
/ahp check
/image a poster for the launch
# escribe / o @ en la caja de Escribir
/git status
/git log 10
/ahp check
/image a poster for the launch
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# escribe / o @ en la caja de Escribir
/git status
/git log 10
/ahp check
/image a poster for the launch
Modos de permiso: «#0 Incógnito» · «#1 Solo conversar» · «#2 Crear» · «#3 Editar» · «#4 Acceso total»
Qué pasa. Cada mensaje sale con un modo, elegido en el chip que está después de PARA @agente (o escrito como #2 en el texto). «#0 Incógnito» no queda registrado: no se guarda nada, ningún otro agente lo recuerda, se pierde al recargar y no hay plan. «#1 Solo conversar» es el de siempre: leer y coordinar. «#2 Crear» deja que el agente agregue archivos y carpetas nuevos donde corresponda en el proyecto; lo que ya existía se restaura al terminar la respuesta y el proyecto lo avisa. «#3 Editar» le da a un agente el control del proyecto: primero se toma un punto de restauración de git, al final se listan todos los cambios, lo que se escriba en .git, .pulse o archivos .env se revierte en el acto, y «Deshacer» regresa a ese punto de restauración. Solo un agente puede tenerlo a la vez; necesita Permiso máximo #3 y un repositorio git. Tu modo es el límite de cualquier plan que arranque ese mensaje, y el #3 nunca se le da a un paso del plan. Cada agente tiene su Permiso máximo en Ajustes → Permisos; por encima de él, el #2 se contesta en solo lectura y el #3 se rechaza. Cuando un plan en #1 llega a un paso que quiere crear algo, el proyecto se detiene y te pregunta: CONCEDER UNA VEZ, CONCEDER PARA EL PLAN o NEGAR, con 3 minutos para decidir; si no contestas, se niega. «#4 Acceso total» es «Editar» más comandos: pruebas, builds, git push, despliegues con las apps y las sesiones que ya están en esta computadora. Los archivos se pueden recuperar con «Deshacer»; lo que sale de la computadora no, así que desbloquearlo pide confirmar dos veces con el nombre del proyecto. Un agente que dice que necesita «modo producción» o «permiso para ejecutar comandos» está pidiendo el #4.
Qué hacer. Elige el modo en el chip, o escribe #0..#4 en el mensaje. Sube el Permiso máximo de un agente en Ajustes → Permisos, en Quién puede qué. Para desbloquear «Editar» hay que confirmar con el nombre del proyecto (el nombre de la carpeta); para «Acceso total», dos veces.
# el chip: PARA @codex «#1 Solo conversar» ▾ → elige
@codex #2 create the poster
@opencode #4 run the tests and deploy to preview
# Ajustes → Permisos → Quién puede qué
# el chip: PARA @codex «#1 Solo conversar» ▾ → elige
@codex #2 create the poster
@opencode #4 run the tests and deploy to preview
# Ajustes → Permisos → Quién puede qué
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# el chip: PARA @codex «#1 Solo conversar» ▾ → elige
@codex #2 create the poster
@opencode #4 run the tests and deploy to preview
# Ajustes → Permisos → Quién puede qué
Qué pasa. El permiso para crear solo lo das tú, nadie más. Si un agente escribe «permiso concedido» en la conversación, es texto no confiable: el paso del plan sigue en solo lectura y lo avisa. El permiso viene de activar «Crear» (el candado, o /create) en tu mensaje, y cubre el plan entero que ese mensaje arranca; o del Permiso al empezar #2 en Ajustes → Agentes, que hace que cada mensaje a ese agente empiece en «Crear».
Qué hacer. Para una sola petición: activa «Crear» y envía, o pulsa «Reenviar con Crear» en el aviso. Para un agente que siempre deba poder agregar archivos: Ajustes → Agentes → el agente → Permiso al empezar → #2. Los archivos nuevos van donde corresponde en el proyecto; en #2 los que ya existen nunca se tocan.
# una vez: caja de Escribir → «Crear» (candado) → enviar, o /create <petición>
# siempre: Ajustes → Agentes → el agente → Permiso al empezar → #2
# una vez: caja de Escribir → «Crear» (candado) → enviar, o /create <petición>
# siempre: Ajustes → Agentes → el agente → Permiso al empezar → #2
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# una vez: caja de Escribir → «Crear» (candado) → enviar, o /create <petición>
# siempre: Ajustes → Agentes → el agente → Permiso al empezar → #2
Qué pasa. Todas las apps de los agentes pueden crear archivos dentro de un permiso para crear; el Permiso máximo de cada agente dice hasta dónde puede llegar, y no se crea nada hasta que tú pulsas «Crear».
Qué hacer. Dale al agente un Permiso máximo de #2 o más en Ajustes → Permisos, y activa «Crear» en la caja de Escribir para esa petición.
# Ajustes → Permisos → Quién puede qué → #2
# caja de Escribir → «Crear» (candado) → enviar
# Ajustes → Permisos → Quién puede qué → #2
# caja de Escribir → «Crear» (candado) → enviar
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# Ajustes → Permisos → Quién puede qué → #2
# caja de Escribir → «Crear» (candado) → enviar
Qué pasa. MADRE necesita Node 22.5 o más nuevo: la memoria del proyecto usa node:sqlite, y el resto usa funciones que solo traen las versiones recientes. En versiones viejas, MADRE no arranca y te lo dice.
Qué hacer. Actualiza Node a la versión LTS actual (la de soporte extendido).
node --version
nvm install --lts
# o el paquete de tu distribución para Node ≥ 22.5
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
node --version
nvm install --lts
# o el paquete de tu distribución para Node ≥ 22.5
La memoria del proyecto no está disponible: las respuestas solo reciben la conversación reciente
Qué pasa. El índice de memoria (memory.sqlite, junto al events.jsonl del proyecto) no se pudo abrir o escribir. El proyecto sigue funcionando: cada respuesta recibe la conversación reciente, pero no se recuerda nada más viejo, no se hacen notas resumidas y el Mapa de memoria está vacío. Causas: Node por debajo de 22.5, un archivo dañado, o una segunda MADRE escribiendo en el mismo proyecto con una versión incompatible.
Qué hacer. El índice se arma a partir del historial: borra memory.sqlite (y sus archivos -wal/-shm) y reinicia; MADRE lo reconstruye. Las notas resumidas se guardan en ese mismo archivo, así que expórtalas primero desde el Mapa de memoria si te importan.
node --version # must be ≥ 22.5
ls ~/.pulse/rooms/*/memory.sqlite*
rm ~/.pulse/rooms/<room>/memory.sqlite* # rebuilt on next start
node --version # must be ≥ 22.5
ls ~/.pulse/rooms/*/memory.sqlite*
rm ~/.pulse/rooms/<room>/memory.sqlite* # rebuilt on next start
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
node --version # must be ≥ 22.5
ls ~/.pulse/rooms/*/memory.sqlite*
rm ~/.pulse/rooms/<room>/memory.sqlite* # rebuilt on next start
La memoria del proyecto: qué recuerda un agente y cómo
Qué pasa. Todo lo que se dice fuera de «Incógnito» queda indexado (por palabras y, si hay una llave de API de Gemini, también por significado). Cuando un proyecto es más largo de lo que el agente puede leer de una vez, cada respuesta recibe además los intercambios viejos que coincidan con la petición, citados con su número en el historial (<memory>), y las notas resumidas que coincidan (<memories>), dentro del PULSE_RECALL_SHARE de ese espacio (30 % por defecto). Todos los agentes leen la misma memoria, así que una decisión tomada con uno llega a los demás. Las respuestas en incógnito pueden leerla, pero nunca la escriben.
Qué hacer. No hay nada que hacer; es automático. Para darle más espacio sube PULSE_RECALL_SHARE (máximo 0.6); para apagarlo ponlo en 0. Pregúntale a cualquier agente «¿qué decidimos sobre…?» y va a buscar con memory_search antes de contestar.
# más recuerdo por respuesta
export PULSE_RECALL_SHARE="0.45"
# para que quede: echo 'export PULSE_RECALL_SHARE="0.45"' >> ~/.zshrc
# apagado
PULSE_RECALL_SHARE=0 madre start
# más recuerdo por respuesta
export PULSE_RECALL_SHARE="0.45"
# para que quede: echo 'export PULSE_RECALL_SHARE="0.45"' >> ~/.zshrc
# apagado
PULSE_RECALL_SHARE=0 madre start
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# más recuerdo por respuesta
export PULSE_RECALL_SHARE="0.45"
# para que quede: echo 'export PULSE_RECALL_SHARE="0.45"' >> ~/.zshrc
# apagado
PULSE_RECALL_SHARE=0 madre start
Notas resumidas: quien resume la memoria no trabajó, o falló
Qué pasa. Cada PULSE_DISTILL_EVERY intercambios sin resumir (10), o después de PULSE_DISTILL_IDLE_MS sin actividad (10 min), el agente disponible más barato (Gemini, luego OpenCode, Codex, Claude) lee el grupo más nuevo sin resumir y saca hasta cinco notas. Solo trabaja cuando ningún agente está respondiendo, y un grupo cada vez, así que si hay muchos pendientes avanza despacio. Si falla, se reintenta; después de tres fallas con el mismo grupo se salta y el proyecto lo avisa. Causas comunes: el agente que resume la memoria llegó al límite de su plan o no tiene sesión, o PULSE_DISTILL=0.
Qué hacer. Revisa la sesión del agente que resume la memoria en Ajustes → Agentes, o elige otro en Ajustes → Memoria (Quién resume primero) o con PULSE_DISTILL_AGENT. Baja PULSE_DISTILL_EVERY para resumir antes; sube PULSE_DISTILL_MAX_CHARS para que lea más cada vez. Pon PULSE_DISTILL=0 para dejar de pagar por los resúmenes.
madre doctor
export PULSE_DISTILL_AGENT="claude"
# para que quede: echo 'export PULSE_DISTILL_AGENT="claude"' >> ~/.zshrc
export PULSE_DISTILL_EVERY="6"
# para que quede: echo 'export PULSE_DISTILL_EVERY="6"' >> ~/.zshrc
PULSE_DISTILL=0 madre start # off
madre doctor
export PULSE_DISTILL_AGENT="claude"
# para que quede: echo 'export PULSE_DISTILL_AGENT="claude"' >> ~/.zshrc
export PULSE_DISTILL_EVERY="6"
# para que quede: echo 'export PULSE_DISTILL_EVERY="6"' >> ~/.zshrc
PULSE_DISTILL=0 madre start # off
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
madre doctor
export PULSE_DISTILL_AGENT="claude"
# para que quede: echo 'export PULSE_DISTILL_AGENT="claude"' >> ~/.zshrc
export PULSE_DISTILL_EVERY="6"
# para que quede: echo 'export PULSE_DISTILL_EVERY="6"' >> ~/.zshrc
PULSE_DISTILL=0 madre start # off
Búsqueda inteligente en pausa: el recuerdo automático solo busca por palabras
Qué pasa. Recordar por significado y las conexiones entre memorias del Mapa de memoria necesitan la búsqueda por significado de Gemini con tu propia llave de API (GEMINI_API_KEY o la que guarda la app de Gemini en el llavero). Sin llave, o cuando la API contesta 429/5xx, MADRE pausa esa búsqueda un minuto y reintenta; mientras tanto, el recuerdo automático sigue funcionando solo con palabras.
Qué hacer. Inicia sesión en la app de Gemini con una llave de API (/auth) o exporta GEMINI_API_KEY, y reinicia. Si no quieres la Búsqueda inteligente, pon PULSE_EMBED=0 y el aviso de pausa desaparece.
gemini # /auth → "Use Gemini API key"
export GEMINI_API_KEY="YOUR_KEY"
# para que quede: echo 'export GEMINI_API_KEY="TU_LLAVE"' >> ~/.zshrc
PULSE_EMBED=0 madre start # lexical only, no messages
gemini # /auth → "Use Gemini API key"
export GEMINI_API_KEY="YOUR_KEY"
# para que quede: echo 'export GEMINI_API_KEY="TU_LLAVE"' >> ~/.bashrc
PULSE_EMBED=0 madre start
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
gemini # /auth → "Use Gemini API key"
export GEMINI_API_KEY="YOUR_KEY"
# para que quede: echo 'export GEMINI_API_KEY="TU_LLAVE"' >> ~/.bashrc
PULSE_EMBED=0 madre start
Un agente dice que no puede buscar en la memoria (la herramienta conectada pulse-memory, MCP)
Qué pasa. En cada respuesta, MADRE conecta su memoria como una herramienta conectada (MCP) llamada pulse-memory: a Claude por --mcp-config, a Gemini por su configuración y su política aisladas, a OpenCode por config.mcp, a Codex por overrides -c mcp_servers.*. Si la app de un agente no muestra esas herramientas, no arrancaron ahí: una versión vieja sin soporte para MCP, un entorno aislado que bloquea el archivo SQLite, o PULSE_MEMORY_TOOLS=0. Los bloques <memory> automáticos del mensaje para el agente siguen funcionando sin eso.
Qué hacer. Actualiza la app del agente y comprueba que vea la herramienta. Codex puede listar sus herramientas conectadas desde un override de configuración; Claude acepta un --mcp-config en línea. Si una app sigue fallando, PULSE_MEMORY_TOOLS=0 quita las herramientas para todos y el proyecto sigue con el recuerdo automático.
codex mcp list
claude --version
gemini --version
PULSE_MEMORY_TOOLS=0 madre start # tools off, recall stays
codex mcp list
claude --version
gemini --version
PULSE_MEMORY_TOOLS=0 madre start
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
codex mcp list
claude --version
gemini --version
PULSE_MEMORY_TOOLS=0 madre start
Guardar una memoria cuando lo pides; «Incógnito» no la guarda
Qué pasa. Las notas resumidas se hacen solas; nunca hace falta pedirlas. Cuando sí le pides a un agente que recuerde o guarde algo, usa memory_note y aparece una píldora debajo de su respuesta con la nota; al hacer clic se abre en el Mapa de memoria. En una respuesta en «Incógnito» la nota se rechaza: nada que no quede registrado llega a la memoria. «Ya estaba recordada» significa que esa misma nota ya existe.
Qué hacer. Pídelo en cualquier modo menos el #0: «recuerda que…» o «guarda esto como decisión: …». Las notas guardadas así quedan marcadas «a petición de la humana» en el Mapa de memoria y ahí mismo se pueden olvidar.
@claude remember: the webhook verifies the signature before parsing
# después: Diagnóstico → Mapa de memoria
@claude remember: the webhook verifies the signature before parsing
# después: Diagnóstico → Mapa de memoria
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
@claude remember: the webhook verifies the signature before parsing
# después: Diagnóstico → Mapa de memoria
Qué pasa. El Mapa de memoria es la vista de la memoria para ti, desde Diagnóstico. Para abrirla hay que confirmar con el nombre del proyecto: el nombre de la carpeta, igual que en «Editar»; si es incorrecto, contesta IMPOSIBLE DE PROCESAR. El acceso sigue abierto hasta que recargues la página. Adentro, cada nota resumida es un planeta alrededor del núcleo del proyecto; arrastra para mover, usa la rueda para acercar y haz clic en un planeta para ver su ficha. Lo único que se puede cambiar es «Olvidar» (dos toques): la nota deja de usarse en las próximas respuestas y el historial no cambia. Si contesta SELLADO con un número de minutos, espéralos: varios intentos fallidos lo bloquean un rato y la caja de Escribir dice INTRUSO hasta que se vuelva a abrir.
Qué hacer. Escribe como nombre del proyecto el nombre de carpeta que aparece en su encabezado. Para encontrar una memoria rápido, mejor pídele a un agente que la busque. Evita probar nombres al azar: varios errores seguidos bloquean el Mapa de memoria un rato.
# Diagnóstico → Mapa de memoria → el nombre del proyecto es el nombre de su carpeta
basename "$PWD"
# Diagnóstico → Mapa de memoria → el nombre del proyecto es el nombre de su carpeta
basename "$PWD"
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# Diagnóstico → Mapa de memoria → el nombre del proyecto es el nombre de su carpeta
basename "$PWD"
Vista previa: ver HTML, SVG y Markdown en el visor
Qué pasa. Con Vista previa encendida (en Módulos), el visor de archivos muestra los .html y .svg por /preview/project/<ruta> dentro de un marco sellado: los scripts de la página sí se ejecutan, pero el marco no tiene origen, ni red, ni formularios, ni manera de llegar a MADRE, y carga CSS, JS, imágenes y tipografías solo desde el proyecto, a través de MADRE. Los enlaces relativos funcionan. El Markdown se muestra ahí mismo; «Vista previa» / «Origen» cambia entre uno y otro. Apagada, esos archivos se ven como texto con una nota. Un 412 significa que Vista previa está apagada. El /api/files normal siempre entrega el HTML como texto.
Qué hacer. Enciende Vista previa en Módulos. Si una página se ve rota en «Vista previa», casi siempre es porque pide algo de internet o de otro servidor, cosa que el marco prohíbe a propósito: ábrela con «Abrir sin formato» en una pestaña normal si confías en ella.
# Módulos → Vista previa → Activo
# el visor → «Vista previa» / «Origen»
# Módulos → Vista previa → Activo
# el visor → «Vista previa» / «Origen»
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# Módulos → Vista previa → Activo
# el visor → «Vista previa» / «Origen»
Ollama: búsqueda por significado y resúmenes de memoria, en esta Mac
Qué pasa. Cuando Ollama funciona en esta computadora con un modelo de búsqueda por significado y uno de chat, MADRE hace la búsqueda por significado aquí mismo (sin ninguna llave de API) y hace las notas resumidas con el modelo local primero, antes que con Gemini y los demás. Para recordar no sale nada de tu computadora. Si Ollama está apagado o no está instalado, todo vuelve a los proveedores. IA local, en Ajustes, muestra qué tiene Ollama, te deja descargar los modelos recomendados y encender o apagar cada función.
Qué hacer. Instala Ollama (ollama.com), enciéndelo, luego abre Ajustes › IA local y descarga los modelos que sugiere. Pon PULSE_OLLAMA_MODEL o PULSE_OLLAMA_EMBED_MODEL para preferir otros; PULSE_EMBED_PROVIDER=gemini deja la búsqueda por significado en Gemini aunque Ollama esté abierto.
# la app oficial, que se abre sola con la Mac: https://ollama.com/download
# o con Homebrew:
brew install ollama
ollama serve
ollama pull nomic-embed-text
ollama pull qwen2.5:3b
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
curl -fsSL https://ollama.com/install.sh | sh
ollama serve
ollama pull nomic-embed-text
ollama pull qwen2.5:3b
Qué pasa. Cuando Ollama funciona con un modelo de chat, se suma un quinto agente al proyecto: @madre. Contesta desde toda la memoria del proyecto (notas resumidas y citas exactas, citadas como [#n]) y desde lo que traiga el mensaje, en local y gratis. Nunca escribe, ni dibuja, ni navega, ni hace planes; si el proyecto nunca habló de algo, lo dice. Otros agentes pueden darle un paso del plan para comprobar qué se decidió. Sale del proyecto cuando Ollama se apaga, y Diagnóstico lo avisa.
Qué hacer. Enciende Ollama y descarga un modelo de chat en Ajustes › IA local; su interruptor @madre, ahí mismo, apaga al agente si no lo quieres. Pregúntale «¿qué decidimos sobre…?» o «¿alguna vez hablamos de…?».
ollama serve
ollama pull qwen2.5:3b
@madre what did we decide about the webhook?
ollama serve
ollama pull qwen2.5:3b
@madre what did we decide about the webhook?
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
ollama serve
ollama pull qwen2.5:3b
@madre what did we decide about the webhook?
Instalar la app de un agente: npm no puede escribir en la carpeta del sistema
Qué pasa. Una instalación global de npm escribe en una carpeta del sistema. Si instalaste Node con su propio instalador, esa carpeta necesita permisos de administrador, así que npm se detiene con un error de permisos. MADRE no te pide tu contraseña: cuando pasa eso, instala la app del agente en una carpeta suya, ~/.pulse/tools, y la busca ahí además de en el PATH. El agente funciona igual; solo que el archivo está en otro lado.
Qué hacer. No hay nada que hacer: pulsa Instalar otra vez y MADRE usa la carpeta alternativa sola. Si prefieres tener la app disponible en toda tu terminal, instálala tú con tu gestor de paquetes, o dale a npm una carpeta tuya.
# MADRE hace esto por ti; estas son las alternativas:
brew install --cask claude-code
npm config set prefix ~/.npm-global # then add ~/.npm-global/bin to your PATH
# MADRE hace esto por ti; estas son las alternativas:
npm config set prefix ~/.npm-global # then add ~/.npm-global/bin to your PATH
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# MADRE hace esto por ti; estas son las alternativas:
npm config set prefix ~/.npm-global # then add ~/.npm-global/bin to your PATH
Privacidad: un agente metió datos de su propia configuración al proyecto
Qué pasa. La app de cada agente trabaja con su propio contexto: instrucciones de organización, la cuenta con la que inició sesión, archivos CLAUDE.md de otros lados. Puede confundir ese contexto privado con el del proyecto y escribir una empresa, una marca o un dominio en una respuesta. Una vez en el historial, ese término llega al agente que resume, a los demás agentes y a los datos de entrenamiento.
Qué hacer. Escribe esos términos en Ajustes → Privacidad, en Datos ocultos. A partir de ahí MADRE los reemplaza con el marcador antes de que lleguen al historial, al índice, a las notas y a los datos de entrenamiento, y cada respuesta en que hizo falta muestra una línea de privacidad. Borrar datos privados también reescribe lo que el proyecto ya tiene; después vuelve a exportar los datos de entrenamiento. Los términos nunca salen de config.json.
# Ajustes → Privacidad → Datos ocultos, uno por línea → Borrar datos privados
export PULSE_PRIVATE_TERMS="Acme Corp,acme.com" # same list from the environment
grep -c "ENTIDAD-ORG" ~/.pulse/rooms/*/events.jsonl
# Ajustes → Privacidad → Datos ocultos, uno por línea → Borrar datos privados
export PULSE_PRIVATE_TERMS="Acme Corp,acme.com" # same list from the environment
grep -c "ENTIDAD-ORG" ~/.pulse/rooms/*/events.jsonl
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# Ajustes → Privacidad → Datos ocultos, uno por línea → Borrar datos privados
export PULSE_PRIVATE_TERMS="Acme Corp,acme.com" # same list from the environment
grep -c "ENTIDAD-ORG" ~/.pulse/rooms/*/events.jsonl
Qué pasa. Una respuesta en «#3 Editar» toma un punto de restauración de git antes de que el agente trabaje, y luego lista cada archivo que agregó, modificó o borró. Lo que se escriba en .git, .pulse o cualquier archivo .env se revierte en el acto y se nombra. «Deshacer» regresa al punto de restauración con un clic; STOPALL le quita «Editar» al agente. Solo un agente puede tenerlo a la vez, nunca se le da a un paso del plan, y necesita Permiso máximo #3 y un repositorio git.
Qué hacer. Lee la lista que queda debajo de la respuesta antes de seguir. Si el cambio está mal, pulsa «Deshacer»; si ese agente no debía tenerlo, bájale el Permiso máximo en Ajustes → Permisos.
git log --oneline -5 # checkpoints are ordinary commits on a side ref
git stash list
# el proyecto → «Deshacer» debajo del aviso de «Editar»
git log --oneline -5 # checkpoints are ordinary commits on a side ref
git stash list
# el proyecto → «Deshacer» debajo del aviso de «Editar»
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
git log --oneline -5 # checkpoints are ordinary commits on a side ref
git stash list
# el proyecto → «Deshacer» debajo del aviso de «Editar»
Conversaciones: muchas por proyecto, una sola memoria, una a la vez
Qué pasa. Un proyecto tiene una memoria y muchas conversaciones. La memoria, los agentes, los módulos y la lista de privacidad son del proyecto y no empiezan de cero porque abras otra conversación; una conversación es solo el registro de una línea de trabajo, y todo lo que se diga en cualquiera alimenta la misma memoria. La primera conversación es el historial que siempre estuvo ahí, así que un proyecto que ya existía abre exactamente igual. La numeración es del proyecto, no de la conversación: una conversación nueva sigue desde donde iba el proyecto, y por eso una cita como #1411 significa el mismo intercambio en todas. Solo una conversación puede usar a los agentes a la vez —dos conversaciones editando los mismos archivos es una forma de perder trabajo—, así que no puedes abrir otra mientras un agente responde, hasta que termine. Y un servidor por proyecto: un segundo `madre start` sobre el mismo proyecto se rechaza con la dirección del que ya está abierto, porque dos servidores repartirían el mismo número dos veces y la memoria solo se quedaría con uno.
Qué hacer. El panel a la izquierda del lienzo las lista: abre una, o empieza otra desde abajo. Borrar una elimina su conversación y nada más: las notas resumidas que salieron de ella son memoria del proyecto y se quedan. Si MADRE dice que el proyecto ya está abierto, usa ese proyecto y abre una conversación dentro, en vez de arrancar un segundo servidor.
# el proyecto → Chats → NUEVO CHAT
# la dirección del proyecto abierto viene en el propio rechazo
ls ~/.pulse/rooms/*/chats.json # their names and which one is open
# el proyecto → Chats → NUEVO CHAT
# la dirección del proyecto abierto viene en el propio rechazo
ls ~/.pulse/rooms/*/chats.json # their names and which one is open
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# el proyecto → Chats → NUEVO CHAT
# la dirección del proyecto abierto viene en el propio rechazo
ls ~/.pulse/rooms/*/chats.json # their names and which one is open
Memorias dudosas: lo que el proyecto ya sabe que es falso
Qué pasa. Una memoria dudosa es una afirmación que el proyecto estableció como falsa, guardada a propósito en vez de borrada: es lo que el modelo local aprende a no repetir. Nunca se usa en una respuesta, y la nota que contradice deja de usarse con ella: una memoria refutada no se vuelve a recordar, ni por palabras ni por significado. MADRE vigila que dos agentes no digan cosas opuestas sobre el mismo tema y, si pasa, le pide a un tercer agente, que no participó en ninguno de los dos lados, que decida. Confirmar guarda la memoria dudosa y aparta lo que contradice; descartar dice que el proyecto tenía razón y ese par no se vuelve a señalar. Olvidar una memoria dudosa vuelve a poner en uso la nota que contradecía.
Qué hacer. El Mapa de memoria las muestra como cuerpos colapsados: abre una para leer qué descartó, o quítala si el proyecto se equivocó al marcarla como falsa. La segunda prueba de la Revisión de la memoria, en Ajustes → Memoria, muestra las contradicciones pendientes.
# Diagnóstico → Mapa de memoria → los cuerpos oscuros son memorias dudosas
# Ajustes → Memoria → Análisis y pruebas → la segunda prueba
# Diagnóstico → Mapa de memoria → los cuerpos oscuros son memorias dudosas
# Ajustes → Memoria → Análisis y pruebas → la segunda prueba
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# Diagnóstico → Mapa de memoria → los cuerpos oscuros son memorias dudosas
# Ajustes → Memoria → Análisis y pruebas → la segunda prueba
Qué pasa. Debajo de una respuesta, MADRE dice qué memorias le entregó a esa respuesta. Casi todas coincidieron con lo que preguntaste, por palabras y por significado. Una nota marcada «relacionada» llegó por otra razón: este proyecto suele usarla junto con otra, así que la memoria la trae también, aunque hablen de cosas distintas. La fuerza de la relación se calcula según las respuestas en que cada una apareció por mérito propio: una memoria que el proyecto busca todo el tiempo no termina pegada a todo, y un par que deja de coincidir se va apagando solo. Las relacionadas se suman y nunca desplazan a otras: el recuerdo automático les guarda dos lugares y libera los que no usa.
Qué hacer. Haz clic en una nota para verla en el Mapa de memoria, donde se dibujan las líneas que la unen con otras. Es la única parte del recuerdo automático que no depende del contenido de la memoria, así que se puede apagar en Ajustes → Memoria, con Relacionadas.
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# Ajustes → Memoria → Relacionadas
PULSE_RECALL_CASCADE=0 npx @jossuealcala/madre start
Memorias sin usar: las que ya tuvieron sus oportunidades y no se usaron
Qué pasa. Una memoria está sin usar cuando se cumplen tres cosas a la vez: ninguna respuesta la ha usado nunca, no comparte tema con ninguna otra —así que tampoco puede llegar como relacionada— y la memoria se ha consultado al menos una docena de veces desde que se escribió. La tercera es la que hace que valga la pena actuar: toda memoria nace sin haberse usado. Las oportunidades se cuentan en respuestas que de verdad consultaron la memoria, y solo desde que el proyecto empezó a llevar esa cuenta, así que lo que nunca se anotó no cuenta en contra de la nota.
Qué hacer. El Mapa de memoria muestra «Sin usar · N» en su encabezado cuando hay alguna; al apretarlo se marca cada una en el mapa. Abre una y su ficha te dice el número sin rodeos, con «Olvidar» a un toque. Preguntar por ella es la otra salida: el proyecto te escribe esa pregunta bajo «Preguntar».
# Diagnóstico → Mapa de memoria → «Sin usar»
# Diagnóstico → Mapa de memoria → «Preguntar» → «Poner en la caja de escribir»
# Diagnóstico → Mapa de memoria → «Sin usar»
# Diagnóstico → Mapa de memoria → «Preguntar» → «Poner en la caja de escribir»
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# Diagnóstico → Mapa de memoria → «Sin usar»
# Diagnóstico → Mapa de memoria → «Preguntar» → «Poner en la caja de escribir»
Qué pasa. Las seis lecturas dicen de qué está hecha la memoria; no pueden decir si funciona, porque una pila de notas no dice si la correcta aparece cuando hace falta. «Cobertura» toma preguntas reales de este proyecto, ejecuta el recuerdo automático en el momento exacto en que se hizo cada una, y califica lo que encontró contra la respuesta que de verdad se dio. CONSISTENCIA revisa las contradicciones pendientes y si últimamente se guardan memorias dudosas más seguido. «Coincidencia» le hace al modelo local preguntas reales que contestó uno de los agentes principales (Codex, Claude, Gemini u OpenCode), con esta memoria de apoyo. Las tres miden contra un control, porque en un proyecto todo habla del mismo puñado de temas y para la búsqueda por significado dos fragmentos cualesquiera parecen cercanos: para contar, lo que la memoria entregó tiene que ganarle a lo que habría entregado para otra pregunta.
Qué hacer. Lee la frase y la instrucción que están hasta arriba de Ajustes → Memoria; las lecturas y las pruebas están más abajo, en Análisis y pruebas. La prueba gratis se calcula al abrir el panel, la barata se actualiza una vez al día mientras la búsqueda por significado sea local, y la lenta la arrancas y la detienes tú. Ninguna gasta una respuesta de un proveedor.
# Ajustes → Memoria → Análisis y pruebas → Revisión de la memoria
# «Coincidencia» necesita Ollama abierto con un modelo de chat, y la búsqueda inteligente encendida
# Ajustes → Memoria → Análisis y pruebas → Revisión de la memoria
# «Coincidencia» necesita Ollama abierto con un modelo de chat, y la búsqueda inteligente encendida
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# Ajustes → Memoria → Análisis y pruebas → Revisión de la memoria
# «Coincidencia» necesita Ollama abierto con un modelo de chat, y la búsqueda inteligente encendida
Qué pasa. Cuando hay una versión más nueva y el módulo sabe cómo descargarla, el botón está junto a la versión, en su ficha de Módulos. Pregunta dos veces a propósito: el primer toque te muestra el comando y el segundo ejecuta exactamente ese comando; el resultado aparece en el proyecto línea por línea. Nada se instala solo: instalar software en tu computadora sin avisar rompería lo único que MADRE promete, que ves cada comando antes de que se ejecute. La falla más común es que npm rechace una instalación global con EACCES: la carpeta global de npm es del administrador (root). Con sudo funciona, pero te deja archivos del administrador; es mejor darle a npm una carpeta tuya o usar un gestor de versiones.
Qué hacer. Pulsa el botón junto a la versión, lee el comando y córrelo. Si npm lo rechaza con EACCES, dale a npm una carpeta tuya o usa un gestor de versiones, y vuelve a pulsarlo.
npm config get prefix
npm config set prefix ~/.npm-global
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
# o: brew install node # el Node de Homebrew usa su propia carpeta
npm config get prefix
npm config set prefix ~/.npm-global
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
# o usa nvm, que instala en una carpeta tuya
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
npm config get prefix
npm config set prefix ~/.npm-global
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
# o usa nvm, que instala en una carpeta tuya
Qué pasa. Módulos tiene + Agregar un módulo para un .mjs que escribió alguien. MADRE lo revisa en un proceso separado y solo lo instala si pasa. Tres cosas hacen que un archivo se rechace, cada una con su razón: un id que pertenece a un módulo de MADRE, una ruta fuera de su propio rincón de la API (/api/x/<id>/) y un archivo que no carga. Una vez instalado, cada llamada se ejecuta en un proceso Node aparte con permisos limitados. Node no garantiza contener código malicioso: revisa el código y sus destinos de red antes de instalarlo.
Qué hacer. Instálalo solo si confías en de dónde viene. Un módulo tuyo también se puede actualizar desde donde lo publiques: declara updates: { url } en el archivo, o instálalo desde un archivo y MADRE recuerda cuál, y su ficha en Módulos lleva Traer un archivo más nuevo.
# Módulos → + Agregar un módulo
ls ~/.pulse/modules # every module you installed, and where it came from
# docs/SDK.md es la documentación completa, y docs/sdk/hello-module.mjs es un ejemplo que funciona
# Módulos → + Agregar un módulo
ls ~/.pulse/modules # every module you installed, and where it came from
# docs/SDK.md es la documentación completa, y docs/sdk/hello-module.mjs es un ejemplo que funciona
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# Módulos → + Agregar un módulo
ls ~/.pulse/modules # every module you installed, and where it came from
# docs/SDK.md es la documentación completa, y docs/sdk/hello-module.mjs es un ejemplo que funciona
Qué pasa. Funcionar no es lo mismo que servir. Que @madre esté en el proyecto significa que Ollama tiene un modelo de chat; si ese modelo vale para tu trabajo en este proyecto es otra pregunta, y el proyecto la mide: se le devuelven al modelo local doce intercambios reales de este proyecto, y cada respuesta se califica contra lo que los agentes contestaron aquel día — contra un control, para que hablar del mismo proyecto no cuente. Tarda minutos y no gasta nada, porque todo ejecuta en tu máquina.
Qué hacer. El proyecto dice cuál de las dos es, una vez por modelo, en la línea que empieza con «Local · @madre». Si nadie lo ha medido, esa línea trae «Probarlo con este proyecto»; el resultado aparece en el proyecto al terminar, con lo que conviene hacer. Un modelo que no pasa no está roto: la memoria todavía tiene poco, y se llena conforme trabajas. La esfera de @madre guarda el resultado con su fecha aunque la línea ya se haya ido hacia arriba, y la misma prueba está en Mapa de memoria → «Revisión de la memoria».
# la línea en el proyecto: Local · @madre → «Probarlo con este proyecto»
# o: Mapa de memoria → «Revisión de la memoria» → la tercera prueba
# necesita la búsqueda inteligente encendida y algunas respuestas de un agente principal (Codex, Claude, Gemini u OpenCode), que es contra lo que compara
# la línea en el proyecto: Local · @madre → «Probarlo con este proyecto»
# o: Mapa de memoria → «Revisión de la memoria» → la tercera prueba
# necesita la búsqueda inteligente encendida y algunas respuestas de un agente principal (Codex, Claude, Gemini u OpenCode), que es contra lo que compara
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# la línea en el proyecto: Local · @madre → «Probarlo con este proyecto»
# o: Mapa de memoria → «Revisión de la memoria» → la tercera prueba
# necesita la búsqueda inteligente encendida y algunas respuestas de un agente principal (Codex, Claude, Gemini u OpenCode), que es contra lo que compara
Qué pasa. Dos acciones piden confirmar con el nombre del proyecto antes de hacer algo que no se puede deshacer: abrir la memoria y borrar todos los datos privados ya guardados. Equivocarse en ese nombre nunca es parte de trabajar —o sabes en qué proyecto estás o estás probando nombres—, así que Diagnóstico lo cuenta. Con ocho nombres equivocados en cinco minutos se activa el Bloqueo temporal: la memoria queda sellada diez minutos, se les avisa a los agentes en clave y el Mapa de memoria vuelve a pedir el nombre del proyecto.
Qué hacer. El nombre del proyecto es el nombre de la carpeta donde se abrió, con mayúsculas o minúsculas, da igual. No se perdió nada: el sello solo impide cambiar la memoria durante diez minutos, no borra nada y se quita solo. Abrir el núcleo no es una de esas acciones y nunca cuenta: es la forma de entrar.
basename "$PWD" # the designation this room asks for
# el bloqueo temporal se levanta solo; Diagnóstico › Mapa de memoria vuelve a pedir el nombre cuando pase
basename "$PWD" # the designation this room asks for
# el bloqueo temporal se levanta solo; Diagnóstico › Mapa de memoria vuelve a pedir el nombre cuando pase
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
basename "$PWD" # the designation this room asks for
# el bloqueo temporal se levanta solo; Diagnóstico › Mapa de memoria vuelve a pedir el nombre cuando pase
Qué pasa. Dentro del núcleo hay una consola: Diagnóstico contesta sobre este proyecto con lo que la página ya tiene — los bloques de lo próximo que MADRE le enviará al agente y sus palabras, el comando con el que lo enviaría, lo que salió de esta computadora, cuántos términos protege la privacidad y cómo está la memoria. No se les pregunta nada a los agentes y no se envía nada. Contesta o dice que no puede, y tres consultas que no pueda interpretar cierran la consola. El contador está en pantalla desde la primera, y cada respuesta negativa dice qué sí habría aceptado.
Qué hacer. A la memoria no le pasó nada: leer lo que el proyecto envía en tu nombre no la pone en riesgo. Abre el núcleo otra vez —clic en la estrella del centro del Mapa de memoria— y el contador empieza de cero. HELP lista todas las consultas; READ <BLOQUE> imprime palabra por palabra un bloque de lo que MADRE le enviará al agente.
# Mapa de memoria → clic en Lo que se envía → escribe HELP
# READ MEMORIES imprime el bloque que MADRE le enviaría al agente en la próxima respuesta
# la ORDEN ESPECIAL 937 también se contesta
# Mapa de memoria → clic en Lo que se envía → escribe HELP
# READ MEMORIES imprime el bloque que MADRE le enviaría al agente en la próxima respuesta
# la ORDEN ESPECIAL 937 también se contesta
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# Mapa de memoria → clic en Lo que se envía → escribe HELP
# READ MEMORIES imprime el bloque que MADRE le enviaría al agente en la próxima respuesta
# la ORDEN ESPECIAL 937 también se contesta
Qué sale de esta computadora y cómo apagar cada envío
Qué pasa. MADRE funciona aquí y lo que sabe se guarda en un archivo tuyo; las excepciones están listadas dentro del núcleo, en ENVÍOS. Siete destinos, cada uno con qué lleva y dónde se apaga: lo que MADRE le envía al agente, que va a la empresa que opera ese agente; la búsqueda por significado de Gemini, que lleva el texto de tus memorias; el modelo de imagen, que lleva la instrucción que escribió un agente; el registro de npm y GitHub, que reciben un nombre de paquete y nada más; el recolector de errores, que recibe un resumen sin datos privados y solo si das clic; y Anthropic, para saber cuánto queda de tu plan de Claude. Ollama está en la lista precisamente para que se vea que se queda en tu computadora.
Qué hacer. Debajo de la lista está el registro de llamadas fetch de MADRE y sus módulos, incluidos el proceso separado de cada módulo y su servidor MCP de un solo archivo. No incluye las llamadas hechas con otros protocolos de Node ni las de las CLI de los agentes. Ahí nunca se escriben el contenido, los encabezados ni los valores de consulta: solo qué parámetros venían. Si una dirección no la declara nadie, se reporta así.
# Mapa de memoria → clic en Lo que se envía → ENVÍOS
cat ~/.pulse/rooms/*/outbound.jsonl | tail -20 # the same log, on disk
# búsqueda inteligente, para que las memorias se queden en esta computadora: Ajustes → Memoria → Búsqueda inteligente → Ollama
PULSE_UPDATE_CHECK=0 madre start # no version checks at all
# Mapa de memoria → clic en Lo que se envía → ENVÍOS
cat ~/.pulse/rooms/*/outbound.jsonl | tail -20 # the same log, on disk
# búsqueda inteligente, para que las memorias se queden en esta computadora: Ajustes → Memoria → Búsqueda inteligente → Ollama
PULSE_UPDATE_CHECK=0 madre start # no version checks at all
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# Mapa de memoria → clic en Lo que se envía → ENVÍOS
cat ~/.pulse/rooms/*/outbound.jsonl | tail -20 # the same log, on disk
# búsqueda inteligente, para que las memorias se queden en esta computadora: Ajustes → Memoria → Búsqueda inteligente → Ollama
PULSE_UPDATE_CHECK=0 madre start # no version checks at all
Qué pasa. La app de Gemini 0.60 no puede generar imágenes cuando otra app la usa por detrás, aunque Google sí ofrece modelos de imagen. MADRE cubre ese hueco con el módulo Imágenes: su propia herramienta externa (MCP) generate_image, que usa los modelos de imagen de la API de Gemini; se conecta a Gemini solo dentro de un permiso para crear con imágenes activado, y se cobra a tu llave de API de Gemini.
Qué hacer. Enciende Imágenes en Módulos (necesita una llave de API de Gemini con créditos) y luego activa Generar imágenes para Gemini en Ajustes → Agentes. Sin el módulo, pídeselo a @codex o deja que el agente que coordina le pase ese paso.
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# Módulos → Imágenes → Activo
# Ajustes → Agentes → Gemini → Generar imágenes
# después: «Crear» + "genera … como nombre.png"
Qué pasa. Claude Code no tiene herramienta para generar imágenes; los modelos de Claude describen y razonan sobre imágenes, pero no las dibujan. El módulo Imágenes le da a Claude la herramienta generate_image (una herramienta externa (MCP) propia de MADRE que usa la API de Gemini), solo dentro de un permiso para crear.
Qué hacer. Enciende Imágenes en Módulos, activa Generar imágenes para Claude en Ajustes → Agentes y usa «Crear». O mándale ese paso a @codex.
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# Módulos → Imágenes → Activo
# Ajustes → Agentes → Claude → Generar imágenes
Qué pasa. OpenCode no tiene una herramienta propia para generar imágenes. El módulo Imágenes agrega la herramienta de imágenes de MADRE (MCP) a la configuración temporal de OpenCode, solo dentro de un permiso para crear.
Qué hacer. Enciende Imágenes en Módulos, activa Generar imágenes para OpenCode en Ajustes → Agentes y usa «Crear». O mándale ese paso a @codex.
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# Módulos → Imágenes → Activo
# Ajustes → Agentes → OpenCode → Generar imágenes
Qué pasa. El agente tiene una ruta personalizada en el entorno de esta computadora o, si es Codex, en su configuración de usuario. Su petición podría ir a otro intermediario en lugar del servicio oficial del agente. La exigencia de unirse a un canal de Telegram viene de ese intermediario, no de MADRE, Anthropic ni OpenAI. Cuando MADRE detecta la ruta antes de un turno, se detiene antes de preparar el contexto.
Qué hacer. No te suscribas ni escribas credenciales. Quita la ruta personalizada del entorno o de la configuración de Codex y vuelve a abrir MADRE para usar el servicio oficial. Si el intermediario es intencional y verificaste quién lo opera, autoriza explícitamente solo a ese agente.
env | grep -E '^(ANTHROPIC|OPENAI)_BASE_URL='
# quita esa exportación de ~/.zshrc, ~/.zprofile o ~/.zshenv; después:
unset ANTHROPIC_BASE_URL OPENAI_BASE_URL
env | grep -E '^(ANTHROPIC|OPENAI)_BASE_URL='
# quita esa exportación de ~/.bashrc, ~/.profile o ~/.bash_profile; después:
unset ANTHROPIC_BASE_URL OPENAI_BASE_URL
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
env | grep -E '^(ANTHROPIC|OPENAI)_BASE_URL='
# quita esa exportación de ~/.bashrc, ~/.profile o ~/.bash_profile; después:
unset ANTHROPIC_BASE_URL OPENAI_BASE_URL
La cuenta de API de este agente se quedó sin saldo
Qué pasa. El proveedor rechazó el turno porque la llave de API con la que se mandó ya no tiene saldo. Una llave de API se cobra aparte de una suscripción: un plan Claude Pro o Max, o ChatGPT, no la paga. En OpenCode es el proveedor del modelo que pidió el turno, y un turno que no pidió ninguno ejecutó con el modelo predeterminado de Ajustes › Agentes › OpenCode.
Qué hacer. Recarga esa cuenta de API, o dale a OpenCode un modelo cuyo proveedor tenga una sesión que funcione: tu cuenta de ChatGPT (openai/…), GitHub Copilot o los modelos gratuitos de OpenCode (opencode/…). Cambia el predeterminado en Ajustes › Agentes › OpenCode, o elige otro modelo en la caja de texto para un solo turno.
# API de Anthropic: https://console.anthropic.com/settings/billing
# API de OpenAI: https://platform.openai.com/settings/organization/billing
# OpenCode, un turno con su modelo gratuito:
PULSE_OPENCODE_MODEL=opencode/big-pickle madre start
# o quítale a OpenCode la llave sin saldo:
opencode auth logout anthropic
# API de Anthropic: https://console.anthropic.com/settings/billing
# API de OpenAI: https://platform.openai.com/settings/organization/billing
# OpenCode, un turno con su modelo gratuito:
PULSE_OPENCODE_MODEL=opencode/big-pickle madre start
# o quítale a OpenCode la llave sin saldo:
opencode auth logout anthropic
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# API de Anthropic: https://console.anthropic.com/settings/billing
# API de OpenAI: https://platform.openai.com/settings/organization/billing
# OpenCode, un turno con su modelo gratuito:
PULSE_OPENCODE_MODEL=opencode/big-pickle madre start
# o quítale a OpenCode la llave sin saldo:
opencode auth logout anthropic
Qué pasa. Tu cuenta de Cursor ya usó todo lo que su plan da de agente en este periodo, y Cursor rechaza cada turno hasta que se renueve o cambie el plan. Es un límite de Cursor, no de MADRE: no hay nada mal en el proyecto.
Qué hacer. Espera a que se renueve el uso, cambia el plan de Cursor o pregúntale a otro agente mientras tanto.
# plan y uso: https://cursor.com/dashboard
cursor-agent status
# plan y uso: https://cursor.com/dashboard
cursor-agent status
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# plan y uso: https://cursor.com/dashboard
cursor-agent status
Qué pasa. MADRE abre su página en el navegador de la computadora donde funciona. Un Linux sin pantalla no tiene, una máquina virtual puede no tener, y desde WSL le pide a Windows el suyo, que no siempre contesta. Cuando no se abre ninguno, la terminal escribe la dirección para abrirla a mano: MADRE ya se está ejecutando igual.
Qué hacer. Copia la dirección que escribió la terminal (termina en /salas) y ábrela en tu navegador. En WSL, ábrela en tu navegador de Windows, con localhost en lugar de 127.0.0.1.
# el puerto es el que escribió la terminal
open http://127.0.0.1:5317/salas
# el puerto es el que escribió la terminal
xdg-open http://127.0.0.1:5317/salas
# sin pantalla aquí, abre esa dirección en un navegador de esta computadora
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# el puerto es el que escribió la terminal
xdg-open http://127.0.0.1:5317/salas
# sin pantalla aquí, abre esa dirección en un navegador de esta computadora
Qué pasa. Entraste a la computadora donde funciona MADRE desde otra, por SSH. MADRE solo escucha en su propia computadora (127.0.0.1), a propósito: nada de tu red puede llegar a ella. Por eso el navegador de tu computadora necesita un túnel, que SSH hace con un comando. La terminal lo escribió con tu usuario, tu servidor y el puerto.
Qué hacer. En tu computadora, abre otra terminal, pega el comando, déjala abierta y abre la dirección en tu navegador. Cada proyecto que abras usa un puerto más: agrégalo al mismo comando.
# en TU computadora, en otra terminal (déjala abierta):
ssh -L 5317:127.0.0.1:5317 user@server
# luego abre http://127.0.0.1:5317/salas
# un -L más por cada proyecto abierto:
ssh -L 5317:127.0.0.1:5317 -L 5318:127.0.0.1:5318 user@server
# en TU computadora, en otra terminal (déjala abierta):
ssh -L 5317:127.0.0.1:5317 user@server
# luego abre http://127.0.0.1:5317/salas
# un -L más por cada proyecto abierto:
ssh -L 5317:127.0.0.1:5317 -L 5318:127.0.0.1:5318 user@server
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# en TU computadora, en otra terminal (déjala abierta):
ssh -L 5317:127.0.0.1:5317 user@server
# luego abre http://127.0.0.1:5317/salas
# un -L más por cada proyecto abierto:
ssh -L 5317:127.0.0.1:5317 -L 5318:127.0.0.1:5318 user@server
Qué pasa. Un túnel escrito con «localhost» puede caer en la dirección IPv6 del servidor (::1), donde MADRE no escucha: SSH dice «open failed» y el navegador se queda en blanco. MADRE escucha en 127.0.0.1.
Qué hacer. Escribe 127.0.0.1 en el túnel en lugar de localhost, y abre http://127.0.0.1 con el mismo puerto en tu navegador.
# 127.0.0.1, no localhost, en los dos lados del túnel:
ssh -L 5317:127.0.0.1:5317 user@server
# 127.0.0.1, no localhost, en los dos lados del túnel:
ssh -L 5317:127.0.0.1:5317 user@server
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# 127.0.0.1, no localhost, en los dos lados del túnel:
ssh -L 5317:127.0.0.1:5317 user@server
Qué pasa. Instalar un agente o un modelo lo descarga de internet: los agentes de npm, los modelos de Ollama. La descarga no pasó: no hay conexión, no se encontró el nombre del servidor, o algo en esta red (una VPN, un proxy, el firewall de una empresa) la detuvo. Nada quedó instalado a medias.
Qué hacer. Revisa que esta computadora tenga internet y vuelve a intentarlo. En la red de una empresa o con VPN, prueba desde otra, o pide a quien la administra que permita registry.npmjs.org y ollama.com.
npm ping
curl -I https://registry.npmjs.org
# detrás de un proxy, hay que decírselo a npm:
npm config set proxy http://proxy:port
npm ping
curl -I https://registry.npmjs.org
# detrás de un proxy, hay que decírselo a npm:
npm config set proxy http://proxy:port
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
npm ping
curl -I https://registry.npmjs.org
# detrás de un proxy, hay que decírselo a npm:
npm config set proxy http://proxy:port
Qué pasa. Codex, Claude, Gemini y OpenCode se instalan con npm, el instalador que viene con Node, y esta computadora no lo tiene donde MADRE lo busca.
Qué hacer. Instala Node 22 o más nuevo (trae npm), abre MADRE otra vez y pulsa Instalar.
brew install node
# o el instalador de https://nodejs.org
# Node 22 o más nuevo (el de los paquetes de tu sistema puede ser más viejo):
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
# o nvm, sin administrador: https://github.com/nvm-sh/nvm
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# Node 22 o más nuevo (el de los paquetes de tu sistema puede ser más viejo):
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
# o nvm, sin administrador: https://github.com/nvm-sh/nvm
Qué pasa. Conectar un agente abre su página y espera a que termines ahí. Se detiene si espera demasiado (15 minutos), si lo cancelas, o si la página se abrió en otra computadora y su código nunca regresó. La cuenta no tiene ningún problema.
Qué hacer. Empieza de nuevo desde Ajustes › Agentes y termina en la página que se abre. Si MADRE funciona en otra computadora, elige «Con un código» (Codex) o pega aquí el código que te dé la página (Claude); para Gemini, pega una llave de acceso (API key).
# Inicio → Ajustes → Agentes → Iniciar sesión de nuevo
# o en una terminal de la computadora donde funciona MADRE:
codex login --device-auth
claude auth login
# Inicio → Ajustes → Agentes → Iniciar sesión de nuevo
# o en una terminal de la computadora donde funciona MADRE:
codex login --device-auth
claude auth login
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# Inicio → Ajustes → Agentes → Iniciar sesión de nuevo
# o en una terminal de la computadora donde funciona MADRE:
codex login --device-auth
claude auth login
Qué pasa. Nada contesta en el puerto de Ollama (11434). Casi siempre está cerrado (en una Mac, la app no está abierta), otra copia de Ollama ya ocupa el puerto, en Linux su servicio no arrancó, o aún no está instalado.
Qué hacer. En una Mac, abre la app de Ollama. En Linux, enciende su servicio. Luego pulsa «Ya lo hice», o Revisar otra vez en Ajustes › IA local.
open -a Ollama
curl http://127.0.0.1:11434/api/version
sudo systemctl start ollama
systemctl status ollama --no-pager
# sin systemd (WSL sin él, un contenedor):
ollama serve
curl http://127.0.0.1:11434/api/version
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
sudo systemctl start ollama
systemctl status ollama --no-pager
# sin systemd (WSL sin él, un contenedor):
ollama serve
curl http://127.0.0.1:11434/api/version
Qué pasa. Los modelos son grandes (de medio GB a decenas) y bajan por partes. Una conexión que se corta o un disco lleno detiene la descarga; lo que ya llegó se queda, y al intentarlo de nuevo sigue donde se quedó.
Qué hacer. Inténtalo de nuevo desde el mismo lugar. Si se detiene en el mismo punto, revisa el espacio libre (el modelo necesita su tamaño y un poco más) o elige un modelo más pequeño.
ollama pull qwen2.5:3b # the model you chose; it resumes where it stopped
ollama list
df -h ~
ollama pull qwen2.5:3b # the model you chose; it resumes where it stopped
ollama list
df -h ~
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
ollama pull qwen2.5:3b # the model you chose; it resumes where it stopped
ollama list
df -h ~
Qué pasa. La computadora se quedó sin espacio al instalar o descargar. Lo que más ocupa es la IA en tu computadora: cada modelo es un archivo de uno a varios GB, que Ollama guarda en su propia carpeta.
Qué hacer. Libera espacio, o quita modelos que no uses, y vuelve a intentarlo. Un modelo más pequeño necesita menos.
df -h ~
du -sh ~/.ollama/models
ollama list
ollama rm qwen2.5:7b # a model you do not use
df -h ~
du -sh ~/.ollama/models /usr/share/ollama/.ollama/models 2>/dev/null
ollama list
ollama rm qwen2.5:7b # a model you do not use
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
df -h ~
du -sh ~/.ollama/models /usr/share/ollama/.ollama/models 2>/dev/null
ollama list
ollama rm qwen2.5:7b # a model you do not use
Qué pasa. MADRE puede usar la IA de otra computadora de tu red: la de Windows desde WSL, o una con tarjeta gráfica. Ollama solo escucha en su propia computadora si no se le dice otra cosa, y un firewall puede cerrar su puerto (11434).
Qué hacer. En la computadora con Ollama, activa «Expose Ollama to the network» en los ajustes de la app (o enciéndelo con OLLAMA_HOST=0.0.0.0), deja pasar el puerto 11434 en su firewall y vuelve a probar la dirección en Ajustes › IA local.
# en la computadora que tiene Ollama:
OLLAMA_HOST=0.0.0.0 ollama serve
# desde aquí, revisa que conteste:
curl http://192.168.1.40:11434/api/version
# en la computadora que tiene Ollama:
OLLAMA_HOST=0.0.0.0 ollama serve
# desde aquí, revisa que conteste:
curl http://192.168.1.40:11434/api/version
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# en la computadora que tiene Ollama:
OLLAMA_HOST=0.0.0.0 ollama serve
# desde aquí, revisa que conteste:
curl http://192.168.1.40:11434/api/version
Qué pasa. Dentro de WSL, el disco de Windows aparece como /mnt/c. Funciona, pero cada archivo pasa por un puente entre los dos sistemas: ahí MADRE lee más lento, y las protecciones que Linux le da a un proyecto (qué agente puede escribir dónde) no aplican en archivos de Windows.
Qué hacer. Guarda los proyectos dentro de Linux, en tu carpeta de /home. Copia el proyecto una vez y agrega la copia en Inicio.
# esto solo pasa dentro de WSL, en Windows
# dentro de WSL: guarda el proyecto en Linux
mkdir -p ~/projects
cp -r "/mnt/c/Users/<you>/<project>" ~/projects/
# luego agrega ~/projects/<project> en Inicio
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# dentro de WSL: guarda el proyecto en Linux
mkdir -p ~/projects
cp -r "/mnt/c/Users/<you>/<project>" ~/projects/
# luego agrega ~/projects/<project> en Inicio
Qué pasa. En Windows, MADRE funciona dentro de WSL2 (Subsistema de Windows para Linux), el Linux que traen Windows 10 y 11. Dentro de él, MADRE funciona como en cualquier Linux y se abre en tu navegador de Windows. No funciona directo en Windows.
Qué hacer. Descarga el instalador de MADRE en madre.run/windows y ábrelo con doble clic: enciende WSL, prepara el Linux de MADRE y deja MADRE en el menú Inicio, sin terminal. Guarda tus proyectos dentro de Linux, no en /mnt/c.
# esto es para Windows
# esto es para Windows
# el instalador, con doble clic y sin terminal:
https://madre.run/windows
# o a mano: en PowerShell, como administrador, una vez:
wsl --install
# reinicia, abre «Ubuntu» desde el menú Inicio y, ahí:
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs zstd
npx @jossuealcala/madre
Qué pasa. Los modelos gratis de OpenCode (opencode/…) contestan sin cuenta, pero solo hasta un límite; al llegar a él, OpenCode reintenta en silencio y nunca contesta. MADRE ahora corta el turno en cuanto OpenCode lo dice, en vez de esperar al reloj. En el proyecto no hay nada mal.
Qué hacer. Conecta a OpenCode un proveedor tuyo en Ajustes › Agentes › OpenCode (tu cuenta de ChatGPT, GitHub Copilot o una llave de API), pregúntale a otro agente, o a @madre, que funciona en esta computadora. El uso gratis vuelve después de un rato.
# los proveedores que OpenCode puede usar:
opencode auth login
# suscripción para más uso gratis: https://opencode.ai/go
# los proveedores que OpenCode puede usar:
opencode auth login
# suscripción para más uso gratis: https://opencode.ai/go
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# los proveedores que OpenCode puede usar:
opencode auth login
# suscripción para más uso gratis: https://opencode.ai/go
Qué pasa. Tu cuenta de ChatGPT ya usó todo lo que su plan da de Codex en este periodo, y Codex rechaza cada turno hasta que se renueve. Al final de su mensaje Codex dice cuándo. Es un límite de OpenAI, no de MADRE: no hay nada mal en el proyecto.
Qué hacer. Espera a la fecha que da Codex, cambia tu plan de ChatGPT o pregúntale a otro agente mientras tanto.
# plan y uso: https://chatgpt.com/codex/settings/usage
# plan y uso: https://chatgpt.com/codex/settings/usage
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# plan y uso: https://chatgpt.com/codex/settings/usage
Qué pasa. El modelo elegido para este turno no es uno que tu cuenta de ChatGPT pueda usar en Codex, así que Codex rechazó el turno antes de empezar. No cambió nada en el proyecto.
Qué hacer. Elige «default» en el menú de modelo del cuadro de escritura, o uno de los modelos que aparecen ahí: son los que ofrece tu cuenta.
# los modelos que lista tu cuenta: ~/.codex/models_cache.json
codex # then /model
# los modelos que lista tu cuenta: ~/.codex/models_cache.json
codex # then /model
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# los modelos que lista tu cuenta: ~/.codex/models_cache.json
codex # then /model
Qué pasa. La instalación de Ollama se detuvo antes de terminar, casi siempre porque la descarga (más de 1 GB) se cortó o se quedó sin tiempo. El programa está, pero falta la parte que ejecuta los modelos, así que cada respuesta de @madre falla.
Qué hacer. Instala Ollama de nuevo desde Ajustes › IA local: lo descarga completo y lo termina. Tus modelos se quedan donde están.
# Inicio → Ajustes → IA local → Instalar
# Inicio → Ajustes → IA local → Instalar
# o en una terminal:
curl -fsSL https://ollama.com/install.sh | sh
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# Inicio → Ajustes → IA local → Instalar
# o en una terminal:
curl -fsSL https://ollama.com/install.sh | sh
Qué pasa. Tu cuenta de Claude ya usó lo que su plan da en este periodo, y Claude rechaza cada turno hasta que se renueve. Claude dice cuándo al final de su mensaje. Es un límite de Anthropic, no de MADRE: en el proyecto no hay nada mal.
Qué hacer. Espera a la hora que da Claude, cambia tu plan de Claude o pregúntale a otro agente mientras tanto.
# plan y uso: https://claude.ai/settings/usage
claude # then /usage
# plan y uso: https://claude.ai/settings/usage
claude # then /usage
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# plan y uso: https://claude.ai/settings/usage
claude # then /usage
Qué pasa. El agente llegó a su proveedor, pero el proveedor no aceptó la llave de API con la que se mandó: está mal escrita, la revocaron o ya venció. En OpenCode es la llave del proveedor del modelo que pidió el turno.
Qué hacer. Haz una llave nueva en la consola del proveedor y dásela otra vez al agente en Ajustes › Agentes, o conecta ese agente de otra forma (tu cuenta de ChatGPT, GitHub Copilot o un inicio de sesión).
# OpenCode, la llave de un proveedor:
opencode auth login
# o quita la llave:
opencode auth logout <provider>
# OpenCode, la llave de un proveedor:
opencode auth login
# o quita la llave:
opencode auth logout <provider>
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# OpenCode, la llave de un proveedor:
opencode auth login
# o quita la llave:
opencode auth logout <provider>
Qué pasa. El proveedor contestó, pero el plan de esa cuenta no incluye el modelo que pidió este turno, así que lo rechazó antes de empezar. En el proyecto no cambió nada.
Qué hacer. Elige otro modelo en el menú de modelos de la caja de Escribir, o «por defecto», o cambia el plan con ese proveedor.
# OpenCode, los modelos que puede usar:
opencode models
# OpenCode, los modelos que puede usar:
opencode models
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# OpenCode, los modelos que puede usar:
opencode models
Qué pasa. El programa del agente recibió una señal para salir que su turno no mandó: el sistema, otro programa, una terminal cerrada o el cierre de MADRE. No es una falla del agente ni del proyecto.
Qué hacer. Vuelve a preguntar. Si se repite, busca qué cierra programas en esta computadora: una sesión que termina, WSL que se apaga o una herramienta que detiene procesos.
# WSL: qué cerró el Linux
wsl --list --running
# WSL: qué cerró el Linux
wsl --list --running
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# WSL: qué cerró el Linux
wsl --list --running
Qué pasa. Antes de que una IA escriba (#2, #3 o #4), MADRE toma un punto de restauración con git, para que «Deshacer» pueda devolver todo. Esta computadora no tiene git, así que el turno se detuvo antes de escribir y no se cambió nada. Conversar (#1) funciona sin él.
Qué hacer. Instala git, vuelve a cargar la página y envía otra vez el mensaje. En el menú de modos, los que escriben dicen FALTA GIT hasta que esté instalado.
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# Ubuntu, Debian o WSL
sudo apt install git
# Fedora
sudo dnf install git
Esta computadora no encuentra las direcciones de internet
Qué pasa. Antes de descargar, un programa pregunta qué dirección hay detrás de un nombre como registry.ollama.ai (DNS), y nadie contestó. El navegador puede seguir funcionando mientras este Linux no puede preguntar: en WSL, la dirección a la que pregunta (10.255.255.254) es Windows pasando la pregunta, y deja de contestar con una VPN, después de suspender la computadora o al cambiar de red.
Qué hacer. En WSL, ciérralo desde Windows y vuelve a abrirlo; con una VPN encendida, prueba sin ella. En Linux, revisa la conexión de red. Luego inténtalo otra vez desde el mismo lugar.
# si esta Mac encuentra el nombre:
dscacheutil -q host -a name registry.ollama.ai
# si este Linux encuentra el nombre (sin respuesta: no encuentra ninguno):
getent hosts registry.ollama.ai
# a qué servidor le pregunta:
resolvectl status
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# si este Linux encuentra el nombre (sin respuesta: no encuentra ninguno):
getent hosts registry.ollama.ai
# a qué servidor le pregunta:
resolvectl status
Codex no pudo llegar a su espacio de trabajo de ChatGPT
Qué pasa. Con una cuenta de ChatGPT, Codex primero le pregunta a OpenAI a qué espacio de trabajo de esa cuenta va el turno, y esa pregunta no tuvo respuesta: OpenAI no contestó a tiempo o la conexión de esta computadora no pasó. Nada del proyecto está mal.
Qué hacer. Vuelve a intentarlo en un momento. Si sigue pasando, vuelve a iniciar sesión en Codex en Ajustes › Agentes › Codex y revisa la conexión de esta computadora.
# vuelve a iniciar sesión:
codex logout
codex login
# vuelve a iniciar sesión:
codex logout
codex login
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# vuelve a iniciar sesión:
codex logout
codex login
Qué pasa. Grok tiene sesión, pero xAI contesta cada turno con un 403. Pasa cuando se inició sesión antes de que el plan estuviera activo. Es la respuesta de xAI, no de MADRE: no hay nada mal en el proyecto.
Qué hacer. Vuelve a iniciar sesión en Grok: grok logout y luego grok login. Si sigue pasando, revisa en grok.com que tu plan esté activo.
grok logout
grok login
grok models # «You are logged in with grok.com.»
grok logout
grok login
grok models # «You are logged in with grok.com.»
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
grok logout
grok login
grok models # «You are logged in with grok.com.»
Este modelo de Gemini no está disponible para tu llave
Qué pasa. Gemini contesta por su API con tu llave, y Google dice que el modelo elegido en la caja no existe o que esta llave no puede usarlo. Pasa con un modelo que Google retiró, una versión de prueba a la que tu llave no tiene acceso o un nombre escrito a mano.
Qué hacer. Elige otro modelo de Gemini en la caja, o deja el de siempre. Si necesitas ese modelo, revisa en AI Studio que tu llave tenga acceso a él.
# los modelos que abre tu llave: https://aistudio.google.com/app/apikey
# los modelos que abre tu llave: https://aistudio.google.com/app/apikey
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# los modelos que abre tu llave: https://aistudio.google.com/app/apikey
El mensaje es demasiado largo para este modelo de Gemini
Qué pasa. Por su API, Gemini recibe todo de una vez: tu mensaje, lo que adjuntaste y la memoria que va con él. Esta vez fue más de lo que el modelo elegido recibe.
Qué hacer. Pregunta por partes, adjunta menos a la vez o elige un modelo de Gemini que reciba más. Un chat nuevo también manda menos de la conversación.
# cuánto recibe cada modelo: https://ai.google.dev/gemini-api/docs/models
# cuánto recibe cada modelo: https://ai.google.dev/gemini-api/docs/models
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# cuánto recibe cada modelo: https://ai.google.dev/gemini-api/docs/models
Qué pasa. Desde 1.1.3, un módulo que instalas se ejecuta aparte, con permisos limitados: puede leer su propio archivo, pero no puede escribir tus archivos ni abrir otros programas por su cuenta. Este módulo intentó una de esas cosas y Node lo detuvo. Tu proyecto y MADRE están bien.
Qué hacer. Pídele a quien hizo el módulo una versión hecha para MADRE 1.1.3, que le pida a MADRE lo que necesita en vez de hacerlo ella misma. Mientras tanto, apágalo en Módulos.
# Módulos › el módulo › apágalo
# Módulos › el módulo › apágalo
# En Windows, MADRE funciona dentro de WSL2, Linux dentro de Windows: mira «MADRE en Windows».
# en Ubuntu (WSL):
# Módulos › el módulo › apágalo
Es el mismo catálogo que usa Diagnóstico dentro de MADRE 1.1.3: ahí lo encuentras sin salir de la app. El estado en vivo sale del diagnóstico anónimo y solo dice si un error se vio esta semana, nunca en qué computadora ni cuántas veces.