@jossuealcala/madre 1.0.4 → 1.1.0

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 (273) hide show
  1. package/ADDITIONAL-TERMS.md +7 -2
  2. package/CHANGELOG.en.md +152 -1
  3. package/CHANGELOG.md +152 -1
  4. package/CONTRIBUTING.md +2 -2
  5. package/LICENSE +111 -661
  6. package/NOTICE +59 -24
  7. package/README.en.md +36 -204
  8. package/README.md +36 -210
  9. package/SECURITY.md +1 -0
  10. package/TRADEMARKS.en.md +13 -14
  11. package/TRADEMARKS.md +42 -26
  12. package/bin/madre.cjs +2 -2
  13. package/bin/madre.mjs +114 -42
  14. package/docs/REFERENCE.md +53 -6
  15. package/docs/SDK.md +44 -5
  16. package/docs/en/REFERENCE.md +53 -6
  17. package/docs/en/SDK.md +43 -4
  18. package/docs/madre-banner.png +0 -0
  19. package/docs/sdk/hello-module.mjs +3 -0
  20. package/package.json +3 -2
  21. package/public/abduction.js +6 -6
  22. package/public/activity.js +425 -0
  23. package/public/app.js +3519 -647
  24. package/public/assets/abduction-cat-blink.webp +0 -0
  25. package/public/assets/abduction-cat-control-left.webp +0 -0
  26. package/public/assets/abduction-cat-control-right.webp +0 -0
  27. package/public/assets/abduction-cat.webp +0 -0
  28. package/public/assets/manual/shots/en-agents.webp +0 -0
  29. package/public/assets/manual/shots/en-chats.webp +0 -0
  30. package/public/assets/manual/shots/en-code.webp +0 -0
  31. package/public/assets/manual/shots/en-composer.webp +0 -0
  32. package/public/assets/manual/shots/en-connectors.webp +0 -0
  33. package/public/assets/manual/shots/en-continuity.webp +0 -0
  34. package/public/assets/manual/shots/en-coordinator.webp +0 -0
  35. package/public/assets/manual/shots/en-copilot.webp +0 -0
  36. package/public/assets/manual/shots/en-diagnostics.webp +0 -0
  37. package/public/assets/manual/shots/en-home.webp +0 -0
  38. package/public/assets/manual/shots/en-local.webp +0 -0
  39. package/public/assets/manual/shots/en-market.webp +0 -0
  40. package/public/assets/manual/shots/en-memory.webp +0 -0
  41. package/public/assets/manual/shots/en-modes.webp +0 -0
  42. package/public/assets/manual/shots/en-notes.webp +0 -0
  43. package/public/assets/manual/shots/en-settings.webp +0 -0
  44. package/public/assets/manual/shots/en-welcome.webp +0 -0
  45. package/public/assets/manual/shots/en-windows.webp +0 -0
  46. package/public/assets/manual/shots/es-agents.webp +0 -0
  47. package/public/assets/manual/shots/es-chats.webp +0 -0
  48. package/public/assets/manual/shots/es-code.webp +0 -0
  49. package/public/assets/manual/shots/es-composer.webp +0 -0
  50. package/public/assets/manual/shots/es-connectors.webp +0 -0
  51. package/public/assets/manual/shots/es-continuity.webp +0 -0
  52. package/public/assets/manual/shots/es-coordinator.webp +0 -0
  53. package/public/assets/manual/shots/es-copilot.webp +0 -0
  54. package/public/assets/manual/shots/es-diagnostics.webp +0 -0
  55. package/public/assets/manual/shots/es-home.webp +0 -0
  56. package/public/assets/manual/shots/es-local.webp +0 -0
  57. package/public/assets/manual/shots/es-market.webp +0 -0
  58. package/public/assets/manual/shots/es-memory.webp +0 -0
  59. package/public/assets/manual/shots/es-modes.webp +0 -0
  60. package/public/assets/manual/shots/es-notes.webp +0 -0
  61. package/public/assets/manual/shots/es-settings.webp +0 -0
  62. package/public/assets/manual/shots/es-welcome.webp +0 -0
  63. package/public/assets/manual/shots/es-windows.webp +0 -0
  64. package/public/assets/news/1.1/en/chats.webp +0 -0
  65. package/public/assets/news/1.1/en/home.webp +0 -0
  66. package/public/assets/news/1.1/en/maps.webp +0 -0
  67. package/public/assets/news/1.1/en/market.webp +0 -0
  68. package/public/assets/news/1.1/en/permissions.webp +0 -0
  69. package/public/assets/news/1.1/en/privacy.webp +0 -0
  70. package/public/assets/news/1.1/en/welcome.webp +0 -0
  71. package/public/assets/news/1.1/es/chats.webp +0 -0
  72. package/public/assets/news/1.1/es/home.webp +0 -0
  73. package/public/assets/news/1.1/es/maps.webp +0 -0
  74. package/public/assets/news/1.1/es/market.webp +0 -0
  75. package/public/assets/news/1.1/es/permissions.webp +0 -0
  76. package/public/assets/news/1.1/es/privacy.webp +0 -0
  77. package/public/assets/news/1.1/es/welcome.webp +0 -0
  78. package/public/attribution.js +15 -16
  79. package/public/brands.js +2 -2
  80. package/public/code-tools.js +2 -2
  81. package/public/editor.js +13 -13
  82. package/public/en.js +483 -0
  83. package/public/es.js +1817 -598
  84. package/public/hardware.js +2 -2
  85. package/public/i18n.js +47 -9
  86. package/public/icons.js +158 -0
  87. package/public/index.html +68 -51
  88. package/public/inquiry.js +2 -2
  89. package/public/loader.js +271 -2
  90. package/public/macroverso.js +60 -21
  91. package/public/manual-content.js +900 -0
  92. package/public/manual-shots.js +47 -0
  93. package/public/manual.css +246 -0
  94. package/public/manual.html +15 -0
  95. package/public/manual.js +427 -0
  96. package/public/market-art.js +99 -41
  97. package/public/market-view.js +243 -47
  98. package/public/market.js +139 -26
  99. package/public/mcp-catalog.js +62 -0
  100. package/public/neural.js +64 -8
  101. package/public/nostromo-engine.js +709 -40
  102. package/public/page-errors.js +29 -0
  103. package/public/power.js +350 -11
  104. package/public/remedy.js +89 -0
  105. package/public/resay.js +4 -2
  106. package/public/review-ask.js +12 -7
  107. package/public/routing.js +3 -3
  108. package/public/salas-mac.css +875 -48
  109. package/public/salas-mac.html +27 -15
  110. package/public/salas-mac.js +1668 -338
  111. package/public/salas.css +2 -2
  112. package/public/salas.html +3 -3
  113. package/public/salas.js +3 -3
  114. package/public/styles.css +2694 -323
  115. package/public/syntax.js +2 -2
  116. package/public/terms.js +152 -0
  117. package/public/touch.js +2 -2
  118. package/public/tour-chapters.js +100 -92
  119. package/public/tour.js +118 -28
  120. package/public/troubleshooting.js +327 -21
  121. package/public/wallpaper.js +4 -3
  122. package/public/welcome.js +923 -0
  123. package/src/activity.mjs +85 -0
  124. package/src/adapters/claude.mjs +61 -35
  125. package/src/adapters/codex.mjs +18 -5
  126. package/src/adapters/cursor.mjs +60 -9
  127. package/src/adapters/gemini.mjs +17 -4
  128. package/src/adapters/madre.mjs +30 -9
  129. package/src/adapters/opencode.mjs +73 -10
  130. package/src/adapters/process.mjs +19 -15
  131. package/src/adapters/subagents.mjs +159 -0
  132. package/src/asking.mjs +8 -2
  133. package/src/auth-probe.mjs +47 -11
  134. package/src/bridge/devices.mjs +2 -2
  135. package/src/bridge/handoff.mjs +2 -2
  136. package/src/bridge/host.mjs +2 -2
  137. package/src/bridge/network.mjs +2 -2
  138. package/src/bridge/policy.mjs +3 -3
  139. package/src/bridge/qr.mjs +2 -2
  140. package/src/bridge/server.mjs +3 -3
  141. package/src/builtin-updates.mjs +87 -0
  142. package/src/capabilities.mjs +5 -5
  143. package/src/chats.mjs +51 -2
  144. package/src/checkpoint.mjs +67 -9
  145. package/src/choices.mjs +2 -2
  146. package/src/cli-args.mjs +2 -2
  147. package/src/cold.mjs +2 -2
  148. package/src/commands.mjs +2 -2
  149. package/src/config.mjs +2 -2
  150. package/src/conversation-context.mjs +2 -2
  151. package/src/credentials.mjs +80 -18
  152. package/src/dataset.mjs +2 -2
  153. package/src/directives.mjs +2 -2
  154. package/src/distiller.mjs +2 -2
  155. package/src/embeddings.mjs +2 -2
  156. package/src/enlaces.mjs +2 -2
  157. package/src/environment.mjs +147 -0
  158. package/src/event-store.mjs +2 -2
  159. package/src/exam.mjs +2 -2
  160. package/src/extensions.mjs +2 -2
  161. package/src/eyecat-watch.mjs +2 -2
  162. package/src/eyecat.mjs +2 -2
  163. package/src/file-ops.mjs +2 -2
  164. package/src/files.mjs +2 -2
  165. package/src/github.mjs +2 -2
  166. package/src/heartbeat.mjs +2 -2
  167. package/src/history.mjs +76 -0
  168. package/src/i18n.mjs +32 -3
  169. package/src/image-studio.mjs +2 -2
  170. package/src/install-metrics.mjs +109 -0
  171. package/src/json-file.mjs +2 -2
  172. package/src/launch.mjs +2 -2
  173. package/src/lease.mjs +15 -4
  174. package/src/lobby-work.mjs +11 -4
  175. package/src/local-ai.mjs +12 -4
  176. package/src/looks.mjs +19 -7
  177. package/src/market-check.mjs +165 -0
  178. package/src/market-key.mjs +10 -2
  179. package/src/market-license.mjs +104 -0
  180. package/src/market-remote.mjs +71 -13
  181. package/src/maturity.mjs +2 -2
  182. package/src/mcp/connect.mjs +2 -2
  183. package/src/mcp/github-server.mjs +2 -2
  184. package/src/mcp/image-server.mjs +2 -2
  185. package/src/mcp/memory-server.mjs +2 -2
  186. package/src/mcp/proxy.mjs +16 -5
  187. package/src/mcp/smtp-server.mjs +2 -2
  188. package/src/memory-dashboard.mjs +2 -2
  189. package/src/memory-tools.mjs +2 -2
  190. package/src/memory.mjs +2 -2
  191. package/src/models.mjs +115 -12
  192. package/src/module-scope.mjs +2 -2
  193. package/src/modules/ahp.mjs +2 -2
  194. package/src/modules/ash-policy.mjs +2 -2
  195. package/src/modules/ash.mjs +2 -2
  196. package/src/modules/bishop-exam.mjs +2 -2
  197. package/src/modules/bishop-plan.mjs +2 -2
  198. package/src/modules/bishop.mjs +9 -3
  199. package/src/modules/choices.mjs +2 -2
  200. package/src/modules/correo.mjs +2 -2
  201. package/src/modules/enlaces.mjs +2 -2
  202. package/src/modules/git-pulse.mjs +2 -2
  203. package/src/modules/github.mjs +2 -2
  204. package/src/modules/helpers.mjs +2 -2
  205. package/src/modules/image-studio.mjs +2 -2
  206. package/src/modules/index.mjs +92 -5
  207. package/src/modules/intents-calibration.mjs +2 -2
  208. package/src/modules/intents-desk.mjs +4 -3
  209. package/src/modules/intents-observe.mjs +2 -2
  210. package/src/modules/intents-policy.mjs +2 -2
  211. package/src/modules/intents-try.mjs +2 -2
  212. package/src/modules/intents.mjs +2 -2
  213. package/src/modules/local-models.mjs +41 -10
  214. package/src/modules/mcp-connect.mjs +2 -2
  215. package/src/modules/notes.mjs +281 -0
  216. package/src/modules/ollama.mjs +48 -13
  217. package/src/modules/playwright.mjs +16 -5
  218. package/src/modules/reminders.mjs +664 -0
  219. package/src/modules/ripley.mjs +3 -3
  220. package/src/modules/runs.mjs +2 -2
  221. package/src/modules/sdk.mjs +57 -9
  222. package/src/modules/updates.mjs +2 -2
  223. package/src/mother.mjs +13 -3
  224. package/src/npm-launch.mjs +2 -2
  225. package/src/ollama.mjs +8 -6
  226. package/src/opencode-health.mjs +83 -0
  227. package/src/outbound.mjs +35 -3
  228. package/src/override.mjs +27 -22
  229. package/src/ports.mjs +2 -2
  230. package/src/prices.mjs +2 -2
  231. package/src/privacy.mjs +2 -2
  232. package/src/quota-monitor.mjs +2 -2
  233. package/src/quota-sources.mjs +2 -2
  234. package/src/request-guard.mjs +2 -2
  235. package/src/review-ask.mjs +4 -3
  236. package/src/room/archivist.mjs +2 -2
  237. package/src/room/attachments.mjs +2 -2
  238. package/src/room/budget.mjs +2 -2
  239. package/src/room/context.mjs +2 -2
  240. package/src/room/control.mjs +2 -2
  241. package/src/room/copilot.mjs +2 -2
  242. package/src/room/economy.mjs +2 -2
  243. package/src/room/escalation.mjs +2 -2
  244. package/src/room/ghost.mjs +2 -2
  245. package/src/room/guard.mjs +6 -4
  246. package/src/room/prompt.mjs +3 -3
  247. package/src/room/returns.mjs +2 -2
  248. package/src/room/runs.mjs +6 -4
  249. package/src/room/vectors.mjs +2 -2
  250. package/src/room.mjs +144 -36
  251. package/src/router.mjs +2 -2
  252. package/src/runs.mjs +2 -2
  253. package/src/runtime-detection.mjs +36 -6
  254. package/src/salas.mjs +31 -6
  255. package/src/sentinel-errors.mjs +17 -7
  256. package/src/server-sentinel.mjs +2 -2
  257. package/src/server.mjs +980 -139
  258. package/src/setup-trouble.mjs +33 -0
  259. package/src/setup.mjs +4 -4
  260. package/src/smtp.mjs +2 -2
  261. package/src/telemetry.mjs +266 -0
  262. package/src/terms.mjs +43 -0
  263. package/src/tour.mjs +60 -7
  264. package/src/uninstall.mjs +225 -0
  265. package/src/updates.mjs +2 -2
  266. package/src/usage-sentinel.mjs +2 -2
  267. package/src/vault.mjs +2 -2
  268. package/src/verdict.mjs +13 -10
  269. package/src/whats-new.mjs +97 -3
  270. package/public/assets/abduction-cat-blink.png +0 -0
  271. package/public/assets/abduction-cat-control-left.png +0 -0
  272. package/public/assets/abduction-cat-control-right.png +0 -0
  273. package/public/assets/abduction-cat.png +0 -0
