@jossuealcala/madre 1.0.4 → 1.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (104) hide show
  1. package/CHANGELOG.en.md +106 -1
  2. package/CHANGELOG.md +106 -1
  3. package/NOTICE +30 -0
  4. package/README.en.md +59 -156
  5. package/README.md +60 -161
  6. package/TRADEMARKS.md +18 -0
  7. package/bin/madre.mjs +2 -2
  8. package/docs/REFERENCE.md +1 -1
  9. package/docs/SDK.md +25 -4
  10. package/docs/en/REFERENCE.md +1 -1
  11. package/docs/en/SDK.md +22 -2
  12. package/docs/madre-banner.png +0 -0
  13. package/package.json +1 -1
  14. package/public/app.js +1078 -239
  15. package/public/assets/manual/madre-manual-en.pdf +0 -0
  16. package/public/assets/manual/madre-manual-es.pdf +0 -0
  17. package/public/assets/manual/shots/en-agents.webp +0 -0
  18. package/public/assets/manual/shots/en-code.webp +0 -0
  19. package/public/assets/manual/shots/en-composer.webp +0 -0
  20. package/public/assets/manual/shots/en-connectors.webp +0 -0
  21. package/public/assets/manual/shots/en-continuity.webp +0 -0
  22. package/public/assets/manual/shots/en-coordinator.webp +0 -0
  23. package/public/assets/manual/shots/en-copilot.webp +0 -0
  24. package/public/assets/manual/shots/en-diagnostics.webp +0 -0
  25. package/public/assets/manual/shots/en-home.webp +0 -0
  26. package/public/assets/manual/shots/en-local.webp +0 -0
  27. package/public/assets/manual/shots/en-memory.webp +0 -0
  28. package/public/assets/manual/shots/en-modes.webp +0 -0
  29. package/public/assets/manual/shots/en-modules.webp +0 -0
  30. package/public/assets/manual/shots/en-notes.webp +0 -0
  31. package/public/assets/manual/shots/en-settings.webp +0 -0
  32. package/public/assets/manual/shots/en-windows.webp +0 -0
  33. package/public/assets/manual/shots/es-agents.webp +0 -0
  34. package/public/assets/manual/shots/es-code.webp +0 -0
  35. package/public/assets/manual/shots/es-composer.webp +0 -0
  36. package/public/assets/manual/shots/es-connectors.webp +0 -0
  37. package/public/assets/manual/shots/es-continuity.webp +0 -0
  38. package/public/assets/manual/shots/es-coordinator.webp +0 -0
  39. package/public/assets/manual/shots/es-copilot.webp +0 -0
  40. package/public/assets/manual/shots/es-diagnostics.webp +0 -0
  41. package/public/assets/manual/shots/es-home.webp +0 -0
  42. package/public/assets/manual/shots/es-local.webp +0 -0
  43. package/public/assets/manual/shots/es-memory.webp +0 -0
  44. package/public/assets/manual/shots/es-modes.webp +0 -0
  45. package/public/assets/manual/shots/es-modules.webp +0 -0
  46. package/public/assets/manual/shots/es-notes.webp +0 -0
  47. package/public/assets/manual/shots/es-settings.webp +0 -0
  48. package/public/assets/manual/shots/es-windows.webp +0 -0
  49. package/public/en.js +74 -0
  50. package/public/es.js +493 -136
  51. package/public/i18n.js +45 -7
  52. package/public/index.html +2 -3
  53. package/public/manual-content.js +657 -0
  54. package/public/manual-shots.js +43 -0
  55. package/public/manual.css +228 -0
  56. package/public/manual.html +15 -0
  57. package/public/manual.js +398 -0
  58. package/public/market-art.js +56 -0
  59. package/public/market-view.js +140 -22
  60. package/public/market.js +25 -14
  61. package/public/mcp-catalog.js +62 -0
  62. package/public/resay.js +1 -0
  63. package/public/salas-mac.css +178 -30
  64. package/public/salas-mac.html +5 -5
  65. package/public/salas-mac.js +432 -67
  66. package/public/styles.css +300 -42
  67. package/public/tour-chapters.js +98 -90
  68. package/public/tour.js +63 -21
  69. package/public/troubleshooting.js +145 -10
  70. package/src/adapters/cursor.mjs +56 -7
  71. package/src/adapters/gemini.mjs +12 -1
  72. package/src/adapters/madre.mjs +27 -6
  73. package/src/adapters/process.mjs +5 -2
  74. package/src/auth-probe.mjs +22 -3
  75. package/src/bridge/policy.mjs +1 -1
  76. package/src/bridge/server.mjs +1 -1
  77. package/src/capabilities.mjs +3 -3
  78. package/src/credentials.mjs +24 -2
  79. package/src/history.mjs +76 -0
  80. package/src/i18n.mjs +23 -1
  81. package/src/local-ai.mjs +10 -2
  82. package/src/looks.mjs +17 -5
  83. package/src/market-license.mjs +104 -0
  84. package/src/market-remote.mjs +17 -1
  85. package/src/mcp/notes-server.mjs +120 -0
  86. package/src/mcp/proxy.mjs +14 -3
  87. package/src/models.mjs +82 -9
  88. package/src/modules/index.mjs +3 -1
  89. package/src/modules/local-models.mjs +28 -0
  90. package/src/modules/notes.mjs +142 -0
  91. package/src/modules/ollama.mjs +39 -10
  92. package/src/modules/playwright.mjs +14 -3
  93. package/src/modules/reminders.mjs +345 -0
  94. package/src/modules/sdk.mjs +21 -5
  95. package/src/mother.mjs +11 -1
  96. package/src/ollama.mjs +2 -2
  97. package/src/opencode-health.mjs +63 -0
  98. package/src/outbound.mjs +25 -1
  99. package/src/reminder-time.mjs +127 -0
  100. package/src/room.mjs +19 -7
  101. package/src/runtime-detection.mjs +6 -2
  102. package/src/sentinel-errors.mjs +4 -3
  103. package/src/server.mjs +302 -70
  104. package/src/tour.mjs +24 -5
