@jossuealcala/madre 1.0.3 → 1.0.5

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.
Files changed (106) hide show
  1. package/CHANGELOG.en.md +113 -1
  2. package/CHANGELOG.md +113 -1
  3. package/NOTICE +30 -0
  4. package/README.en.md +59 -156
  5. package/README.md +60 -161
  6. package/TRADEMARKS.md +18 -0
  7. package/bin/madre.mjs +2 -2
  8. package/docs/REFERENCE.md +1 -1
  9. package/docs/SDK.md +25 -4
  10. package/docs/en/REFERENCE.md +1 -1
  11. package/docs/en/SDK.md +22 -2
  12. package/docs/madre-banner.png +0 -0
  13. package/package.json +1 -1
  14. package/public/app.js +1087 -247
  15. package/public/assets/manual/madre-manual-en.pdf +0 -0
  16. package/public/assets/manual/madre-manual-es.pdf +0 -0
  17. package/public/assets/manual/shots/en-agents.webp +0 -0
  18. package/public/assets/manual/shots/en-code.webp +0 -0
  19. package/public/assets/manual/shots/en-composer.webp +0 -0
  20. package/public/assets/manual/shots/en-connectors.webp +0 -0
  21. package/public/assets/manual/shots/en-continuity.webp +0 -0
  22. package/public/assets/manual/shots/en-coordinator.webp +0 -0
  23. package/public/assets/manual/shots/en-copilot.webp +0 -0
  24. package/public/assets/manual/shots/en-diagnostics.webp +0 -0
  25. package/public/assets/manual/shots/en-home.webp +0 -0
  26. package/public/assets/manual/shots/en-local.webp +0 -0
  27. package/public/assets/manual/shots/en-memory.webp +0 -0
  28. package/public/assets/manual/shots/en-modes.webp +0 -0
  29. package/public/assets/manual/shots/en-modules.webp +0 -0
  30. package/public/assets/manual/shots/en-notes.webp +0 -0
  31. package/public/assets/manual/shots/en-settings.webp +0 -0
  32. package/public/assets/manual/shots/en-windows.webp +0 -0
  33. package/public/assets/manual/shots/es-agents.webp +0 -0
  34. package/public/assets/manual/shots/es-code.webp +0 -0
  35. package/public/assets/manual/shots/es-composer.webp +0 -0
  36. package/public/assets/manual/shots/es-connectors.webp +0 -0
  37. package/public/assets/manual/shots/es-continuity.webp +0 -0
  38. package/public/assets/manual/shots/es-coordinator.webp +0 -0
  39. package/public/assets/manual/shots/es-copilot.webp +0 -0
  40. package/public/assets/manual/shots/es-diagnostics.webp +0 -0
  41. package/public/assets/manual/shots/es-home.webp +0 -0
  42. package/public/assets/manual/shots/es-local.webp +0 -0
  43. package/public/assets/manual/shots/es-memory.webp +0 -0
  44. package/public/assets/manual/shots/es-modes.webp +0 -0
  45. package/public/assets/manual/shots/es-modules.webp +0 -0
  46. package/public/assets/manual/shots/es-notes.webp +0 -0
  47. package/public/assets/manual/shots/es-settings.webp +0 -0
  48. package/public/assets/manual/shots/es-windows.webp +0 -0
  49. package/public/en.js +74 -0
  50. package/public/es.js +495 -137
  51. package/public/i18n.js +45 -7
  52. package/public/index.html +2 -3
  53. package/public/manual-content.js +657 -0
  54. package/public/manual-shots.js +43 -0
  55. package/public/manual.css +228 -0
  56. package/public/manual.html +15 -0
  57. package/public/manual.js +398 -0
  58. package/public/market-art.js +56 -0
  59. package/public/market-view.js +140 -22
  60. package/public/market.js +25 -14
  61. package/public/mcp-catalog.js +62 -0
  62. package/public/resay.js +1 -0
  63. package/public/salas-mac.css +185 -30
  64. package/public/salas-mac.html +5 -5
  65. package/public/salas-mac.js +475 -68
  66. package/public/styles.css +306 -42
  67. package/public/tour-chapters.js +98 -90
  68. package/public/tour.js +63 -21
  69. package/public/troubleshooting.js +145 -10
  70. package/src/adapters/cursor.mjs +56 -7
  71. package/src/adapters/gemini.mjs +12 -1
  72. package/src/adapters/madre.mjs +27 -6
  73. package/src/adapters/process.mjs +5 -2
  74. package/src/auth-probe.mjs +22 -3
  75. package/src/bridge/policy.mjs +1 -1
  76. package/src/bridge/server.mjs +1 -1
  77. package/src/capabilities.mjs +3 -3
  78. package/src/credentials.mjs +24 -2
  79. package/src/history.mjs +76 -0
  80. package/src/i18n.mjs +23 -1
  81. package/src/local-ai.mjs +10 -2
  82. package/src/looks.mjs +17 -5
  83. package/src/market-license.mjs +104 -0
  84. package/src/market-remote.mjs +17 -1
  85. package/src/mcp/notes-server.mjs +120 -0
  86. package/src/mcp/proxy.mjs +14 -3
  87. package/src/models.mjs +82 -9
  88. package/src/modules/index.mjs +3 -1
  89. package/src/modules/local-models.mjs +28 -0
  90. package/src/modules/notes.mjs +142 -0
  91. package/src/modules/ollama.mjs +39 -10
  92. package/src/modules/playwright.mjs +14 -3
  93. package/src/modules/reminders.mjs +345 -0
  94. package/src/modules/sdk.mjs +21 -5
  95. package/src/mother.mjs +11 -1
  96. package/src/ollama.mjs +2 -2
  97. package/src/opencode-health.mjs +63 -0
  98. package/src/outbound.mjs +25 -1
  99. package/src/ports.mjs +4 -6
  100. package/src/reminder-time.mjs +127 -0
  101. package/src/room.mjs +19 -7
  102. package/src/runtime-detection.mjs +6 -2
  103. package/src/sentinel-errors.mjs +4 -3
  104. package/src/server-sentinel.mjs +7 -3
  105. package/src/server.mjs +302 -70
  106. package/src/tour.mjs +24 -5
package/README.en.md CHANGED
@@ -1,5 +1,5 @@
1
1
  <p align="center">
2
- <a href="https://madre.run"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/madre-banner.png" alt="MADRE · All your AIs in one chat · Codex, Claude Code, Gemini CLI and OpenCode" width="100%"></a>
2
+ <a href="https://madre.run"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/en/banner.png" alt="MADRE · All your AIs in one chat · Codex, Claude Code, Gemini CLI, Cursor and OpenCode" width="100%"></a>
3
3
  </p>