package/NOTICE CHANGED
@@ -3,34 +3,69 @@ Copyright © 2026 Jossue Alcalá — https://jossuealcala.com
3
3
 
4
4
  This product is MADRE, created by Jossue Alcalá.
5
5
 
6
- From version 1.0.2 on, MADRE is licensed under the GNU Affero General Public
7
- License, version 3 only (see LICENSE), with additional terms under its
8
- Section 7 (see ADDITIONAL-TERMS.md). Versions 1.0.1 and earlier remain
9
- available under the Apache License 2.0 they were published with.
10
-
11
- Author attribution (Section 7(b)). Every copy of MADRE and every work based on
12
- it must keep displaying, in the corner of every project and of Home, the
13
- attribution «MADRE <version> · © 2026 Jossue Alcalá» linked to
14
- https://jossuealcala.com — or, under another name, «Built with MADRE by Jossue
15
- Alcalá» with the same link — and the same attribution in its Appropriate Legal
16
- Notices. Keep this file, LICENSE and ADDITIONAL-TERMS.md in every distribution,
17
- with the following line, unchanged:
6
+ From version 1.1.0 on, MADRE is licensed under the Business Source License 1.1
7
+ (see LICENSE): free for individuals and for organizations of up to ten people,
8
+ including to provide services to others; each version becomes available under
9
+ the GNU Affero General Public License, version 3 only, four years after it is
10
+ first published. Versions 1.0.2 to 1.0.5 remain under the GNU AGPL v3 only with
11
+ the additional terms in ADDITIONAL-TERMS.md, and versions 1.0.1 and earlier
12
+ under the Apache License 2.0 they were published with.
13
+
14
+ Author attribution. MADRE shows, in the corner of every project and of Home,
15
+ the attribution «MADRE <version> · © 2026 Jossue Alcalá» linked to
16
+ https://jossuealcala.com. Please keep it in every copy and in every work based
17
+ on MADRE — or, under another name, «Built with MADRE by Jossue Alcalá» with the
18
+ same link — together with this file, LICENSE and the following line,
19
+ unchanged:
18
20
 
