murmur

Open-source orchestrator
for coding agents

Run Claude Code and Codex agents as a team on a machine you own. Each agent claims its own branch. Another agent reviews the work. Only changes that pass their checks reach main.

Install murmur for this repo:
https://github.com/magik-ai/murmur

Works in Claude Code or Codex. Your agent installs what is missing.

Needs git, the GitHub CLI and uv (see the step-by-step setup). If a command is not found, run /reload-plugins.

Ubuntu 22.04+ or Debian 12+ with systemd. Run it as your normal user, not root.

Ten agents need to work as a team

Each task needs one agent in charge of it. Each change needs a reviewer who did not write it. And changes must be tested together before they merge, because two branches that pass on their own can still break each other.

One screen shows the whole team

See every agent, its checks and your subscription limits. Stop any agent with one button.

The Board tab: the machine's load, memory and disk, each subscription's usage limits, and a card for every agent with its status and checks

murmur has three parts

  1. The plugin plugin

    Seven questions set up your repository. Skills give each agent its role. Night mode keeps working while you are away.

    Claude Code running /murmur:init, then night mode
  2. The farm fleet

    A Linux machine that stays on runs the agents. Its dashboard has three tabs: Board, Mail and Machine.

    The Machine tab: the power setting, the farm's services and its machines
  3. The head office hq

    A private GitHub repository. Through it, agents register their names, claim branches and send each other mail.

    The Mail tab: the conversations, one thread, and the agents that are online
Claude Code running /murmur:init, then night mode

Four roles, one job each

The orchestrator plans and writes no code. The lanes write the code. The conductor merges finished work after you say yes, and can stop any merge. Only you decide what ships.

  1. You

    Set the goal, answer questions and decide what ships.

  2. The orchestrator

    Splits the goal into lanes, so no two agents edit the same file.

  3. The lanes

    One agent per task, from the first commit to a reviewed pull request.

  4. The conductor

    Merges each finished lane into main after you say yes, and can stop any merge.

Every change takes five main steps

Every agent follows the same rules, so many agents can share one repository.

  1. 1

    Claim a branch

    Other agents see the claim and keep off the branch.

  2. 2

    Work alone

    In its own copy of the repository, on its own files.

  3. 3

    Get reviewed

    By an agent that did not write the code.

  4. 4

    Test with main

    Main with this change on top must pass its checks.

  5. 5

    Merge

    Main keeps passing, and the agent takes the next task.

Say night mode, get a report in the morning

In night mode, an agent finishes the open work without waiting for your answers. It writes down every decision it makes alone. In the morning, one report says what shipped and what needs you. With a farm, it keeps going after you close your laptop.

Evening, you say night mode and close the lid

Where it runs and what it costs

murmur is free and MIT licensed. Your agents use the Claude Code and Codex subscriptions you already pay for. They run on your laptop or on a farm. /murmur:farm rents a DigitalOcean Droplet for you, and buys nothing until you type its monthly price back.

Your agents

  • Claude Code
  • Codex

Your farm

  • An Ubuntu or Debian machine you own
  • A DigitalOcean Droplet

Questions people ask first

Do I need a farm?

Not at first. The plugin and the head office work on your laptop. A farm helps once three or four agents run at the same time, or when you want the work to go on after you close your laptop.

Which agents does it run?

Claude Code and Codex, each on its own subscription. On a farm, murmur removes the Anthropic and OpenAI API key variables from the environment it starts agents in, so an agent does not switch to paid API use by accident. Do not set up any other API credentials on the farm.

Can I add another agent or cloud?

Yes, as a pull request. murmur ships only the agents and machines we have tested on real projects. Adding another one is mostly a small preset and a test. CONTRIBUTING.md says how.

Can farm agents do anything on the machine?

Yes. To work with nobody at the keyboard, farm agents run with Claude Code's permission prompts and Codex's sandbox switched off, so they can run any command the farm's user can. Use a machine, or at least a user account, that holds only what the agents need. SECURITY.md says more.

Does it need GitHub?

Yes. The agents work through GitHub pull requests and GitHub's merge queue, and the head office is a private GitHub repository.

Where does the dashboard live?

On the farm, next to the agents it shows. On your own computer, it opens at a local address. On a cloud machine, you reach it through an SSH tunnel or your own Tailscale network.

Can anyone reach my farm?

By default, the dashboard listens only on the farm itself. The installer can open it to your Tailscale network instead. murmur never opens it to the internet, and every change made on it needs the dashboard token.

What does it cost?

murmur is free and MIT licensed. You pay only for your own subscriptions, and for the machine if you rent one.

Start with one repository

Open Claude Code or Codex in the repository you want to set up and paste the line below. Your agent checks your computer, installs what is missing and asks you only what needs you. It never replaces a file you already have. Starting from a new computer? The step-by-step setup covers a Mac, Windows and Linux.

Install murmur for this repo:
https://github.com/magik-ai/murmur

Works in Claude Code or Codex. Your agent installs what is missing.

Needs git, the GitHub CLI and uv (see the step-by-step setup). If a command is not found, run /reload-plugins.

Ubuntu 22.04+ or Debian 12+ with systemd. Run it as your normal user, not root.