4
4
 
5
5
  <p align="center"><a href="README.md">Español</a> · <b>English</b></p>
@@ -16,194 +16,97 @@
16
16
 
17
17
  # All your AIs in one chat.
18
18
 
19
- Codex, Claude Code, Gemini CLI, OpenCode and Cursor working on your projects,
20
- in the same conversation, remembering the same things. All your projects in one place,
21
- and a Coordinator that sees them from above.
19
+ **MADRE is not another AI.** It is a free app that runs on your computer and brings the AIs you already use (Codex, Claude Code, Gemini, Cursor and OpenCode) into one chat, inside your project’s folder. 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, so you repeat nothing when you switch from one to another.
22
20
 
23
21
  ```
24
22
  npx @jossuealcala/madre
25
23
  ```
26
24
 
27
- That's it. No account to create, no cloud to set up, no key to paste.
28
- MADRE uses the sessions those CLIs already have on your machine.
25
+ You need Node 22.5 or newer and at least one AI signed in. There is no account to create: MADRE uses the sessions your AIs already have on your computer. It runs on macOS and Linux; Windows arrives in version 1.1.
29
26
 
30
27
  <p align="center">
31
- <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/en/home.webp" alt="MADRE Home: the Coordinator with its recent summary, who is waiting for you, the connections and one card per project" width="100%">
28
+ <a href="https://github.com/jossuealcacao-exe/madre/blob/main/docs/media/1.0.5/madre-tour-en.mp4"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/en/video.webp" alt="See how MADRE works in 80 seconds" width="100%"></a>
32
29
  </p>
33
30
 
34
- <p align="center"><sub>Home, with all your projects. The 90-second tour is <a href="https://github.com/jossuealcacao-exe/madre/blob/main/docs/media/1.0/madre-1-0.mp4">in Spanish for now</a>. Also at <a href="https://madre.run/en/">madre.run</a>.</sub></p>
35
-
36
- <br>
37
-
38
- ---
39
-
40
- <br>
41
-
42
- ## What's new in 1.0
43
-
44
- - **Home**: all your projects in one place, open or asleep, with what happened in each one.
45
- - **The Coordinator**: an agent that reads across your projects, signs connections and carries orders from one to another.
46
- - **Connections**: one project looks up what another has already learned, only through a connection that you sign or, if you allow it, the Coordinator.
47
- - **Permissions your way**: from `#0` Incognito to `#4` Full access, with the key you choose.
48
- - **Settings and Diagnostics**: everything you configure in one window, and the fix when something breaks.
49
- - **Modules as apps**, several conversations at once and a code editor in the viewer.
50
-
51
- If you're coming from 0.7.2, your projects, conversations, memory and settings stay. The details are in the [CHANGELOG](CHANGELOG.en.md).
52
-
53
- <br>
54
-
55
- ## One conversation, not four terminals
56
-
57
- <p align="center">
58
- <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/en/one-chat.webp" alt="All your AIs in one chat: each answer with its agent, and the handoff line that says how many messages the next one received" width="100%">
59
- </p>
60
-
61
- You type `@codex` and Codex answers. You type `@claude` and Claude answers, **reading what Codex just said**. You type "@madre, ask the team…" and each one gives its take in turn on the same thing; at the end, @madre sums up where they agree and where they don't, citing each answer.
62
-
63
- Today that's four windows, four contexts and you copying and pasting between them. MADRE turns it into one thread.
64
-
65
- ## All your projects, in one place
31
+ ## How it works
66
32
 
67
33
  <p align="center">
68
- <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/en/connect-agents.webp" alt="The first time in Home: connect your agents, once for all your projects" width="100%">
34
+ <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/en/how.webp" alt="The AIs you already use on the left; MADRE in the middle, with one chat for all of them, permissions, memory and undo; your project on the right. Everything runs on your computer." width="100%">
69
35
  </p>
70
36
 
71
- `npx @jossuealcala/madre` opens **Home**. The first time, it walks you through three steps: connect your agents (once for all your projects), add your folders and open the ones you'll use. Each card says whether an agent is working, whether someone is waiting for you and what was decided while you were away.
72
-
73
- ## A Coordinator that sees all your projects
37
+ This is what a real round table looks like: you ask the team, Codex, Claude, Gemini and OpenCode answer, and @madre sums up where they agree.
74
38
 
75
39
  <p align="center">
76
- <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/en/coordinator.webp" alt="The Coordinator answers what was decided in two connected projects, saying which one each fact came from" width="100%">
40
+ <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/en/mesa-redonda.gif" alt="A real round table in MADRE: four AIs answer one after another and @madre sums up" width="100%">
77
41
  </p>
78
42
 
79
- The **Coordinator** lives in Home. It reads what your projects have learned —only from the ones you connect— and answers you saying which project each fact came from. If you allow it, it carries tasks from one project to another, up to `#2`; anything that needs more permission arrives as a proposal that you unlock. From any project you ask it with `/bishop`.
43
+ ## What it’s for
80
44
 
81
- A **connection** says which kinds of note cross over (decisions, facts, preferences, questions) and until when. Never your files or your conversations, and you can revoke it whenever you want.
82
-
83
- ## A memory that outlives the session
45
+ From code to business. You ask in your own words and each AI does the part it does best.
84
46
 
85
47
  <p align="center">
86
- <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/en/memory-map.webp" alt="The Memory map: colored memories around a magma core, joined by their links" width="100%">
48
+ <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/en/uses.webp" alt="Six cases: fixing a bug between Claude, Codex and Gemini; your business’s page; several opinions before you decide; a local AI for what is private; reminders; a module made to fit" width="100%">
87
49
  </p>
88
50
 