19
21
  Based on MADRE by Jossue Alcalá — https://madre.run
20
22
 
21
23
  "MADRE", the MADRE logo and madre.run are trademarks of Jossue Alcalá. The
22
- License grants no rights to use them (Section 7(e)). A modified version must be
23
- distributed under a different name and logo. See TRADEMARKS.md.
24
+ License grants no rights to use them. A modified version must be distributed
25
+ under a different name and logo. See TRADEMARKS.md.
24
26
 
25
27
  ---
26
28
 
27
- MADRE es de Jossue Alcalá. Desde la versión 1.0.2 se licencia bajo la GNU AGPL
28
- v3 únicamente, con términos adicionales según su sección 7 (ADDITIONAL-TERMS.md).
29
- Toda copia y toda versión basada en MADRE debe seguir mostrando, en la esquina
30
- de cada proyecto y de Inicio, «MADRE <versión> · © 2026 Jossue Alcalá» con
31
- enlace a https://jossuealcala.com —o, con otro nombre, «Desarrollado con MADRE
32
- de Jossue Alcalá» con el mismo enlace— y la misma atribución en sus avisos
33
- legales. Conserva este archivo, LICENSE, ADDITIONAL-TERMS.md y la línea «Based
34
- on MADRE by Jossue Alcalá — https://madre.run». El nombre MADRE, su logo y
35
- madre.run son marcas de Jossue Alcalá: una versión modificada lleva otro nombre.
36
- Ver TRADEMARKS.md.
29
+ MADRE es de Jossue Alcalá. Desde la versión 1.1.0 se licencia bajo la Business
30
+ Source License 1.1 (LICENSE): gratis para personas y para organizaciones de
31
+ hasta diez personas, también para dar servicios a otros; cada versión pasa a la
32
+ GNU AGPL v3 a los cuatro años de publicarse. Las versiones 1.0.2 a 1.0.5 siguen
33
+ bajo la GNU AGPL v3 con los términos de ADDITIONAL-TERMS.md, y las 1.0.1 y
34
+ anteriores bajo la Apache 2.0. MADRE muestra en la esquina de cada proyecto y de
35
+ Inicio «MADRE <versión> · © 2026 Jossue Alcalá» con enlace a
36
+ https://jossuealcala.com; pedimos conservarla en toda copia y versión basada en
37
+ MADRE —o, con otro nombre, «Desarrollado con MADRE de Jossue Alcalá» con el
38
+ mismo enlace— junto con este archivo, LICENSE y la línea «Based on MADRE by
39
+ Jossue Alcalá — https://madre.run». El nombre MADRE, su logo y madre.run son
40
+ marcas de Jossue Alcalá: una versión modificada lleva otro nombre. Ver
41
+ TRADEMARKS.md.
42
+
43
+ ---
44
+
45
+ Third-party marks (public/mcp-catalog.js). The connectors in Settings › Outside
46
+ tools (MCP) show their makers' marks, only to say which service each one
47
+ reaches; the marks are their owners' trademarks (see TRADEMARKS.md). The
48
+ drawings come from Simple Icons, CoreUI Brands and SVG Logos (CC0 1.0), and the
49
+ Context7 mark from vscode-icons, under the MIT License:
50
+
51
+ The MIT License (MIT)
52
+
53
+ Copyright The vscode-icons Contributors
54
+
55
+ Permission is hereby granted, free of charge, to any person obtaining a copy
56
+ of this software and associated documentation files (the "Software"), to deal
57
+ in the Software without restriction, including without limitation the rights
58
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
59
+ copies of the Software, and to permit persons to whom the Software is
60
+ furnished to do so, subject to the following conditions:
61
+
62
+ The above copyright notice and this permission notice shall be included in all
63
+ copies or substantial portions of the Software.
64
+
65
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
66
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
67
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
68
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
69
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
70
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
71
+ SOFTWARE.
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.1/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>
@@ -7,235 +7,67 @@
7
7
  <p align="center">
