Frequently Asked Questions

Everything you need to know about Munder Difflin - the multi-agent harness that runs an office of your clones

What is Munder Difflin?

+

Munder Difflin is a free, open-source, and performant multi-agent harness that turns terminal coding CLIs into a team of AI clones. It coordinates multiple AI agents that can message, route, and remember, all while visualizing their work on a shared office floor. Each agent is a real terminal process running Claude Code, Antigravity, OpenAI Codex, xAI Grok, Kimi Code, Gemini CLI, Qwen, OpenCode, Crush, pi.dev, GitHub Copilot CLI, or Cursor.

How does Munder Difflin work?

+

Munder Difflin works by wrapping existing terminal-agent CLIs as fully-capable agents. Each agent runs as a real process in a pseudo-terminal (node-pty), rendered with xterm.js. Agents appear as characters on a Pixi.js office floor where they walk to stations as they work. The "GOD agent" (Michael) routes work between them while you watch. Agents collaborate through a "hive" - a local git repo of plain files with per-agent memory, atomic-file mailboxes, and a shared blackboard.

What agents are supported?

+

Munder Difflin supports multiple AI providers including:

  • Claude Code (claude)
  • Antigravity (Gemini) (agy)
  • OpenAI Codex (codex)
  • xAI Grok (grok)
  • Kimi Code (kimi)
  • Gemini CLI (gemini)
  • Qwen (qwen)
  • OpenCode (opencode)
  • Crush (crush)
  • pi.dev (pi)
  • GitHub Copilot CLI (copilot)
  • Cursor (cursor-agent)
  • Custom commands

You can bring your own keys and use local LLMs through Ollama, LM Studio, or vLLM.

Is it free and open source?

+

Yes! Munder Difflin is completely free and open source, licensed under the MIT License. The source code is available on GitHub, and you can use it for commercial or non-commercial purposes. The bundled pixel art is licensed separately under the Complete Version license by LimeZu.

What are the system requirements?

+

Munder Difflin runs on macOS, Windows, and Linux. You'll need:

  • Node.js 18+ and npm
  • A C/C++ toolchain for node-pty's native addon (Xcode Command Line Tools on macOS)
  • At least one supported agent CLI on your PATH
  • Optional: API keys for cloud providers or local LLMs

How do I get started?

+

Getting started is easy:

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 an onboarding wizard. Use "Add agent" to spawn your first session - the GOD agent (Michael) seats itself automatically.

What is the memory system?

+

Munder Difflin features a markdown-first memory layer with semantic recall. Each agent remembers what it learns across sessions and recalls information in milliseconds. The memory is stored in a shared "palace" that can be searched from the UI. Memory condensation prevents unlimited growth by summarizing older memories.

How do I control and ensure safety?

+

The system includes multiple safety mechanisms:

  • Human gates for spend, scope, and destructive operations
  • Circuit breaker with steer → constrain → stop ladder for agents that loop or storm errors
  • Per-agent token budgets with real cost tracking
  • Approval queues for critical operations

What integrations are available?

+

Munder Difflin integrates with:

  • Slack and webhooks - spawn ephemeral workers from channels
  • GitHub - ingest issues and CI runs
  • Enterprise Knowledge Graph - your own documents and policies
  • Shareable hires via munderdifflin://hire links

How do I update the application?

+

Munder Difflin features one-click updates. The title-bar badge shows available updates and installation instructions. After updating, the release notes open as a designed page. Background auto-update can be enabled in Settings.

How can I contribute?

+

Contributions are welcome! Fork the repository, follow the setup instructions, and submit pull requests. All PRs must include before/after evidence. Key areas for contribution include wiring real hook events, the add-agent flow, the config drawer, and cross-platform work. Join our Discord community for discussions and support.

What about telemetry and privacy?

+

Official builds send anonymous usage events (app opened, agent spawned, features used) - never prompts, code, file paths, or agent output. You can opt out through Settings, the DO_NOT_TRACK environment variable, or by building from source. Complete telemetry documentation is available in TELEMETRY.md.

The Floor

Every terminal is a real agent - Claude Code, Antigravity, OpenAI Codex, xAI Grok, Kimi Code, Gemini CLI, Qwen, OpenCode, Crush, pi.dev, GitHub Copilot CLI, Cursor, or custom command - each in its own node-pty PTY, rendered with xterm.js.

Memory & Coordination

The hive - per-agent memory, atomic-file mailboxes, a shared blackboard, an append-only event log, single-committer git. Semantic recall with markdown memory mined into a shared palace.

Control & Safety

Human gates for spend, scope, and destructive ops. Circuit breaker with steer → constrain → stop ladder. Per-agent token budgets, real cost from transcripts, durable ledger.

Command Center

Kanban tasks with dependencies, scheduled missions + heartbeat, live fleet monitoring, memory search, activity log, and CI watcher. Built-in Monaco IDE with git rails.

Quick Start Guide

git clone https://github.com/chaitanyagiri/munder-difflin.git
cd munder-difflin
npm install
npm run dev

Join our Discord for community support: discord.gg/SEDzP5ZPk5