89
- Everything that's said gets indexed. When the conversation outgrows the context window, each agent gets back what it needs, cited. Every ten exchanges, the project distills what was said into typed notes: a decision, a fact, a preference, an open question.
90
-
91
- You ask *"why did we choose Postgres?"* three weeks later and the project answers, even if that decision was made by another agent in another session.
92
-
93
- With [Ollama](https://ollama.com) running, that memory also **talks**: `@madre` is a fifth agent, local, free, that answers from the whole archive with citations and writes nothing. And you can **see** it: the **Memory map** is a three-dimensional brain you turn with the mouse, where each memory is a star the color of its type.
94
-
95
- ## They read by default. They write when you say so.
96
-
97
- <p align="center">
98
- <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/en/modes.webp" alt="The mode menu, from #0 Incognito to #4 Full access" width="60%">
99
- </p>
100
-
101
- Every message goes out with a permission mode, and your mode is the ceiling for everything that message starts.
102
-
103
- | | | |
104
- |---|---|---|
105
- | `#1` | **CHAT ONLY** | Read and coordinate. The default. |
106
- | `#2` | **CREATE** | Add new files. Whatever already existed is restored when it's done. |
107
- | `#3` | **EDIT** | Edit the project. A restore point before, a list of changes and `UNDO` after. |
108
- | `#4` | **FULL ACCESS** | Commands, `git push`, deploys. Asks for the key twice. |
109
-
110
- There's also `#0 INCOGNITO`, for what shouldn't be kept anywhere.
111
-
112
- Moving up to `#3` or `#4` is deliberate: MADRE asks for your key —by default, the name of the project folder; in Settings › Permissions you can choose a phrase of your own— and the project itself checks it. No agent can grant itself a permission by writing it in its answer.
113
-
114
- <p align="center">
115
- <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/en/undo.webp" alt="Claude changed two files in #3 Edit and the Undo button takes the project back to the restore point" width="60%">
116
- </p>
117
-
118
- ## Your space, your way
119
-
120
- <p align="center">
121
- <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/en/workspace.webp" alt="The conversation on the left and the code editor beside it, in Edit mode" width="100%">
122
- </p>
123
-
124
- Each panel opens alongside or in a window you can move. Several conversations work at once, the viewer edits code, your project's servers open inside MADRE and you build the bar with a right click. **Settings** (⌘ ,) brings together everything you configure, with search, and **Diagnostics** gives you the fix when something breaks.
125
-
126
- <br>
127
-
128
- ---
129
-
130
- <br>
131
-
132
- ## Make it yours
133
-
134
- MADRE comes with twelve modules —Token saver, Suggested effort, Local AI, GitHub, Continuity and more—, on an app-style board. You write the next one, or you ask an agent to.
135
-
136
- **A module is one file.** No build, no dependencies, no signing up anywhere. You copy it into a folder, reload and it shows up with its switch, its settings and its card. With one you can add a `/whatever` command the project understands, give the agents a tool they didn't have before, change how MADRE behaves, or connect it to something you already use.
137
-
138
- **Or you don't write it.** In the text box:
51
+ ## What you can do
52
+
53
+ <table>
54
+ <tr>
55
+ <td width="50%"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/en/card-mesa.webp" alt="Round table: ask the team and they answer one after another; @madre sums up"><br><b>Round table.</b> Ask the team and they answer one after another; @madre sums up.</td>
56
+ <td width="50%"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/en/card-inicio.webp" alt="Home and Coordinator: all your projects at a glance"><br><b>Home and Coordinator.</b> All your projects at a glance.</td>
57
+ </tr>
58
+ <tr>
59
+ <td width="50%"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/en/card-permisos.webp" alt="Permissions and undo: you decide how far each AI goes"><br><b>Permissions and undo.</b> You decide how far each AI goes.</td>
60
+ <td width="50%"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/en/card-codigo.webp" alt="Code: ask about any line of your project"><br><b>Code.</b> Ask about any line of your project.</td>
61
+ </tr>
62
+ <tr>
63
+ <td width="50%"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/en/card-memoria.webp" alt="Memory: what gets decided stays saved"><br><b>Memory.</b> What gets decided stays saved.</td>
64
+ <td width="50%"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/en/card-modulos.webp" alt="Modules and Market: turn on only what you need"><br><b>Modules and Market.</b> Turn on only what you need.</td>
65
+ </tr>
66
+ <tr>
67
+ <td width="50%"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/en/card-local.webp" alt="Local AI: an AI on your computer, no tokens spent"><br><b>Local AI.</b> An AI on your computer, no tokens spent.</td>
68
+ <td width="50%"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/en/card-ayuda.webp" alt="Diagnostics: if something fails, it tells you the fix"><br><b>Diagnostics.</b> If something fails, it tells you the fix.</td>
69
+ </tr>
70
+ </table>
71
+
72
+ ## Start in three steps
73
+
74
+ 1. **Open it.** Run `npx @jossuealcala/madre` in the Terminal. It opens in your browser, in English or Spanish.
75
+ 2. **Connect your AIs.** MADRE finds the ones you have installed. If one is not signed in, Settings › Agents has the button to sign in; if one is not installed, MADRE installs it for you.
76
+ 3. **Add your project and ask.** Pick the folder and write, for example: `@codex explain this project in five lines`.
77
+
78
+ The first time, MADRE shows you each thing with tips, step by step. The [manual](https://madre.run/en/manual/) takes you from zero to your first project in about ten minutes; it is also inside MADRE (Settings › System) and as a PDF.
139
79
 
140
80
  ```
141
- /module a command that tells me what changed in the repo this week
81
+ npx @jossuealcala/madre # opens Home, with all your projects
82
+ npx @jossuealcala/madre start # opens the project of the folder you are in
83
+ npx @jossuealcala/madre doctor # which AIs you have and which are signed in
142
84
  ```
143
85
 
144
- The agent reads the SDK, writes the file, and MADRE shows you a card to review it before installing it. It never installs itself, and no agent can write to the modules folder.
86
+ MADRE updates itself: the same command gets the newest version, and inside MADRE a notice lets you update in one click.
145
87
 
146
- **Connecting it to an outside service** is the most requested thing, and the short answer is *almost always yes*: the limit isn't MADRE, it's how that service lets you hand over your own key. It's worth it when you can get the key in under five minutes without being a developer and revoke it yourself — GitHub, Linear, Notion, Jira, Slack, Telegram, Stripe, Shopify, Odoo, any database. Where there's a wall is where the provider requires reviewing your app before letting you through: Gmail read access, Meta, banking.
88
+ ## If something fails
147
89
 
148
- Your module declares which key it needs and MADRE draws the field; it declares where it connects to and the outbound log accounts for it; it declares which of its tools **send** something, and the project takes those away from the agents except at step `#4`. You don't program any of that: you declare it.
90
+ Open **Diagnostics** and write what you see, like “Gemini does not answer” or “Claude is not signed in”. It tells you what is going on and gives you the button that fixes it, or the command for the Terminal. Without opening MADRE, `npx @jossuealcala/madre doctor` checks your AIs. The most common problems are in the [manual](https://madre.run/en/manual/#help).
149
91
 
150
- **[Write a module →](docs/en/SDK.md)** · with two complete examples that work as they are: [the minimal one](docs/sdk/hello-module.mjs) and [an integration](docs/sdk/connector-module.mjs).
92
+ ## Your data
151
93
 
152
- <br>
94
+ - **No cloud.** MADRE has no server and no account. It runs on `127.0.0.1` and stops when you close the Terminal.
95
+ - **Your keys are not copied.** Each AI keeps its own session; if you paste a key, MADRE writes it where that AI looks for it and keeps no copy.
96
+ - **You know what leaves.** What an AI reads travels to its provider, with your account, as if you used it in your Terminal. In Diagnostics you see everything that leaves your computer and how to turn it off.
97
+ - **Zero dependencies.** Node and nothing else.
153
98
 
154
- ---
155
-
156
- <br>
99
+ ## New in 1.0.5
157
100
 
158
- ## What MADRE is not
159
-
160
- This matters more than any feature.
161
-
162
- **There is no cloud.** MADRE has no server, no account, no backend. It runs on `127.0.0.1` and dies when you close the terminal.
163
-
164
- **Your keys, where they're needed and nowhere else.** When you give an agent's key, MADRE writes it to the file where that CLI looks for it, locked to your user, and keeps no copy. An integration has no CLI to give it to, so that one —and only that one— MADRE keeps, in its own vault on your machine, with permissions for your user only, accepted only from this computer. Never in its config, its records or its logs, or anything an agent reads: the card only shows that one is saved and how many characters it has.
165
-
166
- **Nothing goes out on its own.** What an agent reads travels to *its* provider, with your account and your limits — as if you had run it in your terminal, because that's exactly what MADRE does. What MADRE looks up on its own is declared, along with what turns it off: the daily check for new versions (npm and GitHub), your Claude plan's quota, Gemini embeddings and images if you turn them on, and crash reports, off by default. And once a day, always, a notice that this copy is still in use: a random identifier, the MADRE version, the operating system and the Node version. No name, email, IP or anything from your projects; it's how the author knows how many people use MADRE.
167
-
168
- **And it lets you read it.** Touch the core of the Memory map and "What is sent" opens: the exact document MADRE writes on your behalf every turn, the exact command it delivers it with, and the log of every call that left this machine. It's not a promise: it's a screen.
169
-
170
- **Zero dependencies.** Node and nothing else.
171
-
172
- <br>
173
-
174
- ---
175
-
176
- <br>
177
-
178
- ## Getting started
179
-
180
- You need **Node 22.5** or later and at least one of these CLIs with a signed-in session: Codex, Claude Code, Gemini CLI, OpenCode or Cursor (`cursor-agent`). Cursor, for now, reads and answers; it does not write in your project yet.
181
-
182
- ```
183
- npx @jossuealcala/madre
184
- ```
185
-
186
- From any folder, it opens **Home** at `http://127.0.0.1:4317/salas`: all your projects in one place, with the Coordinator at the top. The first time, it walks you through three steps: **connect your agents** (install and sign in to each CLI right there, once for all your projects), **add your projects** (you choose the folders; adding them doesn't open them) and **open** the ones you'll use. Each project runs on its own, with its own memory.
187
-
188
- If you'd rather go straight into a project, as before:
189
-
190
- ```
191
- cd your-project
192
- npx @jossuealcala/madre start
193
- ```
194
-
195
- ```
196
- npx @jossuealcala/madre doctor # what's installed, who's signed in
197
- ```
198
-
199
- **Updating.** `npx @jossuealcala/madre` with no version fetches the newest one each time it starts: close it and open it again, or use the new-version notice inside MADRE, which updates it in one click. If you installed it with `npm install -g`, install it again: `npm install -g @jossuealcala/madre@latest`.
200
-
201
- MADRE speaks **Spanish** and **English**: the first time, it opens in your browser's language, and you can change it any time in Settings › Appearance.
202
-
203
- <br>
101
+ - A manual with real pictures and every step marked, inside MADRE and as a PDF, with a guide to train your own AI on your project.
102
+ - Tips that teach you Home and your first project in minutes.
103
+ - Notes and Reminders, which you can also ask any AI for.
104
+ - In Code, you ask about any line: explain, improve, write tests or fix.
105
+ - Connectors in one click: GitHub, Notion, Linear, Stripe and more.
106
+ - Cursor and Gemini show the models of your plan, and Cursor now works with all four permissions.
107
+ - Gemini under load tells you what really happened.
204
108
 
205
- **How each thing works, with the exact numbers:** [docs/en/REFERENCE.md](docs/en/REFERENCE.md)
206
- **How it works inside:** [docs/en/INTERNALS.md](docs/en/INTERNALS.md) · **Write a module:** [docs/en/SDK.md](docs/en/SDK.md)
109
+ The details are in the [CHANGELOG](CHANGELOG.en.md). How each thing works: [docs/en/REFERENCE.md](docs/en/REFERENCE.md) · Inside: [docs/en/INTERNALS.md](docs/en/INTERNALS.md) · Writing a module: [docs/en/SDK.md](docs/en/SDK.md)
207
110
 
208
111
  <br>
209
112
 
package/README.md CHANGED
@@ -1,10 +1,10 @@
1
1
  <p align="center">
2
- <a href="https://madre.run"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/madre-banner.png" alt="MADRE · Todas tus IAs en un mismo chat · Codex, Claude Code, Gemini CLI y OpenCode" width="100%"></a>
2
+ <a href="https://madre.run"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/es/banner.png" alt="MADRE · Todas tus IAs en un mismo chat · Codex, Claude Code, Gemini CLI, Cursor y OpenCode" width="100%"></a>
3
3
  </p>
4
4
 
5
5
  <p align="center"><b>Español</b> · <a href="README.en.md">English</a></p>
6
6
 
7
- <p align="center"><sub><b>In English:</b> MADRE puts Codex, Claude Code, Gemini CLI, OpenCode and Cursor in one local chat on your machine, with one memory they all share. It opens in your browser's language, Spanish or English. <a href="README.en.md"><b>Read the full README in English →</b></a></sub></p>
7
+ <p align="center"><sub><b>In English:</b> MADRE puts Codex, Claude Code, Gemini CLI, Cursor and OpenCode in one chat that runs on your computer, with one memory they all share. <a href="README.en.md"><b>Read the README in English →</b></a></sub></p>
8
8
 
9
9
  <p align="center">
10
10
  <a href="https://www.npmjs.com/package/@jossuealcala/madre"><img alt="npm" src="https://img.shields.io/npm/v/@jossuealcala/madre?style=flat-square&label=npm&color=9bff66&labelColor=050605"></a>
@@ -18,198 +18,97 @@
18
18
 
19
19
  # Todas tus IAs en un mismo chat.
20
20
 
21
- Codex, Claude Code, Gemini CLI, OpenCode y Cursor trabajando sobre tus proyectos,
22
- en la misma conversación, recordando lo mismo. Todos tus proyectos en un lugar,
23
- y un Coordinador que los ve desde arriba.
21
+ **MADRE no es otra IA.** Es una app gratis que corre en tu computadora y junta a las IAs que ya usas (Codex, Claude Code, Gemini, Cursor y OpenCode) en un solo chat, dentro de la carpeta 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, así que no repites nada cuando cambias de una a otra.
24
22
 
25
23
  ```
26
24
  npx @jossuealcala/madre
27
25
  ```
28
26
 
29
- Eso es todo. No hay cuenta que crear, ni nube que configurar, ni llave que pegar.
30
- MADRE usa las sesiones que esas CLIs ya tienen en tu máquina.
27
+ Necesitas Node 22.5 o más nuevo y al menos una IA con sesión. No hay cuenta que crear: MADRE usa las sesiones que tus IAs ya tienen en tu computadora. Corre en macOS y Linux; Windows llega en la versión 1.1.
31
28
 
32
29
  <p align="center">
33
- <a href="https://github.com/jossuealcacao-exe/madre/blob/main/docs/media/1.0/madre-1-0.mp4"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/madre-1-0-video.webp" alt="Ver MADRE 1.0 en 90 segundos" width="100%"></a>
30
+ <a href="https://github.com/jossuealcacao-exe/madre/blob/main/docs/media/1.0.5/madre-tour-es.mp4"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/es/video.webp" alt="Mira cómo se usa MADRE en 80 segundos" width="100%"></a>
34
31
  </p>
35
32
 
36
- <p align="center"><sub>MADRE 1.0 en 90 segundos: pantallas reales sobre proyectos de ejemplo. También en <a href="https://madre.run">madre.run</a>.</sub></p>
37
-
38
- <br>
39
-
40
- ---
41
-
42
- <br>
43
-
44
- ## Lo nuevo en 1.0
45
-
46
- - **Inicio**: todos tus proyectos en un lugar, abiertos o dormidos, con lo que pasó en cada uno.
47
- - **El Coordinador**: un agente que lee entre tus proyectos, firma conexiones y lleva órdenes de uno a otro.
48
- - **Conexiones**: un proyecto consulta lo que otro ya aprendió, solo con una conexión que firmas tú o, si lo permites, el Coordinador.
49
- - **Permisos a tu manera**: de `#0` Incógnito a `#4` Acceso total, con la llave que tú eliges.
50
- - **Ajustes y Diagnóstico**: todo lo que configuras en una ventana, y el remedio cuando algo falla.
51
- - **Módulos como apps**, varias conversaciones a la vez y un editor de código en el visor.
52
-
53
- Si vienes de 0.7.2, tus proyectos, conversaciones, memoria y ajustes se quedan. El detalle, en el [CHANGELOG](CHANGELOG.md).
54
-
55
- <br>
56
-
57
- ## Una conversación, no cuatro terminales
58
-
59
- <p align="center">
60
- <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/ksp-agentes.webp" alt="Todas tus IAs en un mismo chat: Claude contesta después de Codex, con la línea de traspaso que dice cuántos mensajes recibió" width="100%">
61
- </p>
62
-
63
- Escribes `@codex` y contesta Codex. Escribes `@claude` y contesta Claude, **leyendo lo que Codex acaba de decir**. Escribes «@madre, pregúntale al equipo…» y cada uno opina por turno sobre lo mismo; al final, @madre resume en qué coinciden y en qué no, citando cada respuesta.
33
+ ## Cómo funciona
64
34
 
65
35
  <p align="center">
66
- <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/mesa-redonda.gif" alt="Una mesa redonda en MADRE 1.0: la pregunta, el plan de @madre y las respuestas de cada agente" width="100%">
36
+ <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/es/how.webp" alt="Las IAs que ya usas, a la izquierda; MADRE al centro, con un chat para todas, permisos, memoria y deshacer; tu proyecto a la derecha. Todo corre en tu computadora." width="100%">
67
37
  </p>
68
38
 
69
- Hoy eso son cuatro ventanas, cuatro contextos y tú copiando y pegando entre ellas. MADRE lo vuelve un hilo.
70
-
71
- ## Todos tus proyectos, en un lugar
39
+ Así se ve una mesa redonda de verdad: le preguntas al equipo, contestan Codex, Claude, Gemini y OpenCode, y @madre te resume en qué coinciden.
72
40
 
73
41
  <p align="center">
74
- <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/ksp-inicio.webp" alt="Inicio de MADRE 1.0: el Coordinador con su resumen reciente, quién te espera, las conexiones y una tarjeta por proyecto" width="100%">
42
+ <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/es/mesa-redonda.gif" alt="Una mesa redonda real en MADRE: cuatro IAs contestan una tras otra y @madre resume" width="100%">
75
43
  </p>
76
44
 
77
- `npx @jossuealcala/madre` abre **Inicio**. La primera vez te acompaña en tres pasos: conectar tus agentes (una vez para todos tus proyectos), agregar tus carpetas y abrir las que vas a usar. Cada tarjeta dice si un agente trabaja, si alguien te espera y qué se decidió mientras no estabas.
45
+ ## Para qué sirve
78
46
 
79
- ## Un Coordinador que ve todos tus proyectos
47
+ Del código al negocio. Le pides las cosas con tus palabras y cada IA hace la parte que mejor le sale.
80
48
 
81
49
  <p align="center">
82
- <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/ksp-coordinador.webp" alt="El Coordinador responde qué se decidió en dos proyectos conectados, diciendo de cuál sacó cada dato" width="100%">
50
+ <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/es/uses.webp" alt="Seis casos: arreglar un error entre Claude, Codex y Gemini; la página de tu negocio; varias opiniones antes de decidir; IA local para lo privado; recordatorios; un módulo hecho a tu medida" width="100%">
83
51
  </p>
84
52
 
85
- El **Coordinador** vive en Inicio. Lee lo que tus proyectos aprendieron —solo de los que conectas tú— y te contesta diciendo de qué proyecto sacó cada dato. Si lo permites, lleva tareas de un proyecto a otro, hasta `#2`; lo que pide más permiso llega como propuesta que tú desbloqueas. Desde cualquier proyecto le preguntas con `/bishop`.
86
-
87
- Una **conexión** dice qué tipos de nota cruzan (decisiones, hechos, preferencias, preguntas) y hasta cuándo. Nunca tus archivos ni tus conversaciones, y se revoca cuando quieras.
88
-
89
- ## Una memoria que sobrevive a la sesión
90
-
91
- <p align="center">
92
- <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/ksp-memoria.webp" alt="El Mapa de memoria: memorias de colores alrededor de un núcleo de magma, unidas por sus enlaces" width="100%">
93
- </p>
94
-
95
- Todo lo que se dice queda indexado. Cuando la conversación pasa de la ventana de contexto, cada agente recibe de vuelta lo que hace falta, citado. Cada diez intercambios, el proyecto destila lo dicho en notas con tipo: una decisión, un hecho, una preferencia, una pregunta abierta.
96
-
97
- Preguntas *«¿por qué elegimos Postgres?»* tres semanas después y el proyecto contesta, aunque esa decisión la tomara otro agente en otra sesión.
98
-
99
- Con [Ollama](https://ollama.com) corriendo, esa memoria además **habla**: `@madre` es un quinto agente, local, gratis, que responde desde todo el archivo con citas y no escribe nada. Y la puedes **ver**: el **Mapa de memoria** es un cerebro en tres dimensiones que giras con el ratón, donde cada memoria es una estrella del color de su tipo.
100
-
101
- ## Leen por defecto. Escriben cuando tú lo dices.
102
-
103
- <p align="center">
104
- <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/ksp-permisos.webp" alt="El menú de modos de MADRE 1.0, de #0 Incógnito a #4 Acceso total" width="100%">
105
- </p>
106
-
107
- Cada mensaje sale con un modo de permiso, y tu modo es el techo de todo lo que ese mensaje arranque.
108
-
109
- | | | |
110
- |---|---|---|
111
- | `#1` | **SOLO CONVERSAR** | Leer y coordinar. El predeterminado. |
112
- | `#2` | **CREAR** | Añadir archivos nuevos. Lo que ya existía se restaura al terminar. |
113
- | `#3` | **EDITAR** | Editar el proyecto. Punto de restauración antes, lista de cambios y `DESHACER` después. |
114
- | `#4` | **ACCESO TOTAL** | Comandos, `git push`, deploys. Pide la llave dos veces. |
115
-
116
- También hay `#0 INCÓGNITO`, para lo que no debe quedar en ninguna parte.
117
-
118
- Subir a `#3` o `#4` es deliberado: MADRE te pide tu llave —por defecto, el nombre de la carpeta del proyecto; en Ajustes › Permisos puedes elegir una frase tuya— y la comprueba el propio proyecto. Ningún agente puede concederse un permiso escribiéndolo en su respuesta.
119
-
120
- <p align="center">
121
- <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/ksp-deshacer.webp" alt="Claude cambió tres archivos en #3 Editar y el botón Deshacer regresa el proyecto al punto de restauración" width="100%">
122
- </p>
123
-
124
- ## Tu espacio, a tu medida
125
-
126
- <p align="center">
127
- <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/ksp-espacio.webp" alt="La conversación a la izquierda y el editor de código al lado, en modo Editar" width="100%">
128
- </p>
129
-
130
- Cada panel se abre al lado o en una ventana que mueves. Varias conversaciones trabajan a la vez, el visor edita código, los servidores de tu proyecto se abren dentro de MADRE y la barra se arma con clic derecho. **Ajustes** (⌘ ,) reúne todo lo que configuras, con buscador, y **Diagnóstico** te da el remedio cuando algo falla.
131
-
132
- <br>
133
-
134
- ---
135
-
136
- <br>
137
-
138
- ## Hazla tuya
139
-
140
- MADRE trae doce módulos —Ahorro de tokens, Esfuerzo sugerido, IA local, GitHub, Continuidad y más—, en un tablero como de apps. El siguiente lo escribes tú, o se lo pides a un agente.
141
-
142
- **Un módulo es un archivo.** Sin build, sin dependencias, sin registrarse en ningún lado. Lo copias a una carpeta, recargas y aparece con su interruptor, sus ajustes y su ficha. Con uno puedes añadir un comando `/loquesea` que el proyecto entiende, darle a los agentes una herramienta que antes no tenían, cambiar cómo se comporta MADRE, o conectarla con algo que ya usas.
143
-
144
- **O no lo escribes tú.** En la caja de texto:
145
-
146
- ```
147
- /module un comando que me diga qué cambió en el repo esta semana
148
- ```
149
-
150
- El agente lee el SDK, escribe el archivo, y MADRE te enseña una tarjeta para revisarlo antes de instalarlo. Nunca se instala solo, y ningún agente puede escribir en la carpeta de módulos.
151
-
152
- **Conectarla con un servicio de fuera** es lo que más se pide, y la respuesta corta es *casi siempre sí*: el límite no es MADRE, es cómo ese servicio deja que entregues tu propia llave. Vale la pena cuando la consigues en menos de cinco minutos sin ser desarrollador y la puedes revocar sola — GitHub, Linear, Notion, Jira, Slack, Telegram, Stripe, Shopify, Odoo, cualquier base de datos. Donde hay muro es donde el proveedor exige revisar tu app antes de dejarte pasar: Gmail en lectura, Meta, banca.
153
-
154
- Tu módulo declara qué llave necesita y MADRE dibuja el campo; declara a dónde llega y el registro de salidas responde por él; declara qué herramientas suyas **mandan** algo, y el proyecto se las retira a los agentes salvo en el peldaño `#4`. Nada de eso lo programas: lo declaras.
155
-
156
- **[Escribir un módulo →](docs/SDK.md)** · con dos ejemplos completos que funcionan tal cual: [el mínimo](docs/sdk/hello-module.mjs) y [una integración](docs/sdk/connector-module.mjs).
157
-
158
- <br>
159
-
160
- ---
161
-
162
- <br>
163
-
164
- ## Lo que MADRE no es
165
-
166
- Esto importa más que cualquier función.
167
-
168
- **No hay nube.** MADRE no tiene servidor, ni cuenta, ni backend. Corre en `127.0.0.1` y se muere cuando cierras la terminal.
169
-
170
- **Tus llaves, donde hacen falta y en ningún otro lado.** Cuando das la llave de un agente, MADRE la escribe en el archivo donde ese CLI la busca, cerrada a tu usuario, y no conserva copia. Una integración no tiene CLI al que dársela, así que esa —y solo esa— la guarda MADRE, en su propia bodega de tu máquina, con permisos de solo tu usuario, aceptada únicamente desde esta computadora. Nunca en su config, ni en su registro, ni en sus logs, ni en lo que lee un agente: la ficha solo muestra que hay una guardada y cuántos caracteres tiene.
171
-
172
- **Nada sale por su cuenta.** Lo que un agente lee viaja a *su* proveedor, con tu cuenta y tus límites — como si lo hubieras corrido en tu terminal, porque eso es exactamente lo que MADRE hace. Lo que MADRE consulta por su cuenta está declarado, con lo que lo apaga: la consulta diaria de versiones nuevas (npm y GitHub), la cuota de tu plan de Claude, los embeddings e imágenes de Gemini si los activas, y los reportes de fallos, apagados por defecto. Y una vez al día, siempre, un aviso de que esta copia sigue en uso: un identificador al azar, la versión de MADRE, el sistema y la versión de Node. Sin tu nombre, tu correo, tu IP ni nada de tus proyectos; es como el autor sabe cuántas personas usan MADRE.
173
-
174
- **Y te deja leerlo.** Toca el núcleo del Mapa de memoria y se abre «Lo que se envía»: el documento exacto que MADRE escribe en tu nombre cada turno, el comando exacto con el que lo entrega, y el registro de cada llamada que salió de esta máquina. No es una promesa: es una pantalla.
175
-
176
- **Cero dependencias.** Node y nada más.
177
-
178
- <br>
179
-
180
- ---
181
-
182
- <br>
183
-
184
- ## Empezar
185
-
186
- Necesitas **Node 22.5** o superior y al menos una de estas CLIs con sesión iniciada: Codex, Claude Code, Gemini CLI, OpenCode o Cursor (`cursor-agent`). Cursor, por ahora, lee y contesta; todavía no escribe en tu proyecto.
53
+ ## Lo que puedes hacer
54
+
55
+ <table>
56
+ <tr>
57
+ <td width="50%"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/es/card-mesa.webp" alt="Mesa redonda: le preguntas al equipo y contestan una tras otra; @madre resume"><br><b>Mesa redonda.</b> Le preguntas al equipo y contestan una tras otra; @madre resume.</td>
58
+ <td width="50%"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/es/card-inicio.webp" alt="Inicio y Coordinador: todos tus proyectos de un vistazo"><br><b>Inicio y Coordinador.</b> Todos tus proyectos de un vistazo.</td>
59
+ </tr>
60
+ <tr>
61
+ <td width="50%"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/es/card-permisos.webp" alt="Permisos y deshacer: tú decides hasta dónde llega cada IA"><br><b>Permisos y deshacer.</b> Tú decides hasta dónde llega cada IA.</td>
62
+ <td width="50%"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/es/card-codigo.webp" alt="Código: pregunta por cualquier línea de tu proyecto"><br><b>Código.</b> Pregunta por cualquier línea de tu proyecto.</td>
63
+ </tr>
64
+ <tr>
65
+ <td width="50%"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/es/card-memoria.webp" alt="Memoria: lo que se decide se queda guardado"><br><b>Memoria.</b> Lo que se decide se queda guardado.</td>
66
+ <td width="50%"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/es/card-modulos.webp" alt="Módulos y Mercado: enciende solo lo que necesitas"><br><b>Módulos y Mercado.</b> Enciende solo lo que necesitas.</td>
67
+ </tr>
68
+ <tr>
69
+ <td width="50%"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/es/card-local.webp" alt="IA local: una IA en tu computadora, sin gastar tokens"><br><b>IA local.</b> Una IA en tu computadora, sin gastar tokens.</td>
70
+ <td width="50%"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0.5/es/card-ayuda.webp" alt="Diagnóstico: si algo falla, te dice cómo arreglarlo"><br><b>Diagnóstico.</b> Si algo falla, te dice cómo arreglarlo.</td>
71
+ </tr>
72
+ </table>
73
+
74
+ ## Empieza en tres pasos
75
+
76
+ 1. **Ábrela.** Corre `npx @jossuealcala/madre` en la Terminal. Se abre en tu navegador, en español o inglés.
77
+ 2. **Conecta tus IAs.** MADRE encuentra las que tienes instaladas. Si a alguna le falta la sesión, en Ajustes › Agentes está el botón para entrar; si no está instalada, MADRE la instala por ti.
78
+ 3. **Agrega tu proyecto y pregunta.** Escoge la carpeta y escribe, por ejemplo: `@codex explícame este proyecto en cinco líneas`.
79
+
80
+ La primera vez, MADRE te enseña cada cosa con pistas, paso a paso. El [manual](https://madre.run/manual/) te lleva de cero a tu primer proyecto en unos diez minutos; también está dentro de MADRE (Ajustes › Sistema) y en PDF.
187
81
 
188
82
  ```
189
- npx @jossuealcala/madre
83
+ npx @jossuealcala/madre # abre Inicio, con todos tus proyectos
84
+ npx @jossuealcala/madre start # abre directo el proyecto de la carpeta donde estás
85
+ npx @jossuealcala/madre doctor # qué IAs hay y en cuáles tienes sesión
190
86
  ```
191
87
 
192
- Desde cualquier carpeta, abre **Inicio** en `http://127.0.0.1:4317/salas`: todos tus proyectos en un lugar, con el Coordinador arriba. La primera vez te acompaña en tres pasos: **conectar tus agentes** (instalar cada CLI e iniciar sesión ahí mismo, una vez para todos tus proyectos), **agregar tus proyectos** (eliges las carpetas; agregarlas no las abre) y **abrir** los que vas a usar. Cada proyecto corre por su cuenta, con su propia memoria.
88
+ MADRE se actualiza sola: el mismo comando baja la versión más nueva, y dentro de MADRE un aviso te deja actualizar con un clic.
193
89
 
194
- Si prefieres entrar directo a un proyecto, como antes:
90
+ ## Si algo falla
195
91
 
196
- ```
197
- cd tu-proyecto
198
- npx @jossuealcala/madre start
199
- ```
92
+ Abre **Diagnóstico** y escribe lo que ves, como «Gemini no contesta» o «Claude me pide iniciar sesión». Te dice qué pasa y te da el botón que lo arregla, o el comando para la Terminal. Sin abrir MADRE, `npx @jossuealcala/madre doctor` revisa tus IAs. Los problemas más comunes están en el [manual](https://madre.run/manual/#ayuda).
200
93
 
201
- ```
202
- npx @jossuealcala/madre doctor # qué hay instalado, quién tiene sesión
203
- ```
94
+ ## Tus datos
204
95
 
205
- **Actualizar.** `npx @jossuealcala/madre` sin versión baja la más reciente cada vez que arranca: ciérrala y vuelve a abrirla, o usa el aviso de versión nueva dentro de MADRE, que la actualiza con un clic. Si la instalaste con `npm install -g`, vuelve a instalarla: `npm install -g @jossuealcala/madre@latest`.
96
+ - **No hay nube.** MADRE no tiene servidor ni cuenta. Corre en `127.0.0.1` y se cierra cuando cierras la Terminal.
97
+ - **Tus llaves no se copian.** Cada IA guarda su propia sesión; si pegas una llave, MADRE la escribe donde esa IA la busca y no conserva copia.
98
+ - **Sabes qué sale.** Lo que lee una IA viaja a su proveedor, con tu cuenta, como si la usaras en tu Terminal. En Diagnóstico ves cada cosa que sale de tu computadora y cómo apagarla.
99
+ - **Cero dependencias.** Node y nada más.
206
100
 
207
- MADRE habla **español** e **inglés**: la primera vez se abre en el idioma de tu navegador, y en Ajustes › Apariencia lo cambias cuando quieras.
101
+ ## Lo nuevo en 1.0.5
208
102
 
209
- <br>
103
+ - Un manual con capturas reales y cada paso marcado, dentro de MADRE y en PDF, con una guía para entrenar tu propia IA con tu proyecto.
104
+ - Pistas que te enseñan Inicio y tu primer proyecto en minutos.
105
+ - Notas y Recordatorios, que también le pides a cualquier IA.
106
+ - En Código, preguntas por cualquier línea: explicar, mejorar, escribir pruebas o arreglar.
107
+ - Conectores con un clic: GitHub, Notion, Linear, Stripe y más.
108
+ - Cursor y Gemini muestran los modelos de tu plan, y Cursor ya trabaja con los cuatro permisos.
109
+ - Gemini bajo carga te dice qué pasó de verdad.
210
110
 
211
- **Cómo funciona cada cosa, con los números exactos:** [docs/REFERENCE.md](docs/REFERENCE.md)
212
- **Cómo funciona por dentro:** [docs/INTERNALS.md](docs/INTERNALS.md) · **Escribir un módulo:** [docs/SDK.md](docs/SDK.md)
111
+ El detalle está en el [CHANGELOG](CHANGELOG.md). Cómo funciona cada cosa: [docs/REFERENCE.md](docs/REFERENCE.md) · Por dentro: [docs/INTERNALS.md](docs/INTERNALS.md) · Escribir un módulo: [docs/SDK.md](docs/SDK.md)
213
112
 
214
113
  <br>
215
114
 
package/TRADEMARKS.md CHANGED
@@ -44,6 +44,16 @@ el README, la pantalla «Acerca de» o el pie de página.
44
44
  - Dominios, paquetes de npm, cuentas o repositorios cuyo nombre haga creer que son de MADRE.
45
45
  - El logo de MADRE en cualquier cosa que no sea MADRE sin modificar.
46
46
 
47
+ ## Marcas de otros dentro de MADRE
48
+
49
+ Los nombres y logos de los servicios que aparecen en Ajustes › Herramientas externas (MCP) —Notion,
50
+ GitHub, Stripe y los demás— son marcas de sus dueños. MADRE los muestra solo para decir con qué
51
+ servicio se conecta cada conector (uso nominativo), no porque esos dueños respalden a MADRE ni
52
+ tengan relación con ella. Los dibujos vienen de [Simple Icons](https://simpleicons.org) (CC0 1.0)
53
+ con sus colores oficiales; los que Simple Icons no dibuja, de CoreUI Brands y SVG Logos (CC0 1.0) y
54
+ de VSCode Icons (MIT). Si
55
+ eres dueño de una de esas marcas y prefieres que no aparezca, escribe y se quita.
56
+
47
57
  ## Si tienes duda
48
58
 
49
59
  Escribe a Jossue Alcalá en [jossuealcala.com](https://jossuealcala.com) antes de publicar. Esta
@@ -79,4 +89,12 @@ confusable such as "MADRE Pro" or "MADRE+"); anything presented as MADRE or its
79
89
  version; domains, npm packages, accounts or repositories that look like MADRE's; the logo on
80
90
  anything that is not unmodified MADRE.
81
91
 
92
+ **Other people's marks inside MADRE:** the names and logos of the services in Settings › Outside
93
+ tools (MCP) — Notion, GitHub, Stripe and the rest — are their owners' trademarks. MADRE shows them
94
+ only to say which service a connector reaches (nominative use), not because their owners endorse
95
+ or are affiliated with MADRE. The drawings come from [Simple Icons](https://simpleicons.org)
96
+ (CC0 1.0) with their official colors; the ones Simple Icons does not draw, from CoreUI Brands and
97
+ SVG Logos (CC0 1.0) and VSCode Icons (MIT). If
98
+ you own one of those marks and would rather it not appear, write and it is taken off.
99
+
82
100
  In doubt, contact Jossue Alcalá at [jossuealcala.com](https://jossuealcala.com) before publishing.
package/bin/madre.mjs CHANGED
@@ -122,10 +122,10 @@ applyConfigToEnv(await loadConfig(stateRoot));
122
122
 
123
123
  if (command === 'doctor' && (has('--catalog') || has('--conditions'))) {
124
124
  // The same knowledge base MU/TH/UR uses in the room, printed for this platform.
125
- const { CONDITIONS, fixesFor, searchConditions, PLATFORMS } = await import('../public/troubleshooting.js');
125
+ const { CONDITIONS, findConditions, fixesFor, PLATFORMS } = await import('../public/troubleshooting.js');
126
126
  const query = option('--catalog', '') || option('--conditions', '') || '';
127
127
  const platform = PLATFORMS[process.platform] ? process.platform : 'linux';
128
- const list = query && !query.startsWith('--') ? searchConditions(query) : CONDITIONS;
128
+ const list = query && !query.startsWith('--') ? findConditions(query) : CONDITIONS;
129
129
  console.log(`\nDIAGNOSTICS · KNOWN CONDITIONS · ${list.length} OF ${CONDITIONS.length} · ${PLATFORMS[platform].label.toUpperCase()} / ${PLATFORMS[platform].shell.toUpperCase()}\n`);
130
130
  for (const condition of list) {
131
131
  console.log(`▌ ${condition.title}`);