8
8
  <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>
9
9
  <a href="https://github.com/jossuealcacao-exe/madre/actions/workflows/ci.yml"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/jossuealcacao-exe/madre/ci.yml?style=flat-square&label=CI&color=9bff66&labelColor=050605"></a>
10
- <img alt="node" src="https://img.shields.io/badge/node-%E2%89%A5%2022.5-9bff66?style=flat-square&labelColor=050605">
11
- <img alt="dependencies" src="https://img.shields.io/badge/dependencies-0-9bff66?style=flat-square&labelColor=050605">
12
- <img alt="license" src="https://img.shields.io/badge/license-AGPL--3.0-9bff66?style=flat-square&labelColor=050605">
10
+ <img alt="systems" src="https://img.shields.io/badge/macOS%20·%20Linux%20·%20Windows%20(WSL2)-9bff66?style=flat-square&labelColor=050605">
11
+ <img alt="license" src="https://img.shields.io/badge/license-BSL%201.1-9bff66?style=flat-square&labelColor=050605">
13
12
  </p>
14
13
 
15
- <br>
16
-
17
14
  # All your AIs in one chat.
18
15
 
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.
22
-
23
- ```
24
- npx @jossuealcala/madre
25
- ```
26
-
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.
29
-
30
- <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%">
32
- </p>
33
-
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
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 OpenCode) 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.
66
17
 
