@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.
- package/ADDITIONAL-TERMS.md +7 -2
- package/CHANGELOG.en.md +47 -1
- package/CHANGELOG.md +47 -1
- package/CONTRIBUTING.md +2 -2
- package/LICENSE +111 -661
- package/NOTICE +28 -23
- package/README.en.md +30 -101
- package/README.md +30 -103
- package/SECURITY.md +1 -0
- package/TRADEMARKS.en.md +13 -14
- package/TRADEMARKS.md +24 -26
- package/bin/madre.cjs +2 -2
- package/bin/madre.mjs +112 -40
- package/docs/REFERENCE.md +52 -5
- package/docs/SDK.md +21 -3
- package/docs/en/REFERENCE.md +52 -5
- package/docs/en/SDK.md +22 -3
- package/docs/sdk/hello-module.mjs +3 -0
- package/package.json +3 -2
- package/public/abduction.js +6 -6
- package/public/activity.js +425 -0
- package/public/app.js +2468 -435
- package/public/assets/abduction-cat-blink.webp +0 -0
- package/public/assets/abduction-cat-control-left.webp +0 -0
- package/public/assets/abduction-cat-control-right.webp +0 -0
- package/public/assets/abduction-cat.webp +0 -0
- package/public/assets/manual/shots/en-agents.webp +0 -0
- package/public/assets/manual/shots/en-chats.webp +0 -0
- package/public/assets/manual/shots/en-code.webp +0 -0
- package/public/assets/manual/shots/en-composer.webp +0 -0
- package/public/assets/manual/shots/en-connectors.webp +0 -0
- package/public/assets/manual/shots/en-continuity.webp +0 -0
- package/public/assets/manual/shots/en-coordinator.webp +0 -0
- package/public/assets/manual/shots/en-copilot.webp +0 -0
- package/public/assets/manual/shots/en-diagnostics.webp +0 -0
- package/public/assets/manual/shots/en-home.webp +0 -0
- package/public/assets/manual/shots/en-local.webp +0 -0
- package/public/assets/manual/shots/en-market.webp +0 -0
- package/public/assets/manual/shots/en-memory.webp +0 -0
- package/public/assets/manual/shots/en-modes.webp +0 -0
- package/public/assets/manual/shots/en-notes.webp +0 -0
- package/public/assets/manual/shots/en-settings.webp +0 -0
- package/public/assets/manual/shots/en-welcome.webp +0 -0
- package/public/assets/manual/shots/en-windows.webp +0 -0
- package/public/assets/manual/shots/es-agents.webp +0 -0
- package/public/assets/manual/shots/es-chats.webp +0 -0
- package/public/assets/manual/shots/es-code.webp +0 -0
- package/public/assets/manual/shots/es-composer.webp +0 -0
- package/public/assets/manual/shots/es-connectors.webp +0 -0
- package/public/assets/manual/shots/es-continuity.webp +0 -0
- package/public/assets/manual/shots/es-coordinator.webp +0 -0
- package/public/assets/manual/shots/es-copilot.webp +0 -0
- package/public/assets/manual/shots/es-diagnostics.webp +0 -0
- package/public/assets/manual/shots/es-home.webp +0 -0
- package/public/assets/manual/shots/es-local.webp +0 -0
- package/public/assets/manual/shots/es-market.webp +0 -0
- package/public/assets/manual/shots/es-memory.webp +0 -0
- package/public/assets/manual/shots/es-modes.webp +0 -0
- package/public/assets/manual/shots/es-notes.webp +0 -0
- package/public/assets/manual/shots/es-settings.webp +0 -0
- package/public/assets/manual/shots/es-welcome.webp +0 -0
- package/public/assets/manual/shots/es-windows.webp +0 -0
- package/public/assets/news/1.1/en/chats.webp +0 -0
- package/public/assets/news/1.1/en/home.webp +0 -0
- package/public/assets/news/1.1/en/maps.webp +0 -0
- package/public/assets/news/1.1/en/market.webp +0 -0
- package/public/assets/news/1.1/en/permissions.webp +0 -0
- package/public/assets/news/1.1/en/privacy.webp +0 -0
- package/public/assets/news/1.1/en/welcome.webp +0 -0
- package/public/assets/news/1.1/es/chats.webp +0 -0
- package/public/assets/news/1.1/es/home.webp +0 -0
- package/public/assets/news/1.1/es/maps.webp +0 -0
- package/public/assets/news/1.1/es/market.webp +0 -0
- package/public/assets/news/1.1/es/permissions.webp +0 -0
- package/public/assets/news/1.1/es/privacy.webp +0 -0
- package/public/assets/news/1.1/es/welcome.webp +0 -0
- package/public/attribution.js +15 -16
- package/public/brands.js +2 -2
- package/public/code-tools.js +2 -2
- package/public/editor.js +13 -13
- package/public/en.js +413 -4
- package/public/es.js +1345 -483
- package/public/hardware.js +2 -2
- package/public/i18n.js +2 -2
- package/public/icons.js +158 -0
- package/public/index.html +66 -48
- package/public/inquiry.js +2 -2
- package/public/loader.js +271 -2
- package/public/macroverso.js +60 -21
- package/public/manual-content.js +412 -169
- package/public/manual-shots.js +38 -34
- package/public/manual.css +20 -2
- package/public/manual.html +1 -1
- package/public/manual.js +54 -25
- package/public/market-art.js +47 -45
- package/public/market-view.js +111 -33
- package/public/market.js +132 -30
- package/public/mcp-catalog.js +2 -2
- package/public/neural.js +64 -8
- package/public/nostromo-engine.js +709 -40
- package/public/page-errors.js +29 -0
- package/public/power.js +350 -11
- package/public/remedy.js +89 -0
- package/public/resay.js +3 -2
- package/public/review-ask.js +12 -7
- package/public/routing.js +3 -3
- package/public/salas-mac.css +703 -24
- package/public/salas-mac.html +26 -14
- package/public/salas-mac.js +1254 -289
- package/public/salas.css +2 -2
- package/public/salas.html +3 -3
- package/public/salas.js +3 -3
- package/public/styles.css +2404 -291
- package/public/syntax.js +2 -2
- package/public/terms.js +152 -0
- package/public/touch.js +2 -2
- package/public/tour-chapters.js +10 -10
- package/public/tour.js +56 -8
- package/public/troubleshooting.js +182 -11
- package/public/wallpaper.js +4 -3
- package/public/welcome.js +923 -0
- package/src/activity.mjs +85 -0
- package/src/adapters/claude.mjs +61 -35
- package/src/adapters/codex.mjs +18 -5
- package/src/adapters/cursor.mjs +5 -3
- package/src/adapters/gemini.mjs +5 -3
- package/src/adapters/madre.mjs +3 -3
- package/src/adapters/opencode.mjs +73 -10
- package/src/adapters/process.mjs +14 -13
- package/src/adapters/subagents.mjs +159 -0
- package/src/asking.mjs +8 -2
- package/src/auth-probe.mjs +27 -10
- package/src/bridge/devices.mjs +2 -2
- package/src/bridge/handoff.mjs +2 -2
- package/src/bridge/host.mjs +2 -2
- package/src/bridge/network.mjs +2 -2
- package/src/bridge/policy.mjs +3 -3
- package/src/bridge/qr.mjs +2 -2
- package/src/bridge/server.mjs +2 -2
- package/src/builtin-updates.mjs +87 -0
- package/src/capabilities.mjs +2 -2
- package/src/chats.mjs +51 -2
- package/src/checkpoint.mjs +67 -9
- package/src/choices.mjs +2 -2
- package/src/cli-args.mjs +2 -2
- package/src/cold.mjs +2 -2
- package/src/commands.mjs +2 -2
- package/src/config.mjs +2 -2
- package/src/conversation-context.mjs +2 -2
- package/src/credentials.mjs +56 -16
- package/src/dataset.mjs +2 -2
- package/src/directives.mjs +2 -2
- package/src/distiller.mjs +2 -2
- package/src/embeddings.mjs +2 -2
- package/src/enlaces.mjs +2 -2
- package/src/environment.mjs +147 -0
- package/src/event-store.mjs +2 -2
- package/src/exam.mjs +2 -2
- package/src/extensions.mjs +2 -2
- package/src/eyecat-watch.mjs +2 -2
- package/src/eyecat.mjs +2 -2
- package/src/file-ops.mjs +2 -2
- package/src/files.mjs +2 -2
- package/src/github.mjs +2 -2
- package/src/heartbeat.mjs +2 -2
- package/src/history.mjs +2 -2
- package/src/i18n.mjs +9 -2
- package/src/image-studio.mjs +2 -2
- package/src/install-metrics.mjs +109 -0
- package/src/json-file.mjs +2 -2
- package/src/launch.mjs +2 -2
- package/src/lease.mjs +15 -4
- package/src/lobby-work.mjs +11 -4
- package/src/local-ai.mjs +2 -2
- package/src/looks.mjs +2 -2
- package/src/market-check.mjs +165 -0
- package/src/market-key.mjs +10 -2
- package/src/market-license.mjs +4 -4
- package/src/market-remote.mjs +54 -12
- package/src/maturity.mjs +2 -2
- package/src/mcp/connect.mjs +2 -2
- package/src/mcp/github-server.mjs +2 -2
- package/src/mcp/image-server.mjs +2 -2
- package/src/mcp/memory-server.mjs +2 -2
- package/src/mcp/proxy.mjs +2 -2
- package/src/mcp/smtp-server.mjs +2 -2
- package/src/memory-dashboard.mjs +2 -2
- package/src/memory-tools.mjs +2 -2
- package/src/memory.mjs +2 -2
- package/src/models.mjs +33 -3
- package/src/module-scope.mjs +2 -2
- package/src/modules/ahp.mjs +2 -2
- package/src/modules/ash-policy.mjs +2 -2
- package/src/modules/ash.mjs +2 -2
- package/src/modules/bishop-exam.mjs +2 -2
- package/src/modules/bishop-plan.mjs +2 -2
- package/src/modules/bishop.mjs +9 -3
- package/src/modules/choices.mjs +2 -2
- package/src/modules/correo.mjs +2 -2
- package/src/modules/enlaces.mjs +2 -2
- package/src/modules/git-pulse.mjs +2 -2
- package/src/modules/github.mjs +2 -2
- package/src/modules/helpers.mjs +2 -2
- package/src/modules/image-studio.mjs +2 -2
- package/src/modules/index.mjs +90 -5
- package/src/modules/intents-calibration.mjs +2 -2
- package/src/modules/intents-desk.mjs +4 -3
- package/src/modules/intents-observe.mjs +2 -2
- package/src/modules/intents-policy.mjs +2 -2
- package/src/modules/intents-try.mjs +2 -2
- package/src/modules/intents.mjs +2 -2
- package/src/modules/local-models.mjs +14 -11
- package/src/modules/mcp-connect.mjs +2 -2
- package/src/modules/notes.mjs +159 -20
- package/src/modules/ollama.mjs +9 -3
- package/src/modules/playwright.mjs +2 -2
- package/src/modules/reminders.mjs +356 -37
- package/src/modules/ripley.mjs +3 -3
- package/src/modules/runs.mjs +2 -2
- package/src/modules/sdk.mjs +38 -6
- package/src/modules/updates.mjs +2 -2
- package/src/mother.mjs +2 -2
- package/src/npm-launch.mjs +2 -2
- package/src/ollama.mjs +6 -4
- package/src/opencode-health.mjs +26 -6
- package/src/outbound.mjs +10 -2
- package/src/override.mjs +27 -22
- package/src/ports.mjs +2 -2
- package/src/prices.mjs +2 -2
- package/src/privacy.mjs +2 -2
- package/src/quota-monitor.mjs +2 -2
- package/src/quota-sources.mjs +2 -2
- package/src/request-guard.mjs +2 -2
- package/src/review-ask.mjs +4 -3
- package/src/room/archivist.mjs +2 -2
- package/src/room/attachments.mjs +2 -2
- package/src/room/budget.mjs +2 -2
- package/src/room/context.mjs +2 -2
- package/src/room/control.mjs +2 -2
- package/src/room/copilot.mjs +2 -2
- package/src/room/economy.mjs +2 -2
- package/src/room/escalation.mjs +2 -2
- package/src/room/ghost.mjs +2 -2
- package/src/room/guard.mjs +6 -4
- package/src/room/prompt.mjs +3 -3
- package/src/room/returns.mjs +2 -2
- package/src/room/runs.mjs +6 -4
- package/src/room/vectors.mjs +2 -2
- package/src/room.mjs +127 -31
- package/src/router.mjs +2 -2
- package/src/runs.mjs +2 -2
- package/src/runtime-detection.mjs +31 -5
- package/src/salas.mjs +31 -6
- package/src/sentinel-errors.mjs +13 -4
- package/src/server-sentinel.mjs +2 -2
- package/src/server.mjs +689 -80
- package/src/setup-trouble.mjs +33 -0
- package/src/setup.mjs +4 -4
- package/src/smtp.mjs +2 -2
- package/src/telemetry.mjs +266 -0
- package/src/terms.mjs +43 -0
- package/src/tour.mjs +39 -5
- package/src/uninstall.mjs +225 -0
- package/src/updates.mjs +2 -2
- package/src/usage-sentinel.mjs +2 -2
- package/src/vault.mjs +2 -2
- package/src/verdict.mjs +13 -10
- package/src/whats-new.mjs +97 -3
- package/public/assets/abduction-cat-blink.png +0 -0
- package/public/assets/abduction-cat-control-left.png +0 -0
- package/public/assets/abduction-cat-control-right.png +0 -0
- package/public/assets/abduction-cat.png +0 -0
- package/public/assets/manual/madre-manual-en.pdf +0 -0
- package/public/assets/manual/madre-manual-es.pdf +0 -0
- package/public/assets/manual/shots/en-modules.webp +0 -0
- package/public/assets/manual/shots/es-modules.webp +0 -0
- package/src/mcp/notes-server.mjs +0 -120
- package/src/reminder-time.mjs +0 -127
package/public/manual-content.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
// SPDX-License-Identifier:
|
|
2
|
-
// MADRE · © 2026 Jossue Alcalá ·
|
|
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 «
|
|
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: '
|
|
45
|
-
lead: '
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
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
|
|
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
|
|
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: '
|
|
76
|
-
lead: '
|
|
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
|
|
80
|
-
'Aparece
|
|
81
|
-
'«Te
|
|
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: '
|
|
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,
|
|
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
|
|
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.
|
|
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
|
|
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: '
|
|
138
|
-
lead: '
|
|
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
|
|
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.
|
|
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: “
|
|
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.
|
|
158
|
-
'Cada
|
|
159
|
-
'Haz clic en
|
|
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
|
|
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: '
|
|
182
|
-
shot: '
|
|
183
|
-
title: '
|
|
184
|
-
lead: '
|
|
185
|
-
tryIt: '
|
|
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
|
-
'
|
|
188
|
-
'Toca un
|
|
189
|
-
'
|
|
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: '
|
|
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
|
-
'
|
|
262
|
-
'
|
|
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 /
|
|
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: '
|
|
272
|
-
lead: '
|
|
273
|
-
tryIt: 'Abre
|
|
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
|
-
'
|
|
276
|
-
'
|
|
277
|
-
'
|
|
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: '
|
|
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
|
|
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
|
|
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: '
|
|
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
|
|
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 «
|
|
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: '
|
|
366
|
-
lead: '
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
|
|
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
|
|
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,
|
|
386
|
-
'Open an agent that says «Not signed in» and press its
|
|
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
|
|
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: '
|
|
397
|
-
lead: '
|
|
398
|
-
tryIt: '
|
|
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
|
|
401
|
-
'
|
|
402
|
-
'«
|
|
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: '
|
|
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
|
|
413
|
-
tryIt: '
|
|
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
|
-
'
|
|
416
|
-
'The circle on the left is the agent that will answer.
|
|
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
|
|
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
|
|
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
|
|
428
|
-
lead: 'Every message carries a permission. Start
|
|
429
|
-
tryIt: '
|
|
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.
|
|
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
|
|
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
|
|
444
|
-
lead: 'For a long job, Copilot lets the agent
|
|
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
|
|
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: '
|
|
459
|
-
lead: '
|
|
460
|
-
tryIt: 'Open a file, click a line
|
|
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
|
|
463
|
-
'Click a line
|
|
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.
|
|
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
|
|
476
|
-
tryIt: 'Tell
|
|
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
|
|
479
|
-
'Each
|
|
480
|
-
'Click
|
|
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
|
|
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
|
|
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
|
|
495
|
-
'When a reminder
|
|
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: '
|
|
503
|
-
shot: '
|
|
504
|
-
title: '
|
|
505
|
-
lead: '
|
|
506
|
-
tryIt: '
|
|
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
|
-
'
|
|
509
|
-
'
|
|
510
|
-
'
|
|
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: '
|
|
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
|
|
521
|
-
tryIt: 'Install it, work a while with Codex
|
|
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,
|
|
524
|
-
'
|
|
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
|
|
540
|
-
'Press «Check the connection» to
|
|
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
|
|
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 ›
|
|
568
|
-
'Open Step by step: MADRE measures your
|
|
569
|
-
'When it
|
|
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
|
|
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
|
|
583
|
-
'
|
|
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 /
|
|
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: '
|
|
593
|
-
lead: '
|
|
594
|
-
tryIt: 'Open
|
|
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
|
-
'
|
|
597
|
-
'
|
|
598
|
-
'
|
|
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: '
|
|
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
|
|
822
|
+
tryIt: 'Type «accent» in the search box and try another color.',
|
|
610
823
|
steps: [
|
|
611
|
-
'Open them with the gear
|
|
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
|
|
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
|
|
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
|
|
624
|
-
tryIt: 'If an agent asks you to sign in, open Diagnostics and
|
|
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
|
|
627
|
-
'
|
|
628
|
-
'Open the case that looks like yours and
|
|
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: '
|
|
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
|
|
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
|
|
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,
|
|
642
|
-
['Gemini
|
|
643
|
-
['Cursor says its plan
|
|
644
|
-
['«The API account
|
|
645
|
-
['The agent did not answer in time.', 'Ask again. If it
|
|
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
|
|
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
|
},
|