@jossuealcala/madre 1.0.5 → 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 (278) hide show
  1. package/ADDITIONAL-TERMS.md +7 -2
  2. package/CHANGELOG.en.md +47 -1
  3. package/CHANGELOG.md +47 -1
  4. package/CONTRIBUTING.md +2 -2
  5. package/LICENSE +111 -661
  6. package/NOTICE +28 -23
  7. package/README.en.md +30 -101
  8. package/README.md +30 -103
  9. package/SECURITY.md +1 -0
  10. package/TRADEMARKS.en.md +13 -14
  11. package/TRADEMARKS.md +24 -26
  12. package/bin/madre.cjs +2 -2
  13. package/bin/madre.mjs +112 -40
  14. package/docs/REFERENCE.md +52 -5
  15. package/docs/SDK.md +21 -3
  16. package/docs/en/REFERENCE.md +52 -5
  17. package/docs/en/SDK.md +22 -3
  18. package/docs/sdk/hello-module.mjs +3 -0
  19. package/package.json +3 -2
  20. package/public/abduction.js +6 -6
  21. package/public/activity.js +425 -0
  22. package/public/app.js +2468 -435
  23. package/public/assets/abduction-cat-blink.webp +0 -0
  24. package/public/assets/abduction-cat-control-left.webp +0 -0
  25. package/public/assets/abduction-cat-control-right.webp +0 -0
  26. package/public/assets/abduction-cat.webp +0 -0
  27. package/public/assets/manual/shots/en-agents.webp +0 -0
  28. package/public/assets/manual/shots/en-chats.webp +0 -0
  29. package/public/assets/manual/shots/en-code.webp +0 -0
  30. package/public/assets/manual/shots/en-composer.webp +0 -0
  31. package/public/assets/manual/shots/en-connectors.webp +0 -0
  32. package/public/assets/manual/shots/en-continuity.webp +0 -0
  33. package/public/assets/manual/shots/en-coordinator.webp +0 -0
  34. package/public/assets/manual/shots/en-copilot.webp +0 -0
  35. package/public/assets/manual/shots/en-diagnostics.webp +0 -0
  36. package/public/assets/manual/shots/en-home.webp +0 -0
  37. package/public/assets/manual/shots/en-local.webp +0 -0
  38. package/public/assets/manual/shots/en-market.webp +0 -0
  39. package/public/assets/manual/shots/en-memory.webp +0 -0
  40. package/public/assets/manual/shots/en-modes.webp +0 -0
  41. package/public/assets/manual/shots/en-notes.webp +0 -0
  42. package/public/assets/manual/shots/en-settings.webp +0 -0
  43. package/public/assets/manual/shots/en-welcome.webp +0 -0
  44. package/public/assets/manual/shots/en-windows.webp +0 -0
  45. package/public/assets/manual/shots/es-agents.webp +0 -0
  46. package/public/assets/manual/shots/es-chats.webp +0 -0
  47. package/public/assets/manual/shots/es-code.webp +0 -0
  48. package/public/assets/manual/shots/es-composer.webp +0 -0
  49. package/public/assets/manual/shots/es-connectors.webp +0 -0
  50. package/public/assets/manual/shots/es-continuity.webp +0 -0
  51. package/public/assets/manual/shots/es-coordinator.webp +0 -0
  52. package/public/assets/manual/shots/es-copilot.webp +0 -0
  53. package/public/assets/manual/shots/es-diagnostics.webp +0 -0
  54. package/public/assets/manual/shots/es-home.webp +0 -0
  55. package/public/assets/manual/shots/es-local.webp +0 -0
  56. package/public/assets/manual/shots/es-market.webp +0 -0
  57. package/public/assets/manual/shots/es-memory.webp +0 -0
  58. package/public/assets/manual/shots/es-modes.webp +0 -0
  59. package/public/assets/manual/shots/es-notes.webp +0 -0
  60. package/public/assets/manual/shots/es-settings.webp +0 -0
  61. package/public/assets/manual/shots/es-welcome.webp +0 -0
  62. package/public/assets/manual/shots/es-windows.webp +0 -0
  63. package/public/assets/news/1.1/en/chats.webp +0 -0
  64. package/public/assets/news/1.1/en/home.webp +0 -0
  65. package/public/assets/news/1.1/en/maps.webp +0 -0
  66. package/public/assets/news/1.1/en/market.webp +0 -0
  67. package/public/assets/news/1.1/en/permissions.webp +0 -0
  68. package/public/assets/news/1.1/en/privacy.webp +0 -0
  69. package/public/assets/news/1.1/en/welcome.webp +0 -0
  70. package/public/assets/news/1.1/es/chats.webp +0 -0
  71. package/public/assets/news/1.1/es/home.webp +0 -0
  72. package/public/assets/news/1.1/es/maps.webp +0 -0
  73. package/public/assets/news/1.1/es/market.webp +0 -0
  74. package/public/assets/news/1.1/es/permissions.webp +0 -0
  75. package/public/assets/news/1.1/es/privacy.webp +0 -0
  76. package/public/assets/news/1.1/es/welcome.webp +0 -0
  77. package/public/attribution.js +15 -16
  78. package/public/brands.js +2 -2
  79. package/public/code-tools.js +2 -2
  80. package/public/editor.js +13 -13
  81. package/public/en.js +413 -4
  82. package/public/es.js +1345 -483
  83. package/public/hardware.js +2 -2
  84. package/public/i18n.js +2 -2
  85. package/public/icons.js +158 -0
  86. package/public/index.html +66 -48
  87. package/public/inquiry.js +2 -2
  88. package/public/loader.js +271 -2
  89. package/public/macroverso.js +60 -21
  90. package/public/manual-content.js +412 -169
  91. package/public/manual-shots.js +38 -34
  92. package/public/manual.css +20 -2
  93. package/public/manual.html +1 -1
  94. package/public/manual.js +54 -25
  95. package/public/market-art.js +47 -45
  96. package/public/market-view.js +111 -33
  97. package/public/market.js +132 -30
  98. package/public/mcp-catalog.js +2 -2
  99. package/public/neural.js +64 -8
  100. package/public/nostromo-engine.js +709 -40
  101. package/public/page-errors.js +29 -0
  102. package/public/power.js +350 -11
  103. package/public/remedy.js +89 -0
  104. package/public/resay.js +3 -2
  105. package/public/review-ask.js +12 -7
  106. package/public/routing.js +3 -3
  107. package/public/salas-mac.css +703 -24
  108. package/public/salas-mac.html +26 -14
  109. package/public/salas-mac.js +1254 -289
  110. package/public/salas.css +2 -2
  111. package/public/salas.html +3 -3
  112. package/public/salas.js +3 -3
  113. package/public/styles.css +2404 -291
  114. package/public/syntax.js +2 -2
  115. package/public/terms.js +152 -0
  116. package/public/touch.js +2 -2
  117. package/public/tour-chapters.js +10 -10
  118. package/public/tour.js +56 -8
  119. package/public/troubleshooting.js +182 -11
  120. package/public/wallpaper.js +4 -3
  121. package/public/welcome.js +923 -0
  122. package/src/activity.mjs +85 -0
  123. package/src/adapters/claude.mjs +61 -35
  124. package/src/adapters/codex.mjs +18 -5
  125. package/src/adapters/cursor.mjs +5 -3
  126. package/src/adapters/gemini.mjs +5 -3
  127. package/src/adapters/madre.mjs +3 -3
  128. package/src/adapters/opencode.mjs +73 -10
  129. package/src/adapters/process.mjs +14 -13
  130. package/src/adapters/subagents.mjs +159 -0
  131. package/src/asking.mjs +8 -2
  132. package/src/auth-probe.mjs +27 -10
  133. package/src/bridge/devices.mjs +2 -2
  134. package/src/bridge/handoff.mjs +2 -2
  135. package/src/bridge/host.mjs +2 -2
  136. package/src/bridge/network.mjs +2 -2
  137. package/src/bridge/policy.mjs +3 -3
  138. package/src/bridge/qr.mjs +2 -2
  139. package/src/bridge/server.mjs +2 -2
  140. package/src/builtin-updates.mjs +87 -0
  141. package/src/capabilities.mjs +2 -2
  142. package/src/chats.mjs +51 -2
  143. package/src/checkpoint.mjs +67 -9
  144. package/src/choices.mjs +2 -2
  145. package/src/cli-args.mjs +2 -2
  146. package/src/cold.mjs +2 -2
  147. package/src/commands.mjs +2 -2
  148. package/src/config.mjs +2 -2
  149. package/src/conversation-context.mjs +2 -2
  150. package/src/credentials.mjs +56 -16
  151. package/src/dataset.mjs +2 -2
  152. package/src/directives.mjs +2 -2
  153. package/src/distiller.mjs +2 -2
  154. package/src/embeddings.mjs +2 -2
  155. package/src/enlaces.mjs +2 -2
  156. package/src/environment.mjs +147 -0
  157. package/src/event-store.mjs +2 -2
  158. package/src/exam.mjs +2 -2
  159. package/src/extensions.mjs +2 -2
  160. package/src/eyecat-watch.mjs +2 -2
  161. package/src/eyecat.mjs +2 -2
  162. package/src/file-ops.mjs +2 -2
  163. package/src/files.mjs +2 -2
  164. package/src/github.mjs +2 -2
  165. package/src/heartbeat.mjs +2 -2
  166. package/src/history.mjs +2 -2
  167. package/src/i18n.mjs +9 -2
  168. package/src/image-studio.mjs +2 -2
  169. package/src/install-metrics.mjs +109 -0
  170. package/src/json-file.mjs +2 -2
  171. package/src/launch.mjs +2 -2
  172. package/src/lease.mjs +15 -4
  173. package/src/lobby-work.mjs +11 -4
  174. package/src/local-ai.mjs +2 -2
  175. package/src/looks.mjs +2 -2
  176. package/src/market-check.mjs +165 -0
  177. package/src/market-key.mjs +10 -2
  178. package/src/market-license.mjs +4 -4
  179. package/src/market-remote.mjs +54 -12
  180. package/src/maturity.mjs +2 -2
  181. package/src/mcp/connect.mjs +2 -2
  182. package/src/mcp/github-server.mjs +2 -2
  183. package/src/mcp/image-server.mjs +2 -2
  184. package/src/mcp/memory-server.mjs +2 -2
  185. package/src/mcp/proxy.mjs +2 -2
  186. package/src/mcp/smtp-server.mjs +2 -2
  187. package/src/memory-dashboard.mjs +2 -2
  188. package/src/memory-tools.mjs +2 -2
  189. package/src/memory.mjs +2 -2
  190. package/src/models.mjs +33 -3
  191. package/src/module-scope.mjs +2 -2
  192. package/src/modules/ahp.mjs +2 -2
  193. package/src/modules/ash-policy.mjs +2 -2
  194. package/src/modules/ash.mjs +2 -2
  195. package/src/modules/bishop-exam.mjs +2 -2
  196. package/src/modules/bishop-plan.mjs +2 -2
  197. package/src/modules/bishop.mjs +9 -3
  198. package/src/modules/choices.mjs +2 -2
  199. package/src/modules/correo.mjs +2 -2
  200. package/src/modules/enlaces.mjs +2 -2
  201. package/src/modules/git-pulse.mjs +2 -2
  202. package/src/modules/github.mjs +2 -2
  203. package/src/modules/helpers.mjs +2 -2
  204. package/src/modules/image-studio.mjs +2 -2
  205. package/src/modules/index.mjs +90 -5
  206. package/src/modules/intents-calibration.mjs +2 -2
  207. package/src/modules/intents-desk.mjs +4 -3
  208. package/src/modules/intents-observe.mjs +2 -2
  209. package/src/modules/intents-policy.mjs +2 -2
  210. package/src/modules/intents-try.mjs +2 -2
  211. package/src/modules/intents.mjs +2 -2
  212. package/src/modules/local-models.mjs +14 -11
  213. package/src/modules/mcp-connect.mjs +2 -2
  214. package/src/modules/notes.mjs +159 -20
  215. package/src/modules/ollama.mjs +9 -3
  216. package/src/modules/playwright.mjs +2 -2
  217. package/src/modules/reminders.mjs +356 -37
  218. package/src/modules/ripley.mjs +3 -3
  219. package/src/modules/runs.mjs +2 -2
  220. package/src/modules/sdk.mjs +38 -6
  221. package/src/modules/updates.mjs +2 -2
  222. package/src/mother.mjs +2 -2
  223. package/src/npm-launch.mjs +2 -2
  224. package/src/ollama.mjs +6 -4
  225. package/src/opencode-health.mjs +26 -6
  226. package/src/outbound.mjs +10 -2
  227. package/src/override.mjs +27 -22
  228. package/src/ports.mjs +2 -2
  229. package/src/prices.mjs +2 -2
  230. package/src/privacy.mjs +2 -2
  231. package/src/quota-monitor.mjs +2 -2
  232. package/src/quota-sources.mjs +2 -2
  233. package/src/request-guard.mjs +2 -2
  234. package/src/review-ask.mjs +4 -3
  235. package/src/room/archivist.mjs +2 -2
  236. package/src/room/attachments.mjs +2 -2
  237. package/src/room/budget.mjs +2 -2
  238. package/src/room/context.mjs +2 -2
  239. package/src/room/control.mjs +2 -2
  240. package/src/room/copilot.mjs +2 -2
  241. package/src/room/economy.mjs +2 -2
  242. package/src/room/escalation.mjs +2 -2
  243. package/src/room/ghost.mjs +2 -2
  244. package/src/room/guard.mjs +6 -4
  245. package/src/room/prompt.mjs +3 -3
  246. package/src/room/returns.mjs +2 -2
  247. package/src/room/runs.mjs +6 -4
  248. package/src/room/vectors.mjs +2 -2
  249. package/src/room.mjs +127 -31
  250. package/src/router.mjs +2 -2
  251. package/src/runs.mjs +2 -2
  252. package/src/runtime-detection.mjs +31 -5
  253. package/src/salas.mjs +31 -6
  254. package/src/sentinel-errors.mjs +13 -4
  255. package/src/server-sentinel.mjs +2 -2
  256. package/src/server.mjs +689 -80
  257. package/src/setup-trouble.mjs +33 -0
  258. package/src/setup.mjs +4 -4
  259. package/src/smtp.mjs +2 -2
  260. package/src/telemetry.mjs +266 -0
  261. package/src/terms.mjs +43 -0
  262. package/src/tour.mjs +39 -5
  263. package/src/uninstall.mjs +225 -0
  264. package/src/updates.mjs +2 -2
  265. package/src/usage-sentinel.mjs +2 -2
  266. package/src/vault.mjs +2 -2
  267. package/src/verdict.mjs +13 -10
  268. package/src/whats-new.mjs +97 -3
  269. package/public/assets/abduction-cat-blink.png +0 -0
  270. package/public/assets/abduction-cat-control-left.png +0 -0
  271. package/public/assets/abduction-cat-control-right.png +0 -0
  272. package/public/assets/abduction-cat.png +0 -0
  273. package/public/assets/manual/madre-manual-en.pdf +0 -0
  274. package/public/assets/manual/madre-manual-es.pdf +0 -0
  275. package/public/assets/manual/shots/en-modules.webp +0 -0
  276. package/public/assets/manual/shots/es-modules.webp +0 -0
  277. package/src/mcp/notes-server.mjs +0 -120
  278. package/src/reminder-time.mjs +0 -127