67
18
  <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%">
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%">
69
20
  </p>
70
21
 
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
74
-
75
- <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%">
77
- </p>
78
-
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`.
80
-
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
84
-
85
- <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%">
87
- </p>
88
-
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>
22
+ ## Install it
117
23
 
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:
139
-
140
- ```
141
- /module a command that tells me what changed in the repo this week
142
- ```
143
-
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.
145
-
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.
147
-
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.
149
-
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).
151
-
152
- <br>
153
-
154
- ---
155
-
156
- <br>
157
-
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.
24
+ **macOS and Linux.** Open the Terminal and type:
181
25
 
182
26
  ```
183
27
  npx @jossuealcala/madre
184
28
  ```
185
29
 
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.
30
+ **Windows.** MADRE runs inside WSL2, the Linux that comes with Windows:
187
31
 
188
- If you'd rather go straight into a project, as before:
32
+ 1. Open PowerShell as administrator and type `wsl --install`. Restart if it asks you to.
33
+ 2. Open **Ubuntu** from the Start menu.
34
+ 3. Type `npx @jossuealcala/madre` there.
189
35
 
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`.
36
+ You need Node 22.5 or newer and at least one AI you are signed in to. There is no account to create. MADRE opens in your browser and a welcome guides you step by step: it connects your AIs, puts a free AI on your computer if it fits, and adds your first project.
200
37
 
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.
38
+ ## New in 1.1
202
39
 
