MADRE 0.4.1 · Public beta
Codex, Claude Code, Gemini CLI and OpenCode working together on your project: in one conversation, with a memory that keeps what was decided. It runs on your machine. No account, no cloud, free.
npx @jossuealcala/madre start
One command, on macOS and Linux.
What you need first Read the code on GitHub
Install
The command is the same on macOS and Linux. All you need is Node and at least one of your agents, signed in.
Node is the program that runs MADRE, and the only thing it needs. With Homebrew it installs with one command:
brew install nodeNot using Homebrew? Download it from nodejs.org.
Codex, Claude Code, Gemini CLI or OpenCode. MADRE uses the session you already have in each one; it never asks for another account. None yet? Open MADRE anyway: from the room it helps you install them and sign in.
In the Terminal, go to your project folder and run these two lines. MADRE finds your agents and opens the room in your browser.
cd your-project
npx @jossuealcala/madre startWith Ollama, @madre joins as a fifth agent: it runs on your machine, answers from what the room remembers and writes nothing.
brew install ollamaNo Homebrew? MADRE offers the download from ollama.com.
Node is the program that runs MADRE, and the only thing it needs. Install it with your distribution’s package manager, or from nodejs.org. Then check the version:
node --versionCodex, Claude Code, Gemini CLI or OpenCode. MADRE uses the session you already have in each one; it never asks for another account. None yet? Open MADRE anyway: from the room it helps you install them and sign in.
In the Terminal, go to your project folder and run these two lines. MADRE finds your agents and opens the room in your browser.
cd your-project
npx @jossuealcala/madre startWith Ollama, @madre joins as a fifth agent: it runs on your machine, answers from what the room remembers and writes nothing. It installs with its official installer:
curl -fsSL https://ollama.com/install.sh | shIn your browser, at http://127.0.0.1:4317: an address that only exists on your machine. If that port is taken, MADRE uses the next free one.
It tells you which agents MADRE found and which ones are signed in, without opening the room:
npx @jossuealcala/madre doctorWhat it does
Ask one agent and it answers. Ask another and it answers knowing what was already said. Ask for a round table and each one weighs in, in turn. No copying and pasting between windows.
HANDOFF @CODEX → @CLAUDE · 2 MESSAGES CARRIED
How it works
You type one command in your project folder. MADRE finds the agents you have and opens the room in your browser.
Pick it from the list or call it by name, like @claude. Every answer says who replied, with which permission, which model and how much of your plan it used, measured in tokens.
When another agent takes the turn, it receives the conversation. The room shows it in one line, HANDOFF, with how many messages it passed on.
Every ten exchanges, or after ten idle minutes, the room sums up what matters as notes: a decision, a fact, a preference or a question.
Three weeks later you ask “why did we pick Postgres?” and the room tells you, even if another agent made that call in another session.
First steps
The first time, MADRE welcomes you with a four-screen tour: the room, the permission modes, the memory and MU/TH/UR, its diagnostic console. You can skip it.
Three things to try first. We did them for this page, on an empty project:
@madre, ask the crew: where would you start this project, and why?#3 CONTROL, review the list of what changed and, if you don’t like it, roll it back with UNDO.
Permissions
Every message you send carries a permission, which MADRE calls a mode. That mode is the limit for everything the message sets in motion, and no agent can give itself more, not even by asking for it in its answer.
Off the record. Nothing is saved; gone on reload.
Read the project and talk to the room. Writes nothing.
Add new files where they belong in the project. Existing files stay untouched.
Edit the project itself, no approval per action. Override required.
Run commands, push, deploy. What leaves the ship does not come back. Override, twice.
To turn on CONTROL, MADRE asks you to type the project’s folder name. AIRLOCK asks for a second key: typing the word AIRLOCK.
Once it is on, the room answers the way the ship would: SPECIAL ORDER 937 ACKNOWLEDGED.
AIRLOCK can run commands, git push and deploy. Use it as if you were lending that agent your terminal.
Before editing, MADRE saves a restore point (a checkpoint). When it is done, it shows you the list of changes and a button to go back.
We tried it for this page: Codex created a README.md in CONTROL, we pressed UNDO and the file was gone from disk.
What MADRE is not
There is no cloud. MADRE has no servers and no accounts. It runs only on your machine (at 127.0.0.1) and stops when you close the terminal.
It does not keep your keys. If you give it an access key, it stores it where that agent looks for it, locked to your user, and keeps no copy. The room notes that a key was set; never the key.
Your agents don’t go through MADRE. What an agent reads goes straight to its provider, with your account and your limits, just as if you used it in your terminal.
And you can check all of it. Inside the room you can open the exact document MADRE hands each agent on your behalf, the exact command it launches it with, and the list of every address MADRE can connect to, each with its switch.
Nothing else to install. All it needs is Node: zero third-party dependencies, not to use it and not to build it.
It is not another AI to pay for. MADRE brings no model of its own and no subscription. It is free, open source and works with the agents and sessions you already have. @madre, optional, runs on your machine with Ollama.
Gallery
Real MADRE 0.4.0 screens, captured for this page on an empty project. None of them is a mockup.
What’s new · 0.4.1
Released September 27, 2026. The most important parts of this version, in a few words.
Error reports now go to the product’s own address, and the old one keeps answering for rooms already installed. For people there is a form with no account, and GitHub one click away.
Every problem MU/TH/UR knows has its support code, from MU-001 to MU-054: the one you read out when you ask for help. And the full log downloads as a file any spreadsheet opens.
When an agent fails, MADRE first says what happened —“something asked it to stop”, not “code 143”— and then, separately, what the agent’s program answered. A warning is no longer mistaken for the cause.
Fixes in Spanish. The instructions to solve each problem are in Spanish, with the button names you see on screen.
A button where there was a command. Eight problems are now solved with a button in CONNECTIONS, with no commands to type. The command is still there for anyone who prefers the terminal.
Alerts you can close. Each row of the log is dismissed with its ×, or all at once, without erasing the history. The MU/TH/UR badge counts only what is still open.
Image Studio finds your key. The module that makes images now reads your Gemini key where MADRE stores it, on Linux too.
PLAYWRIGHT connects. The browser the agents use now starts: a piece was missing from its command. And it now also checks that the browser is installed.
An agent that updates itself. If Codex, Claude or another agent updates while the room is open, MADRE explains it instead of showing a technical error. Reopening the room finds the new version.
And more: MU/TH/UR warns you when an API key in your setup (ANTHROPIC_API_KEY) makes Claude bill the API instead of your plan, the language you pick switches the whole interface, and EYECAT speaks Spanish. See every change
Compatibility
Every release is tested automatically on both systems, with Node 22 and 24.
See the run on GitHub Actions| System | Node 22 | Node 24 |
|---|---|---|
| macOS | passed | passed |
| Linux | passed | passed |
@madreWhat is tested: that MADRE passes its tests, packs, installs and that its self-check (doctor) answers. What can’t be tested there: the conversation with real agents, because those machines have no signed-in sessions.
Windows? There is code for Windows, but it isn’t tested automatically yet. That is why we don’t list it as supported.
Questions
No. MADRE has no accounts, servers or cloud. It uses the sessions your agents already have on your machine.
Codex, Claude Code, Gemini CLI and OpenCode. If you install Ollama, also @madre: a local agent that answers from what the room remembers and writes nothing.
Nothing. MADRE is free and open source (Apache-2.0 license). Each agent uses your own account and your limits with its provider, just like today.
We can’t promise it yet. The code accounts for Windows, but the automated tests only cover macOS and Linux, so we don’t list it as supported.
MADRE runs on your machine. What an agent reads goes to its provider with your account, just as if you used it in your terminal, and it doesn’t go through MADRE. What MADRE checks on its own is listed in the room with its switch: the daily check for new releases, how much of your Claude plan is left, and error reports, which ship switched off.
By default, agents only read. For them to edit, you raise the mode to CONTROL by typing the project’s folder name. Before editing, MADRE saves a restore point, and UNDO takes the project back to that moment.
Whatever they are configured for: MADRE uses your sessions as they are. The room itself is in Spanish or English, and the EN button switches between them.
Node 22.5 or later. The automated tests use Node 22 and 24.
Docs
npx @jossuealcala/madre start