@@ -1,5 +1,5 @@
1
- // SPDX-License-Identifier: AGPL-3.0-only
2
- // MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
1
+ // SPDX-License-Identifier: BUSL-1.1
2
+ // MADRE · © 2026 Jossue Alcalá · Business Source License 1.1: LICENSE
3
3
  // The user manual (1.0.5): how to use MADRE, for someone who has never used an AI and for someone
4
4
  // who uses one every day. Read in MADRE (public/manual.js, /manual) and printed to the PDF
5
5
  // (scripts/manual-pdf.mjs). Every sentence is something the product does today; the phone, hidden
@@ -10,14 +10,25 @@
10
10
  // whoever already knows the basics. Its `shot` is a picture of MADRE itself (scripts/manual-shots.mjs)
11
11
  // whose numbered marks are the steps, in order. No «in one place», no «at your own pace»: what to
12
12
  // press and what to type. `«Mac»` is said of the computer (i18n.js, hostWords).
13
+ //
14
+ // «Start here» (2026-10-28, docs/private/BIENVENIDA-1.0.6.md, F8): the first section is the way in
15
+ // for each system — a Mac, Linux, Windows with WSL, and a computer reached over SSH or a virtual
16
+ // machine — then the welcome, which leaves MADRE ready. Windows says what docs/WINDOWS.md says: from
17
+ // 1.1.0 MADRE runs inside WSL2, not on Windows directly. Its card is `#windows`: bin/madre.mjs and the
18
+ // mail to the Windows waiting list point there.
19
+ //
20
+ // 1.1.0 (2026-10-28): the layout of 1.1 — Home first, the column at the left in Home and in every
21
+ // project, chats in that column, Files and the other tools in a column at the right, the Market in
22
+ // the left column — with the welcome, the chats and the Market as sections of their own, and the
23
+ // license in a few plain lines.
13
24
 
