@jossuealcala/madre 1.1.2 → 1.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.en.md +40 -1
- package/CHANGELOG.md +40 -1
- package/README.en.md +3 -3
- package/README.md +3 -3
- package/SECURITY.md +11 -6
- package/TRADEMARKS.md +6 -2
- package/bin/madre.mjs +76 -11
- package/docs/REFERENCE.md +16 -10
- package/docs/SDK.md +36 -9
- package/docs/en/REFERENCE.md +12 -8
- package/docs/en/SDK.md +34 -8
- package/docs/en/training/README.md +1 -1
- package/docs/sdk/connector-module.mjs +1 -1
- package/docs/sdk/hello-module.mjs +39 -4
- package/docs/training/README.md +1 -1
- package/docs/training/train.sh +3 -0
- package/habilidades/explicamelo-facil/HABILIDAD.md +19 -0
- package/habilidades/hojas-de-calculo/HABILIDAD.md +18 -0
- package/habilidades/mensajes-a-clientes/HABILIDAD.md +19 -0
- package/habilidades/publicaciones-para-redes/HABILIDAD.md +19 -0
- package/habilidades/resumen-y-pendientes/HABILIDAD.md +18 -0
- package/habilidades/tu-pagina-paso-a-paso/HABILIDAD.md +19 -0
- package/package.json +7 -4
- package/public/activity.js +66 -22
- package/public/app.js +4947 -894
- package/public/assets/brand/OFL-SpaceGrotesk.txt +93 -0
- package/public/assets/brand/SpaceGrotesk-latin-ext.woff2 +0 -0
- package/public/assets/brand/SpaceGrotesk-latin.woff2 +0 -0
- package/public/assets/brand/madre-app-180.png +0 -0
- package/public/assets/brand/madre-app-192.png +0 -0
- package/public/assets/brand/madre-app-512.png +0 -0
- package/public/assets/brand/madre-app.svg +1 -1
- package/public/assets/brand/madre-favicon.svg +1 -1
- package/public/attribution.js +29 -19
- package/public/auto-open.js +102 -0
- package/public/brands.js +36 -19
- package/public/changes.js +63 -0
- package/public/en.js +1085 -102
- package/public/es.js +2940 -1656
- package/public/i18n.js +11 -0
- package/public/index.html +31 -27
- package/public/loader.js +322 -117
- package/public/macroverso.js +57 -355
- package/public/manual-content.js +69 -9
- package/public/manual.js +21 -6
- package/public/market-view.js +298 -84
- package/public/market.js +25 -2
- package/public/mcp-catalog.js +7 -2
- package/public/missions.js +169 -0
- package/public/news-scenes.js +292 -0
- package/public/nostromo-engine.js +935 -654
- package/public/notices.js +78 -0
- package/public/notifications.js +119 -0
- package/public/power.js +1 -1
- package/public/provider-marks.js +170 -0
- package/public/provider-pick.js +147 -0
- package/public/resay.js +4 -0
- package/public/review-ask.js +16 -13
- package/public/routing.js +29 -3
- package/public/salas-mac.css +467 -47
- package/public/salas-mac.html +8 -5
- package/public/salas-mac.js +805 -109
- package/public/salas.css +2 -2
- package/public/salas.html +2 -2
- package/public/salas.js +1 -1
- package/public/starters.js +128 -0
- package/public/styles.css +3036 -340
- package/public/subscription.js +303 -0
- package/public/terms-field.js +170 -0
- package/public/terms.js +117 -19
- package/public/tips.js +158 -0
- package/public/tour-chapters.js +88 -88
- package/public/tour.js +364 -46
- package/public/troubleshooting.js +313 -27
- package/public/welcome-scene.js +446 -0
- package/public/welcome.js +827 -282
- package/src/adapters/claude.mjs +2 -1
- package/src/adapters/codex.mjs +2 -1
- package/src/adapters/cursor.mjs +9 -6
- package/src/adapters/gemini-rest.mjs +236 -0
- package/src/adapters/gemini.mjs +13 -7
- package/src/adapters/grok.mjs +290 -0
- package/src/adapters/madre.mjs +71 -23
- package/src/adapters/opencode.mjs +15 -2
- package/src/adapters/process.mjs +14 -3
- package/src/adapters/steps.mjs +176 -0
- package/src/app-invite.mjs +90 -0
- package/src/auth-probe.mjs +32 -0
- package/src/billing-key.mjs +8 -0
- package/src/billing.mjs +317 -0
- package/src/bridge/policy.mjs +1 -1
- package/src/capabilities.mjs +46 -10
- package/src/chats.mjs +44 -2
- package/src/checkpoint.mjs +119 -1
- package/src/codex-route.mjs +113 -0
- package/src/commands.mjs +5 -2
- package/src/credentials.mjs +46 -8
- package/src/dataset.mjs +18 -7
- package/src/directives.mjs +1 -0
- package/src/event-store.mjs +25 -2
- package/src/extensions.mjs +5 -1
- package/src/ficha.mjs +158 -0
- package/src/files.mjs +36 -2
- package/src/image-studio.mjs +13 -3
- package/src/install-metrics.mjs +9 -3
- package/src/lease.mjs +6 -1
- package/src/looks.mjs +4 -1
- package/src/market-check.mjs +1 -1
- package/src/market-remote.mjs +135 -1
- package/src/mcp/image-server.mjs +59 -90
- package/src/mcp/memory-server.mjs +10 -0
- package/src/memory-tools.mjs +3 -0
- package/src/memory.mjs +29 -4
- package/src/models.mjs +21 -3
- package/src/modules/ahp.mjs +10 -4
- package/src/modules/bishop-exam.mjs +41 -12
- package/src/modules/bishop.mjs +2 -2
- package/src/modules/choices.mjs +12 -10
- package/src/modules/fetch-alone.mjs +7 -0
- package/src/modules/github.mjs +6 -2
- package/src/modules/helpers.mjs +23 -5
- package/src/modules/image-providers.mjs +281 -0
- package/src/modules/image-studio.mjs +106 -39
- package/src/modules/index.mjs +61 -12
- package/src/modules/intents-observe.mjs +3 -1
- package/src/modules/isolated.mjs +160 -0
- package/src/modules/ollama.mjs +35 -6
- package/src/modules/playwright.mjs +78 -20
- package/src/modules/reminders.mjs +42 -2
- package/src/modules/ripley.mjs +2 -1
- package/src/modules/run-alone.mjs +122 -0
- package/src/modules/runs.mjs +11 -8
- package/src/modules/sdk.mjs +10 -3
- package/src/notices-key.mjs +8 -0
- package/src/notices.mjs +185 -0
- package/src/ollama.mjs +57 -15
- package/src/opencode-health.mjs +1 -1
- package/src/outbound.mjs +124 -13
- package/src/quota-sources.mjs +148 -3
- package/src/review-ask.mjs +55 -31
- package/src/room/archivist.mjs +30 -5
- package/src/room/busy.mjs +16 -0
- package/src/room/changes.mjs +79 -0
- package/src/room/control.mjs +36 -6
- package/src/room/economy.mjs +1 -1
- package/src/room/guard.mjs +39 -2
- package/src/room/prompt.mjs +49 -6
- package/src/room/vectors.mjs +7 -1
- package/src/room.mjs +181 -49
- package/src/router.mjs +1 -1
- package/src/runs.mjs +39 -0
- package/src/runtime-detection.mjs +46 -6
- package/src/salas.mjs +181 -18
- package/src/server.mjs +1101 -118
- package/src/service.mjs +116 -0
- package/src/setup-trouble.mjs +20 -1
- package/src/setup.mjs +1 -1
- package/src/skill-check.mjs +269 -0
- package/src/skills-import.mjs +128 -0
- package/src/skills.mjs +502 -0
- package/src/terms.mjs +23 -5
- package/src/tour.mjs +31 -5
- package/src/updates.mjs +47 -4
- package/src/web-preview.mjs +181 -0
- package/src/whats-new.mjs +121 -1
- package/src/rumbo.mjs +0 -337
package/CHANGELOG.en.md
CHANGED
|
@@ -4,7 +4,46 @@ Every published version of `@jossuealcala/madre`. Dates in ISO format.
|
|
|
4
4
|
|
|
5
5
|
A version closes when it is on npm: until then its section is called **Unreleased** and it can keep growing. Each published version has exactly one `vX.Y.Z` tag, one GitHub release and one section here; the patch number can reach two digits (`0.2.10`) before the minor goes up. See `docs/ROADMAP.md` for the criteria on what bumps each number. This is the English translation of [CHANGELOG.md](CHANGELOG.md); the Spanish file is the original.
|
|
6
6
|
|
|
7
|
-
## 1.1.
|
|
7
|
+
## 1.1.5 · Unreleased
|
|
8
|
+
|
|
9
|
+
## 1.1.4 · 2026-11-19
|
|
10
|
+
|
|
11
|
+
- **MADRE is an app now (first beta).** For Mac, signed by Apple: it opens from your applications with no terminal, tells you when an AI finishes, brings its own browser (showing its size as you change the width, and the page's errors one click away) and its terminal, and updates from madre.run with your permission. Its icon turns light or dark with your system's theme. It is free for you under its personal license. If you use MADRE in the browser, after updating it asks whether you stay there or download the app; your projects come along as they are.
|
|
12
|
+
- **You see what changed in every answer.** Under every answer that touches your project, a card says in plain words what changed, with «View» and «Undo» (which asks first). What an AI makes, a page, an image, a PDF or a sheet, opens by itself beside the conversation.
|
|
13
|
+
- **Learn by doing.** First steps offers you five short things instead of a tour: make your first page, ask two AIs the same thing, undo a change, talk to your computer's AI and use something from the Market.
|
|
14
|
+
- **A clearer MADRE.** One emerald accent across the interface; «Before you start» says what MADRE is in three lines and in the opening; the welcome says why it looks at your computer; each answer's header is one line, with what it answers and what it used; notices open and close in one movement; Files keeps its keys fixed on top; and you can rename a project from Home without touching its folder.
|
|
15
|
+
- **Fixes from testing the app.** An AI with «Can create» can now start while another has full access; a panel coming back from a window returns beside the conversation; a double click on the window keys counts as one; Modules no longer overflows long names; and no more stray tips in the second chat.
|
|
16
|
+
- **What people's copies said.** Diagnostics now recognises and explains: Codex asking to sign in again because its token was already used, Cursor without a session, a Gemini model retired for new accounts, an AI's provider answering «Bad Gateway», OpenRouter with no provider that fits your data policy or no models that take tools, Codex unable to start its helper, and Grok on Linux without `bubblewrap`. When an AI ends without writing anything, MADRE says so with its card, and for OpenCode also why: the model only thought, kept using tools or ran out of room. An installer that cannot run says why instead of never answering, and if a project's folder disappears while it is open, its conversation keeps being saved.
|
|
17
|
+
- **Writing a module without guessing.** The SDK guide gives the whole shape of routes, of a card's link and of status, and the `hello` example uses them, working, so your AI no longer has to ask you to search MADRE's code. A route written as an expression starting with `^` is no longer refused when the module is installed, and a module you install answers only at its own addresses (`/api/x/<id>/`), never MADRE's.
|
|
18
|
+
- **Undo no longer leaves behind what an AI creates as its turn begins.** On Linux, a file written in the first milliseconds of the turn, in a folder git ignores, could fall out of the list of what was created and of Undo.
|
|
19
|
+
- **Answers read better.** If an AI gives you a table, you sort it with a click on the header. Code comes with its file name and a button to copy it. Charts and diagrams are drawn right there, and a list of links turns into cards with title and price. The jumping around while an answer comes in is gone too, and a plan now reads step by step.
|
|
20
|
+
- **Images with the keys you already have.** The Images module draws with Gemini, OpenAI or Grok. It finds your key where your AIs already keep it, so it doesn't ask you for it.
|
|
21
|
+
- **Pick how your code looks.** Appearance has three styles for the terminal and the editor: Coldbrew, Oldcode and Simple, each in light and dark. Coldbrew is the house style, emerald green on almost black.
|
|
22
|
+
- **MADRE talks to you more clearly.** Almost a thousand sentences changed. It now says «your AIs» instead of «agents», explains permissions the way a person would and calls memory memory. While we were at it, the memory map draws each memory as a planet, and Settings fits any window size.
|
|
23
|
+
- **@madre doesn't get fooled anymore.** If something it quotes carries a hidden order, it no longer follows it. It sometimes answered just «Noted» because it copied it from a quote, and «room» slipped into its Spanish. Not anymore. Opening a new conversation no longer waits for the last one to finish its summary, and when Diagnostics flags something, your AIs no longer all start answering at once.
|
|
24
|
+
- **Small fixes you'll notice.** Reminders understands exact dates: «November 16 at 10:30» is now the 16th, not today. You can send a message of up to 1 MB, like a whole log pasted in. The access key is no longer written in logs other people on your computer can read. And if Ollama doesn't answer when you open a project, MADRE tries again on its own.
|
|
25
|
+
- **The app is ready for its subscription.** It isn't switched on yet, so today the app is still free. Once it is, you get 30 days free with everything, no card needed. After that it's MXN 109 a month, VAT included. If you decide not to subscribe, MADRE keeps working for free with one active project at a time, and nothing of yours is deleted. A subscription works on up to two computers. On the second one you type the email you paid with, a button arrives and that's it, nothing to copy or paste.
|
|
26
|
+
- **It asks if you like it once you've really used it.** The prompt to leave a review comes after 30 minutes with your AIs working, not just for having the window open. From the app it takes you to write a review. If you installed with npm, it invites you to star it on GitHub, since npm has no reviews.
|
|
27
|
+
|
|
28
|
+
## 1.1.3 · 2026-11-09
|
|
29
|
+
|
|
30
|
+
- **A welcome like setting up a new phone.** Six steps, each with one question in everyday words and an animation, made with the logo's pulse, that shows what is happening. MADRE looks over your computer while you read the greeting; it asks what you want it for and gives you examples of your own, not a programmer's; it recognises the AIs that already have a session and tells you which is which («Pay for ChatGPT Plus? Here it's called Codex»); it brings ticked the folders you already opened with Claude Code, Codex, Gemini, Cursor or VS Code (it only reads where they are, never what they say); it downloads the AI on your computer and its memory with one touch while you carry on, and lets you talk to it as soon as it arrives. It ends inside your project with the first message already written, so you only send it.
|
|
31
|
+
- **Skills: teach MADRE once how you work.** A skill is a page with your way of doing something (quoting, writing an email, reviewing a contract) that MADRE hands to whichever AI answers, Claude, Codex, Gemini, OpenCode or Grok. It comes in on its own when what you ask fits, and the room says why it came in («because you said quote»); you can also keep it always on or off, for all your projects or just one. It never grants permissions: it does not raise the mode or let anyone read, write or run more. You can ask your agent to write one (`/skill` at #2) and you decide whether it is kept; bring the ones you already have in Claude or Codex; find them in the Market, on their own tab, where you read what they will tell your agents before keeping them; send yours to the Market, or share it hand to hand: whoever gets the file drags it into their conversation and MADRE offers to keep it. They are in Market › Skills and in the manual.
|
|
32
|
+
- **MADRE explains each thing.** The first time you touch something important (Running now, the Market, Modules, your AIs, Attach, the model, the copilot) a short note says what it is for, once. Each AI's window shows in bars how much of your plan you have used, when it renews and what it can do. Settings › Memory, training your own AI and the «Getting to know MADRE» tour are told in everyday words.
|
|
33
|
+
- **Notices from the author.** When there is something you need to know (a known fault, an urgent fix), it reaches your MADRE as a card on Home, or as a strip in the project if it is important. They are signed: your copy checks the signature and decides on its own whether the notice is for its version and system, without saying anything about you. «Got it» keeps it. Information notices can be turned off in Settings › Version; security ones cannot.
|
|
34
|
+
- **Interface details.** In Settings, the agents are a quick way in: their logo and their session, three to a row, and each opens its agent. The connectors have a search, and «Add a tool» appears once, at the top. Home's Settings widen by dragging their edge, as a project's do. The connections are compact, centred rows that unfold when pressed, and inside they read in order (what crosses, terms, what it allows). The map also shows the Coordinator's memories. Secondary keys such as «Cancel» have a quieter shade, and the keys show a small, solid tip, inside the projects too. What each turn changed folds into a dot like the other notes, with Undo inside, and a module's answer opens downward. «Bring over what you already have» is also in Market › Skills.
|
|
35
|
+
- **Codex, Claude, Gemini, OpenCode and Grok show their official logos.** Unaltered, in their one-colour version and only to identify each service. Settings › License and authorship says whose each trademark is. Cursor keeps MADRE's own drawing.
|
|
36
|
+
- **Grok, xAI's AI, joins your agents.** It installs from Settings › Agents with its official CLI and connects with your Grok account through a code you confirm on xAI's page. It works at every mode: at #1 it only reads (it is given only the tools that read, and your system keeps it from writing), at #2 and #3 it writes with no terminal, and at #4 it runs commands too. At no mode does it touch `.env`, `.git` or MADRE's folders. With Web access on, it searches and opens pages. It also generates images: at #2 they land in the turn's draft folder, and at #3 and #4 in `imagenes/`. It does not load the hooks, skills or servers you have in Claude or Cursor. If xAI refuses your account, MADRE tells you how to fix it. An AI that only reads (Grok, or Gemini when it answers through its API) no longer asks for a mode it cannot use, and MADRE no longer offers «Create» for it.
|
|
37
|
+
- **No other program on your computer can use MADRE in your name.** Until now any program on the computer (of any user and, in WSL2, Windows' too) could read your projects, install a module or open #4 by talking to MADRE directly. Now every request carries a ficha: a secret only your user can read. The browser MADRE opens gets it in the address and keeps it; nothing changes for you. If you open MADRE in another browser, paste the full address it wrote in the terminal. Home makes a new ficha each time it starts.
|
|
38
|
+
- **«What is sent» says rightly where the signal that MADRE is open goes.** The five-minute notice that is part of the anonymous diagnostics was logged as if it went to the error-report collector, with the wrong switch. It now has its own line and says it turns off with the diagnostics. The README also names the three sends to madre.run (the daily notice, the diagnostics and the automatic error report), not two.
|
|
39
|
+
- **Gemini with a key, nothing to install.** With a Google API key (free or paid), Gemini answers even if its program is not installed, and if the credits of the model you chose run out, it tries a fallback one. That way it only answers: to write in your project it still needs its program.
|
|
40
|
+
- **Clearer permissions.** With #3 open, your next message stays at #3 instead of going back to #1 and asking again. If the same AI asks for #3 a second time, the card offers you the copilot. On a narrow screen the mode says its short name («#1 Chat»). Undo and edit say so once, in your language.
|
|
41
|
+
- **MADRE on a Linux server.** Each project remembers its port, so it comes back on the same one after a restart. And from Home › Settings, or with `madre servicio activar`, MADRE starts with the computer, comes back on its own if it closes and reopens the projects you had open (Linux with systemd only, no administrator rights).
|
|
42
|
+
- **Safer modules.** A module you install runs in a separate process with limited permissions: it cannot write your files or start other programs directly. It is not a barrier against a module made to do harm, so review what you install. Installing one by hand needs the #4 key: no other program on your computer can install one for you. A module that is off does not hear the conversation.
|
|
43
|
+
- **A more honest memory.** A note says who wrote it down and whether you confirmed it; one an AI saved without sources says so, and no longer overturns what you confirmed. Summarising the memory is no longer given to an AI without a session. What the project's memory sends to Gemini shows in «What is sent».
|
|
44
|
+
- **The AI on your computer, without cut-offs.** On a computer without a graphics card, tidying the memory and the Coordinator no longer stop at five minutes. If the computer is already very busy, that background work waits a few minutes instead of slowing you down. When Ollama fails because of the network, the site's name or a cut download, MADRE says which; and @madre without Ollama tells you how to start it. The exam of your trained AI only asks what it did not see in training, and training no longer ends in an error.
|
|
45
|
+
- **Attachments and files.** A PDF or a photo from the conversation is saved in the project folder you choose. A text too long for a message is sent as an attachment instead of being refused. Attachment names keep their accents. Undo also removes what an AI created in folders git ignores, and a `.env` a turn changes goes back to how it was.
|
|
46
|
+
- **Fixes the diagnostics asked for.** Codex no longer offers models your account refuses. Claude's key is checked with Anthropic when you save it, so a bad key is said before the first message. Codex cannot write to places MADRE cannot identify. «MADRE is already open for this project» is said in your language, and opening it again opens it instead of failing. A repository git refuses to read is no longer taken for a project without git. Closing the copilot's window while it prepares its turn no longer makes it fail. The commands card shows the real command from `package.json`. «Stop everything» no longer reaches the diagnostics as a fault. And scrolling on at the end of the chat, as a trackpad's momentum does, no longer writes «end of record» or marks your next message.
|
|
8
47
|
|
|
9
48
|
## 1.1.2 · 2026-11-02
|
|
10
49
|
|
package/CHANGELOG.md
CHANGED
|
@@ -4,7 +4,46 @@ Todas las versiones publicadas de `@jossuealcala/madre`. Fechas en ISO.
|
|
|
4
4
|
|
|
5
5
|
Una versión se cierra cuando está en npm: hasta entonces su sección se llama **Sin publicar** y puede crecer. Cada versión publicada tiene exactamente una etiqueta `vX.Y.Z`, una release en GitHub y una sección aquí; el parche puede llegar a dos dígitos (`0.2.10`) antes de subir el menor. Ver `docs/ROADMAP.md` para el criterio de qué sube cada número.
|
|
6
6
|
|
|
7
|
-
## 1.1.
|
|
7
|
+
## 1.1.5 · Sin publicar
|
|
8
|
+
|
|
9
|
+
## 1.1.4 · 2026-11-19
|
|
10
|
+
|
|
11
|
+
- **MADRE ya es una app (primera beta).** Para Mac, firmada por Apple: se abre desde tus aplicaciones sin terminal, te avisa cuando una IA termina, trae su propio navegador (con sus medidas al cambiar el ancho y los errores de la página a un clic) y su terminal, y se actualiza desde madre.run con tu permiso. Su ícono cambia a claro u oscuro con el tema de tu sistema. Es gratis para ti con su licencia personal. Si usas MADRE en el navegador, después de actualizar te pregunta si te quedas ahí o bajas la app; tus proyectos llegan tal como están.
|
|
12
|
+
- **Ves qué cambió en cada respuesta.** Bajo cada respuesta que toca tu proyecto, una tarjeta dice en palabras simples qué cambió, con «Ver» y «Deshacer» (que pregunta antes). Lo que una IA crea, una página, una imagen, un PDF o una hoja, se abre solo al lado de la conversación.
|
|
13
|
+
- **Aprende haciendo.** Primeros pasos te propone cinco cosas cortas en vez de un recorrido: crea tu primera página, pregúntale lo mismo a dos IAs, deshaz un cambio, habla con la IA de tu computadora y usa algo del Mercado.
|
|
14
|
+
- **Una MADRE más clara.** Un solo acento esmeralda en toda la interfaz; «Antes de empezar» explica qué es MADRE en tres líneas y en la entrada; la bienvenida dice para qué revisa tu computadora; la cabecera de cada respuesta va en una línea, con a qué responde y lo que gastó; los avisos se abren y cierran en un solo movimiento; Archivos deja sus botones fijos arriba; y puedes renombrar un proyecto desde Inicio sin tocar su carpeta.
|
|
15
|
+
- **Arreglos de la prueba en la app.** Una IA con «Puede crear» ya puede empezar mientras otra tiene acceso total; el panel que vuelve de ventana regresa al lado de la conversación; un doble clic en los botones de ventana cuenta como uno; Módulos ya no desborda nombres largos; y se acabaron los globos sueltos en el segundo chat.
|
|
16
|
+
- **Lo que dijeron las copias de la gente.** Diagnóstico ya reconoce y explica: Codex que pide volver a iniciar sesión porque su token ya se usó, Cursor sin sesión, un modelo de Gemini retirado para cuentas nuevas, el proveedor de una IA que contesta «Bad Gateway», OpenRouter sin proveedor que cumpla tu política de datos o sin modelos que acepten herramientas, Codex que no pudo arrancar su ayudante y Grok en Linux sin `bubblewrap`. Cuando una IA termina sin escribir nada, MADRE lo dice con su ficha, y en OpenCode también por qué: si el modelo solo pensó, se quedó usando herramientas o se quedó sin espacio. Un instalador que no se puede ejecutar dice por qué en vez de quedarse sin contestar, y si la carpeta de un proyecto desaparece mientras está abierto, su conversación se sigue guardando.
|
|
17
|
+
- **Escribir un módulo sin adivinar.** La guía del SDK trae completas las formas de las rutas, del enlace de una tarjeta y del estado, y el ejemplo `hello` las usa funcionando, así que tu IA ya no tiene que pedirte que busques en el código de MADRE. Una ruta escrita como expresión que empieza con `^` ya no se rechaza al instalar el módulo, y un módulo que instalas solo contesta en sus propias direcciones (`/api/x/<id>/`), nunca en las de MADRE.
|
|
18
|
+
- **Deshacer no deja atrás lo que una IA crea al empezar su turno.** En Linux, un archivo escrito en los primeros milisegundos del turno, en una carpeta que git ignora, podía quedar fuera de la lista de lo creado y de Deshacer.
|
|
19
|
+
- **Las respuestas se leen mejor.** Si una IA te da una tabla, la ordenas con un clic en el encabezado. El código llega con el nombre de su archivo y un botón para copiarlo. Las gráficas y los diagramas se dibujan ahí mismo, y una lista de enlaces se vuelve tarjetas con título y precio. También se acabaron los brincos mientras llega una respuesta, y un plan ya se lee paso a paso.
|
|
20
|
+
- **Imágenes con las llaves que ya tienes.** El módulo Imágenes dibuja con Gemini, OpenAI o Grok. Encuentra tu llave donde tus IAs ya la guardan, así que no te la pide.
|
|
21
|
+
- **Elige cómo se ve tu código.** En Apariencia hay tres estilos para la terminal y el editor: Coldbrew, Oldcode y Simple, cada uno en claro y en oscuro. Coldbrew es el de la casa, verde esmeralda sobre casi negro.
|
|
22
|
+
- **MADRE te habla más claro.** Cambiaron casi mil frases. Ahora dice «tus IAs» y no «agentes», explica los permisos como lo haría una persona y a la memoria le dice memoria. De paso, el Mapa de memoria dibuja cada recuerdo como un planeta, y Ajustes se acomoda a cualquier tamaño de ventana.
|
|
23
|
+
- **@madre ya no se deja engañar.** Si algo que cita trae una orden escondida, ya no la sigue. A veces contestaba solo «Anotado» porque lo copiaba de una cita, y se le colaba «room» en español. Ya no. Abrir una conversación nueva ya no espera a que la anterior termine su resumen, y cuando Diagnóstico avisa algo, tus IAs ya no se ponen a contestar todas a la vez.
|
|
24
|
+
- **Arreglos chicos que se notan.** Recordatorios entiende fechas exactas: «16 de noviembre a las 10:30» ya es el 16 y no hoy. Puedes mandar un mensaje de hasta 1 MB, como un registro pegado completo. La llave de acceso ya no queda escrita en registros que otras personas de tu computadora pueden leer. Y si Ollama no responde cuando abres un proyecto, MADRE vuelve a intentarlo sola.
|
|
25
|
+
- **La app ya está lista para su suscripción.** Todavía no se activa, así que hoy la app sigue gratis. Cuando se active, tendrás 30 días gratis con todo, sin dar tarjeta. Después cuesta $109 MXN al mes, con IVA incluido. Si decides no suscribirte, MADRE sigue funcionando gratis con un proyecto activo a la vez y no se borra nada tuyo. Una suscripción sirve en hasta dos computadoras. En la segunda escribes el correo con el que pagaste, te llega un botón y listo, sin copiar ni pegar nada.
|
|
26
|
+
- **Te pregunta si te gusta cuando ya la usaste de verdad.** El aviso para dejar una reseña sale después de 30 minutos con tus IAs trabajando, no por tener la ventana abierta. Desde la app te lleva a escribir una reseña. Si instalaste con npm, te invita a darle una estrella en GitHub, porque npm no tiene reseñas.
|
|
27
|
+
|
|
28
|
+
## 1.1.3 · 2026-11-09
|
|
29
|
+
|
|
30
|
+
- **Una bienvenida como estrenar teléfono.** Seis pasos, cada uno con una sola pregunta en palabras de todos los días y una animación que enseña qué está pasando, hecha con el pulso del logo. MADRE revisa tu computadora mientras lees el saludo; te pregunta para qué la quieres y con eso te da ejemplos tuyos, no de programador; reconoce las IAs que ya tienen sesión y te dice cuál es cuál («¿Pagas ChatGPT Plus? Aquí se llama Codex»); trae marcadas las carpetas que ya abriste con Claude Code, Codex, Gemini, Cursor o VS Code (solo lee dónde están, nunca lo que dicen); baja la IA de tu computadora y su memoria de un solo toque mientras sigues, y te deja platicar con ella en cuanto llega. Termina dentro de tu proyecto con el primer mensaje ya escrito, para que solo lo mandes.
|
|
31
|
+
- **Habilidades: enséñale una vez a MADRE cómo trabajas.** Una habilidad es una página con tu forma de hacer algo (cotizar, escribir un correo, revisar un contrato) que MADRE le pasa a la IA que conteste, sea Claude, Codex, Gemini, OpenCode o Grok. Entra sola cuando lo que pides viene al caso y la sala dice por qué entró («porque dijiste cotización»); también puedes dejarla siempre encendida o apagada, para todos tus proyectos o solo para uno. Nunca da permisos: no sube el modo ni deja leer, escribir o ejecutar más. Puedes pedirle a tu agente que escriba una (`/habilidad` en #2) y tú decides si se guarda; traer las que ya tienes en Claude o en Codex; buscarlas en el Mercado, en su propia pestaña, donde lees lo que le dirán a tus agentes antes de guardarlas; mandar la tuya al Mercado, o compartirla de mano en mano: quien recibe el archivo lo arrastra a su conversación y MADRE le ofrece guardarlo. Están en Mercado › Habilidades y en el manual.
|
|
32
|
+
- **MADRE te explica cada cosa.** La primera vez que tocas algo importante (Plan actual, el Mercado, Módulos, tus IAs, Adjuntar, el modelo, el copiloto) sale una nota corta que dice para qué sirve, una sola vez. La ventana de cada IA enseña con barras cuánto de tu plan llevas, cuándo se renueva y qué puede hacer. Ajustes › Memoria, entrenar tu propia IA y el recorrido «Conoce MADRE» están dichos con palabras de todos los días. «En marcha» se llama ahora «Plan actual», y en español una orden se «ejecuta»: MADRE ya no dice «correr».
|
|
33
|
+
- **Avisos del autor.** Cuando haya algo que tengas que saber (una falla conocida, un arreglo urgente), llega a tu MADRE como una tarjeta en Inicio, o como una franja en el proyecto si es importante. Van firmados: tu copia comprueba la firma y decide sola si el aviso es para su versión y su sistema, sin decir nada de ti. «Entendido» lo guarda. Los de información se apagan en Ajustes › Versión; los de seguridad, no.
|
|
34
|
+
- **Detalles de la interfaz.** En Ajustes, los agentes son un acceso rápido: su logo y su sesión, tres por fila, y cada uno abre su agente. Los conectores tienen buscador y «Agregar conector» aparece una sola vez, arriba. Los Ajustes de Inicio se ensanchan arrastrando su borde, como los de un proyecto. Las conexiones son filas compactas y centradas que se despliegan al pulsarlas, y adentro se leen en orden (qué se comparte, condiciones, qué permite). El mapa muestra también las memorias del Coordinador. Los botones secundarios, como «Cancelar», tienen una sombra más discreta, y los botones muestran un globo de ayuda pequeño y sólido, también dentro de los proyectos. Lo que cambió cada turno se pliega en un punto como las demás notas, con Deshacer adentro, y la respuesta de un módulo se abre hacia abajo. «Trae las que ya tienes» también está en Mercado › Habilidades.
|
|
35
|
+
- **Codex, Claude, Gemini, OpenCode y Grok se ven con sus logos oficiales.** Sin alterar, en su versión de un solo color y solo para identificar cada servicio. Ajustes › Licencia y autoría dice de quién es cada marca. Cursor conserva el dibujo de MADRE.
|
|
36
|
+
- **Grok, la IA de xAI, se suma a tus agentes.** Se instala desde Ajustes › Agentes con su CLI oficial y se conecta con tu cuenta de Grok con un código que confirmas en la página de xAI. Trabaja en todos los modos: en #1 solo lee (recibe solo las herramientas que leen y tu sistema le impide escribir), en #2 y #3 escribe sin terminal, y en #4 también corre comandos. En ningún modo toca `.env`, `.git` ni las carpetas de MADRE. Con «Acceso a la web» encendido, busca y abre páginas. También genera imágenes: en #2 quedan en la carpeta de borrador del turno y en #3 y #4, en `imagenes/`. No carga los ganchos, habilidades ni servidores que tengas en Claude o Cursor. Si xAI rechaza tu cuenta, MADRE te dice cómo arreglarlo. Una IA que solo lee (Grok, o Gemini cuando contesta por su API) ya no pide un modo que no puede usar, ni MADRE te ofrece «Crear» para ella.
|
|
37
|
+
- **Ningún otro programa de tu computadora puede usar MADRE por ti.** Hasta ahora, cualquier programa de la computadora (de cualquier usuario y, en WSL2, también los de Windows) podía leer tus proyectos, instalar un módulo o abrir #4 hablándole directo a MADRE. Ahora cada petición lleva una ficha: un secreto que solo tu usuario puede leer. El navegador que MADRE abre la recibe en la dirección y la guarda; para ti nada cambia. Si abres MADRE en otro navegador, pega la dirección completa que escribió en la terminal. Inicio hace una ficha nueva cada vez que arranca.
|
|
38
|
+
- **«Lo que se envía» dice bien a dónde va la señal de que MADRE está abierta.** El aviso de cada cinco minutos que forma parte del diagnóstico anónimo se anotaba como si fuera al servicio de reportes de errores, con el interruptor equivocado. Ahora tiene su propia línea y dice que se apaga con el diagnóstico. El README también nombra los tres envíos a madre.run (el aviso diario, el diagnóstico y el reporte automático de errores), no dos.
|
|
39
|
+
- **Gemini con una llave, sin instalar nada.** Con una llave de la API de Google (gratuita o de paga), Gemini contesta aunque no tengas su programa instalado, y si se acaban los créditos del modelo que elegiste, prueba con uno de respaldo. Así solo contesta: para escribir en tu proyecto sigue haciendo falta su programa.
|
|
40
|
+
- **Permisos más claros.** Con #3 abierto, tu siguiente mensaje sigue en #3 en vez de volver a #1 y pedirlo otra vez. Si la misma IA pide #3 por segunda vez, la tarjeta te ofrece el copiloto. En una pantalla angosta el modo dice su nombre corto («#1 Conversar»). Deshacer y editar avisan una sola vez, en tu idioma.
|
|
41
|
+
- **MADRE en un servidor Linux.** Cada proyecto recuerda su puerto, así que vuelve en el mismo al reiniciar. Y desde Inicio › Ajustes, o con `madre servicio activar`, MADRE arranca con la computadora, vuelve sola si se cierra y reabre los proyectos que tenías abiertos (solo Linux con systemd, sin permisos de administrador).
|
|
42
|
+
- **Módulos más seguros.** Un módulo que instalas se ejecuta en un proceso aparte, con permisos limitados: no puede escribir tus archivos ni abrir otros programas directamente. No es una barrera contra un módulo hecho para dañar, así que revisa lo que instalas. Para instalar uno a mano hace falta la llave de #4: ningún otro programa de tu computadora puede instalarlo por ti. Un módulo apagado no oye la conversación.
|
|
43
|
+
- **La memoria, más honesta.** Una nota dice quién la anotó y si tú la confirmaste; la que una IA guardó sin fuentes lo dice, y ya no tumba lo que tú confirmaste. Resumir la memoria ya no se le encarga a una IA sin sesión. Lo que la memoria del proyecto manda a Gemini aparece en «Lo que se envía».
|
|
44
|
+
- **La IA de tu computadora, sin cortes.** En una computadora sin tarjeta de video, ordenar la memoria y el Coordinador ya no se cortan a los cinco minutos. Si la computadora ya está muy ocupada, ese trabajo de fondo espera unos minutos en vez de quitarte velocidad. Cuando Ollama falla por la red, por el nombre del sitio o porque cortó la descarga, MADRE dice cuál fue; y @madre sin Ollama te dice cómo encenderlo. El examen de tu IA entrenada solo pregunta lo que no vio al entrenar, y el entrenamiento ya no termina en error.
|
|
45
|
+
- **Adjuntos y archivos.** Un PDF o una foto de la conversación se guardan en la carpeta del proyecto que elijas. Un texto demasiado largo para un mensaje se manda como adjunto en vez de rechazarse. Los nombres de los adjuntos conservan sus acentos. Deshacer borra también lo que una IA creó en carpetas que git ignora, y un `.env` que un turno cambia vuelve a como estaba.
|
|
46
|
+
- **Arreglos que pidió el diagnóstico.** Codex ya no ofrece modelos que tu cuenta rechaza. La llave de Claude se comprueba con Anthropic al guardarla, así que una llave mala se dice antes del primer mensaje. Codex no puede escribir en lugares que MADRE no logra identificar. «MADRE ya está abierta para este proyecto» se dice en tu idioma, y abrirla otra vez la abre en vez de fallar. Un repositorio que git se niega a leer ya no se toma por un proyecto sin git. Cerrar la ventana del copiloto mientras prepara su turno ya no lo hace fallar. La tarjeta de comandos muestra la orden real de `package.json`. «Detener todo» ya no llega al diagnóstico como una falla. Y seguir desplazando hacia abajo al final del chat, como hace la inercia de un trackpad, ya no escribe «fin del registro» ni marca tu siguiente mensaje.
|
|
8
47
|
|
|
9
48
|
## 1.1.2 · 2026-11-02
|
|
10
49
|
|
package/README.en.md
CHANGED
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
|
|
14
14
|
# All your AIs in one chat.
|
|
15
15
|
|
|
16
|
-
**MADRE is not another AI.** It is an app that runs on your computer and brings the AIs you already use (Codex, Claude Code, Gemini, Cursor and
|
|
16
|
+
**MADRE is not another AI.** It is an app that runs on your computer and brings the AIs you already use (Codex, Claude Code, Gemini, Cursor, OpenCode and Grok) into one chat, inside your project. You write to them in your own words, each one reads what the others said, and you decide what they may change. What gets decided is kept.
|
|
17
17
|
|
|
18
18
|
<p align="center">
|
|
19
19
|
<img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/public/assets/news/1.1/en/chats.webp" alt="A project in MADRE 1.1: chats on the left and OpenCode checking a shop's cart" width="100%">
|
|
@@ -44,7 +44,7 @@ You need Node 22.5 or newer and at least one AI you are signed in to. There is n
|
|
|
44
44
|
</tr>
|
|
45
45
|
</table>
|
|
46
46
|
|
|
47
|
-
Also: chats to one side like in chat apps, Windows through WSL2, and project maps that grow with what they know. The details are in the [CHANGELOG](CHANGELOG.en.md).
|
|
47
|
+
Also: skills, to teach MADRE once how you work so all your AIs follow it; Grok among your AIs; chats to one side like in chat apps, Windows through WSL2, and project maps that grow with what they know. The details are in the [CHANGELOG](CHANGELOG.en.md).
|
|
48
48
|
|
|
49
49
|
## If something fails
|
|
50
50
|
|
|
@@ -54,7 +54,7 @@ Open **Diagnostics** and type what you see, like "Gemini does not answer". It te
|
|
|
54
54
|
|
|
55
55
|
- **It runs on your computer.** MADRE has no account and no cloud: it opens on `127.0.0.1`.
|
|
56
56
|
- **Your keys are not copied.** Each AI keeps its own sign-in.
|
|
57
|
-
- **You know what leaves.** What an AI reads goes to its provider, with your account, just as in your Terminal.
|
|
57
|
+
- **You know what leaves.** What an AI reads goes to its provider, with your account, just as in your Terminal. Three things go to madre.run, never what you write or your projects: a daily notice that the copy is still in use (a random identifier, the version, the system and Node), which is always on; anonymous diagnostics (what failed, how much it is used and, every five minutes, that the copy is open), which you turn off in Settings; and the automatic report of an error MADRE does not know (what failed and where in MADRE), which comes on with the diagnostics and has its own switch. Every send is written down on your computer, in «What is sent». The details are in [what leaves the machine](docs/en/REFERENCE.md#what-leaves-the-machine).
|
|
58
58
|
|
|
59
59
|
## License
|
|
60
60
|
|
package/README.md
CHANGED
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
|
|
14
14
|
# Todas tus IAs en un mismo chat.
|
|
15
15
|
|
|
16
|
-
**MADRE no es otra IA.** Es una app que corre en tu computadora y junta a las IAs que ya usas (Codex, Claude Code, Gemini, Cursor y
|
|
16
|
+
**MADRE no es otra IA.** Es una app que corre en tu computadora y junta a las IAs que ya usas (Codex, Claude Code, Gemini, Cursor, OpenCode y Grok) en un solo chat, dentro de tu proyecto. Les escribes con tus palabras, cada una lee lo que dijeron las otras y tú decides qué pueden cambiar. Lo que se decide queda guardado.
|
|
17
17
|
|
|
18
18
|
<p align="center">
|
|
19
19
|
<img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/public/assets/news/1.1/es/chats.webp" alt="Un proyecto en MADRE 1.1: los chats a la izquierda y OpenCode revisando el carrito de una tienda" width="100%">
|
|
@@ -44,7 +44,7 @@ Necesitas Node 22.5 o más nuevo y al menos una IA con sesión. No hay cuenta qu
|
|
|
44
44
|
</tr>
|
|
45
45
|
</table>
|
|
46
46
|
|
|
47
|
-
También: chats a un lado como en las apps de chat, Windows con WSL2 y mapas de proyectos que crecen con lo que saben. El detalle está en el [CHANGELOG](CHANGELOG.md).
|
|
47
|
+
También: habilidades, para enseñarle una vez a MADRE cómo trabajas y que todas tus IAs lo sigan; Grok entre tus IAs; chats a un lado como en las apps de chat, Windows con WSL2 y mapas de proyectos que crecen con lo que saben. El detalle está en el [CHANGELOG](CHANGELOG.md).
|
|
48
48
|
|
|
49
49
|
## Si algo falla
|
|
50
50
|
|
|
@@ -54,7 +54,7 @@ Abre **Diagnóstico** y escribe lo que ves, como «Gemini no contesta». Te dice
|
|
|
54
54
|
|
|
55
55
|
- **Corre en tu computadora.** MADRE no tiene cuenta ni nube: abre en `127.0.0.1`.
|
|
56
56
|
- **Tus llaves no se copian.** Cada IA guarda su propia sesión.
|
|
57
|
-
- **Sabes qué sale.** Lo que lee una IA va a su proveedor, con tu cuenta, igual que en tu Terminal.
|
|
57
|
+
- **Sabes qué sale.** Lo que lee una IA va a su proveedor, con tu cuenta, igual que en tu Terminal. A madre.run van tres cosas, nunca lo que escribes ni tus proyectos: un aviso diario de que la copia sigue en uso (un identificador al azar, la versión, el sistema y Node), que siempre está encendido; un diagnóstico anónimo (qué falló, cuánto se usa y, cada cinco minutos, que la copia está abierta), que apagas en Ajustes; y el reporte automático de un error que MADRE no conoce (qué falló y en qué parte de MADRE), que viene encendido con el diagnóstico y tiene su propio interruptor. Cada envío queda anotado en tu computadora, en «Lo que se envía». El detalle está en [lo que sale de la máquina](docs/REFERENCE.md#lo-que-sale-de-la-máquina).
|
|
58
58
|
|
|
59
59
|
## Licencia
|
|
60
60
|
|
package/SECURITY.md
CHANGED
|
@@ -4,19 +4,24 @@ MADRE runs on your machine, talks to no cloud of its own and stores no credentia
|
|
|
4
4
|
|
|
5
5
|
## Reporting
|
|
6
6
|
|
|
7
|
-
If you find a way for an agent to write outside its lease, to keep
|
|
7
|
+
If you find a way for an agent to write outside its lease, to keep EDIT it should not have, to reach the memory of a room it is not in, or to make MADRE send anything you did not allow, tell the author privately first:
|
|
8
8
|
|
|
9
9
|
- GitHub: open a **private security advisory** at https://github.com/jossuealcacao-exe/madre/security/advisories/new
|
|
10
|
-
- Or
|
|
10
|
+
- Or use the private form at https://madre.run/report and choose «Something else»
|
|
11
11
|
|
|
12
|
-
Please include the MADRE version (`madre doctor --json`), the platform, which agent and mode were involved, and the smallest sequence of messages that reproduces it. A fix ships as a patch release and the advisory is published once it is out. Reports that are about a CLI's own behaviour (Codex, Claude Code, Gemini CLI, OpenCode) are forwarded to that project.
|
|
12
|
+
Please include the MADRE version (`madre doctor --json`), the platform, which agent and mode were involved, and the smallest sequence of messages that reproduces it. A fix ships as a patch release and the advisory is published once it is out. Reports that are about a CLI's own behaviour (Codex, Claude Code, Gemini CLI, OpenCode, Cursor) are forwarded to that project.
|
|
13
13
|
|
|
14
14
|
## Known, accepted for the beta
|
|
15
15
|
|
|
16
|
-
- In `#3
|
|
17
|
-
-
|
|
16
|
+
- In `#3 EDIT`, `.env` files, `.pulse/`, `.madre/` and `.claude/settings.local.json` are made read-only for the length of the turn and restored from the checkpoint afterwards; `.git/` stays writable because the CLIs need it and is only restored after the turn. A `.env` that git ignores is not in the checkpoint: MADRE keeps its own copy of it for the turn and puts it back if the turn changed it, deleted it or swapped it for a link. An agent that changes permissions on purpose is caught by that restoration, not prevented.
|
|
17
|
+
- **Files changed where git does not look are outside the restore point.** In a folder your `.gitignore` excludes, `UNDO` removes the files the turn created there (not in heavy folders such as `node_modules`, `dist` or `.venv`), and only while each is as the turn left it; when those folders hold more files than MADRE photographs before a turn (5,000), it cannot tell new from old and `UNDO` leaves them all. A file someone else creates there while the turn runs is taken as the turn's. A file that was already there and was changed, other than `.env`, is not in the checkpoint and `UNDO` cannot bring its old content back; the turn's card lists both kinds so you know. Keep anything you could not lose (records, data) under version control or backed up.
|
|
18
|
+
- **`#3` and `#4` are unlocked from MADRE's own page.** `#3` takes one confirmation and `#4` two, or your own phrase (once for `#3`, twice for `#4`) if you set one in Settings › Permissions; the phrase is never stored, only its salted SHA-256. The key is checked by the project itself, not by the browser. The agent's max mode in Settings › Permissions must already reach the mode, which is a separate deliberate act; no agent can raise its own ceiling, and a permission an agent writes into its own answer is not a permission.
|
|
19
|
+
- `#4 FULL ACCESS` runs commands with the CLIs and sessions already on the machine: tests, builds, `git push`, deploys. Files come back with `UNDO`; **what leaves the machine does not**. Treat `#4` as handing that agent your shell.
|
|
20
|
+
- **COPILOT** (turned on with the `#3` key, for up to 24 hours) lets the agent you write to edit the project without asking each time. The only commands it runs by itself are ones that read (files and git); tests, builds, commits and everything else wait for your button. What it deletes is put back after the turn, and anything that leaves the machine is still `#4` with its own key. After 8 rounds in a row of running and asking again it stops and asks you; STOP ALL or a restart ends it.
|
|
18
21
|
- **Runs** (a module, off until you switch it on) lets an agent below `#4` ask you to run a command. Nothing runs until you press its button, and the server runs the line it recorded the agent asking for, never one sent by the page. Each line runs alone from the project root with no shell, so the line you read is the argv that runs; lines that would need a shell (`|`, `&&`, redirections, variables, globs) are shown and refused. A checkpoint is taken first and `UNDO` restores files; what the command sends off the machine does not come back. Read a command before you press it as you would before pasting it into a terminal.
|
|
22
|
+
- **Modules you install run in separate Node processes with limited permissions.** The ordinary file and process APIs can read the module file and MADRE's SDK, but cannot directly write files or start another process. Calls to MADRE's settings, room and credential vault pass through a narrow bridge. A one-file MCP server gets the same limits, with write access to the turn's scratch folder when the turn allows it. When Node offers `--allow-net`, MADRE grants network access only to modules that declare a destination; on older Node versions, the permission model does not restrict network access. A declaration does not limit which host the module can contact. **[Node's permission model is not a security boundary against malicious code](https://nodejs.org/api/permissions.html#permissions).** Review the code and destinations before installing it. Installing one by hand (a file, an upload, or confirming a refresh) asks for the `#4` key from MADRE's page; the Market's catalog is signed.
|
|
19
23
|
- **Windows (from 1.1.0) is supported inside WSL2 only**, where MADRE works as on any Linux. Keep your projects inside Linux (`~/…`), not in `/mnt/c`: on the Windows drive the write bit MADRE uses to keep `#1`–`#3` read-only does not hold the same way. Started on Windows itself, MADRE explains how to get to WSL2 and stops.
|
|
20
|
-
-
|
|
24
|
+
- **The local API asks for a ficha** (from 1.1.3). Every request carries a random secret kept in `~/.pulse/credentials/ficha.json`, readable only by your user: the browser gets it once in the address MADRE opens and keeps it in an `HttpOnly`, `SameSite=Strict` cookie, and MADRE's own processes send it in the `x-madre-ficha` header. The address with the ficha is never written to MADRE's start, restart or update logs in a way another user can read: those files are only yours. Without the ficha MADRE says only that it is MADRE and its version. It keeps out programs that cannot read that file: other users of the computer, and anything that only reaches the port. It does not keep out a program running as you, which can read the file as it reads everything else of yours, and the browser sends the cookie to every port of `127.0.0.1` it opens.
|
|
25
|
+
- Everything said outside `#0 INCOGNITO` is kept in the room's memory and reaches every agent of that room. Use INCOGNITO for what must not be remembered.
|
|
21
26
|
|
|
22
27
|
NOBODY DELETES MOTHER'S MEMORY. EVERYTHING ELSE IS FAIR GAME.
|
package/TRADEMARKS.md
CHANGED
|
@@ -49,7 +49,9 @@ GitHub, Stripe y los demás— son marcas de sus dueños. MADRE los muestra solo
|
|
|
49
49
|
servicio se conecta cada conector (uso nominativo), no porque esos dueños respalden a MADRE ni
|
|
50
50
|
tengan relación con ella. Los dibujos vienen de [Simple Icons](https://simpleicons.org) (CC0 1.0)
|
|
51
51
|
con sus colores oficiales; los que Simple Icons no dibuja, de CoreUI Brands y SVG Logos (CC0 1.0) y
|
|
52
|
-
de VSCode Icons (MIT).
|
|
52
|
+
de VSCode Icons (MIT). Los logos de los proveedores de OpenCode (Anthropic, OpenAI, Google, Groq y
|
|
53
|
+
los demás) y los de los agentes vienen de [Lobe Icons](https://lobehub.com/icons) (MIT), en su
|
|
54
|
+
versión de un solo color y sin alterar, solo para decir de qué proveedor es cada llave. Si
|
|
53
55
|
eres dueño de una de esas marcas y prefieres que no aparezca, escribe y se quita.
|
|
54
56
|
|
|
55
57
|
## Si tienes duda
|
|
@@ -92,7 +94,9 @@ tools (MCP) — Notion, GitHub, Stripe and the rest — are their owners' tradem
|
|
|
92
94
|
only to say which service a connector reaches (nominative use), not because their owners endorse
|
|
93
95
|
or are affiliated with MADRE. The drawings come from [Simple Icons](https://simpleicons.org)
|
|
94
96
|
(CC0 1.0) with their official colors; the ones Simple Icons does not draw, from CoreUI Brands and
|
|
95
|
-
SVG Logos (CC0 1.0) and VSCode Icons (MIT).
|
|
97
|
+
SVG Logos (CC0 1.0) and VSCode Icons (MIT). The logos of OpenCode's providers (Anthropic, OpenAI,
|
|
98
|
+
Google, Groq and the rest) and of the agents come from [Lobe Icons](https://lobehub.com/icons) (MIT),
|
|
99
|
+
in their one-colour version and unaltered, only to say which provider each key is for. If
|
|
96
100
|
you own one of those marks and would rather it not appear, write and it is taken off.
|
|
97
101
|
|
|
98
102
|
In doubt, contact Jossue Alcalá at [jossuealcala.com](https://jossuealcala.com) before publishing.
|
package/bin/madre.mjs
CHANGED
|
@@ -13,8 +13,9 @@ import { probeAll } from '../src/auth-probe.mjs';
|
|
|
13
13
|
import { applyConfigToEnv, loadConfig } from '../src/config.mjs';
|
|
14
14
|
import { isOnline, runSetup } from '../src/setup.mjs';
|
|
15
15
|
import { parseArgs } from '../src/cli-args.mjs';
|
|
16
|
-
import { ensureSalasProject, isSalasRoom, projectRootFor } from '../src/salas.mjs';
|
|
16
|
+
import { choosePort, ensureSalasProject, isSalasRoom, keptPorts, projectRootFor } from '../src/salas.mjs';
|
|
17
17
|
import { forgetNpxLaunch } from '../src/npm-launch.mjs';
|
|
18
|
+
import { fichaHeaders, fichaShown, readFicha, withFicha, withoutFicha } from '../src/ficha.mjs';
|
|
18
19
|
import { createServer } from 'node:net';
|
|
19
20
|
|
|
20
21
|
// Before anything is run: what npx left about the call that started MADRE is not passed on to the
|
|
@@ -61,13 +62,27 @@ Prefer the terminal? Inside Ubuntu (WSL2):
|
|
|
61
62
|
}
|
|
62
63
|
const option = (name, fallback) => cli.option(name.replace(/^--/, ''), fallback);
|
|
63
64
|
|
|
65
|
+
// A MADRE already open for this project: its address with the ficha, said in the language MADRE
|
|
66
|
+
// speaks (Q-1; Home reads the address after it in either, src/server.mjs ALREADY_OPEN), and its page
|
|
67
|
+
// opened unless --no-open.
|
|
68
|
+
async function showOpen(url, { openBrowser = true, openPath = '' } = {}) {
|
|
69
|
+
const address = withFicha(`${url}${openPath}`, await readFicha(salasHome));
|
|
70
|
+
// The key only where a person or the app reads it (L-15, src/ficha.mjs).
|
|
71
|
+
const shown = fichaShown() ? address : withoutFicha(address);
|
|
72
|
+
console.log(`\n${t('MADRE is already open for this project')}\n\n ${shown}\n ${t('Project:')} ${projectRoot}\n ${t('Close that room first if you want a fresh one.')}\n`);
|
|
73
|
+
if (openBrowser) await openUrl(address);
|
|
74
|
+
}
|
|
75
|
+
|
|
64
76
|
// Is a MADRE already serving this very project nearby? `start` walks ports, so look along the
|
|
65
77
|
// same short stretch and compare the project each one reports.
|
|
66
78
|
async function roomAlreadyOpen(port, projectRoot, span = 8) {
|
|
67
79
|
const mine = await realpath(projectRoot).catch(() => resolve(projectRoot));
|
|
68
80
|
for (let candidate = port; candidate < port + span; candidate += 1) {
|
|
69
81
|
try {
|
|
70
|
-
|
|
82
|
+
// With the ficha (src/ficha.mjs): without it a MADRE says only that it is one, not which project.
|
|
83
|
+
// Two seconds (Q-3): a Linux that is just starting (WSL after Windows boots) took longer than
|
|
84
|
+
// the half second this had, and the CLI walked past the MADRE that was already open.
|
|
85
|
+
const response = await fetch(`http://127.0.0.1:${candidate}/api/version`, { headers: await fichaHeaders(), signal: AbortSignal.timeout(2000) });
|
|
71
86
|
if (!response.ok) continue;
|
|
72
87
|
const info = await response.json();
|
|
73
88
|
const theirs = info?.project ? await realpath(info.project).catch(() => info.project) : null;
|
|
@@ -93,11 +108,13 @@ const HELP_TEXT = `MADRE
|
|
|
93
108
|
Opens Home: every project on this computer, in one place.
|
|
94
109
|
madre start [--project PATH] [--port 4317] [--no-open] [--setup]
|
|
95
110
|
Opens the project in this folder (or PATH) directly.
|
|
96
|
-
Without --port,
|
|
111
|
+
Without --port, the project opens on the port it kept, or the next free one.
|
|
97
112
|
madre lobby [--port 4317] [--no-open] (also: madre salas; opens Home)
|
|
98
113
|
madre setup [--project PATH] [--port 4317] [--no-open]
|
|
99
114
|
madre doctor [--project PATH] [--json]
|
|
100
115
|
madre check-module --file <module.mjs> [--entry <entrada.json>] [--json] [--lang es]
|
|
116
|
+
madre check-skill --folder <habilidades/id> [--json] [--lang es]
|
|
117
|
+
madre servicio [activar|quitar|estado] (Linux)
|
|
101
118
|
|
|
102
119
|
(none) Opens Home. From there you add projects, connect the agents
|
|
103
120
|
and enter any project. The Coordinator lives there.
|
|
@@ -105,6 +122,8 @@ const HELP_TEXT = `MADRE
|
|
|
105
122
|
setup Detects the agents on this computer, shows who has a session,
|
|
106
123
|
and runs each agent's own sign-in from here.
|
|
107
124
|
doctor Prints the same diagnosis without the wizard.
|
|
125
|
+
servicio Home starts with this Linux and comes back if it falls,
|
|
126
|
+
with the projects that were open.
|
|
108
127
|
`;
|
|
109
128
|
|
|
110
129
|
// Where a room without --port starts looking (QA 1.1.0, GEN-02): 4317, or PULSE_PORT_BASE for the
|
|
@@ -128,19 +147,34 @@ async function openRoom(options) {
|
|
|
128
147
|
console.error(`\n MADRE › port ${port} is already in use. Another MADRE may be open there; try --port ${port + 1} or omit --port to pick one automatically.\n`);
|
|
129
148
|
process.exit(2);
|
|
130
149
|
}
|
|
150
|
+
// Without --port, a project asks for the port it kept, and one with none skips the ports other
|
|
151
|
+
// projects keep (src/salas.mjs, L-6): a project's number no longer depends on what opened first.
|
|
152
|
+
let others = new Set();
|
|
153
|
+
if (!explicit) {
|
|
154
|
+
const kept = await keptPorts(salasHome, await realpath(projectRoot).catch(() => resolve(projectRoot)));
|
|
155
|
+
others = kept.others;
|
|
156
|
+
port = await choosePort({ base: port, mine: kept.mine, others, taken: portTaken });
|
|
157
|
+
}
|
|
131
158
|
for (let attempt = 0; attempt < 20; attempt += 1) {
|
|
132
159
|
try {
|
|
133
160
|
return await startPulse({ ...options, port });
|
|
134
161
|
} catch (error) {
|
|
135
|
-
// The room itself says it is taken, whatever port this attempt used.
|
|
136
|
-
|
|
162
|
+
// The room itself says it is taken, whatever port this attempt used. Where it says it is open,
|
|
163
|
+
// that page is shown, as a MADRE found before starting is (Q-3: the Windows shortcut opened a
|
|
164
|
+
// second time, in a Linux slow to answer the look below, left the person with nothing).
|
|
165
|
+
if (error.code === 'ROOM_IN_USE') {
|
|
166
|
+
if (Number.isInteger(error.port)) { await showOpen(`http://127.0.0.1:${error.port}`, options); process.exit(0); }
|
|
167
|
+
console.error(`\n MADRE › ${error.message}\n`);
|
|
168
|
+
process.exit(2);
|
|
169
|
+
}
|
|
137
170
|
if (error.code !== 'EADDRINUSE') throw error;
|
|
138
171
|
if (explicit) {
|
|
139
172
|
console.error(`\n MADRE › port ${port} is already in use. Another MADRE may be open there; try --port ${port + 1} or omit --port to pick one automatically.\n`);
|
|
140
173
|
process.exit(2);
|
|
141
174
|
}
|
|
142
|
-
|
|
143
|
-
port += 1;
|
|
175
|
+
const busy = port;
|
|
176
|
+
do port += 1; while (others.has(port));
|
|
177
|
+
console.error(` MADRE › port ${busy} in use, trying ${port}.`);
|
|
144
178
|
}
|
|
145
179
|
}
|
|
146
180
|
console.error(`\n MADRE › no free port between ${options.port} and ${port}. Pass --port explicitly.\n`);
|
|
@@ -171,7 +205,7 @@ if (has('--version') || has('-v') || command === 'version') {
|
|
|
171
205
|
}
|
|
172
206
|
// A command that only reads leaves nothing behind (QA 1.1.0, NUE-37): after uninstalling, `madre
|
|
173
207
|
// doctor` made ~/.pulse again, with Home's folder and the update cache in it.
|
|
174
|
-
const onlyReads = command === 'doctor' || command === 'check-module';
|
|
208
|
+
const onlyReads = command === 'doctor' || command === 'check-module' || command === 'check-skill';
|
|
175
209
|
if (command !== 'help' && !(onlyReads && isSalasRoom(projectRoot, salasHome))) {
|
|
176
210
|
// The notebook of Salas is MADRE's own folder: made here, empty, the first time it is opened
|
|
177
211
|
// (D-S08). If it cannot be made, the check below says so, as for any folder that is not there.
|
|
@@ -225,7 +259,7 @@ if (command === 'doctor' && (has('--catalog') || has('--conditions'))) {
|
|
|
225
259
|
const result = await exportDataset({ events: await store.readAll(), notes: memory ? memory.memories({ limit: 5000 }) : [], dir: join(roomDir, 'dataset'), project: basename(canonical), home: homedir() });
|
|
226
260
|
memory?.close();
|
|
227
261
|
if (has('--json')) console.log(JSON.stringify(result, null, 2));
|
|
228
|
-
else console.log(`\nMADRE dataset · ${result.project}\n\n pairs ${result.pairs} (${result.turns} turns · ${result.notes} notes)\n train ${result.train}\n valid ${result.valid}\n by agent ${Object.entries(result.byAgent).map(([id, n]) => `@${id} ${n}`).join(' · ') || '-'}\n folder ${result.dir}\n\n Train it: docs/training/README.md (mlx-lm on Apple Silicon), then \`ollama create madre-${result.project.toLowerCase().replace(/[^a-z0-9]+/g, '-')}\` and @madre picks it up.\n`);
|
|
262
|
+
else console.log(`\nMADRE dataset · ${result.project}\n\n pairs ${result.pairs} (${result.turns} turns · ${result.notes} notes)\n train ${result.train}\n valid ${result.valid}\n test ${result.test}\n by agent ${Object.entries(result.byAgent).map(([id, n]) => `@${id} ${n}`).join(' · ') || '-'}\n folder ${result.dir}\n\n Train it: docs/training/README.md (mlx-lm on Apple Silicon), then \`ollama create madre-${result.project.toLowerCase().replace(/[^a-z0-9]+/g, '-')}\` and @madre picks it up.\n`);
|
|
229
263
|
process.exitCode = 0;
|
|
230
264
|
} else if (command === 'doctor') {
|
|
231
265
|
const agents = await detectAgents();
|
|
@@ -287,8 +321,7 @@ if (command === 'doctor' && (has('--catalog') || has('--conditions'))) {
|
|
|
287
321
|
// A room for this project may already be open. Show that one instead of starting a second.
|
|
288
322
|
const running = await roomAlreadyOpen(port, projectRoot);
|
|
289
323
|
if (running) {
|
|
290
|
-
|
|
291
|
-
if (!noOpen) await openUrl(`${running.url}${openPath}`);
|
|
324
|
+
await showOpen(running.url, { openBrowser: !noOpen, openPath });
|
|
292
325
|
process.exit(0);
|
|
293
326
|
}
|
|
294
327
|
await openRoom({ port, projectRoot, openBrowser: !noOpen, openPath });
|
|
@@ -309,6 +342,38 @@ if (command === 'doctor' && (has('--catalog') || has('--conditions'))) {
|
|
|
309
342
|
if (has('--json')) console.log(JSON.stringify({ ...result, markdown: undefined }, null, 2));
|
|
310
343
|
else console.log(result.markdown);
|
|
311
344
|
process.exitCode = result.ok ? 0 : 1;
|
|
345
|
+
} else if (command === 'check-skill') {
|
|
346
|
+
// The same check for a skill (src/skill-check.mjs): what the madre-mercado repository's CI runs on
|
|
347
|
+
// every pull request that adds habilidades/<id>/, and what anyone can run before sending one.
|
|
348
|
+
const folder = option('--folder', null) ?? option('--dir', null);
|
|
349
|
+
if (!folder) { console.error('Usage: madre check-skill --folder <habilidades/id> [--json] [--lang es]'); process.exit(2); }
|
|
350
|
+
(await import('../src/i18n.mjs')).setLanguage(option('--lang', 'en'));
|
|
351
|
+
const { checkSkillFolder } = await import('../src/skill-check.mjs');
|
|
352
|
+
const result = await checkSkillFolder(folder);
|
|
353
|
+
if (has('--json')) console.log(JSON.stringify({ ...result, markdown: undefined }, null, 2));
|
|
354
|
+
else console.log(result.markdown);
|
|
355
|
+
process.exitCode = result.ok ? 0 : 1;
|
|
356
|
+
} else if (command === 'servicio' || command === 'service') {
|
|
357
|
+
// MADRE as a service of this Linux (src/service.mjs, L-3): the same switch as Home › Settings.
|
|
358
|
+
const { disableService, enableService, launcherScript, serviceState } = await import('../src/service.mjs');
|
|
359
|
+
const { detectInstall } = await import('../src/updates.mjs');
|
|
360
|
+
const pkg = JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8'));
|
|
361
|
+
const action = process.argv.slice(3).find((word) => !word.startsWith('-')) ?? 'estado';
|
|
362
|
+
const launcher = launcherScript({ install: detectInstall({ projectRoot: process.cwd() }), name: pkg.name, version: pkg.version, port: Number(option('--port', DEFAULT_PORT)) });
|
|
363
|
+
const state = ['activar', 'on', 'enable'].includes(action) ? await enableService({ stateRoot: salasHome, launcher })
|
|
364
|
+
: ['quitar', 'off', 'disable'].includes(action) ? await disableService({ stateRoot: salasHome })
|
|
365
|
+
: ['estado', 'status'].includes(action) ? await serviceState()
|
|
366
|
+
: null;
|
|
367
|
+
if (!state) { console.error(t('Usage: madre servicio [activar|quitar|estado]')); process.exit(2); }
|
|
368
|
+
if (!state.supported) console.log(`\n ${state.why === 'linux' ? t('MADRE starts with the computer only on Linux, as a systemd service.') : t('This Linux has no systemd for your user, so MADRE cannot start with it.')}\n`);
|
|
369
|
+
else if (state.refused === 'install') console.log(`\n ${t('This copy of MADRE was installed inside a project; install it with npx or npm -g to start it with the computer.')}\n`);
|
|
370
|
+
else if (state.refused) console.log(`\n ${t('systemd did not turn the service on: {detail}', { detail: state.detail ?? '' })}\n`);
|
|
371
|
+
else {
|
|
372
|
+
console.log(`\n ${state.enabled ? t('On: Home starts when this computer does, and again if it falls, with the projects that were open.') : t('Off: MADRE starts only when you open it.')}`);
|
|
373
|
+
if (state.enabled && !state.linger) console.log(` ${t('For it to start before anyone signs in, run this once: {command}', { command: state.lingerCommand })}`);
|
|
374
|
+
console.log('');
|
|
375
|
+
}
|
|
376
|
+
process.exitCode = state.supported && !state.refused ? 0 : 1;
|
|
312
377
|
} else if (command === 'help') {
|
|
313
378
|
console.log(t(HELP_TEXT));
|
|
314
379
|
} else {
|
package/docs/REFERENCE.md
CHANGED
|
@@ -14,7 +14,7 @@ Todo lo que MADRE hace, con los números exactos. Para empezar en cinco minutos,
|
|
|
14
14
|
Necesitas Node 22.5 o superior y al menos una de estas CLIs con sesión iniciada: **Codex**, **Claude Code**, **Gemini CLI**, **OpenCode**. Si además corre **Ollama** con un modelo de chat, el proyecto tiene un quinto agente local.
|
|
15
15
|
|
|
16
16
|
1. Corre `npx @jossuealcala/madre` desde cualquier carpeta: abre Inicio, con todos tus proyectos y el Coordinador arriba. La primera vez lo acompaña un asistente de tres pasos: conectar los agentes (cada uno con su botón para instalarlo y firmarlo, ahí mismo; una vez para todos los proyectos), agregar los proyectos (eliges carpetas dentro de tu carpeta de usuario; agregar no abre) y abrir los que vas a usar. `npx @jossuealcala/madre start` dentro de una carpeta sigue abriendo ese proyecto directo; si no hay agentes, el proyecto abre igual en Conecta tus agentes para instalarlos y firmarlos.
|
|
17
|
-
2. El proyecto abre en `http://127.0.0.1:4317`. Elige un agente en el selector o escribe `@claude …`. El chip junto a `to @agente` dice en qué modo sale el mensaje; `#1 SOLO CONVERSAR`, solo lectura, es el predeterminado.
|
|
17
|
+
2. El proyecto abre en `http://127.0.0.1:4317`. MADRE abre el navegador con su ficha en la dirección (`?ficha=…`): el navegador la guarda y la dirección queda limpia. Elige un agente en el selector o escribe `@claude …`. El chip junto a `to @agente` dice en qué modo sale el mensaje; `#1 SOLO CONVERSAR`, solo lectura, es el predeterminado.
|
|
18
18
|
3. Para sumar o reconectar una IA más tarde: Ajustes → Agentes (el botón de ajustes de la barra, o ⌘, / Ctrl+,), donde los agentes viven junto al resto de los ajustes. Codex, Claude Code, Gemini (con tu cuenta de Google) y OpenCode (con GitHub Copilot) se firman con un clic; Gemini y OpenCode también aceptan su llave ahí mismo. Debajo de cada agente, «¿Prefieres tu terminal?» despliega el mismo paso escrito como comando, para quien prefiera hacerlo a mano. MADRE no guarda credenciales de proveedores: cada sesión y cada llave van al archivo de su propio CLI.
|
|
19
19
|
4. Con Ollama, el módulo IA local (Módulos, en la barra) ya está encendido: la memoria se embebe localmente y `@madre` aparece en la fila.
|
|
20
20
|
5. Ajustes → Memoria decide quién destila la memoria y cada cuánto. El Mapa de memoria, desde la cabecera de Diagnóstico, muestra lo que el proyecto recuerda.
|
|
@@ -25,7 +25,7 @@ npx @jossuealcala/madre setup # el mismo alta, desde la terminal, si la pr
|
|
|
25
25
|
npx @jossuealcala/madre start --no-open --project RUTA
|
|
26
26
|
```
|
|
27
27
|
|
|
28
|
-
**En un servidor, sin pantalla.** MADRE escucha solo en `127.0.0.1` de la máquina donde corre, y es a propósito:
|
|
28
|
+
**En un servidor, sin pantalla.** MADRE escucha solo en `127.0.0.1` de la máquina donde corre, y es a propósito: quien llegara a ella podría poner a trabajar a los agentes ahí. No abras sus puertos a la red. Para usarla en un servidor, ábrela por un túnel SSH desde tu computadora. Inicio usa el 4317 y cada proyecto que abras toma el siguiente puerto libre (4318, 4319…), así que el túnel lleva varios; si abres más proyectos, agrega más `-L`.
|
|
29
29
|
|
|
30
30
|
```bash
|
|
31
31
|
# en tu computadora: entra al servidor con el túnel
|
|
@@ -34,7 +34,9 @@ ssh -L 4317:127.0.0.1:4317 -L 4318:127.0.0.1:4318 -L 4319:127.0.0.1:4319 -L 4320
|
|
|
34
34
|
npx @jossuealcala/madre --no-open
|
|
35
35
|
```
|
|
36
36
|
|
|
37
|
-
Luego abre
|
|
37
|
+
Luego abre en el navegador de tu computadora la dirección que MADRE escribió en la terminal del servidor, la que termina en `?ficha=…`. Los agentes se instalan en el servidor y se conectan desde Ajustes › Agentes: Claude te da un enlace y un código que pegas ahí mismo, y Gemini y OpenCode aceptan su llave. Usa tu usuario y no root: los agentes trabajan con los permisos de quien corre MADRE.
|
|
38
|
+
|
|
39
|
+
**La ficha.** Cada petición a MADRE lleva su ficha: un secreto al azar en `~/.pulse/credentials/ficha.json`, que solo tu usuario puede leer. El navegador la recibe una vez, en la dirección que MADRE abre, y la guarda en una cookie; los procesos de MADRE la mandan en la cabecera `x-madre-ficha`. Sin ella, MADRE solo dice que es MADRE y su versión: no deja leer tus proyectos, ni instalar módulos, ni abrir #4. Inicio hace una nueva cada vez que arranca y abre el navegador; un reinicio sin navegador (una actualización, un proyecto que abre Inicio) conserva la de antes. Una pestaña sin ficha te dice desde dónde abrir MADRE. Lo que no frena: un programa que corre con tu usuario puede leer el archivo, como lee todo lo tuyo, y la cookie también viaja a otros puertos de `127.0.0.1` que abras en el mismo navegador.
|
|
38
40
|
|
|
39
41
|
**Tres nombres.** **MADRE** es el producto. **Diagnóstico** es su voz operativa: fallas, conexiones, ajustes. **Historial** es el canal sobre el que corre el proyecto: el registro de eventos, el bloque del plan, la carpeta `.pulse/` donde caen los artefactos; esos identificadores conservan su nombre de antes, PULSE.
|
|
40
42
|
|
|
@@ -116,9 +118,9 @@ Cada mensaje sale con un modo. Tu modo es el techo de cualquier plan que ese men
|
|
|
116
118
|
| **OpenCode** | sí | `-f` | permisos `edit` por patrón | sí, con **Imágenes** | webfetch / websearch |
|
|
117
119
|
| **@madre** | la memoria | no | no | no | no |
|
|
118
120
|
|
|
119
|
-
**Imágenes** es un módulo de MADRE: un servidor MCP propio que expone `generate_image` sobre
|
|
121
|
+
**Imágenes** es un módulo de MADRE: un servidor MCP propio que expone `generate_image` sobre el modelo de imágenes que elijas en Módulos › Imágenes —Gemini (Google), GPT Image (OpenAI) o Grok Imagine (xAI)—, con tu propia llave y tu saldo; todos cobran cada imagen, ninguno tiene nivel gratis para imágenes. La página del módulo, «Con qué dibuja», muestra lo que ya tienes sin preguntarte: la llave de Gemini que usa Gemini CLI (`~/.gemini/.env` o el llavero), las de OpenAI, xAI o Google que usa OpenCode (su `auth.json`), la de OpenAI con la que entró Codex, y `GEMINI_API_KEY`, `OPENAI_API_KEY` o `XAI_API_KEY` si MADRE se abrió con ellas. Lo que no tienes aparece con qué es, dónde se consigue la llave y un campo para pegarla: la de Gemini se guarda donde la lee Gemini CLI; la de OpenAI o xAI, en la bóveda de MADRE (`~/.pulse/credentials/image-studio.json`, `0600`), después de preguntarle al proveedor si la acepta (lista modelos, no gasta saldo). Mientras no elijas, dibuja el primero cuya llave encuentre. El servidor lee la llave él mismo al dibujar: no viaja en su entorno, que en Claude Code va en los argumentos. Ollama dibujó un tiempo solo en Mac y hoy no lo hace, así que no se ofrece. Se conecta a Claude, Gemini y OpenCode solo dentro de un permiso CREAR con el alcance de imágenes encendido, en sus homes aislados, y la imagen cae en la carpeta del turno como cualquier artefacto. `/image <petición>` arma el permiso y enruta al agente que puede generar. Codex y Grok dibujan con su propia cuenta; los demás, con Imágenes.
|
|
120
122
|
|
|
121
|
-
El acceso web es un permiso permanente por agente,
|
|
123
|
+
El acceso web es un permiso permanente por agente, encendido por defecto, que se apaga en Ajustes → Agentes, con Acceso a la web.
|
|
122
124
|
|
|
123
125
|
### Subagentes de cada IA
|
|
124
126
|
|
|
@@ -129,7 +131,7 @@ Desde 1.1.0, de **#1 a #3**, Claude, OpenCode y Codex pueden repartir su trabajo
|
|
|
129
131
|
| **Claude** | Herramienta `Agent`: el subagente hereda las mismas herramientas y reglas (`--tools`, `--allowedTools`, `dontAsk`) | Sin `Agent` |
|
|
130
132
|
| **OpenCode** | Solo `explore` y `general`, cada uno con los permisos del turno y sin poder llamar a otro (los de fábrica de OpenCode escriben y corren comandos) | `task` negado |
|
|
131
133
|
| **Codex** | Sus subagentes quedan dentro de la misma caja de arena | Límite de un hilo: `features.multi_agent_v2.max_concurrent_threads_per_session=1` |
|
|
132
|
-
| **Gemini** · **Cursor** | No | No |
|
|
134
|
+
| **Gemini** · **Cursor** · **Grok** | No | No |
|
|
133
135
|
|
|
134
136
|
Probado con las IAs reales (Claude 2.1.267, OpenCode 1.18.4, Codex 0.161): en #1 el subagente lee y no escribe; en #3 escribe en el proyecto, `.pulse/` lo rechaza y no hay comandos; en #4 Codex responde «agent thread limit reached».
|
|
135
137
|
|
|
@@ -153,7 +155,7 @@ MADRE ejecuta los pasos como turnos normales: cada uno queda en el ledger, pasa
|
|
|
153
155
|
|
|
154
156
|
**TURNOS.** En Diagnóstico, junto al centinela. Encendido por defecto: una conversación que sigue trabajando cuando abres otra no se detiene, sigue escribiendo su registro y el panel de conversaciones la marca hasta que termina. Dos límites: conversaciones trabajando a la vez (2) y turnos a la vez en cada una (3); un mensaje que los pasaría se rechaza con el motivo antes de empezar. Todas las conversaciones comparten un solo titular de EDITAR o ACCESO TOTAL. Apagado, una sola conversación maneja a los agentes y no se puede cambiar de una que está trabajando. `DETENER TODO` detiene todas.
|
|
155
157
|
|
|
156
|
-
**DETENER TODO.** El botón de la barra, `STOPALL` en la caja de Escribir o `curl -X POST http://127.0.0.1:4317/api/stop-all` detienen todos los planes y matan todos los procesos de agente. Diagnóstico avisa en rojo cuando el proyecto se escapa: tres agentes a la vez, un agente con dos turnos cruzados, un plan de más de cinco minutos.
|
|
158
|
+
**DETENER TODO.** El botón de la barra, `STOPALL` en la caja de Escribir o `curl -X POST -H "x-madre-ficha: $(node -p "require(require('os').homedir() + '/.pulse/credentials/ficha.json').ficha")" http://127.0.0.1:4317/api/stop-all` detienen todos los planes y matan todos los procesos de agente. Diagnóstico avisa en rojo cuando el proyecto se escapa: tres agentes a la vez, un agente con dos turnos cruzados, un plan de más de cinco minutos.
|
|
157
159
|
|
|
158
160
|
---
|
|
159
161
|
|
|
@@ -199,7 +201,7 @@ Cambia a quién va y las palabras cambian; sube el modo y aparece el permiso que
|
|
|
199
201
|
|
|
200
202
|
**THE LAUNCH.** Debajo del documento, el comando exacto que MADRE correría para entregarlo: el ejecutable, el directorio, cada bandera y el lugar donde entra el briefing. No es una descripción — lo arman los mismos adaptadores que lo armarían de verdad. Debajo, lo que mantiene la corrida dentro del turno (la sesión que no persiste, el hogar temporal que se borra al terminar) y los servidores MCP que podría llamar, con sus herramientas contadas. **De ese comando nunca se imprime un valor de entorno, solo los nombres**: una línea de comandos es algo que la gente fotografía.
|
|
201
203
|
|
|
202
|
-
**Envíos.** El registro de
|
|
204
|
+
**Envíos.** El registro de llamadas `fetch` de MADRE y de sus módulos, incluidos los módulos aislados y sus servidores MCP de un solo archivo. No observa otros protocolos de Node ni las conexiones de las CLI de los agentes. Nunca guarda cuerpos, cabeceras ni valores de consulta: solo el destino y cuántas veces se llamó.
|
|
203
205
|
|
|
204
206
|
**La consola.** Dentro del núcleo, Diagnóstico contesta desde lo que el proyecto ya tiene. Tres respuestas que no entiende y la interfaz se cierra.
|
|
205
207
|
|
|
@@ -223,7 +225,7 @@ El botón de la barra abre la pantalla de diagnóstico. Escribe un síntoma, un
|
|
|
223
225
|
| Módulo | Qué añade |
|
|
224
226
|
|---|---|
|
|
225
227
|
| **Git** | `/git status`, `/git log [n]`, `/git diff`, `/git branches`: hechos del repositorio como tarjeta en el hilo, que los agentes también leen. `/git commit "mensaje"` y `/git push confirm`: tu mano sobre el repositorio, con vista previa de lo que saldría |
|
|
226
|
-
| **Imágenes** | `generate_image` para Claude, Gemini y OpenCode, con tu
|
|
228
|
+
| **Imágenes** | `generate_image` para Claude, Gemini y OpenCode, con tu llave de Gemini, OpenAI o xAI, dentro de CREAR |
|
|
227
229
|
| **Vista previa** | El visor renderiza HTML, SVG y Markdown en un marco sellado, con recarga automática |
|
|
228
230
|
| **IA local** | Búsqueda inteligente, archivista y `@madre` en local, gratis y sin cuenta. Se instala, se despierta y descarga su modelo desde Conecta tus agentes |
|
|
229
231
|
| **Navegador de pruebas** | Un navegador headless en los turnos que piden ver, probar o capturar una página. Solo alcanza esta MADRE y los servidores que arrancaste desde COMANDOS: abrir la Vista previa o la app servida, hacer clic, leer consola, capturas al borrador del turno. Al encenderlo, MADRE comprueba que el servidor arranque con su navegador. Requiere `@playwright/mcp` |
|
|
@@ -342,8 +344,10 @@ La carpeta de MADRE se borra entera solo si es suya sin duda: ruta absoluta, nun
|
|
|
342
344
|
## LO QUE SALE DE LA MÁQUINA
|
|
343
345
|
|
|
344
346
|
- **Sin nube ni cuenta.** MADRE no tiene cuenta ni backend que guarde lo tuyo. No guarda credenciales de proveedores.
|
|
345
|
-
- **Lo que un agente lee, viaja a su proveedor.** Codex a OpenAI, Claude Code a Anthropic, Gemini CLI a Google, OpenCode a quien tenga configurado. Si `OPENAI_BASE_URL
|
|
347
|
+
- **Lo que un agente lee, viaja a su proveedor.** Codex a OpenAI, Claude Code a Anthropic, Gemini CLI a Google, OpenCode a quien tenga configurado. Si `OPENAI_BASE_URL`, `ANTHROPIC_BASE_URL` o la configuración de usuario de Codex cambia ese destino, MADRE enseña solo el hostname y bloquea el turno antes de armar el briefing; un gateway verificado se autoriza por agente con `PULSE_ALLOW_CUSTOM_AGENT_ENDPOINTS`. Una ruta de Codex que MADRE no pueda identificar también se bloquea. Aplican la cuenta, los límites y los términos del destino efectivo. `@madre` y el archivista con Ollama no salen de la máquina.
|
|
348
|
+
- **Gemini sin su CLI.** Con solo una llave de Gemini (`GEMINI_API_KEY` o la que pegas en Ajustes › Agentes, que se guarda en `~/.gemini/.env`) y sin el CLI instalado, `@gemini` contesta por la API de Google: el propio proceso de MADRE envía el informe con tu llave en una cabecera, y la salida queda en el registro como «Google · Gemini, por su API». Así solo contesta (#1 como máximo): no lee el proyecto ni los adjuntos, y no escribe. Al instalar el CLI de Gemini, sus turnos vuelven al CLI. Antes de guardar una llave, MADRE le pregunta a Google si la acepta.
|
|
346
349
|
- **Un aviso diario de que sigue en uso, siempre encendido.** Una vez al día cada copia le dice a madre.run que está en uso: un identificador al azar que la copia creó para sí (`~/.pulse/install-id`), la versión de MADRE, el sistema y la versión mayor de Node. Nada más: ni nombre, ni correo, ni proyecto, ni rutas, ni agentes, ni nada de lo que se dice en un proyecto; madre.run no guarda la IP. Es la forma en que el autor sabe cuántas personas usan MADRE, qué versiones corren y si regresan. Sale por el mismo registro que todo lo demás, así que aparece en «Lo que se envía». Sin red, falla en silencio. (`src/heartbeat.mjs`)
|
|
350
|
+
- **Los avisos del autor.** Al abrir y a lo más cada 15 minutos, MADRE le pide a madre.run los avisos que su autor escribió para todas las copias (una versión con un arreglo de seguridad, un servicio que se detiene). No envía nada de ti: ni identificador ni versión; cada copia decide por su cuenta qué avisos son para ella. Cada aviso viene firmado con la llave del autor, y MADRE no muestra ninguno cuya firma no compruebe (`src/notices-key.mjs`), así que madre.run no puede inventar ni cambiar uno. No depende del diagnóstico. Los de información y los importantes se apagan en Ajustes › Versión › Avisos de MADRE; los de seguridad se muestran siempre. Si tienes el diagnóstico encendido, se cuenta que se vio un aviso, nunca quién lo vio. (`src/notices.mjs`)
|
|
347
351
|
- **Diagnóstico anónimo, encendido salvo que lo apagues.** Desde 2026-10-28, cada copia guarda en `~/.pulse/telemetry/` las fallas que encuentra (las que Diagnóstico conoce, con su código MU, y las que nadie ha catalogado; fallos del proceso, rutas que se rompen, errores de la página, instalaciones que no terminan) y cuántos turnos, modos y funciones se usaron. Una vez al día, y poco después de una falla nunca vista, lo manda a madre.run con los mismos cuatro datos del aviso diario, su arquitectura y si corre en WSL; después lo borra. Los mensajes van sin rutas (cada una sale como `<path>`), sin nombres de usuario, llaves ni correos, y de cada falla solo las líneas del código de MADRE por donde pasó. Nunca lo que escribes, tus proyectos ni tus archivos. Se apaga en Ajustes › Versión e informes › «Enviar diagnóstico anónimo» (y se borra lo que esperaba) o con `PULSE_TELEMETRY=0`; ahí mismo se ve el lote exacto que saldría. (`src/telemetry.mjs`, `public/page-errors.js`)
|
|
348
352
|
- **Cómo corre cada copia, su ciclo de vida y si está encendida ahora (desde 1.1.0, dentro del diagnóstico anónimo y con su mismo interruptor).**
|
|
349
353
|
- **Entorno**, como números y nombres de partes de MADRE:
|
|
@@ -405,6 +409,8 @@ La carpeta de MADRE se borra entera solo si es suya sin duda: ruta absoluta, nun
|
|
|
405
409
|
| `PULSE_DELEGATION` · `PULSE_MAX_PLAN_STEPS` | `1` · `4` | Planes |
|
|
406
410
|
| `PULSE_ESCALATION_MS` | `180000` | Cronómetro de la solicitud de permiso |
|
|
407
411
|
| `PULSE_OPENCODE_MODEL` | del config | `proveedor/modelo` para OpenCode |
|
|
412
|
+
| `PULSE_GROK_MODEL` | el de Grok | Modelo de Grok cuando no se elige uno (`grok models` los lista) |
|
|
413
|
+
| `PULSE_GROK_SANDBOX` | `read-only` | `off` quita `--sandbox` donde el aislamiento de Grok no arranca; `--tools` sigue limitándolo a leer |
|
|
408
414
|
| `PULSE_CLAUDE_USAGE` · `PULSE_OFFICIAL_QUOTA` | `0` · `1` | Cuota oficial de Claude (lee el llavero); `0` apaga todas las lecturas de proveedor |
|
|
409
415
|
| `PULSE_GEMINI_IDLE_MS` · `PULSE_GEMINI_RETRIES` · `PULSE_GEMINI_FALLBACK_MODEL` | `90000` · `1` · `gemini-3-flash-preview` (vacío: sin respaldo) | Gemini bajo carga |
|
|
410
416
|
|