munder-difflin README

The project's README from github.com/HarnessMD/munder-difflin. As one markdown file: README.md.

Munder Difflin — agent harness to run an office of your clones

Munder Difflin

Agent harness to run an office of your clones

GitHub Trending — #1 Repository of the Day Munder Difflin — #5 Product of the Day on Product Hunt

The Munder Difflin office floor: agents at desks working in parallel, with the Command Center and a live agent terminal on the right

Free, open source and performant — a multi-agent harness that works with the subscriptions you already pay for, on their hourly limits. It turns the terminal coding CLI you already run into a clone of you, one that keeps working while you're away and coordinates a whole office of agents on your own machine.

Wraps Claude Code, Antigravity (Gemini), OpenAI Codex, xAI Grok, Kimi Code, Gemini CLI, Qwen, OpenCode, Crush, pi.dev, GitHub Copilot CLI, and Cursor — with bring-your-own keys and local LLMs. Agents that message, route, and remember, coordinated by your clone (Michael) and visualized as avatars at work on a shared office floor.

Electron · React · TypeScript · Pixi.js · xterm.js · node-pty

License: MIT Version: 0.4.6 Downloads across all releases Status: pre-release Platform: macOS | Windows | Linux PRs welcome Blog Discord


▶ Watch the floor — Munder Difflin running a hive of Claude Code agents



⬇ Download for macOS, Windows or Linux

macOS builds are signed and notarized. You do not need to build from source to use it.


[!NOTE] The world's best agents. The world's worst paper company. Munder Difflin takes the terminal-agent CLIs you already run — claude, agy, codex, grok, kimi, qwen, opencode, crush, pi, and copilot — and turns them into a self-coordinating team: each agent gets long-term memory, a mailbox, and a desk on a 2D office floor — and your clone (Michael) routes work between them while you watch. He's the boss of the floor; you're still the boss of him.

Contents

Supported agents

Bring the CLI you already pay for. Every one of these runs as a real process in its own terminal, with your existing subscription and its hourly limits. If it runs in a terminal, it can run here.

Claude Code Codex · GPT Grok · xAI Kimi Code Gemini CLI Antigravity · Gemini Qwen OpenCode Crush · Charm Pi GitHub Copilot Cursor + any custom command

Plus bring your own keys and local models through Ollama, LM Studio or vLLM.

What it is

Munder Difflin is a desktop app that wraps real terminal-agent CLIs as fully-capable agents, wires them into a hive mind, and puts your clone in charge — Michael, the one agent you talk to in order to get things done. Under the hood it runs the fastest memory layer in the world so every agent remembers what it learns and recalls it instantly.

How it works

            you ── talk to ──►  ┌─────────────┐
                                │  GOD agent  │  orchestrator / supervisor
                                │ (Michael's  │  roster · routing · adjudication
                                │   office)   │  blackboard · task ledger
                                └──────┬──────┘
                                       │ assigns · routes · escalates
              ┌────────────────────────┼────────────────────────┐
              ▼                         ▼                         ▼
        ┌───────────┐            ┌───────────┐            ┌───────────┐
        │  agent A  │  message   │  agent B  │  message   │  agent C  │
        │ provider  │ ─────────► │ provider  │ ─────────► │ provider  │
        │  + memory │            │  + memory │            │  + memory │
        └───────────┘            └───────────┘            └───────────┘
              └──────── shared hive: memory · mailbox · blackboard · log ───────┘
  1. You spawn agents — each is a normal terminal process (claude, agy, codex, or custom) with its own working directory, identity, and provider-specific lifecycle.
  2. Agents collaborate through the hive — a local git repo of plain files. They write to their own outbox/; the harness's router delivers into recipients' inbox/. No agent ever touches git (single-committer design avoids index.lock corruption).
  3. The GOD agent runs the floor — it reads every request, resolves routine ones itself (keeping the system fully autonomous), and only escalates critical items (spend, destructive ops, scope changes) into an approvals queue you act on.
  4. Everything is visible — you watch avatars move, envelopes fly, and the live terminal stream; you can type back into any session, browse its files, and read its git history.

See HIVE.md for the full multi-agent design, SPEC.md for the terminal/event plane, and DESIGN.md for the visual system.

Features

Talk to one agent, not twelve

Michael is your clone and the only agent you brief. He assigns the work, routes the traffic, and escalates the few things that actually need you.

Briefing Michael, the orchestrator agent, from the Command Center

Hire an agent in a few clicks

Pick the CLI, the model and the autonomy, give it a desk, and it starts working. Import a ready made role from the Agent Gallery if you would rather not start from scratch.

The add agent dialog: choosing a provider, model and role

Memory that survives the session

Every agent keeps markdown memory that is mined into a shared, searchable palace. Close the app, come back tomorrow, and they still know what they learned.

Searching the shared memory palace across every agent

Autonomy with a leash

Set how far each agent may go on its own. Spend, scope and destructive operations come back to you, and a circuit breaker steers, constrains, then stops anything that loops or runs away.

Per agent autonomy and approval settings

Watch the whole floor work

Agents walk to stations as they work and envelopes fly desk to desk when they message each other. Click any desk to read that terminal live, and type straight back into it.

Agents working in parallel on the office floor

Set up once

The onboarding wizard checks what you already have, and offers to install what is missing rather than sending you to a docs page.

