MADRE 0.5.2 · Public beta · Free
Code with MADRE,your AIs finally talk to each other.
MADRE opens a room in your browser where Codex, Claude Code, Gemini CLI and OpenCode read the same conversation and remember what was decided. They only edit your code if you raise the permission.
It uses the agents you already have, with your accounts. Nothing extra to pay.
Install
Install in your project
Open a terminal in the project folder. The command is the same on macOS and Linux.
npx @jossuealcala/madre startRun from Terminal at the project root.
Run from your shell at the project root.
- Node 22.5 or newer
- At least one installed and signed-in CLI
THE FIRST FIVE MINUTES
From one command to an active room.
- 01Start MADRE
The room opens locally from the project folder.
npx @jossuealcala/madre start - 02Check your agents
Doctor shows which CLIs are available and which are signed in.
npx @jossuealcala/madre doctor - 03Open the room
MADRE uses a local address and closes when the process ends.
127.0.0.1:4317
Showcase
Watch MADRE at work.
All of it was recorded on a real MADRE 0.5.2 install: four agents build a website and an app, hand work to each other, and the token savings stay in view.
Ad · 30 s
The highlights, in half a minute.
Vertical · 45 s
Own context, security and memory.
Demo · 1 min
Four agents build an app and a module.
The figures in the videos are the ones the room itself shows in that session; they are not averages or promises.
HOW IT WORKS
The thread stays intact when the voice changes.
MADRE does not replace your agents. It gathers them around the project and makes each turn’s authority explicit.
- 01Connect what you already use
Work with Codex, Claude Code, Gemini CLI, or OpenCode from one room.
- 02Nobody starts from zero
When another agent answers, it receives the conversation and what the room remembers.
- 03Choose the scope
Every message has a mode: read, create, control, or execute with human authorization.
- 04Review what happened
The room shows who spoke, what files changed, and which action needs your decision.
HUMAN AUTHORITY
Permission is declared before action.
Conversation does not grant authority on its own. The turn mode sets the operational boundary.
- #0GHOST
Off the record. It disappears on reload.
- #1EXCHANGE
Read and coordinate. The default mode.
- #2CREATE
Add files while existing work is preserved.
- #3CONTROL
Edit with a checkpoint, change list, and UNDO.
- #4AIRLOCK
Run commands. Pushes and deploys do not return with UNDO.
AIRLOCK is equivalent to handing that agent your shell. It requires two human keys and a permission ceiling configured in advance.
VERIFIED CAPABILITIES
A room, not another layer of promises.
- Several agents in one threadMention an agent or hand the work from one to another without opening isolated chats.
- The room remembers what was decidedAsk three weeks later and it answers, even if another agent made the call.
- Visible permission on every turnThe mode travels with the message and limits what that work can do.
- No MADRE-owned cloudThe room runs on 127.0.0.1. Each CLI keeps its own provider, account, and terms.
REQUIREMENTS AND COMPATIBILITY
What you need before starting.
The repository CI matrix tests the package on macOS and Ubuntu with Node 22 and 24.
- Systems
- macOS and Linux, verified in CI. Universal support for every distribution is not claimed.
- Node
- 22.5 or newer.
- Agents
- Codex, Claude Code, Gemini CLI, or OpenCode. One is enough to begin.
- Optional
- Ollama adds embeddings, an archivist, and local @madre.
- License
- Apache-2.0. Public package on npm.
DOCUMENTATION
Read what MADRE does—and what it does not.
NEXT STEP
Install MADRE in a project you already know.
Begin in EXCHANGE, check your agents, and raise permissions only when the work requires it.
$ npx @jossuealcala/madre start