203
- <br>
40
+ <table>
41
+ <tr>
42
+ <td width="50%"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/public/assets/news/1.1/en/home.webp" alt="Home: your projects, the Coordinator and what is waiting for you"><br><b>Home.</b> Your projects, the Coordinator and what is waiting for you, in one place.</td>
43
+ <td width="50%"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/public/assets/news/1.1/en/market.webp" alt="The Market: modules installed in one click"><br><b>The Market.</b> Notes, Reminders, Before you push and more, in one click.</td>
44
+ </tr>
45
+ <tr>
46
+ <td width="50%"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/public/assets/news/1.1/en/welcome.webp" alt="The welcome: connect your agents without the terminal"><br><b>A step-by-step welcome.</b> No terminal needed.</td>
47
+ <td width="50%"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/public/assets/news/1.1/en/permissions.webp" alt="Permissions: from #0 to #4"><br><b>You decide what changes.</b> From chat only to full access, with undo.</td>
48
+ </tr>
49
+ </table>
204
50
 
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)
51
+ 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).
207
52
 
208
- <br>
53
+ ## If something fails
209
54
 
210
- ---
211
-
212
- <br>
213
-
214
- ## Status
55
+ Open **Diagnostics** and type what you see, like "Gemini does not answer". It tells you what is going on and gives you the button that fixes it. Without opening MADRE, `npx @jossuealcala/madre doctor` checks your AIs. Common problems are in the [manual](https://madre.run/en/manual/#ayuda).
215
56
 
216
- Public beta. The core is tested and under CI on macOS and Linux with Node 22 and 24; the surface keeps changing. The decisions that still hurt are written down, without embellishment, in [*What leaves the machine*](docs/en/REFERENCE.md#what-leaves-the-machine).
57
+ ## Your data
217
58
 
218
- A version is closed when it's on npm. The details of each one in [CHANGELOG.en.md](CHANGELOG.en.md); what's coming, in the [roadmap](https://github.com/jossuealcacao-exe/madre/blob/main/docs/en/ROADMAP.md).
59
+ - **It runs on your computer.** MADRE has no account and no cloud: it opens on `127.0.0.1`.
60
+ - **Your keys are not copied.** Each AI keeps its own sign-in.
61
+ - **You know what leaves.** What an AI reads goes to its provider, with your account, just as in your Terminal. Once a day MADRE sends anonymous diagnostics (what failed and how much it is used, never what you write or your projects); turn it off in Settings.
219
62
 
220
- Problems: from any fix in Diagnostics ("Not fixed?") or in [issues](https://github.com/jossuealcacao-exe/madre/issues).
221
- Security: [SECURITY.md](SECURITY.md) · Contributing: [CONTRIBUTING.md](CONTRIBUTING.md)
63
+ ## License
222
64
 
223
- MADRE is free and will stay that way. If it saves you time and you want it to keep growing,
224
- you can [sponsor it](https://github.com/sponsors/jossuealcacao-exe). Nothing in the product
225
- changes based on what you do with that link.
65
+ **Free for individuals and for teams of up to 10**, also when you use it to work for your clients. Anyone can try it. A larger organization using it in its work, or anyone who wants to offer MADRE as a service, needs a commercial license: write to hola@jossuealcala.com.
226
66
 
227
- AGPL-3.0 with additional terms · © 2026 [Jossue Alcalá](https://jossuealcala.com/en/)
67
+ The code is public ([Business Source License 1.1](LICENSE)). It is not an open source license, but each version becomes [GNU AGPL v3](https://www.gnu.org/licenses/agpl-3.0.html) four years after it is published. Versions up to 1.0.5 keep the license they were released with. The MADRE name and logo are trademarks of Jossue Alcalá ([TRADEMARKS.en.md](TRADEMARKS.en.md)).
228
68
 
229
- The code is free software under the [GNU AGPL v3](LICENSE) with [additional terms](ADDITIONAL-TERMS.md):
230
- use it, modify it and fork it, as long as your version stays open under the same license and keeps the
231
- authorship visible —«MADRE ‹version› · © 2026 Jossue Alcalá» in the corner of every project and of Home,
232
- linked to jossuealcala.com, or «Built with MADRE by Jossue Alcalá» under another name. The name
233
- **MADRE**, its logo and madre.run are trademarks of Jossue Alcalá: a modified version goes by another
234
- name. Up to 1.0.1, MADRE was published under the Apache License 2.0. What's allowed and what isn't:
235
- [TRADEMARKS.en.md](TRADEMARKS.en.md).
69
+ ---
236
70
 
237
- <br>
71
+ [Manual](https://madre.run/en/manual/) · [CHANGELOG](CHANGELOG.en.md) · [How each thing works](docs/REFERENCE.md) · [Writing a module](docs/SDK.md) · [Security](SECURITY.md) · [Contributing](CONTRIBUTING.md) · [Issues](https://github.com/jossuealcacao-exe/madre/issues)
238
72
 
239
- ```
240
- NOBODY DELETES MOTHER'S MEMORY.
241
- ```
73
+ © 2026 [Jossue Alcalá](https://jossuealcala.com)