@@ -0,0 +1,657 @@
1
+ // SPDX-License-Identifier: AGPL-3.0-only
2
+ // MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
3
+ // The user manual (1.0.5): how to use MADRE, for someone who has never used an AI and for someone
4
+ // who uses one every day. Read in MADRE (public/manual.js, /manual) and printed to the PDF
5
+ // (scripts/manual-pdf.mjs). Every sentence is something the product does today; the phone, hidden
6
+ // in the public version, is not told.
7
+ //
8
+ // Rewritten on 2026-10-21, when the first version read like a brochure. Each section says what the
9
+ // thing is for in one plain sentence, gives one exact thing to try, the steps, and a line for
10
+ // whoever already knows the basics. Its `shot` is a picture of MADRE itself (scripts/manual-shots.mjs)
11
+ // whose numbered marks are the steps, in order. No «in one place», no «at your own pace»: what to
12
+ // press and what to type. `«Mac»` is said of the computer (i18n.js, hostWords).
13
+
14
+ export const MANUAL = {
15
+ es: {
16
+ title: 'Manual de MADRE',
17
+ subtitle: 'Cómo trabajar con tus agentes de IA',
18
+ 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.',
21
+ ],
22
+ words: {
23
+ title: 'Cuatro palabras antes de empezar',
24
+ list: [
25
+ ['Agente', 'Una IA que trabaja en tu proyecto. Codex, Claude y Gemini son agentes.'],
26
+ ['Proyecto', 'Una carpeta de tu Mac. Cada una tiene sus chats y su memoria.'],
27
+ ['Permiso', 'Lo que el agente puede hacer con ese mensaje: solo platicar, crear archivos o cambiarlos.'],
28
+ ['Memoria', 'Lo que MADRE recuerda de tu proyecto, para que no tengas que explicarlo cada vez.'],
29
+ ],
30
+ },
31
+ contents: 'Contenido',
32
+ parts: { start: 'Empezar', work: 'Trabajar', more: 'Más funciones', help: 'Ayuda' },
33
+ problem: ['Lo que ves', 'Qué hacer'],
34
+ copy: 'Copiar',
35
+ copied: 'Copiado',
36
+ tryIt: 'Pruébalo',
37
+ expert: 'Si ya sabes',
38
+ shortcuts: 'Todos los atajos',
39
+ sections: [
40
+ {
41
+ id: 'instalar',
42
+ part: 'start',
43
+ 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.',
52
+ ],
53
+ 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
+ },
55
+ {
56
+ id: 'agentes',
57
+ part: 'start',
58
+ icon: 'agents',
59
+ shot: 'agents',
60
+ title: 'Conecta tus agentes',
61
+ 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
+ tryIt: 'Si ya usas ChatGPT, conecta Codex con esa misma cuenta: es lo más rápido.',
63
+ steps: [
64
+ 'En Inicio, abre Ajustes › Agentes. La primera vez MADRE te lo muestra solo.',
65
+ '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
+ 'Cuando dice «Conectado», ya puedes hablarle.',
67
+ ],
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.',
69
+ },
70
+ {
71
+ id: 'inicio',
72
+ part: 'start',
73
+ icon: 'home',
74
+ 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.',
77
+ tryIt: 'Si no tienes una carpeta a la mano, crea una vacía que se llame «prueba» y agrégala.',
78
+ 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.',
82
+ ],
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.',
84
+ },
85
+ {
86
+ id: 'hablar',
87
+ part: 'start',
88
+ icon: 'chat',
89
+ shot: 'composer',
90
+ title: 'Pídele algo a un agente',
91
+ lead: 'Escribes abajo y el agente contesta en el chat. No hace falta saber de IA: pídelo como se lo pedirías a una persona.',
92
+ tryIt: 'Escribe: “Explícame qué hace este proyecto en cinco líneas”.',
93
+ steps: [
94
+ 'Escribe en la caja y pulsa ↵ para enviar.',
95
+ 'El círculo de la izquierda es el agente que te va a contestar. Tócalo para elegir otro.',
96
+ '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í.',
98
+ ],
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.',
100
+ },
101
+ {
102
+ id: 'permisos',
103
+ part: 'work',
104
+ icon: 'shield',
105
+ shot: 'modes',
106
+ title: 'Hasta dónde puede llegar',
107
+ lead: 'Cada mensaje lleva un permiso. Empieza en #1, que no cambia nada, y súbelo cuando quieras que el agente trabaje en tus archivos.',
108
+ tryIt: 'Con #2 pide: “crea un archivo pendientes.md con lo que falta”. El archivo nuevo aparece; los que ya tenías no se tocan.',
109
+ steps: [
110
+ '#1 Solo conversar: lee tu proyecto y te contesta.',
111
+ '#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.',
113
+ '#4 Acceso total: corre comandos y puede publicar. Te pide confirmar dos veces.',
114
+ ],
115
+ expert: '#0 Incógnito platica sin guardar nada. El tope de cada agente y cómo confirmas están en Ajustes › Permisos.',
116
+ },
117
+ {
118
+ id: 'copiloto',
119
+ part: 'work',
120
+ icon: 'robot',
121
+ shot: 'copilot',
122
+ title: 'Déjalo trabajar solo un rato',
123
+ lead: 'Para un trabajo largo, el Copiloto deja que el agente avance sin pedirte permiso en cada paso.',
124
+ tryIt: 'Enciéndelo una hora y pide: “revisa todas las pruebas y arregla las que fallen”.',
125
+ steps: [
126
+ 'Pulsa el robot junto a la caja.',
127
+ 'Elige por cuánto tiempo: de 30 minutos a 24 horas.',
128
+ 'Enciéndelo y escribe la tarea. Te pide confirmar una sola vez.',
129
+ ],
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.',
131
+ },
132
+ {
133
+ id: 'codigo',
134
+ part: 'work',
135
+ icon: 'code',
136
+ 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.',
139
+ tryIt: 'Abre un archivo, haz clic en el número de una línea y pulsa PREGUNTAR › Explicar.',
140
+ steps: [
141
+ 'Pulsa Código en la barra de arriba.',
142
+ '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.',
145
+ ],
146
+ expert: '⌘ P busca un archivo por su nombre. EDITAR te deja escribir: ⌘ S guarda, ⌘ F busca y ⌘ / comenta.',
147
+ },
148
+ {
149
+ id: 'memoria',
150
+ part: 'work',
151
+ icon: 'stars',
152
+ shot: 'memory',
153
+ title: 'La memoria',
154
+ 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.',
156
+ 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.',
160
+ ],
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.',
162
+ },
163
+ {
164
+ id: 'notas',
165
+ part: 'work',
166
+ icon: 'note',
167
+ shot: 'notes',
168
+ title: 'Notas y recordatorios',
169
+ 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
+ tryIt: 'Escríbele a un agente: “recuérdame mañana a las 10 revisar el banner”.',
171
+ steps: [
172
+ 'Enciende Notas y Recordatorios en Módulos.',
173
+ '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.',
175
+ ],
176
+ 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
+ },
178
+ {
179
+ id: 'modulos',
180
+ 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.',
186
+ 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.',
190
+ ],
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.',
192
+ },
193
+ {
194
+ id: 'continuidad',
195
+ part: 'more',
196
+ icon: 'loop',
197
+ shot: 'continuity',
198
+ title: 'Continuidad',
199
+ lead: 'Continuidad guarda dentro de tu proyecto en qué va el trabajo: decisiones, pendientes y puntos para deshacer. Si cambias de agente, de editor o de computadora, el siguiente sigue desde ahí.',
200
+ tryIt: 'Instálalo, trabaja un rato con Codex y abre el proyecto en Claude Code, fuera de MADRE: ya sabe en qué ibas.',
201
+ steps: [
202
+ 'En Módulos, toca Continuidad.',
203
+ 'En «Lo que modifica» ves qué escribe: una carpeta .ahp/ dentro de tu proyecto, en texto.',
204
+ 'Pulsa Instalar. Tu proyecto necesita usar git, con al menos un commit.',
205
+ ],
206
+ expert: 'Fuera de MADRE se llama AHP+. Claude Code, Codex y OpenCode lo leen con sus propios archivos, y viaja con tu repositorio.',
207
+ },
208
+ {
209
+ id: 'herramientas',
210
+ part: 'more',
211
+ icon: 'plug',
212
+ shot: 'connectors',
213
+ title: 'Conectores (MCP)',
214
+ lead: 'Un conector deja que tus agentes usen otra app, como GitHub, Notion o tu calendario.',
215
+ tryIt: 'Conecta GitHub y pregunta: “¿qué issues tengo abiertos?”.',
216
+ steps: [
217
+ 'Abre Ajustes › Conectores (MCP).',
218
+ 'Elige uno del catálogo y pulsa Conectar. Algunos abren su página para que inicies sesión.',
219
+ 'Pulsa «Revisar conexión» para confirmar que responde.',
220
+ ],
221
+ expert: 'Si ya los configuraste en Claude Code, Codex, Gemini o Cursor, «Importar desde tus apps» los trae.',
222
+ },
223
+ {
224
+ id: 'ia-local',
225
+ part: 'more',
226
+ icon: 'chip',
227
+ shot: 'local',
228
+ title: 'IA en tu Mac',
229
+ lead: 'Una IA que corre en tu equipo, gratis y sin internet. MADRE la usa para ordenar la memoria y como un agente más: @madre.',
230
+ tryIt: 'Descarga el modelo recomendado y pregúntale a @madre algo de tu proyecto.',
231
+ steps: [
232
+ 'En Inicio, abre Ajustes › IA local.',
233
+ 'Descarga el modelo marcado como «Recomendado para tu equipo»: ya está medido para tu Mac.',
234
+ 'Elige qué proyectos la usan.',
235
+ ],
236
+ expert: 'Funciona con Ollama. MADRE solo te ofrece los modelos que caben en tu equipo.',
237
+ },
238
+ {
239
+ id: 'entrena',
240
+ part: 'more',
241
+ icon: 'stars',
242
+ title: 'Entrena tu IA',
243
+ lead: 'Le enseñas a @madre con lo que sabe tu proyecto. Todo pasa en tu computadora: exportas, entrenas un modelo chico y Ollama lo corre.',
244
+ tryIt: 'Exporta y fíjate cuántos ejemplos tiene ya tu proyecto.',
245
+ steps: [
246
+ 'Abre Ajustes › Memoria › Entrena tu propia IA y pulsa Exportar. Rutas, nombres, correos y llaves se tapan, y lo de #0 Incógnito no entra.',
247
+ 'Abre Paso a paso: MADRE mide tu equipo, te sugiere el tamaño y te da cada comando con tus carpetas.',
248
+ 'Al terminar, en Ajustes › IA local pulsa Revisar otra vez: @madre ya contesta con tu modelo.',
249
+ ],
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.',
251
+ },
252
+ {
253
+ id: 'coordinador',
254
+ part: 'more',
255
+ icon: 'orbit',
256
+ shot: 'coordinator',
257
+ title: 'Varios proyectos a la vez',
258
+ lead: 'El Coordinador ve todos tus proyectos. Con una conexión, un proyecto puede consultar lo que aprendió otro.',
259
+ tryIt: 'En Inicio, pregúntale al Coordinador: “¿en qué proyecto me quedé ayer?”.',
260
+ 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.',
263
+ ],
264
+ expert: 'Desde cualquier proyecto le preguntas con /bishop. Por una conexión viajan notas de memoria, nunca tus archivos ni tus chats.',
265
+ },
266
+ {
267
+ id: 'ventanas',
268
+ part: 'more',
269
+ icon: 'windows',
270
+ 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.',
274
+ 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.',
278
+ ],
279
+ expert: 'Cuando escribes en la caja o en Código, las ventanas que estorban se apartan solas.',
280
+ },
281
+ {
282
+ id: 'ajustes',
283
+ part: 'more',
284
+ icon: 'gear',
285
+ shot: 'settings',
286
+ title: 'Ajustes',
287
+ lead: 'Agentes, permisos, apariencia, memoria y privacidad se cambian aquí.',
288
+ tryIt: 'Escribe «acento» en el buscador y prueba otro color.',
289
+ steps: [
290
+ 'Ábrelos con el engrane de la barra o con ⌘ ,.',
291
+ 'Busca cualquier ajuste por su nombre.',
292
+ 'Cada tarjeta dice cómo está antes de abrirla. Lo que cambias se guarda solo.',
293
+ ],
294
+ expert: 'Cada proyecto puede tener su propio color y su propio fondo.',
295
+ },
296
+ {
297
+ id: 'ayuda',
298
+ part: 'help',
299
+ icon: 'help',
300
+ shot: 'diagnostics',
301
+ title: 'Cuando algo no funciona',
302
+ lead: 'Diagnóstico revisa qué pasa y te da el botón para arreglarlo, sin salir del proyecto.',
303
+ tryIt: 'Si un agente te pide iniciar sesión, abre Diagnóstico y escribe “Claude me pide iniciar sesión”.',
304
+ steps: [
305
+ 'Pulsa Diagnóstico en la barra.',
306
+ 'Escribe lo que ves, con tus palabras.',
307
+ 'Abre el caso que se parece al tuyo y sigue lo que te dice.',
308
+ ],
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.',
310
+ },
311
+ {
312
+ id: 'errores',
313
+ part: 'help',
314
+ icon: 'warning',
315
+ title: 'Problemas comunes',
316
+ lead: 'Lo que más suele pasar y cómo se arregla. Si lo tuyo no está aquí, abre Diagnóstico y escribe lo que ves.',
317
+ problems: [
318
+ ['Un agente dice «Sin iniciar sesión».', 'Ajustes › Agentes: ábrelo y pulsa su botón para entrar con tu cuenta.'],
319
+ ['MADRE no encuentra un agente.', 'Ajustes › Agentes › Instalar. MADRE corre el comando por ti.'],
320
+ ['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.'],
322
+ ['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
+ ['«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
+ ['El agente no contestó a tiempo.', 'Vuelve a preguntar. Si pasa seguido, sube el tiempo límite en Ajustes › Trabajo y límites.'],
325
+ ['«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
+ ['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.'],
327
+ ['Una respuesta se cortó porque MADRE se reinició.', 'Vuelve a preguntar. El chat no se perdió.'],
328
+ ],
329
+ expert: 'Diagnóstico también funciona desde la Terminal: `npx @jossuealcala/madre doctor`.',
330
+ },
331
+ ],
332
+ closing: 'MADRE es software libre (AGPL v3). Ayuda y novedades en madre.run.',
333
+ pdf: 'Descargar en PDF',
334
+ language: 'English',
335
+ },
336
+ en: {
337
+ title: 'MADRE manual',
338
+ subtitle: 'How to work with your AI agents',
339
+ 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.',
342
+ ],
343
+ words: {
344
+ title: 'Four words before you start',
345
+ list: [
346
+ ['Agent', 'An AI that works on your project. Codex, Claude and Gemini are agents.'],
347
+ ['Project', 'A folder on your Mac. Each one has its chats and its memory.'],
348
+ ['Permission', 'What the agent may do with that message: only talk, create files or change them.'],
349
+ ['Memory', 'What MADRE remembers about your project, so you do not have to explain it every time.'],
350
+ ],
351
+ },
352
+ contents: 'Contents',
353
+ parts: { start: 'Getting started', work: 'Working', more: 'More', help: 'Help' },
354
+ problem: ['What you see', 'What to do'],
355
+ copy: 'Copy',
356
+ copied: 'Copied',
357
+ tryIt: 'Try it',
358
+ expert: 'If you know the basics',
359
+ shortcuts: 'Every shortcut',
360
+ sections: [
361
+ {
362
+ id: 'instalar',
363
+ part: 'start',
364
+ 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.',
373
+ ],
374
+ 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
+ },
376
+ {
377
+ id: 'agentes',
378
+ part: 'start',
379
+ icon: 'agents',
380
+ shot: 'agents',
381
+ title: 'Connect your agents',
382
+ 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.',
384
+ 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.',
387
+ 'Once it says «Connected», you can talk to it.',
388
+ ],
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.',
390
+ },
391
+ {
392
+ id: 'inicio',
393
+ part: 'start',
394
+ icon: 'home',
395
+ 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.',
399
+ 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.',
403
+ ],
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.',
405
+ },
406
+ {
407
+ id: 'hablar',
408
+ part: 'start',
409
+ icon: 'chat',
410
+ shot: 'composer',
411
+ 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”.',
414
+ 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.',
419
+ ],
420
+ expert: '@ calls an agent, # changes the permission, ! quotes a file and / opens the commands. ⌥ ↵ makes a new line and ⌘ V pastes an image.',
421
+ },
422
+ {
423
+ id: 'permisos',
424
+ part: 'work',
425
+ icon: 'shield',
426
+ 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.',
430
+ steps: [
431
+ '#1 Chat only: reads your project and answers.',
432
+ '#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.',
434
+ '#4 Full access: runs commands and may publish. It asks you to confirm twice.',
435
+ ],
436
+ expert: '#0 Incognito talks without saving anything. Each agent\'s ceiling, and how you confirm, are in Settings › Permissions.',
437
+ },
438
+ {
439
+ id: 'copiloto',
440
+ part: 'work',
441
+ icon: 'robot',
442
+ 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.',
445
+ tryIt: 'Turn it on for an hour and ask: “go through every test and fix the ones that fail”.',
446
+ steps: [
447
+ 'Press the robot beside the box.',
448
+ 'Choose for how long: from 30 minutes to 24 hours.',
449
+ 'Turn it on and write the task. It asks you to confirm only once.',
450
+ ],
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.',
452
+ },
453
+ {
454
+ id: 'codigo',
455
+ part: 'work',
456
+ icon: 'code',
457
+ 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.',
461
+ 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.',
466
+ ],
467
+ expert: '⌘ P finds a file by name. EDIT lets you write: ⌘ S saves, ⌘ F finds and ⌘ / comments.',
468
+ },
469
+ {
470
+ id: 'memoria',
471
+ part: 'work',
472
+ icon: 'stars',
473
+ shot: 'memory',
474
+ 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.',
477
+ 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.',
481
+ ],
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.',
483
+ },
484
+ {
485
+ id: 'notas',
486
+ part: 'work',
487
+ icon: 'note',
488
+ shot: 'notes',
489
+ 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.',
491
+ tryIt: 'Write to an agent: “remind me tomorrow at 10 to check the banner”.',
492
+ 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.',
496
+ ],
497
+ 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
+ },
499
+ {
500
+ id: 'modulos',
501
+ 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.',
507
+ 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.',
511
+ ],
512
+ expert: 'The Market, from Home, has more. On each module\'s page you choose all your projects or just one.',
513
+ },
514
+ {
515
+ id: 'continuidad',
516
+ part: 'more',
517
+ icon: 'loop',
518
+ shot: 'continuity',
519
+ 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.',
522
+ 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.',
525
+ 'Press Install. Your project needs to use git, with at least one commit.',
526
+ ],
527
+ expert: 'Outside MADRE it is called AHP+. Claude Code, Codex and OpenCode read it with their own files, and it travels with your repository.',
528
+ },
529
+ {
530
+ id: 'herramientas',
531
+ part: 'more',
532
+ icon: 'plug',
533
+ shot: 'connectors',
534
+ title: 'Connectors (MCP)',
535
+ lead: 'A connector lets your agents use another app, such as GitHub, Notion or your calendar.',
536
+ tryIt: 'Connect GitHub and ask: “which issues do I have open?”.',
537
+ steps: [
538
+ '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.',
541
+ ],
542
+ expert: 'If you set them up in Claude Code, Codex, Gemini or Cursor already, «Import from your apps» brings them over.',
543
+ },
544
+ {
545
+ id: 'ia-local',
546
+ part: 'more',
547
+ icon: 'chip',
548
+ shot: 'local',
549
+ title: 'AI on your Mac',
550
+ lead: 'An AI that runs on your machine, free and offline. MADRE uses it to keep the memory in order and as one more agent: @madre.',
551
+ tryIt: 'Download the recommended model and ask @madre something about your project.',
552
+ steps: [
553
+ 'In Home, open Settings › Local AI.',
554
+ 'Download the model marked «Recommended for your computer»: it is already sized for your Mac.',
555
+ 'Choose which projects use it.',
556
+ ],
557
+ expert: 'It runs on Ollama. MADRE only offers the models that fit your computer.',
558
+ },
559
+ {
560
+ id: 'entrena',
561
+ part: 'more',
562
+ icon: 'stars',
563
+ title: 'Train your AI',
564
+ 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
+ tryIt: 'Export and see how many examples your project already has.',
566
+ 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.',
570
+ ],
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.',
572
+ },
573
+ {
574
+ id: 'coordinador',
575
+ part: 'more',
576
+ icon: 'orbit',
577
+ shot: 'coordinator',
578
+ title: 'Several projects at once',
579
+ lead: 'The Coordinator sees all your projects. With a connection, one project can look up what another learned.',
580
+ tryIt: 'In Home, ask the Coordinator: “which project was I on yesterday?”.',
581
+ 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.',
584
+ ],
585
+ expert: 'From any project you ask it with /bishop. Memory notes travel through a connection, never your files or your chats.',
586
+ },
587
+ {
588
+ id: 'ventanas',
589
+ part: 'more',
590
+ icon: 'windows',
591
+ 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.',
595
+ 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.',
599
+ ],
600
+ expert: 'When you type in the box or in Code, the windows in the way step aside on their own.',
601
+ },
602
+ {
603
+ id: 'ajustes',
604
+ part: 'more',
605
+ icon: 'gear',
606
+ shot: 'settings',
607
+ title: 'Settings',
608
+ lead: 'Agents, permissions, appearance, memory and privacy are changed here.',
609
+ tryIt: 'Type «accent» in the search and try another colour.',
610
+ steps: [
611
+ 'Open them with the gear on the bar or with ⌘ ,.',
612
+ 'Find any setting by its name.',
613
+ 'Each card says how things stand before you open it. What you change saves on its own.',
614
+ ],
615
+ expert: 'Each project can have its own colour and its own background.',
616
+ },
617
+ {
618
+ id: 'ayuda',
619
+ part: 'help',
620
+ icon: 'help',
621
+ shot: 'diagnostics',
622
+ 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”.',
625
+ 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.',
629
+ ],
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.',
631
+ },
632
+ {
633
+ id: 'errores',
634
+ part: 'help',
635
+ icon: 'warning',
636
+ 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.',
638
+ problems: [
639
+ ['An agent says «Not signed in».', 'Settings › Agents: open it and press its key to sign in with your account.'],
640
+ ['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.'],
646
+ ['«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
+ ['The Terminal says your Node is too old.', 'Install Node 22.5 or newer from nodejs.org and run the command again.'],
648
+ ['An answer stopped because MADRE restarted.', 'Ask again. The chat was not lost.'],
649
+ ],
650
+ expert: 'Diagnostics works from the Terminal too: `npx @jossuealcala/madre doctor`.',
651
+ },
652
+ ],
653
+ closing: 'MADRE is free software (AGPL v3). Help and news at madre.run.',
654
+ pdf: 'Download as PDF',
655
+ language: 'Español',
656
+ },
657
+ };