@jossuealcala/madre 1.0.4 → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/ADDITIONAL-TERMS.md +7 -2
- package/CHANGELOG.en.md +152 -1
- package/CHANGELOG.md +152 -1
- package/CONTRIBUTING.md +2 -2
- package/LICENSE +111 -661
- package/NOTICE +59 -24
- package/README.en.md +36 -204
- package/README.md +36 -210
- package/SECURITY.md +1 -0
- package/TRADEMARKS.en.md +13 -14
- package/TRADEMARKS.md +42 -26
- package/bin/madre.cjs +2 -2
- package/bin/madre.mjs +114 -42
- package/docs/REFERENCE.md +53 -6
- package/docs/SDK.md +44 -5
- package/docs/en/REFERENCE.md +53 -6
- package/docs/en/SDK.md +43 -4
- package/docs/madre-banner.png +0 -0
- 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 +3519 -647
- 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 +483 -0
- package/public/es.js +1817 -598
- package/public/hardware.js +2 -2
- package/public/i18n.js +47 -9
- package/public/icons.js +158 -0
- package/public/index.html +68 -51
- package/public/inquiry.js +2 -2
- package/public/loader.js +271 -2
- package/public/macroverso.js +60 -21
- package/public/manual-content.js +900 -0
- package/public/manual-shots.js +47 -0
- package/public/manual.css +246 -0
- package/public/manual.html +15 -0
- package/public/manual.js +427 -0
- package/public/market-art.js +99 -41
- package/public/market-view.js +243 -47
- package/public/market.js +139 -26
- package/public/mcp-catalog.js +62 -0
- 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 +4 -2
- package/public/review-ask.js +12 -7
- package/public/routing.js +3 -3
- package/public/salas-mac.css +875 -48
- package/public/salas-mac.html +27 -15
- package/public/salas-mac.js +1668 -338
- package/public/salas.css +2 -2
- package/public/salas.html +3 -3
- package/public/salas.js +3 -3
- package/public/styles.css +2694 -323
- package/public/syntax.js +2 -2
- package/public/terms.js +152 -0
- package/public/touch.js +2 -2
- package/public/tour-chapters.js +100 -92
- package/public/tour.js +118 -28
- package/public/troubleshooting.js +327 -21
- 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 +60 -9
- package/src/adapters/gemini.mjs +17 -4
- package/src/adapters/madre.mjs +30 -9
- package/src/adapters/opencode.mjs +73 -10
- package/src/adapters/process.mjs +19 -15
- package/src/adapters/subagents.mjs +159 -0
- package/src/asking.mjs +8 -2
- package/src/auth-probe.mjs +47 -11
- 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 +3 -3
- package/src/builtin-updates.mjs +87 -0
- package/src/capabilities.mjs +5 -5
- 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 +80 -18
- 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 +76 -0
- package/src/i18n.mjs +32 -3
- 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 +12 -4
- package/src/looks.mjs +19 -7
- package/src/market-check.mjs +165 -0
- package/src/market-key.mjs +10 -2
- package/src/market-license.mjs +104 -0
- package/src/market-remote.mjs +71 -13
- 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 +16 -5
- 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 +115 -12
- 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 +92 -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 +41 -10
- package/src/modules/mcp-connect.mjs +2 -2
- package/src/modules/notes.mjs +281 -0
- package/src/modules/ollama.mjs +48 -13
- package/src/modules/playwright.mjs +16 -5
- package/src/modules/reminders.mjs +664 -0
- package/src/modules/ripley.mjs +3 -3
- package/src/modules/runs.mjs +2 -2
- package/src/modules/sdk.mjs +57 -9
- package/src/modules/updates.mjs +2 -2
- package/src/mother.mjs +13 -3
- package/src/npm-launch.mjs +2 -2
- package/src/ollama.mjs +8 -6
- package/src/opencode-health.mjs +83 -0
- package/src/outbound.mjs +35 -3
- 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 +144 -36
- package/src/router.mjs +2 -2
- package/src/runs.mjs +2 -2
- package/src/runtime-detection.mjs +36 -6
- package/src/salas.mjs +31 -6
- package/src/sentinel-errors.mjs +17 -7
- package/src/server-sentinel.mjs +2 -2
- package/src/server.mjs +980 -139
- 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 +60 -7
- 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/NOTICE
CHANGED
|
@@ -3,34 +3,69 @@ Copyright © 2026 Jossue Alcalá — https://jossuealcala.com
|
|
|
3
3
|
|
|
4
4
|
This product is MADRE, created by Jossue Alcalá.
|
|
5
5
|
|
|
6
|
-
From version 1.0
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
6
|
+
From version 1.1.0 on, MADRE is licensed under the Business Source License 1.1
|
|
7
|
+
(see LICENSE): free for individuals and for organizations of up to ten people,
|
|
8
|
+
including to provide services to others; each version becomes available under
|
|
9
|
+
the GNU Affero General Public License, version 3 only, four years after it is
|
|
10
|
+
first published. Versions 1.0.2 to 1.0.5 remain under the GNU AGPL v3 only with
|
|
11
|
+
the additional terms in ADDITIONAL-TERMS.md, and versions 1.0.1 and earlier
|
|
12
|
+
under the Apache License 2.0 they were published with.
|
|
13
|
+
|
|
14
|
+
Author attribution. MADRE shows, in the corner of every project and of Home,
|
|
15
|
+
the attribution «MADRE <version> · © 2026 Jossue Alcalá» linked to
|
|
16
|
+
https://jossuealcala.com. Please keep it in every copy and in every work based
|
|
17
|
+
on MADRE — or, under another name, «Built with MADRE by Jossue Alcalá» with the
|
|
18
|
+
same link — together with this file, LICENSE and the following line,
|
|
19
|
+
unchanged:
|
|
18
20
|
|
|
19
21
|
Based on MADRE by Jossue Alcalá — https://madre.run
|
|
20
22
|
|
|
21
23
|
"MADRE", the MADRE logo and madre.run are trademarks of Jossue Alcalá. The
|
|
22
|
-
License grants no rights to use them
|
|
23
|
-
|
|
24
|
+
License grants no rights to use them. A modified version must be distributed
|
|
25
|
+
under a different name and logo. See TRADEMARKS.md.
|
|
24
26
|
|
|
25
27
|
---
|
|
26
28
|
|
|
27
|
-
MADRE es de Jossue Alcalá. Desde la versión 1.0
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
29
|
+
MADRE es de Jossue Alcalá. Desde la versión 1.1.0 se licencia bajo la Business
|
|
30
|
+
Source License 1.1 (LICENSE): gratis para personas y para organizaciones de
|
|
31
|
+
hasta diez personas, también para dar servicios a otros; cada versión pasa a la
|
|
32
|
+
GNU AGPL v3 a los cuatro años de publicarse. Las versiones 1.0.2 a 1.0.5 siguen
|
|
33
|
+
bajo la GNU AGPL v3 con los términos de ADDITIONAL-TERMS.md, y las 1.0.1 y
|
|
34
|
+
anteriores bajo la Apache 2.0. MADRE muestra en la esquina de cada proyecto y de
|
|
35
|
+
Inicio «MADRE <versión> · © 2026 Jossue Alcalá» con enlace a
|
|
36
|
+
https://jossuealcala.com; pedimos conservarla en toda copia y versión basada en
|
|
37
|
+
MADRE —o, con otro nombre, «Desarrollado con MADRE de Jossue Alcalá» con el
|
|
38
|
+
mismo enlace— junto con este archivo, LICENSE y la línea «Based on MADRE by
|
|
39
|
+
Jossue Alcalá — https://madre.run». El nombre MADRE, su logo y madre.run son
|
|
40
|
+
marcas de Jossue Alcalá: una versión modificada lleva otro nombre. Ver
|
|
41
|
+
TRADEMARKS.md.
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
Third-party marks (public/mcp-catalog.js). The connectors in Settings › Outside
|
|
46
|
+
tools (MCP) show their makers' marks, only to say which service each one
|
|
47
|
+
reaches; the marks are their owners' trademarks (see TRADEMARKS.md). The
|
|
48
|
+
drawings come from Simple Icons, CoreUI Brands and SVG Logos (CC0 1.0), and the
|
|
49
|
+
Context7 mark from vscode-icons, under the MIT License:
|
|
50
|
+
|
|
51
|
+
The MIT License (MIT)
|
|
52
|
+
|
|
53
|
+
Copyright The vscode-icons Contributors
|
|
54
|
+
|
|
55
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
56
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
57
|
+
in the Software without restriction, including without limitation the rights
|
|
58
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
59
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
60
|
+
furnished to do so, subject to the following conditions:
|
|
61
|
+
|
|
62
|
+
The above copyright notice and this permission notice shall be included in all
|
|
63
|
+
copies or substantial portions of the Software.
|
|
64
|
+
|
|
65
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
66
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
67
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
68
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
69
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
70
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
71
|
+
SOFTWARE.
|
package/README.en.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
<p align="center">
|
|
2
|
-
<a href="https://madre.run"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/
|
|
2
|
+
<a href="https://madre.run"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.1/en/banner.png" alt="MADRE · All your AIs in one chat · Codex, Claude Code, Gemini CLI, Cursor and OpenCode" width="100%"></a>
|
|
3
3
|
</p>
|
|
4
4
|
|
|
5
5
|
<p align="center"><a href="README.md">Español</a> · <b>English</b></p>
|
|
@@ -7,235 +7,67 @@
|
|
|
7
7
|
<p align="center">
|
|
8
8
|
<a href="https://www.npmjs.com/package/@jossuealcala/madre"><img alt="npm" src="https://img.shields.io/npm/v/@jossuealcala/madre?style=flat-square&label=npm&color=9bff66&labelColor=050605"></a>
|
|
9
9
|
<a href="https://github.com/jossuealcacao-exe/madre/actions/workflows/ci.yml"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/jossuealcacao-exe/madre/ci.yml?style=flat-square&label=CI&color=9bff66&labelColor=050605"></a>
|
|
10
|
-
<img alt="
|
|
11
|
-
<img alt="
|
|
12
|
-
<img alt="license" src="https://img.shields.io/badge/license-AGPL--3.0-9bff66?style=flat-square&labelColor=050605">
|
|
10
|
+
<img alt="systems" src="https://img.shields.io/badge/macOS%20·%20Linux%20·%20Windows%20(WSL2)-9bff66?style=flat-square&labelColor=050605">
|
|
11
|
+
<img alt="license" src="https://img.shields.io/badge/license-BSL%201.1-9bff66?style=flat-square&labelColor=050605">
|
|
13
12
|
</p>
|
|
14
13
|
|
|
15
|
-
<br>
|
|
16
|
-
|
|
17
14
|
# All your AIs in one chat.
|
|
18
15
|
|
|
19
|
-
Codex, Claude Code, Gemini
|
|
20
|
-
in the same conversation, remembering the same things. All your projects in one place,
|
|
21
|
-
and a Coordinator that sees them from above.
|
|
22
|
-
|
|
23
|
-
```
|
|
24
|
-
npx @jossuealcala/madre
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
That's it. No account to create, no cloud to set up, no key to paste.
|
|
28
|
-
MADRE uses the sessions those CLIs already have on your machine.
|
|
29
|
-
|
|
30
|
-
<p align="center">
|
|
31
|
-
<img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/en/home.webp" alt="MADRE Home: the Coordinator with its recent summary, who is waiting for you, the connections and one card per project" width="100%">
|
|
32
|
-
</p>
|
|
33
|
-
|
|
34
|
-
<p align="center"><sub>Home, with all your projects. The 90-second tour is <a href="https://github.com/jossuealcacao-exe/madre/blob/main/docs/media/1.0/madre-1-0.mp4">in Spanish for now</a>. Also at <a href="https://madre.run/en/">madre.run</a>.</sub></p>
|
|
35
|
-
|
|
36
|
-
<br>
|
|
37
|
-
|
|
38
|
-
---
|
|
39
|
-
|
|
40
|
-
<br>
|
|
41
|
-
|
|
42
|
-
## What's new in 1.0
|
|
43
|
-
|
|
44
|
-
- **Home**: all your projects in one place, open or asleep, with what happened in each one.
|
|
45
|
-
- **The Coordinator**: an agent that reads across your projects, signs connections and carries orders from one to another.
|
|
46
|
-
- **Connections**: one project looks up what another has already learned, only through a connection that you sign or, if you allow it, the Coordinator.
|
|
47
|
-
- **Permissions your way**: from `#0` Incognito to `#4` Full access, with the key you choose.
|
|
48
|
-
- **Settings and Diagnostics**: everything you configure in one window, and the fix when something breaks.
|
|
49
|
-
- **Modules as apps**, several conversations at once and a code editor in the viewer.
|
|
50
|
-
|
|
51
|
-
If you're coming from 0.7.2, your projects, conversations, memory and settings stay. The details are in the [CHANGELOG](CHANGELOG.en.md).
|
|
52
|
-
|
|
53
|
-
<br>
|
|
54
|
-
|
|
55
|
-
## One conversation, not four terminals
|
|
56
|
-
|
|
57
|
-
<p align="center">
|
|
58
|
-
<img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/en/one-chat.webp" alt="All your AIs in one chat: each answer with its agent, and the handoff line that says how many messages the next one received" width="100%">
|
|
59
|
-
</p>
|
|
60
|
-
|
|
61
|
-
You type `@codex` and Codex answers. You type `@claude` and Claude answers, **reading what Codex just said**. You type "@madre, ask the team…" and each one gives its take in turn on the same thing; at the end, @madre sums up where they agree and where they don't, citing each answer.
|
|
62
|
-
|
|
63
|
-
Today that's four windows, four contexts and you copying and pasting between them. MADRE turns it into one thread.
|
|
64
|
-
|
|
65
|
-
## All your projects, in one place
|
|
16
|
+
**MADRE is not another AI.** It is an app that runs on your computer and brings the AIs you already use (Codex, Claude Code, Gemini, Cursor and OpenCode) into one chat, inside your project. You write to them in your own words, each one reads what the others said, and you decide what they may change. What gets decided is kept.
|
|
66
17
|
|
|
67
18
|
<p align="center">
|
|
68
|
-
<img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/
|
|
19
|
+
<img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/public/assets/news/1.1/en/chats.webp" alt="A project in MADRE 1.1: chats on the left and OpenCode checking a shop's cart" width="100%">
|
|
69
20
|
</p>
|
|
70
21
|
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
## A Coordinator that sees all your projects
|
|
74
|
-
|
|
75
|
-
<p align="center">
|
|
76
|
-
<img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/en/coordinator.webp" alt="The Coordinator answers what was decided in two connected projects, saying which one each fact came from" width="100%">
|
|
77
|
-
</p>
|
|
78
|
-
|
|
79
|
-
The **Coordinator** lives in Home. It reads what your projects have learned —only from the ones you connect— and answers you saying which project each fact came from. If you allow it, it carries tasks from one project to another, up to `#2`; anything that needs more permission arrives as a proposal that you unlock. From any project you ask it with `/bishop`.
|
|
80
|
-
|
|
81
|
-
A **connection** says which kinds of note cross over (decisions, facts, preferences, questions) and until when. Never your files or your conversations, and you can revoke it whenever you want.
|
|
82
|
-
|
|
83
|
-
## A memory that outlives the session
|
|
84
|
-
|
|
85
|
-
<p align="center">
|
|
86
|
-
<img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/en/memory-map.webp" alt="The Memory map: colored memories around a magma core, joined by their links" width="100%">
|
|
87
|
-
</p>
|
|
88
|
-
|
|
89
|
-
Everything that's said gets indexed. When the conversation outgrows the context window, each agent gets back what it needs, cited. Every ten exchanges, the project distills what was said into typed notes: a decision, a fact, a preference, an open question.
|
|
90
|
-
|
|
91
|
-
You ask *"why did we choose Postgres?"* three weeks later and the project answers, even if that decision was made by another agent in another session.
|
|
92
|
-
|
|
93
|
-
With [Ollama](https://ollama.com) running, that memory also **talks**: `@madre` is a fifth agent, local, free, that answers from the whole archive with citations and writes nothing. And you can **see** it: the **Memory map** is a three-dimensional brain you turn with the mouse, where each memory is a star the color of its type.
|
|
94
|
-
|
|
95
|
-
## They read by default. They write when you say so.
|
|
96
|
-
|
|
97
|
-
<p align="center">
|
|
98
|
-
<img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/en/modes.webp" alt="The mode menu, from #0 Incognito to #4 Full access" width="60%">
|
|
99
|
-
</p>
|
|
100
|
-
|
|
101
|
-
Every message goes out with a permission mode, and your mode is the ceiling for everything that message starts.
|
|
102
|
-
|
|
103
|
-
| | | |
|
|
104
|
-
|---|---|---|
|
|
105
|
-
| `#1` | **CHAT ONLY** | Read and coordinate. The default. |
|
|
106
|
-
| `#2` | **CREATE** | Add new files. Whatever already existed is restored when it's done. |
|
|
107
|
-
| `#3` | **EDIT** | Edit the project. A restore point before, a list of changes and `UNDO` after. |
|
|
108
|
-
| `#4` | **FULL ACCESS** | Commands, `git push`, deploys. Asks for the key twice. |
|
|
109
|
-
|
|
110
|
-
There's also `#0 INCOGNITO`, for what shouldn't be kept anywhere.
|
|
111
|
-
|
|
112
|
-
Moving up to `#3` or `#4` is deliberate: MADRE asks for your key —by default, the name of the project folder; in Settings › Permissions you can choose a phrase of your own— and the project itself checks it. No agent can grant itself a permission by writing it in its answer.
|
|
113
|
-
|
|
114
|
-
<p align="center">
|
|
115
|
-
<img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/en/undo.webp" alt="Claude changed two files in #3 Edit and the Undo button takes the project back to the restore point" width="60%">
|
|
116
|
-
</p>
|
|
22
|
+
## Install it
|
|
117
23
|
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
<p align="center">
|
|
121
|
-
<img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/en/workspace.webp" alt="The conversation on the left and the code editor beside it, in Edit mode" width="100%">
|
|
122
|
-
</p>
|
|
123
|
-
|
|
124
|
-
Each panel opens alongside or in a window you can move. Several conversations work at once, the viewer edits code, your project's servers open inside MADRE and you build the bar with a right click. **Settings** (⌘ ,) brings together everything you configure, with search, and **Diagnostics** gives you the fix when something breaks.
|
|
125
|
-
|
|
126
|
-
<br>
|
|
127
|
-
|
|
128
|
-
---
|
|
129
|
-
|
|
130
|
-
<br>
|
|
131
|
-
|
|
132
|
-
## Make it yours
|
|
133
|
-
|
|
134
|
-
MADRE comes with twelve modules —Token saver, Suggested effort, Local AI, GitHub, Continuity and more—, on an app-style board. You write the next one, or you ask an agent to.
|
|
135
|
-
|
|
136
|
-
**A module is one file.** No build, no dependencies, no signing up anywhere. You copy it into a folder, reload and it shows up with its switch, its settings and its card. With one you can add a `/whatever` command the project understands, give the agents a tool they didn't have before, change how MADRE behaves, or connect it to something you already use.
|
|
137
|
-
|
|
138
|
-
**Or you don't write it.** In the text box:
|
|
139
|
-
|
|
140
|
-
```
|
|
141
|
-
/module a command that tells me what changed in the repo this week
|
|
142
|
-
```
|
|
143
|
-
|
|
144
|
-
The agent reads the SDK, writes the file, and MADRE shows you a card to review it before installing it. It never installs itself, and no agent can write to the modules folder.
|
|
145
|
-
|
|
146
|
-
**Connecting it to an outside service** is the most requested thing, and the short answer is *almost always yes*: the limit isn't MADRE, it's how that service lets you hand over your own key. It's worth it when you can get the key in under five minutes without being a developer and revoke it yourself — GitHub, Linear, Notion, Jira, Slack, Telegram, Stripe, Shopify, Odoo, any database. Where there's a wall is where the provider requires reviewing your app before letting you through: Gmail read access, Meta, banking.
|
|
147
|
-
|
|
148
|
-
Your module declares which key it needs and MADRE draws the field; it declares where it connects to and the outbound log accounts for it; it declares which of its tools **send** something, and the project takes those away from the agents except at step `#4`. You don't program any of that: you declare it.
|
|
149
|
-
|
|
150
|
-
**[Write a module →](docs/en/SDK.md)** · with two complete examples that work as they are: [the minimal one](docs/sdk/hello-module.mjs) and [an integration](docs/sdk/connector-module.mjs).
|
|
151
|
-
|
|
152
|
-
<br>
|
|
153
|
-
|
|
154
|
-
---
|
|
155
|
-
|
|
156
|
-
<br>
|
|
157
|
-
|
|
158
|
-
## What MADRE is not
|
|
159
|
-
|
|
160
|
-
This matters more than any feature.
|
|
161
|
-
|
|
162
|
-
**There is no cloud.** MADRE has no server, no account, no backend. It runs on `127.0.0.1` and dies when you close the terminal.
|
|
163
|
-
|
|
164
|
-
**Your keys, where they're needed and nowhere else.** When you give an agent's key, MADRE writes it to the file where that CLI looks for it, locked to your user, and keeps no copy. An integration has no CLI to give it to, so that one —and only that one— MADRE keeps, in its own vault on your machine, with permissions for your user only, accepted only from this computer. Never in its config, its records or its logs, or anything an agent reads: the card only shows that one is saved and how many characters it has.
|
|
165
|
-
|
|
166
|
-
**Nothing goes out on its own.** What an agent reads travels to *its* provider, with your account and your limits — as if you had run it in your terminal, because that's exactly what MADRE does. What MADRE looks up on its own is declared, along with what turns it off: the daily check for new versions (npm and GitHub), your Claude plan's quota, Gemini embeddings and images if you turn them on, and crash reports, off by default. And once a day, always, a notice that this copy is still in use: a random identifier, the MADRE version, the operating system and the Node version. No name, email, IP or anything from your projects; it's how the author knows how many people use MADRE.
|
|
167
|
-
|
|
168
|
-
**And it lets you read it.** Touch the core of the Memory map and "What is sent" opens: the exact document MADRE writes on your behalf every turn, the exact command it delivers it with, and the log of every call that left this machine. It's not a promise: it's a screen.
|
|
169
|
-
|
|
170
|
-
**Zero dependencies.** Node and nothing else.
|
|
171
|
-
|
|
172
|
-
<br>
|
|
173
|
-
|
|
174
|
-
---
|
|
175
|
-
|
|
176
|
-
<br>
|
|
177
|
-
|
|
178
|
-
## Getting started
|
|
179
|
-
|
|
180
|
-
You need **Node 22.5** or later and at least one of these CLIs with a signed-in session: Codex, Claude Code, Gemini CLI, OpenCode or Cursor (`cursor-agent`). Cursor, for now, reads and answers; it does not write in your project yet.
|
|
24
|
+
**macOS and Linux.** Open the Terminal and type:
|
|
181
25
|
|
|
182
26
|
```
|
|
183
27
|
npx @jossuealcala/madre
|
|
184
28
|
```
|
|
185
29
|
|
|
186
|
-
|
|
30
|
+
**Windows.** MADRE runs inside WSL2, the Linux that comes with Windows:
|
|
187
31
|
|
|
188
|
-
|
|
32
|
+
1. Open PowerShell as administrator and type `wsl --install`. Restart if it asks you to.
|
|
33
|
+
2. Open **Ubuntu** from the Start menu.
|
|
34
|
+
3. Type `npx @jossuealcala/madre` there.
|
|
189
35
|
|
|
190
|
-
|
|
191
|
-
cd your-project
|
|
192
|
-
npx @jossuealcala/madre start
|
|
193
|
-
```
|
|
194
|
-
|
|
195
|
-
```
|
|
196
|
-
npx @jossuealcala/madre doctor # what's installed, who's signed in
|
|
197
|
-
```
|
|
198
|
-
|
|
199
|
-
**Updating.** `npx @jossuealcala/madre` with no version fetches the newest one each time it starts: close it and open it again, or use the new-version notice inside MADRE, which updates it in one click. If you installed it with `npm install -g`, install it again: `npm install -g @jossuealcala/madre@latest`.
|
|
36
|
+
You need Node 22.5 or newer and at least one AI you are signed in to. There is no account to create. MADRE opens in your browser and a welcome guides you step by step: it connects your AIs, puts a free AI on your computer if it fits, and adds your first project.
|
|
200
37
|
|
|
201
|
-
|
|
38
|
+
## New in 1.1
|
|
202
39
|
|
|
203
|
-
<
|
|
40
|
+
<table>
|
|
41
|
+
<tr>
|
|
42
|
+
<td width="50%"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/public/assets/news/1.1/en/home.webp" alt="Home: your projects, the Coordinator and what is waiting for you"><br><b>Home.</b> Your projects, the Coordinator and what is waiting for you, in one place.</td>
|
|
43
|
+
<td width="50%"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/public/assets/news/1.1/en/market.webp" alt="The Market: modules installed in one click"><br><b>The Market.</b> Notes, Reminders, Before you push and more, in one click.</td>
|
|
44
|
+
</tr>
|
|
45
|
+
<tr>
|
|
46
|
+
<td width="50%"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/public/assets/news/1.1/en/welcome.webp" alt="The welcome: connect your agents without the terminal"><br><b>A step-by-step welcome.</b> No terminal needed.</td>
|
|
47
|
+
<td width="50%"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/public/assets/news/1.1/en/permissions.webp" alt="Permissions: from #0 to #4"><br><b>You decide what changes.</b> From chat only to full access, with undo.</td>
|
|
48
|
+
</tr>
|
|
49
|
+
</table>
|
|
204
50
|
|
|
205
|
-
|
|
206
|
-
**How it works inside:** [docs/en/INTERNALS.md](docs/en/INTERNALS.md) · **Write a module:** [docs/en/SDK.md](docs/en/SDK.md)
|
|
51
|
+
Also: chats to one side like in chat apps, Windows through WSL2, and project maps that grow with what they know. The details are in the [CHANGELOG](CHANGELOG.en.md).
|
|
207
52
|
|
|
208
|
-
|
|
53
|
+
## If something fails
|
|
209
54
|
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
<br>
|
|
213
|
-
|
|
214
|
-
## Status
|
|
55
|
+
Open **Diagnostics** and type what you see, like "Gemini does not answer". It tells you what is going on and gives you the button that fixes it. Without opening MADRE, `npx @jossuealcala/madre doctor` checks your AIs. Common problems are in the [manual](https://madre.run/en/manual/#ayuda).
|
|
215
56
|
|
|
216
|
-
|
|
57
|
+
## Your data
|
|
217
58
|
|
|
218
|
-
|
|
59
|
+
- **It runs on your computer.** MADRE has no account and no cloud: it opens on `127.0.0.1`.
|
|
60
|
+
- **Your keys are not copied.** Each AI keeps its own sign-in.
|
|
61
|
+
- **You know what leaves.** What an AI reads goes to its provider, with your account, just as in your Terminal. Once a day MADRE sends anonymous diagnostics (what failed and how much it is used, never what you write or your projects); turn it off in Settings.
|
|
219
62
|
|
|
220
|
-
|
|
221
|
-
Security: [SECURITY.md](SECURITY.md) · Contributing: [CONTRIBUTING.md](CONTRIBUTING.md)
|
|
63
|
+
## License
|
|
222
64
|
|
|
223
|
-
|
|
224
|
-
you can [sponsor it](https://github.com/sponsors/jossuealcacao-exe). Nothing in the product
|
|
225
|
-
changes based on what you do with that link.
|
|
65
|
+
**Free for individuals and for teams of up to 10**, also when you use it to work for your clients. Anyone can try it. A larger organization using it in its work, or anyone who wants to offer MADRE as a service, needs a commercial license: write to hola@jossuealcala.com.
|
|
226
66
|
|
|
227
|
-
AGPL-3.0 with
|
|
67
|
+
The code is public ([Business Source License 1.1](LICENSE)). It is not an open source license, but each version becomes [GNU AGPL v3](https://www.gnu.org/licenses/agpl-3.0.html) four years after it is published. Versions up to 1.0.5 keep the license they were released with. The MADRE name and logo are trademarks of Jossue Alcalá ([TRADEMARKS.en.md](TRADEMARKS.en.md)).
|
|
228
68
|
|
|
229
|
-
|
|
230
|
-
use it, modify it and fork it, as long as your version stays open under the same license and keeps the
|
|
231
|
-
authorship visible —«MADRE ‹version› · © 2026 Jossue Alcalá» in the corner of every project and of Home,
|
|
232
|
-
linked to jossuealcala.com, or «Built with MADRE by Jossue Alcalá» under another name. The name
|
|
233
|
-
**MADRE**, its logo and madre.run are trademarks of Jossue Alcalá: a modified version goes by another
|
|
234
|
-
name. Up to 1.0.1, MADRE was published under the Apache License 2.0. What's allowed and what isn't:
|
|
235
|
-
[TRADEMARKS.en.md](TRADEMARKS.en.md).
|
|
69
|
+
---
|
|
236
70
|
|
|
237
|
-
|
|
71
|
+
[Manual](https://madre.run/en/manual/) · [CHANGELOG](CHANGELOG.en.md) · [How each thing works](docs/REFERENCE.md) · [Writing a module](docs/SDK.md) · [Security](SECURITY.md) · [Contributing](CONTRIBUTING.md) · [Issues](https://github.com/jossuealcacao-exe/madre/issues)
|
|
238
72
|
|
|
239
|
-
|
|
240
|
-
NOBODY DELETES MOTHER'S MEMORY.
|
|
241
|
-
```
|
|
73
|
+
© 2026 [Jossue Alcalá](https://jossuealcala.com)
|