Real MADRE 1.1 screens, untouched.
How it works
Videos of MADRE on a real computer, with real projects.
Welcome
It checks your computer, connects the AIs you already use and adds your first project. All with buttons, no terminal.
Home
Home tells you what happened in each project and who is waiting for your answer. The Coordinator is an AI that reads the projects you connect and tells you where each fact came from.
Your chats
Type @ to choose who you talk to. The AI reads your project before answering, and the others read the conversation: you never repeat yourself.
Market
Notes, Reminders, Preview, Before you push and more. Before you install anything you see what it does and where it connects.
Permissions and undo
For an AI to edit or run commands, you raise the permission on that message. Before it touches anything, MADRE keeps a copy, and Undo puts everything back.
Your files
Open files, the browser or the map on the right, without leaving MADRE. Select a few lines and ask an AI about that exact piece.
Real recordings of MADRE 1.1, on real projects, untouched.
What it’s for
You already use Claude, ChatGPT or Gemini. MADRE puts them in one chat, inside your project, and you decide who does what. A few examples:
Coding
You ask: “@claude find out why the cart won’t charge. @codex fix it. @gemini check nothing else breaks.”
Claude finds it, Codex fixes it with your permission and Gemini checks it. None of them needs you to repeat a thing. If you don’t like it, Undo puts everything back.
Who does it: ClaudeCodexGemini
Your business online
You ask: “@cursor suggest the design. @codex build it with the menu and a WhatsApp button.”
Cursor designs and Codex writes the files in your folder. You see it in Preview, next to the chat, without leaving MADRE.
Who does it: CursorCodexPreview
Decisions
You ask: “@madre, ask the team: should I raise prices or run a promotion?”
They answer one after another, each reading the ones before. At the end, @madre tells you where they agree and where they don’t.
Who does it: @madreClaudeGeminiCodex
Local AI
You ask: “@madre, what did we agree with the supplier last week?”
@madre runs on your machine: it spends no tokens and what you ask it never leaves. It answers from what the project remembers, and you can train it on your project.
Who does it: @madre
Day to day
You ask: “Tomorrow at 10 I’ll call the accountant.”
Reminders asks “Shall I remind you?” with the time already set. One tap and done; when it’s due, it shows up in Home. Everything else goes in Notes.
Who does it: RemindersNotes
Made to fit
You ask: “@codex make me a module that shows today’s orders.”
A module is a single file. Your AI writes it, you turn it on in Modules and it shows up in your project. The ones other people make, you get from the Market.
Who does it: CodexModulesMarket
Install
You need Node and one AI you are signed in to. On Mac and Linux it is one command; on Windows, an installer.
Node is what makes MADRE run. Got Homebrew? Paste this:
brew install nodeNo Homebrew? Grab the installer from nodejs.org.
Codex, Claude Code, Gemini CLI, Cursor or OpenCode. MADRE uses the account you already have in each one. Don’t have any yet? Open MADRE anyway and it’ll help you install them.
Paste this line in the Terminal. Home opens in your browser and walks you through connecting your AIs and adding your projects.
npx @jossuealcala/madreWith Ollama, @madre is a fifth AI that runs on your computer. It answers with what the project remembers and doesn’t change anything.
brew install ollamaNo Homebrew? MADRE offers to download it from ollama.com.
In your browser, at http://127.0.0.1:4317. That address only exists on your computer, not on the internet. If it’s taken, MADRE grabs the next free one.
Without opening MADRE, it tells you which AIs it found and which ones you’re signed in to:
npx @jossuealcala/madre doctorNode is what makes MADRE run. Install it with your system’s package manager or from nodejs.org. Then check which version you got:
node --versionCodex, Claude Code, Gemini CLI, Cursor or OpenCode. MADRE uses the account you already have in each one. Don’t have any yet? Open MADRE anyway and it’ll help you install them.
Paste this line in the Terminal. Home opens in your browser and walks you through connecting your AIs and adding your projects.
npx @jossuealcala/madreWith Ollama, @madre is a fifth AI that runs on your computer. It answers with what the project remembers and doesn’t change anything. You install it with its official installer:
curl -fsSL https://ollama.com/install.sh | shIn your browser, at http://127.0.0.1:4317. That address only exists on your computer, not on the internet. If it’s taken, MADRE grabs the next free one.
Without opening MADRE, it tells you which AIs it found and which ones you’re signed in to:
npx @jossuealcala/madre doctorOn Windows you don’t need a terminal: there’s an installer. Three steps.
It’s a tiny file. Open it with a double click.
If Edge or Chrome say it is «not commonly downloaded», that is because it is new and not signed yet: choose Keep.
Press More info and then Run anyway.
It shows up because the installer doesn’t have a digital signature yet, not because anything is wrong with it. We’re already getting the certificate so this notice goes away.
If your antivirus flags it as a virus, it’s because of that same missing signature, not because it is one. What to do
If Windows asks for permission or a restart, say yes. If it restarted, open «MADRE» on your desktop when you’re back. In a few minutes MADRE is in your Start menu.
Windows 10 or 11, 64-bit. Everything explained, step by step
The manual route: MADRE inside WSL2, in your own Ubuntu. If you open MADRE on Windows directly, it tells you these same steps.
Open PowerShell as administrator and paste this. When it finishes, restart the computer.
wsl --installFind it in the Start menu. The first time it asks you for a Linux user name and password. Then install Node there, and zstd, which the AI on your computer (Ollama) needs to install:
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs zstdPaste this line in the Ubuntu window, not in PowerShell. MADRE opens in your Windows browser.
npx @jossuealcala/madreYour AIs (Codex, Claude Code, Gemini…) are installed inside Ubuntu. MADRE helps you in the welcome.
Already have Ollama on Windows? MADRE finds it from WSL: in the welcome, choose “Use the Ollama on Windows”.
First time? Follow the 10-minute manual
Want to see what the command does before you run it? All of MADRE’s code is in plain sight on GitHub.
Review the code on GitHubRather not open another app? Try AHP+ and keep working from your IDE
Permissions
If you say nothing, the AIs only read. For them to create, edit or run commands, you raise the permission on that message. None of them can raise it on its own.
Off the record. Nothing is saved and it is gone on reload.
Reads the project and talks about it. Writes nothing.
Creates new files where they belong in the project. Existing ones are not touched.
Edits the project, without approving action by action. Asks you to confirm.
Runs commands, pushes and deploys. What leaves the machine does not come back. Asks you to confirm twice.
For #3 Edit you confirm; for #4 Full access, you confirm twice. If you prefer, in Settings › Permissions you set a phrase of your own and MADRE asks for it instead. That way nobody turns it on by mistake with a click.
The project itself checks it. If you want, the permission can stay open for a while, to work without interruptions.
#4 Full access can run commands, git push and publish. Use it only if you’d lend that AI your Terminal.
Before editing, MADRE saves a restore point of your project. When it’s done you see what changed and a button, Undo, to go back.
For this page, Claude changed three files in #3 Edit. I hit Undo and the project went back to how it was.
Privacy
No cloud, no accounts. MADRE runs only on your computer (at 127.0.0.1) and shuts down when you close the Terminal. You don’t need an account, and there’s no MADRE cloud in between.
It doesn’t keep your keys. If you give it an access key, it leaves it where that AI looks for it, locked to your user, and keeps no copy.
Your AIs don’t go through MADRE. What an AI reads goes straight to its provider, with your account and your limits, just like when you use it in your Terminal.
You can see everything it does. Touch the core of the Memory map. There you see what MADRE sends each AI, the exact command it uses and every internet address it can reach, with what turns it off.
All it needs is Node. It installs no third-party packages.
It costs you nothing. For individuals and teams of up to 10, MADRE is free, with no subscription. It works with the AIs you already have. @madre is optional and runs on your computer with Ollama.
What’s new · 1.1.0
1.1 lays MADRE out like a chat app, adds the Market and reaches Windows with WSL2. These are the real screens; the same ones MADRE shows you when it updates.
Opening MADRE takes you to Home: your projects, the Coordinator and what is waiting for you. Your chats and projects are on the left, like in chat apps.
Each project keeps its chats in the column on the left. You can open two side by side, or one in its own window. Files, the browser and the map open on the right.
Add features in one click: Notes, Reminders, Preview, Before you push and more. Every module tells you what it does before you install it, and anyone can propose their own.
Connect your agents, put a free AI on your computer and get the memory ready, without the terminal. If you come from an earlier version, a short summary of what is new greets you.
#3 Edit asks you to confirm and #4 Full access, to confirm twice. You can also leave them open for longer, to work without interruptions.
Your projects and memories show as planets or as neurons, and grow the more they know.
Once a day MADRE sends what failed and how much it is used, with nothing you write and nothing from your projects. Turn it off in Settings › Updates and errors.
Windows, with WSL2. MADRE runs inside WSL2, the Linux that comes with Windows. Open it on Windows directly and it tells you the three steps.
You read a module before installing it. MADRE shows you where it connects, which keys it asks for and what it adds, and installs it only if you accept.
Notes and Reminders update themselves. When a fix ships, it arrives signed through the Market and MADRE tells you once.
A new license. Free for individuals and teams of up to 10, also to work for clients. Explained here.
And also: Reminders understands “today”, “tonight” and “Done” better; Files no longer loses what you hadn’t saved; and network errors are said in your language. See every change
What would you like in the next version? Tell me your idea
Market
The Market is inside MADRE, in the left column. Every module tells you what it does, where it connects and what it asks for before you install it. What you get is for the project you asked from.
Before you push Checks you don’t push keys or private files to GitHub.
Test browser Your agents open your page, walk through it and bring you screenshots.
Continuity Pick up where you left off, with any AI.
Notes and Reminders What is pending doesn’t get lost in the chat.
Local AI A free, private AI on your computer.
GitHub Your pull requests and issues without leaving the chat.
How to use it: open a project, press Market in the left column and hit Get.
Do you make modules? A module is a single file. Send it to the community Market and, once I’ve read it, I sign it for everyone. How to make a module The community Market, on GitHub
Help
What happens most when you start, and how to fix it. Inside MADRE, Diagnostics (the pulse icon) understands you in your own words.
Fixes with Jossue AI
Jossue AI is my AI assistant and it knows MADRE: write what you see, in your own words, and it tells you what to do, step by step. No account needed.
Node is missing, or too old. Install Node 22.5 or newer and open the Terminal again. Check with node --version.
Use the installer at madre.run/en/windows: it does everything without a terminal. If it says Windows can’t start MADRE’s Linux, turn on virtualization. If you installed it by hand, paste MADRE’s command in the Ubuntu window, not in PowerShell.
It isn’t. Antivirus programs don’t trust new unsigned programs, and our installer isn’t signed yet; the certificate is in progress. Check that your file’s fingerprint is the one we publish and get it out of quarantine, without turning off your antivirus. Step by step.
Sign in to that AI once. Inside MADRE: Settings › Agents, its account button. Or in the Terminal, with its own command (for example claude).
Open the address MADRE writes in the Terminal yourself, like http://127.0.0.1:4317. In WSL or over SSH this is normal: the Terminal tells you what to do.
The local AI needs Ollama running. Open it and, in MADRE, Settings › Local AI › Check. In WSL you can use the Ollama you have on Windows.
Ollama’s installer needs zstd, which Ubuntu doesn’t come with. In the Ubuntu window paste sudo apt-get install -y zstd and, in MADRE, press Install again.
If an AI edited in #3, hit Undo on that turn: the project goes back to the restore point.
In Home › Settings › Version, press Uninstall…. It tells you what goes and what stays before removing anything; your projects and your AIs stay.
Got an error with a code (MU-…)? Look it up in the known errors
More fixes, step by step, in the manual · Not here? Tell me what’s happening, no account needed
Want to check your setup without opening MADRE?
npx @jossuealcala/madre doctor
Questions
No. MADRE has no accounts, no servers and no cloud. It uses the sessions your AIs already have on your computer.
Codex, Claude Code, Gemini CLI, Cursor and OpenCode. If you install Ollama, also @madre, your local AI. It answers with what the project remembers and changes nothing.
For individuals and teams of up to 10, nothing, also if you work for clients. Larger organizations, or anyone who wants to offer MADRE as a service, need a commercial license. Each AI uses your own account and limits with its provider, as you already do today. The details are in the license.
The code is in plain sight on GitHub and you can read, change and share it. From 1.1 it uses the Business Source License 1.1, which is not an open source license: each version moves to the GNU AGPL v3, which is, four years after it is published. Versions up to 1.0.5 keep theirs.
Yes. Download the installer at madre.run/en/windows, double-click it and you’re done: it sets up WSL2, the Linux that comes with Windows, without you opening a terminal. If you prefer the terminal, the steps are in Install › Windows.
It’s an AI that lives in Home. It reads what your projects learned, only the ones you connect, and tells you which project each fact came from. If you let it, it carries tasks from one project to another, up to #2. Anything that needs more permission reaches you as a proposal, and you decide.
MADRE runs on your computer. What an AI reads travels to its provider with your account, just as if you used it in your Terminal, and does not go through MADRE. What MADRE sends on its own you see and turn off in Settings: the daily check for new versions and the anonymous errors (what failed and how much it’s used, with nothing you write and nothing from your projects). Also, once a day it says it is still in use, and that notice cannot be turned off: a random id, the version, the system and the Node version.
If you say nothing, the AIs only read. For them to edit, you raise the permission to #3 Edit. Before editing, MADRE takes a restore point, and Undo takes the project back to that moment.
Node 22.5 or newer. The automatic tests run on Node 22 and 24, on macOS and Linux.
I do, Jossué Alcalá. I make it and I read every report that comes in.
Still have a question?
Paste this in the Terminal and MADRE opens.
npx @jossuealcala/madre