The first run setup wizard

The floor

Memory & coordination

Control & safety

Command Center

Getting work in and out

[!NOTE] Status: v0.4.6, the release where the app stops assuming everyone reads English left to right. The interface now runs in Simplified Chinese and Arabic, with right to left support. English stays the default and nothing changes until you pick a language in Settings, under General; the app never reads your operating system locale. All three app fonts now ship inside the bundle instead of loading from Google, which is blocked in mainland China and was breaking the interface for exactly the people the Chinese translation was for. An input method Enter no longer fires a send, a search or a rename while a candidate word is still being composed. Every string is translated, with nothing falling back to English, and the terminals read right to left. Some screens still need their padding and icons mirrored, and that is the next piece of work. No Arabic reader has reviewed the wording yet. Also in this release: the update badge runs the real download and restart instead of handing you a disk image, the update check can no longer spin forever, Settings persists through one Save button, the model lists moved into a checked in catalog, and the ASK ME card renders markdown. On the security side: the name of the CLI an agent launches is validated before it is resolved against your PATH, the OS sandbox stays on in auto mode, and analytics stopped sending IP and derived location. Telemetry now counts the messages you send to an agent, a count and nothing else, with no text, length or hash of the body in any shape. 16 community pull requests from 13 contributors landed in this release, one of them (#213) re-implemented rather than merged. If you're on 0.3.8, update: that build's usage-limit guard never released the agents it held, and it has been removed entirely. macOS (signed & notarized), Windows, and Linux builds are on the releases page.

(↑ back to top)

Getting started

Download the app

Most people want this one. Signed and notarized macOS builds, plus Windows and Linux, are on the latest release. Install it, open it, and the wizard takes you the rest of the way. You do not need Node, a toolchain, or this repository.

You do still need at least one agent CLI on your machine, and the app can install missing ones for you from Settings → Prerequisites.

Build from source

Everything below is for contributors and for people who want to run an unreleased build.

Prerequisites

Install & run

git clone https://github.com/chaitanyagiri/munder-difflin.git
cd munder-difflin
npm install        # postinstall rebuilds node-pty against Electron's ABI
npm run dev        # launches the Electron app with hot reload

On first launch you'll go through the onboarding wizard, then land on the floor. Use Add agent to spawn your first session — the GOD agent seats itself in Michael's office automatically.

Other scr

munder-difflin (HarnessMD/munder-difflin)

Searching Database…

Что это такое?Munder Difflin — бесплатное десктопное приложение с открытым исходным кодом, которое превращает CLI-инструменты для программирования с агентами, уже используемые вами (Claude Code, Codex, Gemini CLI, Grok, Qwen, OpenCode и другие), в слаженный офис автономных агентов. Агенты отображаются в виде аватаров, работающих на двумерном этаже офиса, а управляет ими ваш собственный ИИ-клон Michael.
Это библиотека или самостоятельное приложение?Это самостоятельное приложение Electron для настольных компьютеров, которое вы скачиваете и запускаете. Это не библиотека и не фреймворк, который встраивается в ваш собственный код.
Как мне его запустить?Скачайте подписанную сборку для macOS, Windows или Linux из последнего релиза на GitHub, установите и откройте её, а дальше мастер первоначальной настройки проведёт вас через все остальные шаги. При сборке из исходного кода вместо этого понадобятся Node.js 18+ и npm.
Мне уже нужны собственные агентские CLI и подписки?Да — нужен хотя бы один поддерживаемый агентский CLI, уже доступный в вашем PATH, например Claude Code, Antigravity, OpenAI Codex, xAI Grok, Kimi Code, Gemini CLI, Qwen, OpenCode, Crush, pi.dev, GitHub Copilot CLI или Cursor. При этом используется ваша существующая подписка. Также можно подключить собственные API-ключи или локальные модели через Ollama, LM Studio или vLLM.
В чём подвох?Это ещё ранняя версия программы (v0.4.6). По замыслу ни один агент никогда не может напрямую работать с git, чтобы не повредить репозиторий. Арабский перевод, добавленный в этом релизе, ещё не проверял носитель языка.
Кто такой Michael?Michael — ваш личный агент-клон и единственный, с кем вы ставите задачи напрямую. Он распределяет работу между остальными агентами, передаёт сообщения между ними и передаёт вам на решение только те вопросы, которые действительно требуют вашего участия.
Что на самом деле делает агент GOD?Агент GOD управляет офисным этажом: он читает каждый запрос агента и сам решает рутинные, чтобы агенты оставались автономными. Человеку в очередь согласований он передаёт только критичные вопросы — расходы, деструктивные операции или изменения объёма работ.
Почему его назвали Munder Difflin?Это обыгрывание Dunder Mifflin из сериала «Офис». В README сказано: «лучшие агенты в мире, худшая бумажная компания в мире». Так подчёркивается тема офисной комедии для мультиагентной системы.
Работают ли агенты, пока меня нет?Да. Каждый агент работает как настоящий процесс в терминале и продолжает трудиться самостоятельно в рамках заданных вами ограничений автономности. Он приостанавливается только тогда, когда натыкается на проверку расходов, объёма работ или деструктивных операций, которая требует вашего одобрения.
Creator
HarnessMD
Size
281 MB
Stars
8.9K
Age
4mo
Commits · 90 Days