14
25
  export const MANUAL = {
15
26
  es: {
16
27
  title: 'Manual de MADRE',
17
28
  subtitle: 'Cómo trabajar con tus agentes de IA',
18
29
  intro: [
19
- 'En MADRE trabajas con las IAs que ya usas: Codex, Claude, Gemini, Cursor u OpenCode. Les escribes, leen tu proyecto y tú decides qué pueden cambiar.',
20
- 'Si nunca has usado una IA, empieza por «Instala MADRE» y sigue en orden. Si ya las usas, ve directo a lo que necesites: cada sección cierra con lo que conviene saber cuando ya tienes práctica.',
30
+ 'En MADRE trabajas con las IAs que ya usas: Codex, Claude, Gemini, Cursor u OpenCode. Les escribes como en un chat, leen tu proyecto y tú decides qué pueden cambiar.',
31
+ 'Si nunca has usado una IA, empieza por «Empieza aquí» y sigue en orden. Si ya las usas, ve directo a lo que necesites: cada sección cierra con lo que conviene saber cuando ya tienes práctica.',
21
32
  ],
22
33
  words: {
23
34
  title: 'Cuatro palabras antes de empezar',
@@ -41,17 +52,74 @@ export const MANUAL = {
41
52
  id: 'instalar',
42
53
  part: 'start',
43
54
  icon: 'download',
44
- title: 'Instala MADRE',
45
- lead: 'MADRE se instala con un comando y se abre en tu navegador. No pide cuenta ni tarjeta.',
46
- code: ['npx @jossuealcala/madre'],
47
- tryIt: 'Para saber si ya tienes Node, escribe en la Terminal `node --version`. Si dice v22.5 o un número mayor, ya está.',
48
- steps: [
49
- 'Instala Node.js 22.5 o más nuevo desde nodejs.org. Si ya lo tienes, sáltate este paso.',
50
- 'Abre la Terminal, pega el comando de arriba y pulsa ↵.',
51
- 'MADRE se abre en tu navegador, en Inicio. La próxima vez usa el mismo comando.',
55
+ title: 'Empieza aquí',
56
+ lead: 'Un comando instala MADRE y la abre en tu navegador. Ahí, la bienvenida te deja todo listo paso a paso. Después ya no necesitas la terminal (la ventana donde se escriben comandos). No pide cuenta ni tarjeta.',
57
+ systems: [
58
+ {
59
+ name: 'Mac',
60
+ steps: [
61
+ 'Instala Node 22.5 o más nuevo desde nodejs.org, o con `brew install node`. Si ya lo tienes, sáltate este paso.',
62
+ 'Abre la app Terminal (búscala con Spotlight) y pega el comando.',
63
+ ],
64
+ code: ['npx @jossuealcala/madre'],
65
+ tip: 'Para la IA en tu computadora, la bienvenida te da el enlace a la app oficial de Ollama.',
66
+ },
67
+ {
68
+ name: 'Linux',
69
+ steps: [
70
+ 'Instala Node 22.5 o más nuevo desde nodejs.org o con nvm: el de los paquetes de tu sistema puede ser más viejo.',
71
+ 'Abre tu terminal y pega el comando.',
72
+ ],
73
+ code: ['npx @jossuealcala/madre'],
74
+ tip: 'Para instalar Ollama, Linux pide tu contraseña. La bienvenida te da la línea para copiarla: MADRE nunca pide ni guarda contraseñas.',
75
+ },
76
+ {
77
+ id: 'windows',
78
+ name: 'Windows, con WSL2',
79
+ note: 'En Windows, MADRE funciona dentro de WSL2, el Linux que traen Windows 10 y 11. Si la abres directo en Windows, te explica estos pasos y se detiene.',
80
+ steps: [
81
+ 'Una vez, en PowerShell como administrador, escribe `wsl --install` y reinicia.',
82
+ 'Abre «Ubuntu» desde el menú Inicio e instala Node 22: `curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -` y luego `sudo apt install -y nodejs`.',
83
+ 'Pega el comando en Ubuntu. MADRE se abre en tu navegador de Windows.',
84
+ ],
85
+ code: ['npx @jossuealcala/madre'],
86
+ tip: 'Guarda tus proyectos dentro de Linux (en /home), no en /mnt/c: ahí MADRE va más rápido y protege mejor tus archivos.',
87
+ },
88
+ {
89
+ name: 'Otra computadora (SSH) o máquina virtual',
90
+ note: 'Si MADRE corre en un servidor o en una máquina virtual a la que entras por SSH, tu navegador está en tu computadora y llega a MADRE por un túnel.',
91
+ steps: [
92
+ 'En el servidor, pega el comando de MADRE. La terminal te escribe el comando del túnel con tu usuario, tu servidor y el puerto.',
93
+ 'En tu computadora, abre otra terminal, pega ese comando y déjala abierta.',
94
+ 'Abre http://127.0.0.1:5317/salas en tu navegador.',
95
+ ],
96
+ code: ['npx @jossuealcala/madre'],
97
+ tip: 'En una máquina virtual la IA en tu computadora va lenta. Si tu PC tiene Windows, MADRE va mejor con WSL que en una máquina virtual.',
98
+ },
99
+ ],
100
+ tryIt: 'Para saber si ya tienes Node, escribe en la terminal `node --version`. Si dice v22.5 o un número mayor, ya está.',
101
+ steps: [
102
+ 'MADRE se abre en tu navegador con la bienvenida. Elige tu idioma y sigue los siete pasos.',
103
+ 'Si algo falla, la bienvenida te dice qué pasó, y «Ver cómo arreglarlo» te da los pasos para tu sistema.',
104
+ 'Para volver otro día, usa el mismo comando: se abre Inicio, con tus proyectos.',
52
105
  ],
53
106
  expert: 'MADRE no guarda tus contraseñas: usa las sesiones que tus agentes ya tienen en tu Mac. Con `--port 4800` la abres en otro puerto.',
54
107
  },
108
+ {
109
+ id: 'bienvenida',
110
+ part: 'start',
111
+ icon: 'check',
112
+ shot: 'welcome',
113
+ title: 'La bienvenida',
114
+ lead: 'La primera vez, MADRE te recibe con siete pasos: tu computadora, tus agentes, la IA en tu computadora, la memoria y tu primer proyecto. Todo con botones, sin terminal.',
115
+ tryIt: 'Si ya la cerraste, ábrela otra vez: en Inicio, Ajustes › Proyectos › «Ver la bienvenida otra vez».',
116
+ steps: [
117
+ 'A la izquierda están los siete pasos. Puedes ir a cualquiera; los que terminas quedan con una palomita.',
118
+ 'Cada paso te explica qué es y te da el botón para hacerlo: conectar un agente, descargar la IA o elegir tu carpeta.',
119
+ '«Continuar» te lleva al siguiente. Lo que dejes pendiente lo haces después en Ajustes.',
120
+ ],
121
+ expert: 'La bienvenida recuerda en qué paso te quedaste. Si ya usabas MADRE 1.0, Inicio te enseña primero lo nuevo de 1.1.',
122
+ },
55
123
  {
56
124
  id: 'agentes',
57
125
  part: 'start',
@@ -61,26 +129,26 @@ export const MANUAL = {
61
129
  lead: 'Un agente es una IA como Codex, Claude o Gemini. Lo conectas una vez y todos tus proyectos lo usan. Con uno basta para empezar.',
62
130
  tryIt: 'Si ya usas ChatGPT, conecta Codex con esa misma cuenta: es lo más rápido.',
63
131
  steps: [
64
- 'En Inicio, abre Ajustes › Agentes. La primera vez MADRE te lo muestra solo.',
132
+ 'En Inicio, abre Ajustes (el engrane, abajo a la izquierda) › Agentes. La primera vez, la bienvenida te lleva ahí.',
65
133
  'Abre un agente que diga «Sin iniciar sesión» y pulsa su botón, como «Cuenta de Claude». Entras con tu cuenta en la página del proveedor. Si no lo tienes, verás Instalar.',
66
134
  'Cuando dice «Conectado», ya puedes hablarle.',
67
135
  ],
68
- expert: 'Cada agente guarda su propia sesión; MADRE no la lee. Las llaves de API (Gemini, OpenCode) se pegan en la misma tarjeta, y «¿Prefieres tu terminal?» te da el comando.',
136
+ expert: 'Cada agente guarda su propia sesión; MADRE no la lee. Las llaves de acceso (API key) de Codex, Claude, Gemini y OpenCode se pegan en la misma tarjeta, y «¿Prefieres tu terminal?» te da el comando. Si MADRE corre en otra computadora, Codex se conecta «Con un código».',
69
137
  },
70
138
  {
71
139
  id: 'inicio',
72
140
  part: 'start',
73
141
  icon: 'home',
74
142
  shot: 'home',
75
- title: 'Tu primer proyecto',
76
- lead: 'Un proyecto es una carpeta de tu Mac. MADRE la abre, la lee y le guarda memoria. Agregarla no cambia nada de lo que hay dentro.',
143
+ title: 'Inicio y tus proyectos',
144
+ lead: 'Inicio es lo primero que ves al abrir MADRE: tus proyectos, el Coordinador y lo que te espera. Un proyecto es una carpeta de tu Mac; agregarla no cambia nada de lo que hay dentro.',
77
145
  tryIt: 'Si no tienes una carpeta a la mano, crea una vacía que se llame «prueba» y agrégala.',
78
146
  steps: [
79
- 'En Inicio, pulsa «Agregar proyecto» y elige la carpeta.',
80
- 'Aparece su tarjeta. Haz clic en ella para abrir el proyecto.',
81
- '«Te necesita» junta lo que quedó pendiente: una pregunta de un agente, un permiso o un recordatorio.',
147
+ 'En la columna izquierda, pulsa «Agregar proyecto» y elige la carpeta.',
148
+ 'Aparece en Proyectos. Pulsa Abrir en su tarjeta para entrar.',
149
+ '«Te espera» junta lo que quedó pendiente: una pregunta de un agente, un permiso o un recordatorio.',
82
150
  ],
83
- expert: 'Clic derecho en una tarjeta para anclarla a la barra o quitarla de MADRE; tu carpeta se queda igual. Clic derecho en el fondo agrega widgets.',
151
+ expert: 'La columna izquierda es la misma en Inicio y en cada proyecto: Inicio, el Coordinador, el Mercado y tus proyectos abiertos. «Te necesita» pone primero los proyectos que tienen algo pendiente. El menú ··· de una tarjeta la quita de MADRE; tu carpeta se queda igual.',
84
152
  },
85
153
  {
86
154
  id: 'hablar',
@@ -94,9 +162,25 @@ export const MANUAL = {
94
162
  'Escribe en la caja y pulsa ↵ para enviar.',
95
163
  'El círculo de la izquierda es el agente que te va a contestar. Tócalo para elegir otro.',
96
164
  'La etiqueta con # es el permiso. Con #1 el agente lee y te contesta, pero no cambia nada.',
97
- 'A un lado eliges el modelo y cuánto piensa. Si no sabes cuál, déjalos así.',
165
+ 'A un lado eliges el modelo y, en algunos agentes, cuánto piensa. Si no sabes cuál, déjalo así.',
98
166
  ],
99
- expert: '@ llama a un agente, # cambia el permiso, ! cita un archivo y / abre los comandos. ⌥ ↵ hace un salto de línea y ⌘ V pega una imagen.',
167
+ expert: '@ llama a un agente; con varios al principio («@opencode @madre ¿…?») la pregunta va a cada uno y cada uno contesta aparte. # cambia el permiso, ! cita un archivo y / abre los comandos. ⌥ ↵ hace un salto de línea y ⌘ V pega una imagen.',
168
+ },
169
+ {
170
+ id: 'chats',
171
+ part: 'work',
172
+ icon: 'list',
173
+ shot: 'chats',
174
+ title: 'Tus chats',
175
+ lead: 'Cada proyecto guarda sus chats en la columna izquierda. Todos comparten la memoria del proyecto: lo que se decidió en uno, el agente lo sabe en otro.',
176
+ tryIt: 'Abre un chat nuevo y pregunta algo que decidiste en otro chat.',
177
+ steps: [
178
+ '«Nuevo chat» empieza una conversación.',
179
+ 'Tus chats quedan debajo, el más reciente arriba. Haz clic en uno para volver a él.',
180
+ 'Pasa el puntero sobre un chat: el primer botón lo abre al lado, en la otra mitad de la ventana.',
181
+ 'El segundo lo abre en su propia ventana, que puedes mover. La ✕ lo borra.',
182
+ ],
183
+ expert: 'La tecla de arriba a la izquierda oculta la columna para tener más espacio; en una ventana angosta, la columna se abre encima de la conversación. En Proyectos, abajo, saltas a otro proyecto abierto sin pasar por Inicio.',
100
184
  },
101
185
  {
102
186
  id: 'permisos',
@@ -109,10 +193,10 @@ export const MANUAL = {
109
193
  steps: [
110
194
  '#1 Solo conversar: lee tu proyecto y te contesta.',
111
195
  '#2 Crear: agrega archivos nuevos.',
112
- '#3 Editar: cambia tus archivos. Para subir a #3 te pide confirmar, y MADRE guarda un punto para deshacer.',
196
+ '#3 Editar: cambia tus archivos. Te pide confirmar, y MADRE guarda un punto para deshacer.',
113
197
  '#4 Acceso total: corre comandos y puede publicar. Te pide confirmar dos veces.',
114
198
  ],
115
- expert: '#0 Incógnito platica sin guardar nada. El tope de cada agente y cómo confirmas están en Ajustes › Permisos.',
199
+ expert: '#0 Incógnito platica sin guardar nada. Puedes dejar #3 o #4 abiertos más tiempo, para trabajar sin interrupciones. El tope de cada agente y cómo confirmas están en Ajustes › Permisos.',
116
200
  },
117
201
  {
118
202
  id: 'copiloto',
@@ -127,23 +211,36 @@ export const MANUAL = {
127
211
  'Elige por cuánto tiempo: de 30 minutos a 24 horas.',
128
212
  'Enciéndelo y escribe la tarea. Te pide confirmar una sola vez.',
129
213
  ],
130
- expert: 'Con Copiloto el agente edita y corre lo seguro, como tus pruebas. Nunca borra ni publica. Se apaga solo al acabarse el tiempo, o con DETENER TODO.',
214
+ expert: 'Con Copiloto el agente edita y corre lo seguro, como tus pruebas. Nunca borra ni publica. Se apaga solo al acabarse el tiempo, o con «Detener todo».',
215
+ },
216
+ {
217
+ id: 'en-marcha',
218
+ part: 'work',
219
+ icon: 'running',
220
+ title: 'Lo que está pasando',
221
+ lead: 'En marcha te muestra todo lo que MADRE está haciendo en tus proyectos abiertos, sin abrir una terminal, y te deja detenerlo.',
222
+ tryIt: 'Pídele algo largo a un agente y abre En marcha mientras trabaja.',
223
+ steps: [
224
+ 'Busca en la barra de arriba la línea de pulso. Su número dice cuántas cosas corren, y la línea late mientras algo trabaja.',
225
+ 'Púlsala. En «Ahora» ves cada agente respondiendo, sus planes, los servidores y lo que se instala. Abajo están lo que terminó hace poco y los recordatorios que vienen.',
226
+ 'Abre una fila para ver los detalles. «Ir al chat» te lleva a esa conversación; «Detener» frena solo eso.',
227
+ ],
228
+ expert: '«Detener todo» frena todo en todos tus proyectos, y te pide confirmar. La misma tecla está en Inicio. En una pantalla angosta, el panel sube desde abajo.',
131
229
  },
132
230
  {
133
231
  id: 'codigo',
134
232
  part: 'work',
135
233
  icon: 'code',
136
234
  shot: 'code',
137
- title: 'Revisa el código',
138
- lead: 'Código abre tus archivos junto al chat. Lo que cambió cada agente queda marcado con su color.',
235
+ title: 'Tus archivos',
236
+ lead: 'Archivos abre tu proyecto a la derecha del chat. Lo que cambió cada agente queda marcado con su color.',
139
237
  tryIt: 'Abre un archivo, haz clic en el número de una línea y pulsa PREGUNTAR › Explicar.',
140
238
  steps: [
141
- 'Pulsa Código en la barra de arriba.',
239
+ 'Pulsa Archivos (</>) en la barra de arriba y abre un archivo desde la lista.',
142
240
  'Haz clic en el número de una línea. Con ⇧ eliges varias.',
143
- 'Pulsa PREGUNTAR.',
144
- 'Elige al agente y qué quieres: explicar, mejorar, escribir pruebas o arreglar.',
241
+ 'Pulsa PREGUNTAR: elige al agente y lo que quieres, o copia la referencia para citarla en el chat.',
145
242
  ],
146
- expert: '⌘ P busca un archivo por su nombre. EDITAR te deja escribir: ⌘ S guarda, ⌘ F busca y ⌘ / comenta.',
243
+ expert: '⌘ P busca un archivo por su nombre. Editar te deja escribir: ⌘ S guarda, ⌘ F busca y ⌘ / comenta. Si cierras un archivo con cambios sin guardar, se quedan en su pestaña.',
147
244
  },
148
245
  {
149
246
  id: 'memoria',
@@ -152,13 +249,13 @@ export const MANUAL = {
152
249
  shot: 'memory',
153
250
  title: 'La memoria',
154
251
  lead: 'MADRE recuerda lo que se decide en tu proyecto, para que no tengas que explicarlo cada vez. Todos tus agentes leen la misma memoria.',
155
- tryIt: 'Dile a un agente: “recuerda que los precios siempre llevan IVA”. Luego pregúntale a otro agente cómo van los precios.',
252
+ tryIt: 'Dile a un agente: “toma nota: los precios siempre llevan IVA”. Luego pregúntale a otro agente cómo van los precios.',
156
253
  steps: [
157
- 'Pulsa Mapa de memoria en la barra. Se abre a pantalla completa.',
158
- 'Cada estrella es algo que MADRE recuerda. Su color dice si es una decisión, un hecho o una preferencia.',
159
- 'Haz clic en una estrella para leerla. Si ya no es cierta, desde ahí la olvidas.',
254
+ 'Pulsa Mapa de memoria en la barra. Escribe el nombre del proyecto y se abre a pantalla completa.',
255
+ 'Cada punto es algo que MADRE recuerda. Su color dice si es una decisión, un hecho o una preferencia.',
256
+ 'Haz clic en uno para leerlo. Si ya no es cierto, desde ahí lo olvidas.',
160
257
  ],
161
- expert: 'Con #0 Incógnito no se guarda nada. Con IA local, la memoria se busca por lo que quiere decir, no solo por las palabras.',
258
+ expert: 'Neural, arriba a la derecha, dibuja el mismo mapa como neuronas. Con #0 Incógnito no se guarda nada. Con IA local, la memoria se busca por lo que quiere decir, no solo por las palabras.',
162
259
  },
163
260
  {
164
261
  id: 'notas',
@@ -169,26 +266,26 @@ export const MANUAL = {
169
266
  lead: 'Una nota es un papel de color pegado en tu proyecto. Un recordatorio te avisa el día y la hora que le digas.',
170
267
  tryIt: 'Escríbele a un agente: “recuérdame mañana a las 10 revisar el banner”.',
171
268
  steps: [
172
- 'Enciende Notas y Recordatorios en Módulos.',
269
+ 'Enciende Notas y Recordatorios en Módulos, en la barra de arriba.',
173
270
  'Cada nota abre su ventana: escribe, cambia el color o tírala a la basura.',
174
- 'Cuando vence un recordatorio, MADRE te lo muestra en el proyecto y en «Te necesita», en Inicio.',
271
+ 'Cuando llega la hora de un recordatorio, MADRE te lo muestra en el proyecto y en «Te espera», en Inicio: «Listo», «En una hora» o «Mañana».',
175
272
  ],
176
273
  expert: '/notas y /recordatorios le piden la nota o el recordatorio al agente que tengas elegido. Si escribes «tengo que…», MADRE te ofrece guardarlo.',
177
274
  },
178
275
  {
179
276
  id: 'modulos',
180
277
  part: 'more',
181
- icon: 'grid',
182
- shot: 'modules',
183
- title: 'Módulos',
184
- lead: 'Funciones que enciendes cuando las necesitas. Apagado, un módulo no hace nada.',
185
- tryIt: 'Enciende «Ahorro de tokens» y haz la misma pregunta otra vez: la respuesta sale más corta.',
278
+ icon: 'market',
279
+ shot: 'market',
280
+ title: 'El Mercado y tus módulos',
281
+ lead: 'El Mercado suma funciones a MADRE: Notas, Recordatorios, Vista previa, Antes de subir y más. Cada módulo te dice qué hace antes de instalarlo.',
282
+ tryIt: 'Busca «Antes de subir» y obténlo: antes de subir tu código a GitHub, revisa que no se vayan llaves ni archivos privados.',
186
283
  steps: [
187
- 'Abre Módulos en la barra del proyecto.',
188
- 'Toca un mosaico para leer qué hace, qué escribe y qué necesita.',
189
- 'Mueve su interruptor para encenderlo.',
284
+ 'Pulsa Mercado en la columna izquierda.',
285
+ 'Toca un módulo para leer qué hace, qué toca de tu proyecto y quién lo hizo.',
286
+ 'Pulsa Obtener o Instalar. Después lo enciendes o lo apagas en Módulos, en la barra del proyecto.',
190
287
  ],
191
- expert: 'En el Mercado, desde Inicio, hay más. En la página de cada módulo eliges si lo quieres en todos tus proyectos o solo en uno.',
288
+ expert: 'Lo que obtienes en el Mercado de un proyecto es para ese proyecto. Los módulos de la comunidad dicen quién los hizo y su licencia; MADRE revisa su firma antes de instalarlos.',
192
289
  },
193
290
  {
194
291
  id: 'continuidad',
@@ -233,7 +330,7 @@ export const MANUAL = {
233
330
  'Descarga el modelo marcado como «Recomendado para tu equipo»: ya está medido para tu Mac.',
234
331
  'Elige qué proyectos la usan.',
235
332
  ],
236
- expert: 'Funciona con Ollama. MADRE solo te ofrece los modelos que caben en tu equipo.',
333
+ expert: 'Funciona con Ollama. MADRE solo te ofrece los modelos que caben en tu equipo. Si otra computadora de tu red tiene Ollama y tarjeta gráfica (o, desde WSL, la de Windows), escribe su dirección en «Dirección de Ollama».',
237
334
  },
238
335
  {
239
336
  id: 'entrena',
@@ -247,7 +344,7 @@ export const MANUAL = {
247
344
  'Abre Paso a paso: MADRE mide tu equipo, te sugiere el tamaño y te da cada comando con tus carpetas.',
248
345
  'Al terminar, en Ajustes › IA local pulsa Revisar otra vez: @madre ya contesta con tu modelo.',
249
346
  ],
250
- expert: 'Funciona en Mac con chip Apple; en Linux con tarjeta NVIDIA es de prueba. Con unos 200 ejemplos aprende el tono, desde 1000 vale la pena. Antes de confiar en él, pregúntale diez cosas que el proyecto decidió y cinco que nunca se hablaron.',
347
+ expert: 'Funciona en Mac con chip Apple; en Linux con tarjeta NVIDIA, o en Windows dentro de WSL con su tarjeta NVIDIA, es de prueba. Con unos 200 ejemplos aprende el tono, desde 1000 vale la pena. Antes de confiar en él, pregúntale diez cosas que el proyecto decidió y cinco que nunca se hablaron.',
251
348
  },
252
349
  {
253
350
  id: 'coordinador',
@@ -258,25 +355,25 @@ export const MANUAL = {
258
355
  lead: 'El Coordinador ve todos tus proyectos. Con una conexión, un proyecto puede consultar lo que aprendió otro.',
259
356
  tryIt: 'En Inicio, pregúntale al Coordinador: “¿en qué proyecto me quedé ayer?”.',
260
357
  steps: [
261
- 'Háblale al Coordinador desde Inicio.',
262
- 'Crea una conexión entre dos proyectos. Tú decides qué puede consultar y hasta cuándo.',
358
+ 'En Inicio, pulsa «Hablar con el Coordinador».',
359
+ 'Pulsa «Conectar proyectos» y elige dos. Tú decides qué puede consultar y hasta cuándo.',
263
360
  ],
264
- expert: 'Desde cualquier proyecto le preguntas con /bishop. Por una conexión viajan notas de memoria, nunca tus archivos ni tus chats.',
361
+ expert: 'Desde cualquier proyecto le preguntas con /coordinador. Por una conexión viajan notas de memoria, nunca tus archivos ni tus chats.',
265
362
  },
266
363
  {
267
364
  id: 'ventanas',
268
365
  part: 'more',
269
366
  icon: 'windows',
270
367
  shot: 'windows',
271
- title: 'Ventanas',
272
- lead: 'Chats, notas, archivos y ajustes se abren como ventanas que mueves igual que en tu Mac.',
273
- tryIt: 'Abre una nota y haz clic en el fondo del proyecto: la nota se hace a un lado. Otro clic la regresa.',
368
+ title: 'La columna derecha y las ventanas',
369
+ lead: 'Archivos, Tus servidores y las demás herramientas se abren a la derecha del chat, cada una en su pestaña. Cualquiera puede salir a una ventana que mueves como en tu Mac.',
370
+ tryIt: 'Abre Archivos y pulsa el botón de ventana: Archivos flota sobre el chat. Otro clic lo regresa a su lugar.',
274
371
  steps: [
275
- 'Arrastra una ventana por su cabecera.',
276
- 'Deja el puntero sobre su botón de ventana: te ofrece mitad, cuarto o pantalla completa.',
277
- 'Clic en el fondo para apartar todas; clic en el borde de una para traerla.',
372
+ 'Cada herramienta abierta es una pestaña. La ✕ de la pestaña la cierra.',
373
+ 'El botón de ventana la saca de la columna, para ponerla donde quieras.',
374
+ 'El último botón cierra la columna completa.',
278
375
  ],
279
- expert: 'Cuando escribes en la caja o en Código, las ventanas que estorban se apartan solas.',
376
+ expert: 'Deja el puntero sobre el botón de ventana de una ventana: te ofrece mitad, cuarto o pantalla completa. Si la ventana de tu navegador se hace angosta, lo que ya no cabe junto al chat se vuelve ventana solo.',
280
377
  },
281
378
  {
282
379
  id: 'ajustes',
@@ -287,11 +384,11 @@ export const MANUAL = {
287
384
  lead: 'Agentes, permisos, apariencia, memoria y privacidad se cambian aquí.',
288
385
  tryIt: 'Escribe «acento» en el buscador y prueba otro color.',
289
386
  steps: [
290
- 'Ábrelos con el engrane de la barra o con ⌘ ,.',
387
+ 'Ábrelos con el engrane de la columna izquierda o con ⌘ ,.',
291
388
  'Busca cualquier ajuste por su nombre.',
292
389
  'Cada tarjeta dice cómo está antes de abrirla. Lo que cambias se guarda solo.',
293
390
  ],
294
- expert: 'Cada proyecto puede tener su propio color y su propio fondo.',
391
+ expert: 'Cada proyecto puede tener su propio color. En Actualizaciones y errores ves qué enviaría el diagnóstico anónimo, y ahí lo apagas.',
295
392
  },
296
393
  {
297
394
  id: 'ayuda',
@@ -306,7 +403,7 @@ export const MANUAL = {
306
403
  'Escribe lo que ves, con tus palabras.',
307
404
  'Abre el caso que se parece al tuyo y sigue lo que te dice.',
308
405
  ],
309
- expert: 'Ahí mismo ves qué salió de tu Mac y a dónde, y cómo apagar cada cosa. ? abre todos los atajos en cualquier pantalla.',
406
+ expert: 'Arriba eliges tu sistema (macOS, Linux, WSL o Windows) y los comandos cambian con él. ? abre todos los atajos en cualquier pantalla.',
310
407
  },
311
408
  {
312
409
  id: 'errores',
@@ -318,18 +415,48 @@ export const MANUAL = {
318
415
  ['Un agente dice «Sin iniciar sesión».', 'Ajustes › Agentes: ábrelo y pulsa su botón para entrar con tu cuenta.'],
319
416
  ['MADRE no encuentra un agente.', 'Ajustes › Agentes › Instalar. MADRE corre el comando por ti.'],
320
417
  ['Gemini dice que llegó a su límite (429) o que está saturado (503).', 'Espera un minuto y vuelve a preguntar, elige otro modelo en el menú de modelo o pásale la pregunta a otro agente.'],
321
- ['Gemini rechaza tu cuenta personal de Google.', 'Pega una llave de Google AI Studio en Ajustes › Agentes › Gemini.'],
418
+ ['Gemini rechaza tu cuenta personal de Google.', 'Pega una llave de acceso (API key) de Google AI Studio en Ajustes › Agentes › Gemini.'],
322
419
  ['Cursor dice que llegó al límite de su plan.', 'Es el límite de tu plan de Cursor, no de MADRE. Espera a que se renueve o pregúntale a otro agente.'],
323
420
  ['«La cuenta de API se quedó sin saldo».', 'Recarga esa cuenta o, en Ajustes › Agentes, elige un modelo que use tu plan, como ChatGPT o GitHub Copilot.'],
324
421
  ['El agente no contestó a tiempo.', 'Vuelve a preguntar. Si pasa seguido, sube el tiempo límite en Ajustes › Trabajo y límites.'],
325
422
  ['«El puerto ya está en uso».', 'Ya hay otra MADRE abierta: usa esa, o abre esta en otro puerto con `npx @jossuealcala/madre --port 4800`.'],
326
423
  ['La Terminal dice que tu Node es muy viejo.', 'Instala Node 22.5 o más nuevo desde nodejs.org y vuelve a correr el comando.'],
424
+ ['Abriste MADRE en Windows y te dice que se detiene.', 'En Windows, MADRE funciona dentro de WSL2. Sigue los pasos de «Windows, con WSL2» en «Empieza aquí».'],
425
+ ['En WSL, la IA local de Windows no contesta.', 'En la app de Ollama de Windows, activa «Expose Ollama to the network». Luego, en Ajustes › IA local, escribe la dirección que te sugiere MADRE.'],
426
+ ['No se abrió el navegador.', 'Abre la dirección que escribió la terminal (termina en /salas). En WSL, ábrela en tu navegador de Windows con localhost.'],
427
+ ['Entraste por SSH y la página no carga.', 'Abre en tu computadora el túnel que escribió la terminal, con 127.0.0.1 y no localhost, y déjalo abierto.'],
327
428
  ['Una respuesta se cortó porque MADRE se reinició.', 'Vuelve a preguntar. El chat no se perdió.'],
328
429
  ],
329
430
  expert: 'Diagnóstico también funciona desde la Terminal: `npx @jossuealcala/madre doctor`.',
330
431
  },
432
+ {
433
+ id: 'desinstalar',
434
+ part: 'help',
435
+ icon: 'trash',
436
+ title: 'Desinstalar MADRE',
437
+ lead: 'Si ya no la quieres, MADRE se quita sola desde Inicio, y antes te dice qué borra.',
438
+ steps: [
439
+ 'En Inicio, abre Ajustes › Versión y pulsa «Desinstalar…».',
440
+ 'Lee la lista de lo que se borra y lo que se queda. Tus proyectos y tus IAs se quedan siempre.',
441
+ 'Pulsa Desinstalar. MADRE cierra todo y borra sus conversaciones, su memoria, sus ajustes y su carpeta .pulse en cada proyecto.',
442
+ ],
443
+ expert: 'Lo que crearon las IAs en .pulse/out se queda, salvo que marques la casilla. Si instalaste MADRE con npm -g, al final te da el comando para quitar el programa: `npm uninstall -g @jossuealcala/madre`.',
444
+ },
445
+ {
446
+ id: 'licencia',
447
+ part: 'help',
448
+ icon: 'book',
449
+ title: 'La licencia, en corto',
450
+ lead: 'MADRE usa la Business Source License 1.1. Su código es público: puedes leerlo, cambiarlo y compartirlo.',
451
+ steps: [
452
+ 'Es gratis para personas y para organizaciones de hasta 10 personas, también si usas MADRE para dar servicios a otros, por ejemplo como independiente o como agencia.',
453
+ 'Una organización más grande, o quien quiera ofrecer MADRE a otros como servicio, necesita una licencia comercial: escribe a hola@jossuealcala.com.',
454
+ 'Cada versión pasa a la licencia libre GNU AGPL v3 cuatro años después de publicarse.',
455
+ ],
456
+ expert: 'Las versiones 1.0.2 a 1.0.5 siguen con la GNU AGPL v3. El texto completo está en el archivo LICENSE y, dentro de MADRE, en Ajustes › Actualizaciones y errores › La licencia.',
457
+ },
331
458
  ],
332
- closing: 'MADRE es software libre (AGPL v3). Ayuda y novedades en madre.run.',
459
+ closing: 'MADRE es gratis para personas y equipos de hasta 10 (licencia BSL 1.1). Ayuda y novedades en madre.run.',
333
460
  pdf: 'Descargar en PDF',
334
461
  language: 'English',
335
462
  },
@@ -337,8 +464,8 @@ export const MANUAL = {
337
464
  title: 'MADRE manual',
338
465
  subtitle: 'How to work with your AI agents',
339
466
  intro: [
340
- 'In MADRE you work with the AIs you already use: Codex, Claude, Gemini, Cursor or OpenCode. You write to them, they read your project, and you decide what they may change.',
341
- 'If you have never used an AI, start with «Install MADRE» and go in order. If you use them already, go straight to what you need: each section ends with what is worth knowing once you have some practice.',
467
+ 'In MADRE you work with the AIs you already use: Codex, Claude, Gemini, Cursor or OpenCode. You write to them as in a chat, they read your project, and you decide what they may change.',
468
+ 'If you have never used an AI, start with «Start here» and go in order. If you use them already, go straight to what you need: each section ends with what is worth knowing once you have some practice.',
342
469
  ],
343
470
  words: {
344
471
  title: 'Four words before you start',
@@ -362,17 +489,74 @@ export const MANUAL = {
362
489
  id: 'instalar',
363
490
  part: 'start',
364
491
  icon: 'download',
365
- title: 'Install MADRE',
366
- lead: 'MADRE installs with one command and opens in your browser. No account, no card.',
367
- code: ['npx @jossuealcala/madre'],
368
- tryIt: 'To know whether you have Node already, type `node --version` in the Terminal. If it says v22.5 or a higher number, you are set.',
369
- steps: [
370
- 'Install Node.js 22.5 or newer from nodejs.org. If you have it, skip this step.',
371
- 'Open the Terminal, paste the command above and press ↵.',
372
- 'MADRE opens in your browser, in Home. Next time, use the same command.',
492
+ title: 'Start here',
493
+ lead: 'One command installs MADRE and opens it in your browser. There, the welcome gets everything ready step by step. After that you do not need the terminal (the window where you type commands). No account, no card.',
494
+ systems: [
495
+ {
496
+ name: 'Mac',
497
+ steps: [
498
+ 'Install Node 22.5 or newer from nodejs.org, or with `brew install node`. If you have it, skip this step.',
499
+ 'Open the Terminal app (find it with Spotlight) and paste the command.',
500
+ ],
501
+ code: ['npx @jossuealcala/madre'],
502
+ tip: 'For AI on your computer, the welcome gives you the link to the official Ollama app.',
503
+ },
504
+ {
505
+ name: 'Linux',
506
+ steps: [
507
+ 'Install Node 22.5 or newer from nodejs.org or with nvm: the one in your system\'s packages may be older.',
508
+ 'Open your terminal and paste the command.',
509
+ ],
510
+ code: ['npx @jossuealcala/madre'],
511
+ tip: 'To install Ollama, Linux asks for your password. The welcome gives you the line to copy: MADRE never asks for passwords or keeps them.',
512
+ },
513
+ {
514
+ id: 'windows',
515
+ name: 'Windows, with WSL2',
516
+ note: 'On Windows, MADRE runs inside WSL2, the Linux that comes with Windows 10 and 11. Opened on Windows itself, it explains these steps and stops.',
517
+ steps: [
518
+ 'Once, in PowerShell as administrator, type `wsl --install` and restart.',
519
+ 'Open «Ubuntu» from the Start menu and install Node 22: `curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -` and then `sudo apt install -y nodejs`.',
520
+ 'Paste the command in Ubuntu. MADRE opens in your Windows browser.',
521
+ ],
522
+ code: ['npx @jossuealcala/madre'],
523
+ tip: 'Keep your projects inside Linux (in /home), not in /mnt/c: there MADRE is faster and protects your files better.',
524
+ },
525
+ {
526
+ name: 'Another computer (SSH) or a virtual machine',
527
+ note: 'If MADRE runs on a server or in a virtual machine you reach over SSH, your browser is on your own computer and reaches MADRE through a tunnel.',
528
+ steps: [
529
+ 'On the server, paste MADRE\'s command. The terminal writes the tunnel command for you, with your user, your server and the port.',
530
+ 'On your own computer, open another terminal, paste that command and leave it open.',
531
+ 'Open http://127.0.0.1:5317/salas in your browser.',
532
+ ],
533
+ code: ['npx @jossuealcala/madre'],
534
+ tip: 'In a virtual machine, AI on your computer is slow. If your PC runs Windows, MADRE works better with WSL than in a virtual machine.',
535
+ },
536
+ ],
537
+ tryIt: 'To know whether you have Node already, type `node --version` in the terminal. If it says v22.5 or a higher number, you are set.',
538
+ steps: [
539
+ 'MADRE opens in your browser with the welcome. Choose your language and follow the seven steps.',
540
+ 'If something fails, the welcome tells you what happened, and «See how to fix it» gives you the steps for your system.',
541
+ 'To come back another day, use the same command: Home opens, with your projects.',
373
542
  ],
374
543
  expert: 'MADRE does not keep your passwords: it uses the sessions your agents already have on your Mac. With `--port 4800` it opens on another port.',
375
544
  },
545
+ {
546
+ id: 'bienvenida',
547
+ part: 'start',
548
+ icon: 'check',
549
+ shot: 'welcome',
550
+ title: 'The welcome',
551
+ lead: 'The first time, MADRE greets you with seven steps: your computer, your agents, AI on your computer, the memory and your first project. All with buttons, no terminal.',
552
+ tryIt: 'If you closed it, open it again: in Home, Settings › Projects › «See the welcome again».',
553
+ steps: [
554
+ 'The seven steps are on the left. You can go to any of them; the ones you finish get a tick.',
555
+ 'Each step tells you what it is and gives you the button to do it: connect an agent, download the AI or choose your folder.',
556
+ '«Continue» takes you to the next one. Whatever you leave for later can be done in Settings.',
557
+ ],
558
+ expert: 'The welcome remembers the step you were on. If you used MADRE 1.0 before, Home shows you what is new in 1.1 first.',
559
+ },
376
560
  {
377
561
  id: 'agentes',
378
562
  part: 'start',
@@ -380,28 +564,28 @@ export const MANUAL = {
380
564
  shot: 'agents',
381
565
  title: 'Connect your agents',
382
566
  lead: 'An agent is an AI such as Codex, Claude or Gemini. You connect it once and every project uses it. One is enough to start.',
383
- tryIt: 'If you use ChatGPT already, connect Codex with that same account: it is the quickest.',
567
+ tryIt: 'If you already use ChatGPT, connect Codex with that same account: it is the quickest.',
384
568
  steps: [
385
- 'In Home, open Settings › Agents. The first time, MADRE shows it to you on its own.',
386
- 'Open an agent that says «Not signed in» and press its key, such as «Claude account». You sign in with your account on the provider\'s page. If you do not have it, you will see Install.',
569
+ 'In Home, open Settings (the gear, bottom left) › Agents. The first time, the welcome takes you there.',
570
+ 'Open an agent that says «Not signed in» and press its button, such as «Claude account». You sign in with your account on the provider\'s page. If you do not have it, you will see Install.',
387
571
  'Once it says «Connected», you can talk to it.',
388
572
  ],
389
- expert: 'Each agent keeps its own session; MADRE does not read it. API keys (Gemini, OpenCode) are pasted on the same card, and «Prefer your terminal?» gives you the command.',
573
+ expert: 'Each agent keeps its own session; MADRE does not read it. Access keys (API keys) for Codex, Claude, Gemini and OpenCode go in the same card, and «Prefer your terminal?» gives you the command. If MADRE runs on another computer, Codex connects «With a code».',
390
574
  },
391
575
  {
392
576
  id: 'inicio',
393
577
  part: 'start',
394
578
  icon: 'home',
395
579
  shot: 'home',
396
- title: 'Your first project',
397
- lead: 'A project is a folder on your Mac. MADRE opens it, reads it and keeps a memory of it. Adding it changes nothing inside.',
398
- tryIt: 'No folder at hand? Make an empty one called «test» and add it.',
580
+ title: 'Home and your projects',
581
+ lead: 'Home is the first thing you see when you open MADRE: your projects, the Coordinator and what is waiting for you. A project is a folder on your Mac; adding it changes nothing inside it.',
582
+ tryIt: 'If you have no folder at hand, create an empty one called «test» and add it.',
399
583
  steps: [
400
- 'In Home, press «Add project» and choose the folder.',
401
- 'Its card appears. Click it to open the project.',
402
- '«Needs you» gathers what is pending: an agent\'s question, a permission or a reminder.',
584
+ 'In the left column, press «Add a project» and choose the folder.',
585
+ 'It shows up under Projects. Press Open on its card to go in.',
586
+ '«Waiting on you» gathers what was left open: a question from an agent, a permission or a reminder.',
403
587
  ],
404
- expert: 'Right-click a card to pin it to the bar or take it out of MADRE; your folder stays as it is. Right-click the background to add widgets.',
588
+ expert: 'The left column is the same in Home and in every project: Home, the Coordinator, the Market and your open projects. «Attention» puts first the projects with something waiting. The ··· menu of a card takes it out of MADRE; your folder stays as it is.',
405
589
  },
406
590
  {
407
591
  id: 'hablar',
@@ -409,62 +593,91 @@ export const MANUAL = {
409
593
  icon: 'chat',
410
594
  shot: 'composer',
411
595
  title: 'Ask an agent for something',
412
- lead: 'You write at the bottom and the agent answers in the chat. You do not need to know about AI: ask the way you would ask a person.',
413
- tryIt: 'Write: “Explain what this project does in five lines”.',
596
+ lead: 'You type at the bottom and the agent answers in the chat. You do not need to know about AI: ask the way you would ask a person.',
597
+ tryIt: 'Type: “Explain what this project does in five lines”.',
414
598
  steps: [
415
- 'Write in the box and press ↵ to send.',
416
- 'The circle on the left is the agent that will answer. Press it to choose another.',
417
- 'The tag with # is the permission. With #1 the agent reads and answers but changes nothing.',
418
- 'Beside it you choose the model and how hard it thinks. If unsure, leave them be.',
599
+ 'Type in the box and press ↵ to send.',
600
+ 'The circle on the left is the agent that will answer. Tap it to choose another.',
601
+ 'The tag with # is the permission. With #1 the agent reads and answers you, but changes nothing.',
602
+ 'Beside it you choose the model and, for some agents, how much it thinks. If you are not sure, leave it.',
419
603
  ],
420
- expert: '@ calls an agent, # changes the permission, ! quotes a file and / opens the commands. ⌥ ↵ makes a new line and ⌘ V pastes an image.',
604
+ expert: '@ calls an agent; with several at the start («@opencode @madre …?») the question goes to each one and each answers on its own. # changes the permission, ! quotes a file and / opens the commands. ⌥ ↵ adds a line break and ⌘ V pastes an image.',
605
+ },
606
+ {
607
+ id: 'chats',
608
+ part: 'work',
609
+ icon: 'list',
610
+ shot: 'chats',
611
+ title: 'Your chats',
612
+ lead: 'Each project keeps its chats in the left column. They all share the project\'s memory: what was decided in one, the agent knows in another.',
613
+ tryIt: 'Open a new chat and ask about something you decided in another chat.',
614
+ steps: [
615
+ '«New chat» starts a conversation.',
616
+ 'Your chats stay below it, the latest on top. Click one to go back to it.',
617
+ 'Hover over a chat: the first button opens it beside, in the other half of the window.',
618
+ 'The second opens it in its own window, which you can move. The ✕ deletes it.',
619
+ ],
620
+ expert: 'The key at the top left hides the column to give you more room; in a narrow window, the column opens over the conversation. Under Projects, at the bottom, you jump to another open project without going through Home.',
421
621
  },
422
622
  {
423
623
  id: 'permisos',
424
624
  part: 'work',
425
625
  icon: 'shield',
426
626
  shot: 'modes',
427
- title: 'How far it may go',
428
- lead: 'Every message carries a permission. Start at #1, which changes nothing, and raise it when you want the agent to work on your files.',
429
- tryIt: 'At #2 ask: “create a todo.md file with what is left”. The new file appears; the ones you had are not touched.',
627
+ title: 'How far it can go',
628
+ lead: 'Every message carries a permission. Start with #1, which changes nothing, and raise it when you want the agent to work on your files.',
629
+ tryIt: 'With #2 ask: “create a todo.md file with what is left”. The new file appears; the files you had are not touched.',
430
630
  steps: [
431
- '#1 Chat only: reads your project and answers.',
631
+ '#1 Chat only: reads your project and answers you.',
432
632
  '#2 Create: adds new files.',
433
- '#3 Edit: changes your files. Going up to #3 asks you to confirm, and MADRE keeps a point to undo.',
633
+ '#3 Edit: changes your files. It asks you to confirm, and MADRE keeps a point to undo.',
434
634
  '#4 Full access: runs commands and may publish. It asks you to confirm twice.',
435
635
  ],
436
- expert: '#0 Incognito talks without saving anything. Each agent\'s ceiling, and how you confirm, are in Settings › Permissions.',
636
+ expert: '#0 Incognito talks without keeping anything. You can leave #3 or #4 open for longer, to work without interruptions. Each agent\'s ceiling and how you confirm are in Settings › Permissions.',
437
637
  },
438
638
  {
439
639
  id: 'copiloto',
440
640
  part: 'work',
441
641
  icon: 'robot',
442
642
  shot: 'copilot',
443
- title: 'Let it work alone for a while',
444
- lead: 'For a long job, Copilot lets the agent carry on without asking at every step.',
643
+ title: 'Let it work on its own for a while',
644
+ lead: 'For a long job, Copilot lets the agent move on without asking your permission at every step.',
445
645
  tryIt: 'Turn it on for an hour and ask: “go through every test and fix the ones that fail”.',
446
646
  steps: [
447
647
  'Press the robot beside the box.',
448
648
  'Choose for how long: from 30 minutes to 24 hours.',
449
649
  'Turn it on and write the task. It asks you to confirm only once.',
450
650
  ],
451
- expert: 'With Copilot the agent edits and runs what is safe, such as your tests. It never deletes or publishes. It stops on its own when the time is up, or with STOP ALL.',
651
+ expert: 'With Copilot the agent edits and runs what is safe, such as your tests. It never deletes or publishes. It turns itself off when the time is up, or with «Stop all».',
652
+ },
653
+ {
654
+ id: 'en-marcha',
655
+ part: 'work',
656
+ icon: 'running',
657
+ title: 'What is happening',
658
+ lead: 'Running now shows you everything MADRE is doing in your open projects, without opening a terminal, and lets you stop it.',
659
+ tryIt: 'Ask an agent for something long and open Running now while it works.',
660
+ steps: [
661
+ 'Look for the pulse line on the bar at the top. Its number says how many things are running, and the line beats while something works.',
662
+ 'Press it. Under «Now» you see each agent answering, its plans, the servers and what is installing. Below are what ended a moment ago and the reminders coming up.',
663
+ 'Open a row to see the details. «Go to the chat» takes you to that conversation; «Stop» stops only that.',
664
+ ],
665
+ expert: '«Stop everything» stops everything in all your projects, and asks you to confirm. The same key is in Home. On a narrow screen, the panel comes up from the bottom.',
452
666
  },
453
667
  {
454
668
  id: 'codigo',
455
669
  part: 'work',
456
670
  icon: 'code',
457
671
  shot: 'code',
458
- title: 'Look at the code',
459
- lead: 'Code opens your files beside the chat. What each agent changed is marked in its colour.',
460
- tryIt: 'Open a file, click a line number and press ASK › Explain.',
672
+ title: 'Your files',
673
+ lead: 'Files opens your project to the right of the chat. What each agent changed is marked in its color.',
674
+ tryIt: 'Open a file, click the number of a line and press ASK › Explain.',
461
675
  steps: [
462
- 'Press Code on the bar at the top.',
463
- 'Click a line number. With ⇧ you pick several.',
464
- 'Press ASK.',
465
- 'Choose the agent and what you want: explain, improve, write tests or fix.',
676
+ 'Press Files (</>) in the bar at the top and open a file from the list.',
677
+ 'Click the number of a line. With ⇧ you choose several.',
678
+ 'Press ASK: choose the agent and what you want, or copy the reference to quote it in the chat.',
466
679
  ],
467
- expert: '⌘ P finds a file by name. EDIT lets you write: ⌘ S saves, ⌘ F finds and ⌘ / comments.',
680
+ expert: '⌘ P finds a file by its name. Edit lets you type: ⌘ S saves, ⌘ F searches and ⌘ / comments. If you close a file with unsaved changes, they stay in its tab.',
468
681
  },
469
682
  {
470
683
  id: 'memoria',
@@ -472,14 +685,14 @@ export const MANUAL = {
472
685
  icon: 'stars',
473
686
  shot: 'memory',
474
687
  title: 'The memory',
475
- lead: 'MADRE remembers what gets decided in your project, so you do not have to explain it every time. All your agents read the same memory.',
476
- tryIt: 'Tell an agent: “remember that prices always include tax”. Then ask another agent how the prices work.',
688
+ lead: 'MADRE remembers what is decided in your project, so you do not have to explain it every time. All your agents read the same memory.',
689
+ tryIt: 'Tell one agent: “note this: prices always include tax”. Then ask another agent about prices.',
477
690
  steps: [
478
- 'Press Memory map on the bar. It opens full screen.',
479
- 'Each star is something MADRE remembers. Its colour says whether it is a decision, a fact or a preference.',
480
- 'Click a star to read it. If it is no longer true, you forget it from there.',
691
+ 'Press Memory map in the bar. Type the project\'s name and it opens full screen.',
692
+ 'Each dot is something MADRE remembers. Its color says whether it is a decision, a fact or a preference.',
693
+ 'Click one to read it. If it is no longer true, you forget it from there.',
481
694
  ],
482
- expert: 'With #0 Incognito nothing is kept. With the local AI, the memory is searched by what things mean, not only by their words.',
695
+ expert: 'Neural, at the top right, draws the same map as neurons. With #0 Incognito nothing is kept. With local AI, the memory is searched by what it means, not only by its words.',
483
696
  },
484
697
  {
485
698
  id: 'notas',
@@ -487,29 +700,29 @@ export const MANUAL = {
487
700
  icon: 'note',
488
701
  shot: 'notes',
489
702
  title: 'Notes and reminders',
490
- lead: 'A note is a coloured slip stuck to your project. A reminder tells you on the day and at the hour you say.',
703
+ lead: 'A note is a colored sticky note on your project. A reminder tells you on the day and at the time you say.',
491
704
  tryIt: 'Write to an agent: “remind me tomorrow at 10 to check the banner”.',
492
705
  steps: [
493
- 'Turn on Notes and Reminders in Modules.',
494
- 'Each note opens its own window: write, change the colour or throw it away.',
495
- 'When a reminder is due, MADRE shows it in the project and in «Needs you», in Home.',
706
+ 'Turn on Notes and Reminders in Modules, in the bar at the top.',
707
+ 'Each note opens its window: write, change its color or throw it away.',
708
+ 'When a reminder\'s time comes, MADRE shows it in the project and in «Waiting on you», in Home: «Done», «In an hour» or «Tomorrow».',
496
709
  ],
497
710
  expert: '/notes and /reminders ask the agent you have chosen for the note or the reminder. If you write «I have to…», MADRE offers to keep it.',
498
711
  },
499
712
  {
500
713
  id: 'modulos',
501
714
  part: 'more',
502
- icon: 'grid',
503
- shot: 'modules',
504
- title: 'Modules',
505
- lead: 'Features you turn on when you need them. While it is off, a module does nothing.',
506
- tryIt: 'Turn on «Token saver» and ask the same question again: the answer comes out shorter.',
715
+ icon: 'market',
716
+ shot: 'market',
717
+ title: 'The Market and your modules',
718
+ lead: 'The Market adds features to MADRE: Notes, Reminders, Preview, Before you push and more. Every module tells you what it does before you install it.',
719
+ tryIt: 'Find «Before you push» and get it: before your code goes to GitHub, it checks that no keys or private files go with it.',
507
720
  steps: [
508
- 'Open Modules on the project\'s bar.',
509
- 'Press a tile to read what it does, what it writes and what it needs.',
510
- 'Move its switch to turn it on.',
721
+ 'Press Market in the left column.',
722
+ 'Tap a module to read what it does, what it touches in your project and who made it.',
723
+ 'Press Get or Install. Afterwards you turn it on or off in Modules, in the project\'s bar.',
511
724
  ],
512
- expert: 'The Market, from Home, has more. On each module\'s page you choose all your projects or just one.',
725
+ expert: 'What you get in a project\'s Market is for that project. Community modules say who made them and their license; MADRE checks their signature before installing them.',
513
726
  },
514
727
  {
515
728
  id: 'continuidad',
@@ -517,11 +730,11 @@ export const MANUAL = {
517
730
  icon: 'loop',
518
731
  shot: 'continuity',
519
732
  title: 'Continuity',
520
- lead: 'Continuity keeps, inside your project, where the work stands: decisions, what is left and points to undo. If you change agent, editor or computer, the next one carries on from there.',
521
- tryIt: 'Install it, work a while with Codex and open the project in Claude Code, outside MADRE: it knows where you were.',
733
+ lead: 'Continuity keeps, inside your project, where the work stands: decisions, what is pending and points to undo. If you switch agent, editor or computer, the next one picks up from there.',
734
+ tryIt: 'Install it, work for a while with Codex, then open the project in Claude Code, outside MADRE: it already knows where you were.',
522
735
  steps: [
523
- 'In Modules, press Continuity.',
524
- 'Under «What it touches» you see what it writes: a .ahp/ folder inside your project, in plain text.',
736
+ 'In Modules, tap Continuity.',
737
+ '«What it touches» shows what it writes: a .ahp/ folder inside your project, in plain text.',
525
738
  'Press Install. Your project needs to use git, with at least one commit.',
526
739
  ],
527
740
  expert: 'Outside MADRE it is called AHP+. Claude Code, Codex and OpenCode read it with their own files, and it travels with your repository.',
@@ -536,10 +749,10 @@ export const MANUAL = {
536
749
  tryIt: 'Connect GitHub and ask: “which issues do I have open?”.',
537
750
  steps: [
538
751
  'Open Settings › Connectors (MCP).',
539
- 'Choose one from the catalogue and press Connect. Some open their page so you can sign in.',
540
- 'Press «Check the connection» to make sure it answers.',
752
+ 'Choose one from the catalog and press Connect. Some open their page so you can sign in.',
753
+ 'Press «Check the connection» to confirm it answers.',
541
754
  ],
542
- expert: 'If you set them up in Claude Code, Codex, Gemini or Cursor already, «Import from your apps» brings them over.',
755
+ expert: 'If you already set them up in Claude Code, Codex, Gemini or Cursor, «Import from your apps» brings them in.',
543
756
  },
544
757
  {
545
758
  id: 'ia-local',
@@ -554,7 +767,7 @@ export const MANUAL = {
554
767
  'Download the model marked «Recommended for your computer»: it is already sized for your Mac.',
555
768
  'Choose which projects use it.',
556
769
  ],
557
- expert: 'It runs on Ollama. MADRE only offers the models that fit your computer.',
770
+ expert: 'It runs on Ollama. MADRE only offers the models that fit your machine. If another computer on your network has Ollama and a graphics card (or, from WSL, Windows\' own), type its address in «Ollama address».',
558
771
  },
559
772
  {
560
773
  id: 'entrena',
@@ -564,11 +777,11 @@ export const MANUAL = {
564
777
  lead: 'You teach @madre with what your project knows. It all happens on your computer: you export, train a small model and Ollama runs it.',
565
778
  tryIt: 'Export and see how many examples your project already has.',
566
779
  steps: [
567
- 'Open Settings › What it remembers › Train your own AI and press Export. Paths, names, emails and keys are hidden, and nothing from #0 Incognito goes in.',
568
- 'Open Step by step: MADRE measures your computer, suggests the size and gives you each command with your folders.',
569
- 'When it’s done, press Check again in Settings › Local AI: @madre now answers with your model.',
780
+ 'Open Settings › Memory › Train your own AI and press Export. Paths, names, emails and keys are covered, and nothing from #0 Incognito goes in.',
781
+ 'Open Step by step: MADRE measures your machine, suggests the size and gives you each command with your folders.',
782
+ 'When it is done, in Settings › Local AI press Check again: @madre now answers with your model.',
570
783
  ],
571
- expert: 'It works on Macs with an Apple chip; on Linux with an NVIDIA card it’s experimental. With about 200 examples it learns the tone, from 1000 it’s worth it. Before you trust it, ask it ten things the project decided and five that never came up.',
784
+ expert: 'It works on a Mac with an Apple chip; on Linux with an NVIDIA card, or on Windows inside WSL with its NVIDIA card, it is a trial. With about 200 examples it learns the tone; from 1000 it is worth it. Before you trust it, ask it ten things the project decided and five that were never discussed.',
572
785
  },
573
786
  {
574
787
  id: 'coordinador',
@@ -576,28 +789,28 @@ export const MANUAL = {
576
789
  icon: 'orbit',
577
790
  shot: 'coordinator',
578
791
  title: 'Several projects at once',
579
- lead: 'The Coordinator sees all your projects. With a connection, one project can look up what another learned.',
792
+ lead: 'The Coordinator sees all your projects. With a connection, one project can look up what another one learned.',
580
793
  tryIt: 'In Home, ask the Coordinator: “which project was I on yesterday?”.',
581
794
  steps: [
582
- 'Talk to the Coordinator from Home.',
583
- 'Make a connection between two projects. You decide what it may look up and until when.',
795
+ 'In Home, press «Talk to the Coordinator».',
796
+ 'Press «Connect projects» and choose two. You decide what it may look up and until when.',
584
797
  ],
585
- expert: 'From any project you ask it with /bishop. Memory notes travel through a connection, never your files or your chats.',
798
+ expert: 'From any project you ask it with /coordinator. Memory notes travel through a connection, never your files or your chats.',
586
799
  },
587
800
  {
588
801
  id: 'ventanas',
589
802
  part: 'more',
590
803
  icon: 'windows',
591
804
  shot: 'windows',
592
- title: 'Windows',
593
- lead: 'Chats, notes, files and settings open as windows you move just as on your Mac.',
594
- tryIt: 'Open a note and click the project\'s background: the note steps aside. Another click brings it back.',
805
+ title: 'The right column and windows',
806
+ lead: 'Files, Your servers and the other tools open to the right of the chat, each in its tab. Any of them can come out as a window you move around, as on your Mac.',
807
+ tryIt: 'Open Files and press the window button: Files floats over the chat. Another click puts it back.',
595
808
  steps: [
596
- 'Drag a window by its header.',
597
- 'Rest the pointer on its window key: it offers half, quarter or full screen.',
598
- 'Click the background to set them all aside; click one\'s edge to bring it back.',
809
+ 'Each open tool is a tab. The tab\'s ✕ closes it.',
810
+ 'The window button takes it out of the column, to put it wherever you like.',
811
+ 'The last button closes the whole column.',
599
812
  ],
600
- expert: 'When you type in the box or in Code, the windows in the way step aside on their own.',
813
+ expert: 'Rest the pointer on a window\'s window button: it offers half, quarter or full screen. If your browser window gets narrow, whatever no longer fits beside the chat becomes a window on its own.',
601
814
  },
602
815
  {
603
816
  id: 'ajustes',
@@ -606,13 +819,13 @@ export const MANUAL = {
606
819
  shot: 'settings',
607
820
  title: 'Settings',
608
821
  lead: 'Agents, permissions, appearance, memory and privacy are changed here.',
609
- tryIt: 'Type «accent» in the search and try another colour.',
822
+ tryIt: 'Type «accent» in the search box and try another color.',
610
823
  steps: [
611
- 'Open them with the gear on the bar or with ⌘ ,.',
824
+ 'Open them with the gear in the left column or with ⌘ ,.',
612
825
  'Find any setting by its name.',
613
- 'Each card says how things stand before you open it. What you change saves on its own.',
826
+ 'Each card says how it is set before you open it. What you change saves itself.',
614
827
  ],
615
- expert: 'Each project can have its own colour and its own background.',
828
+ expert: 'Each project can have its own color. In Updates and errors you see what the anonymous diagnostics would send, and turn them off there.',
616
829
  },
617
830
  {
618
831
  id: 'ayuda',
@@ -620,37 +833,67 @@ export const MANUAL = {
620
833
  icon: 'help',
621
834
  shot: 'diagnostics',
622
835
  title: 'When something does not work',
623
- lead: 'Diagnostics checks what is going on and gives you the key that fixes it, without leaving the project.',
624
- tryIt: 'If an agent asks you to sign in, open Diagnostics and write “Claude is not signed in”.',
836
+ lead: 'Diagnostics checks what is going on and gives you the button to fix it, without leaving the project.',
837
+ tryIt: 'If an agent asks you to sign in, open Diagnostics and type “Claude is not signed in”.',
625
838
  steps: [
626
- 'Press Diagnostics on the bar.',
627
- 'Write what you see, in your own words.',
628
- 'Open the case that looks like yours and do what it says.',
839
+ 'Press Diagnostics in the bar.',
840
+ 'Type what you see, in your own words.',
841
+ 'Open the case that looks like yours and follow what it says.',
629
842
  ],
630
- expert: 'There you also see what left your Mac and where to, and how to turn each thing off. ? opens every shortcut on any screen.',
843
+ expert: 'At the top you choose your system (macOS, Linux, WSL or Windows) and the commands change with it. ? opens every shortcut on any screen.',
631
844
  },
632
845
  {
633
846
  id: 'errores',
634
847
  part: 'help',
635
848
  icon: 'warning',
636
849
  title: 'Common problems',
637
- lead: 'What happens most often and how to fix it. If yours is not here, open Diagnostics and write what you see.',
850
+ lead: 'What happens most often and how to fix it. If yours is not here, open Diagnostics and type what you see.',
638
851
  problems: [
639
- ['An agent says «Not signed in».', 'Settings › Agents: open it and press its key to sign in with your account.'],
852
+ ['An agent says «Not signed in».', 'Settings › Agents: open it and press its button to sign in with your account.'],
640
853
  ['MADRE does not find an agent.', 'Settings › Agents › Install. MADRE runs the command for you.'],
641
- ['Gemini says it hit its limit (429) or is overloaded (503).', 'Wait a minute and ask again, pick another model in the model menu, or hand the question to another agent.'],
642
- ['Gemini refuses your personal Google account.', 'Paste a Google AI Studio key in Settings › Agents › Gemini.'],
643
- ['Cursor says its plan hit its limit.', 'It is your Cursor plan\'s limit, not MADRE\'s. Wait for it to renew or ask another agent.'],
644
- ['«The API account has no credit left».', 'Top up that account or, in Settings › Agents, pick a model that uses your plan, such as ChatGPT or GitHub Copilot.'],
645
- ['The agent did not answer in time.', 'Ask again. If it keeps happening, raise the time limit in Settings › Work and limits.'],
854
+ ['Gemini says it hit its limit (429) or is overloaded (503).', 'Wait a minute and ask again, choose another model in the model menu, or pass the question to another agent.'],
855
+ ['Gemini turns down your personal Google account.', 'Paste an access key (API key) from Google AI Studio in Settings › Agents › Gemini.'],
856
+ ['Cursor says it reached its plan\'s limit.', 'It is your Cursor plan\'s limit, not MADRE\'s. Wait for it to renew or ask another agent.'],
857
+ ['«The API account ran out of credit».', 'Top up that account or, in Settings › Agents, choose a model that uses your plan, such as ChatGPT or GitHub Copilot.'],
858
+ ['The agent did not answer in time.', 'Ask again. If it happens often, raise the time limit in Settings › Work and limits.'],
646
859
  ['«The port is already in use».', 'Another MADRE is open: use that one, or open this one on another port with `npx @jossuealcala/madre --port 4800`.'],
647
860
  ['The Terminal says your Node is too old.', 'Install Node 22.5 or newer from nodejs.org and run the command again.'],
861
+ ['You opened MADRE on Windows and it says it stops.', 'On Windows, MADRE runs inside WSL2. Follow «Windows, with WSL2» in «Start here».'],
862
+ ['In WSL, Windows\' local AI does not answer.', 'In the Ollama app on Windows, turn on «Expose Ollama to the network». Then, in Settings › Local AI, type the address MADRE suggests.'],
863
+ ['The browser did not open.', 'Open the address the terminal printed (it ends in /salas). In WSL, open it in your Windows browser with localhost.'],
864
+ ['You came in over SSH and the page does not load.', 'On your own computer, open the tunnel the terminal printed, with 127.0.0.1 and not localhost, and leave it open.'],
648
865
  ['An answer stopped because MADRE restarted.', 'Ask again. The chat was not lost.'],
649
866
  ],
650
867
  expert: 'Diagnostics works from the Terminal too: `npx @jossuealcala/madre doctor`.',
651
868
  },
869
+ {
870
+ id: 'desinstalar',
871
+ part: 'help',
872
+ icon: 'trash',
873
+ title: 'Uninstall MADRE',
874
+ lead: 'If you no longer want it, MADRE removes itself from Home, and tells you first what it takes away.',
875
+ steps: [
876
+ 'In Home, open Settings › Version and press «Uninstall…».',
877
+ 'Read the list of what goes and what stays. Your projects and your AIs always stay.',
878
+ 'Press Uninstall. MADRE closes everything and takes away its conversations, its memory, its settings and its .pulse folder in each project.',
879
+ ],
880
+ expert: 'What the AIs created in .pulse/out stays, unless you tick the box. If you installed MADRE with npm -g, at the end it gives you the command to remove the program: `npm uninstall -g @jossuealcala/madre`.',
881
+ },
882
+ {
883
+ id: 'licencia',
884
+ part: 'help',
885
+ icon: 'book',
886
+ title: 'The license, in short',
887
+ lead: 'MADRE uses the Business Source License 1.1. Its code is public: you may read it, change it and share it.',
888
+ steps: [
889
+ 'It is free for individuals and for organizations of up to 10 people, also when you use MADRE to provide services to others, for example as a freelancer or an agency.',
890
+ 'A larger organization, or anyone who wants to offer MADRE to others as a service, needs a commercial license: write to hola@jossuealcala.com.',
891
+ 'Each version moves to the free GNU AGPL v3 license four years after it is published.',
892
+ ],
893
+ expert: 'Versions 1.0.2 to 1.0.5 stay under the GNU AGPL v3. The full text is in the LICENSE file and, inside MADRE, in Settings › Updates and errors › The license.',
894
+ },
652
895
  ],
653
- closing: 'MADRE is free software (AGPL v3). Help and news at madre.run.',
896
+ closing: 'MADRE is free for individuals and teams of up to 10 (BSL 1.1 license). Help and news at madre.run.',
654
897
  pdf: 'Download as PDF',
655
898
  language: 'Español',
656
899
  },