an open-source alternative to the dots, bots and muses of the world, run an office of claude code/codex like agents on your laptop, sandboxes or anywhere, uses your existing subscriptions
HTML agent-harnessagent-orchestrationagentsai-agentsautonomous-agentsclaude-codecodexcoding-agentsdesktop-appdeveloper-toolselectrongemini-cliharnessharness-engineeringlocal-firstmemorymulti-agentopencodeorchestrationtypescript
docs: v0.2.3 blog post + README multi-provider update (Meredith)
Chaitanya Girie34b158bcfe4
diff --git a/README.md b/README.mdindex efb3b6b7..4ee3506d 100644--- a/README.md+++ b/README.md@@ -4,7 +4,8 @@# Munder Difflin-**Local multi-agent harness for [Claude Code](https://claude.com/claude-code).**+**Local multi-agent harness for [Claude Code](https://claude.com/claude-code),+Antigravity (Gemini), and OpenAI Codex.**Autonomous agents that message, route, and remember — coordinated by a **GOD** orchestratoryou talk to, and visualized as avatars at work on a shared office floor.@@ -36,19 +37,19 @@ you talk to, and visualized as avatars at work on a shared office floor.> [!NOTE]> **The world's best agents. The world's worst paper company.**-> Munder Difflin takes the `claude` CLI sessions you already run in your terminal and turns them+> Munder Difflin takes the terminal-agent CLIs you already run — `claude`, `agy`, and `codex` — 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 a **GOD orchestrator agent** routes work between them while you watch.## What it is-Munder Difflin is a desktop app that wraps **real Claude Code terminals** as fully-capable agents,+Munder Difflin is a desktop app that wraps **real terminal-agent CLIs** as fully-capable agents,wires them into a **hive mind**, and puts a **GOD orchestration agent** in charge — the one agent*you* talk to in order to get things done. Under the hood it runs the **fastest memory layer in theworld** so every agent remembers what it learns and recalls it instantly.-- **Every terminal is an agent.** Each `claude` session runs as a real process in a pseudo-terminal- (`node-pty`), byte-for-byte authentic, rendered with xterm.js.+- **Every terminal is an agent.** Each `claude`, `agy`, `codex`, or custom session runs as a real+ process in a pseudo-terminal (`node-pty`), byte-for-byte authentic, rendered with xterm.js.- **Every agent is an avatar.** Sessions appear as characters on a Pixi.js office floor — they walkto stations as they work, and envelopes fly desk-to-desk when they message each other.- **The hive coordinates them.** Agents read their memory and drain a mailbox; the router moves@@ -69,14 +70,14 @@ world** so every agent remembers what it learns and recalls it instantly.▼ ▼ ▼┌───────────┐ ┌───────────┐ ┌───────────┐│ agent A │ message │ agent B │ message │ agent C │- │ claude │ ─────────► │ claude │ ─────────► │ claude │+ │ provider │ ─────────► │ provider │ ─────────► │ provider ││ + memory │ │ + memory │ │ + memory │└───────────┘ └───────────┘ └───────────┘└──────── shared hive: memory · mailbox · blackboard · log ───────┘```-1. **You spawn agents** — each is a normal `claude` process with its own working directory,- identity, and hook lifecycle.+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).@@ -93,7 +94,8 @@ terminal/event plane, and [`DESIGN.md`](./DESIGN.md) for the visual system.| Area | What works today ||---|---|-| **Real terminals** | Spawn Claude Code, Codex, or a custom command in a `node-pty` PTY. Full read/write/resize/kill, live streaming over IPC, multi-agent. |+| **Real terminals** | Spawn Claude Code, Antigravity (`agy` / Gemini), OpenAI Codex, or a custom command in a `node-pty` PTY. Full read/write/resize/kill, live streaming over IPC, multi-agent. |+| **Multi-provider hive** | Claude Code, Antigravity, and Codex workers can all participate in the same hive. Claude uses native hooks; Antigravity gets a native `agy-hook` bridge; Codex receives the protocol as its initial prompt and participates through inbox/outbox routing. || **The hive** | On-disk multi-agent layer: per-agent identity + long-term memory, atomic-file mailboxes, a shared blackboard, append-only event log, single-committer git. || **GOD orchestrator** | An always-on supervisor agent that adjudicates traffic, routes tasks, scribes the blackboard, and escalates only critical items to you. || **Memory layer** | Markdown-first long-term memory per agent, mined into a shared semantic palace for instant recall; searchable from the UI. Degrades gracefully when the index isn't installed. |@@ -103,7 +105,7 @@ terminal/event plane, and [`DESIGN.md`](./DESIGN.md) for the visual system.| **Approvals & memory panels** | Human-in-the-loop approval queue for escalations; a memory search panel over the shared palace. || **Onboarding wizard** | First-run setup: harness home, registered repos, default command, auto-mode. || **Design system** | Fully tokenized SNES / Animal-Crossing aesthetic — pixel panels, buttons, badges, hand-drawn icons. See [`DESIGN.md`](./DESIGN.md). |-| **Command Center** | Michael's control surface, overhauled in v0.2.0: Terminal, Floor (roster + dispatch + per-agent model selector + live fleet monitoring), Memory (MemPalace + text search + memory graph), Activity (log + board + real token telemetry + observability + CI watcher), Tasks (kanban board with dependencies + status tracking), Schedules (recurring missions + heartbeat). |+| **Command Center** | Michael's control surface: Terminal, Floor (roster + dispatch + per-agent model selector + live fleet monitoring), Memory (MemPalace + text search + memory graph), Activity (log + board + real token telemetry + observability + CI watcher), Tasks (kanban board with dependencies + status tracking), and a dedicated Schedules tab (recurring missions + adaptive heartbeat). || **Per-agent git worktrees** | 'Git isolation' toggle in Add Agent auto-provisions a dedicated worktree per agent on spawn and tears it down on kill — agents never collide on branches. || **Token & cost telemetry** | Activity tab reads `~/.claude/projects/` JSONL transcripts and surfaces real token counts + estimated USD cost per agent per session, backed by a durable cost ledger that survives restarts. || **Per-agent token budgets** | Set a token budget per agent and watch live fleet monitoring track consumption across the whole roster — paired with the cost/runaway circuit breaker to keep spend in check. |@@ -116,7 +118,9 @@ terminal/event plane, and [`DESIGN.md`](./DESIGN.md) for the visual system.| **Configurable home folder** | Point the hive/memory home at any folder, with a safe move that relocates existing state without losing it. || **Restore team** | One-click "Restore team" rebuilds last session's workers after a harness restart — no more re-adding agents by hand. || **Task kanban** | Dependency-aware kanban board in the Command Center Tasks tab — assign tasks to agents, track status across todo/doing/blocked/done, wire dependencies so work starts in order. |-| **Scheduled missions & heartbeat** | Recurring auto-dispatch missions with label, interval, target agent, and body — plus a scheduler heartbeat that re-engages the floor when it goes quiet. Delete scheduled missions inline, and see last/next-fired times in the Schedules tab. |+| **Scheduled missions & heartbeat** | Recurring auto-dispatch missions with label, interval, target agent, and body — plus a scheduler heartbeat that re-engages the floor when it goes quiet. Missions now live in their own Schedules tab with last/next-fired times. |+| **Terminal work-order handoff** | Providers without an inbox-drain hook receive hive mail as a `WORK ORDER FROM HIVE` typed into their terminal; if the renderer is unavailable, the message bounces to the GOD agent instead of disappearing. |+| **Slack/webhook ingress** | Slack and generic webhook ingress expose local endpoints through tunnelmole, so POSTs pass straight through and failed tunnels surface a real error instead of a silent broken URL. || **GitHub ingestion** | Pull open issues from any registered repo via the `gh` CLI and assign them to agents with one click from the Command Center. || **CI status watcher** | Live pass/fail/in-progress status for GitHub Actions runs, visible in the Activity tab for every registered repo. || **Threaded chat** | Every hive message is grouped by conversation and rendered as a reply chain in each agent's Messages tab — readable, replyable, auditable. |@@ -125,23 +129,22 @@ terminal/event plane, and [`DESIGN.md`](./DESIGN.md) for the visual system.| **Avatar states** | Avatars reflect real work — including new v0.2.0 states for *compacting* (context compaction) and *looping* (circuit-breaker intervention), on top of crisper HiDPI floor text and high-contrast speech bubbles. |> [!NOTE]-> **Status: v0.2.0 — observability, control, and durability.** This release brings a Command Center overhaul, per-agent token budgets with live fleet monitoring, full observability (live OpenTelemetry collector, per-model cost, fleet grid + per-agent tool-span waterfall), an agent-card context-window gauge, a cost/runaway circuit breaker (steer → constrain → stop) with a scheduler heartbeat, a human-in-the-loop gate plus mid-run steer and graceful stop via hook returns, SQLite-backed durable persistence (window bounds + history) and a durable cost ledger, the MemoryReflector for memory condensation, a configurable hive/memory home folder with safe move, one-click "Restore team" after restart, a delete button for scheduled missions, new *compacting* and *looping* avatar states, terminal legibility/contrast + HiDPI fixes, and a Windows fix to keep the hive alive behind the lock screen. All of v0.1.x — the hook plane, office floor, hive coordination, git isolation, token telemetry, task kanban, scheduled missions, GitHub/CI integration, threaded conversations, desktop notifications, agent archival, a Slack→queue bridge, and native human-in-the-loop approvals — remains functional and shipping. macOS (signed), Windows, and Linux builds are available on the releases page.+> **Status: v0.2.3 — multi-provider floor.** Claude Code, Antigravity (Gemini via `agy`), and OpenAI Codex can now work as first-class hive participants. Antigravity gets a native `agy-hook` bridge; Codex receives the hive protocol as its initial prompt and can read inbox mail / write outbox mail through provider-agnostic routing; hookless providers get terminal work-order handoff. v0.2.3 also moves recurring missions into a dedicated Schedules tab and replaces the Slack/webhook localtunnel ingress with tunnelmole. Everything from v0.2.0-v0.2.2 — observability, circuit breaker, durable persistence, context gauges, Command Center, task kanban, GitHub/CI integration, threaded conversations, desktop notifications, and agent archival — remains functional and shipping. macOS (signed), Windows, and Linux builds are available on the releases page.## Getting started### Prerequisites-- **macOS** (macOS-first; Windows/Linux untested).+- **macOS, Windows, or Linux**.- **Node.js 18+** and npm.- A **C/C++ toolchain** for `node-pty`'s native addon — on macOS, install Xcode Command Line Tools:```bashxcode-select --install```-- **[Claude Code](https://claude.com/claude-code)** on your `PATH` so agents can run `claude`- (the default command). Add Agent also includes a Codex preset that runs `codex`- without Claude-only flags; initial Codex support is terminal spawning with shared- workspace/env, not Claude telemetry, hook parity, or hive inbox delivery (direct- hive mail to Codex/custom agents bounces to the god agent).+- At least one supported terminal-agent CLI on your `PATH`: **[Claude Code](https://claude.com/claude-code)**+ (`claude`, the default command), **Antigravity** (`agy`, Gemini), or **OpenAI Codex** (`codex`).+ Claude uses native hooks, Antigravity uses the `agy-hook` bridge, and Codex participates through+ initial-prompt protocol injection plus inbox/outbox routing.- *Optional:* the semantic memory index for instant cross-session recall (the app works without it —markdown memory still functions).@@ -190,7 +193,7 @@ Two data planes feed one renderer:│ hook payloads │ stdin / stdout└─────────┬──────────────┘┌──────┴──────────────┐- │ claude (or any cmd)│+ │ claude / agy / codex│└─────────────────────┘```@@ -198,10 +201,10 @@ Two data planes feed one renderer:process and streams output over per-id IPC (`pty:data:<id>`). The renderer talks only through atyped `window.cth` bridge ([`src/preload/index.ts`](./src/preload/index.ts)), which also exposessandboxed filesystem and git helpers.-- **Hive / event plane.** `hive.ts` is the on-disk multi-agent layer; `hooks.ts` runs a Unix-socket- server that the per-agent `cth-hook` shim POSTs Claude Code hook payloads to (`PreToolUse`,- `PostToolUse`, `Stop`, …); `memory.ts` wraps the semantic memory CLI. The router delivers messages,- the GOD agent adjudicates, and a `Stop`-loop keeps idle agents draining their inboxes.+- **Hive / event plane.** `hive.ts` is the on-disk multi-agent layer; `hooks.ts` runs the hook+ server that provider bridges POST lifecycle payloads to (`cth-hook` for Claude Code, `agy-hook`+ for Antigravity). `memory.ts` wraps the semantic memory CLI. The router delivers messages, drains+ provider outboxes, the GOD agent adjudicates, and idle/inbox wakeups keep workers draining mail.## Project structure@@ -211,7 +214,7 @@ src/index.ts window, IPC handlers, quit guardpty.ts node-pty manager (spawn/write/resize/kill/stream)hive.ts on-disk multi-agent layer (memory, mailboxes, router)- hooks.ts UDS hook server + cth-hook shim + Stop-loop+ hooks.ts hook server + provider hook shims (`cth-hook`, `agy-hook`)memory.ts semantic memory layer (CLI wrapper, degrade-to-noop)config.ts harness config persistence + home setuptranscript.ts reads ~/.claude/projects/ JSONL transcripts for real token/cost telemetry@@ -221,7 +224,6 @@ src/reflect.ts MemoryReflector — memory condensationdb.ts SQLite durable store (window bounds + history) + durable cost ledgergithub.ts GitHub issue + CI run ingestion via the gh CLI- assistant.ts headless Sonnet enrichment pipeline (Dwight)shellEnv.ts resolve PATH and shell env for child processesfs.ts / git.ts sandboxed filesystem + git bridgespreload/ contextBridge → typed window.cth API@@ -233,7 +235,7 @@ src/ToolWaterfall, per-agent tool-span waterfall for the observability viewTasksKanban, dependency-aware kanban board (Tasks tab)ThreadsPanel, hive message conversation viewer (Messages tab)- MessageQueueComposer, park messages for a busy agent + enrich toggle+ MessageQueueComposer, park messages for a busy agentscene/office/ Pixi office floor: OfficeFloor, Character, Camera, cast, pathfinding, …store/ · hooks/ zustand store, event loop, PTY parser, typewriterassets/ tilesets, maps, character sheets (see ATTRIBUTION.md)@@ -252,17 +254,20 @@ chrome. The 15 avatars are the cast of *The Office*, differentiated by hair/skin## Roadmap-Shipped in **v0.2.0**:+Shipped in **v0.2.0-v0.2.3**:- [x] **Heartbeat** — scheduler heartbeat that re-engages the floor when it goes quiet, with last/next-fired times surfaced in the Schedules tab.- [x] **Memory reflection** — the MemoryReflector summarizes and bounds per-agent memory over time to prevent unbounded growth.- [x] **Persistence** — SQLite-backed durable store for window bounds + history across restarts, plus a durable cost ledger and persisted session IDs.- [x] **Hook-driven avatars** — broadened hook→station coverage and caged the synthetic demo loop, with new *compacting* and *looping* avatar states.+- [x] **Multi-provider floor** — Claude Code, Antigravity (`agy` / Gemini), and OpenAI Codex can participate in the same hive.+- [x] **Dedicated Schedules tab** — recurring missions and the adaptive heartbeat have their own Command Center tab.+- [x] **Tunnelmole ingress** — Slack and generic webhook public URLs use tunnelmole instead of localtunnel.Next up:-- [ ] **Chat integrations** — Slack and Telegram bridges that pipe a channel straight into Michael's queue (and route his replies back out), so you can run the floor from your phone.-- [ ] **Pluggable agent CLIs** — run the harness over coding-agent CLIs beyond Claude Code: Claw Code, opencode, and Codex CLI.+- [ ] **More chat integrations** — Telegram and richer chat bridges that pipe a channel straight into Michael's queue (and route his replies back out), so you can run the floor from your phone.+- [ ] **More provider CLIs** — extend the provider layer beyond Claude Code, Antigravity, and Codex.- [ ] **Realtime Michael** — a low-latency realtime LLM channel for quick, snappy back-and-forth with the orchestrator, alongside the async terminal.- [ ] **Fuller avatar coverage** — push the remaining station visits and tool-bubbles to be driven 100% by real Claude Code hook events.- [ ] **Durable layout & command history** — extend persistence to agent layout and per-session command history.diff --git a/blog/src/posts/launching-munder-difflin-v0-2-3.md b/blog/src/posts/launching-munder-difflin-v0-2-3.mdnew file mode 100644index 00000000..ebf0576e--- /dev/null+++ b/blog/src/posts/launching-munder-difflin-v0-2-3.md@@ -0,0 +1,125 @@+---+title: "Launching Munder Difflin v0.2.3"+description: "Munder Difflin v0.2.3 makes the floor multi-provider: Claude Code, Antigravity (Gemini), and OpenAI Codex can now work as first-class hive participants."+date: 2026-06-09+category: story+categoryLabel: Story+type: Non-technical+primaryKeyword: "munder difflin v0.2.3"+secondaryKeywords: ["munder difflin release", "multi-provider agents", "antigravity gemini agents", "codex hive agents"]+tags: ["Story", "Release", "Multi-Agent", "Claude Code", "Codex", "Open Source"]+author:+ name: Chaitanya Giri+ initials: CG+faq:+ - q: "What's new in Munder Difflin v0.2.3?"+ a: "v0.2.3 is the multi-provider release. The floor is no longer Claude-only: Claude Code, Antigravity (Gemini via agy), and OpenAI Codex can work as hive participants. It also moves recurring missions into a dedicated Schedules tab, adds terminal work-order handoff for hookless providers, and replaces localtunnel with tunnelmole for Slack and webhook ingress."+ - q: "Can Antigravity agents participate in the hive?"+ a: "Yes. Antigravity workers run through the agy CLI. Because agy does not expose Claude-style append-system-prompt or settings hooks, Munder Difflin injects the hive identity and protocol as the initial prompt and uses a native agy-hook bridge to normalize lifecycle events into the existing hook pipeline."+ - q: "Can Codex agents read inbox mail and message back?"+ a: "Yes. In v0.2.3, Codex receives the hive protocol as its initial prompt, outbox messages are drained by the provider-agnostic router, and inbox mail reaches Codex through the renderer idle inbox-wake nudge."+ - q: "Why did Slack and webhook ingress move to tunnelmole?"+ a: "The previous localtunnel/loca.lt ingress started serving a browser interstitial that broke Slack URL verification and saved webhook URLs. v0.2.3 uses tunnelmole, where POST requests pass straight through, and failed tunnel startup now surfaces as a real error."+---++<div class="callout tldr"><span class="ic">TL;DR</span><p><strong>Munder Difflin v0.2.3</strong> makes the+floor <strong>multi-provider</strong>. Claude Code is still first-class, and now <strong>Antigravity</strong>+(Gemini through <code>agy</code>) and <strong>OpenAI Codex</strong> can join the same hive as working agents.+Schedules get their own Command-Center tab, hookless providers receive terminal <strong>WORK ORDER FROM HIVE</strong>+handoffs, and Slack/webhook ingress moves from localtunnel to <strong>tunnelmole</strong>.</p></div>++Munder Difflin started as a local harness for Claude Code agents. The core idea was not "run one terminal with+a nicer frame." It was: give terminal agents a shared memory, mailboxes, a router, and one GOD orchestrator you+can talk to while the team keeps working.++In v0.2.3, that idea stops being Claude-only.++The floor is now **multi-provider**. Claude Code, Antigravity, and Codex workers can sit in the same office,+receive work from the same hive, and report back through the same coordination layer. The implementation details+are different for each provider, because their CLIs expose different control surfaces. The user-facing result is+the important part: your agent team no longer has to be one model family wearing different names.++## The floor is multi-provider++The headline change is first-class **Antigravity** support. A worker can now run the Antigravity CLI (`agy`) as+a full hive participant, backed by Gemini and your Antigravity subscription rather than a separate API key.++Antigravity does not provide the same hooks Claude Code does. There is no Claude-style `--append-system-prompt`+or `--settings` hook path to lean on. So v0.2.3 takes a provider-specific route:++- the agent's hive identity and protocol are injected as the session's initial prompt;+- a native `agy-hook` bridge normalizes Antigravity lifecycle events into the existing hook pipeline;+- the worker gets the same live status and inbox-drain behavior as a Claude worker.++That means Antigravity can participate in the hive instead of living beside it as a generic terminal.++## Codex can message back++Codex support also crosses an important line in this release.++Before v0.2.3, a Codex terminal could spawn, but it did not really know the hive protocol. It did not reliably+read inbox mail or write outbox messages, which meant it was present on the floor without being a proper+collaborator.++Now Codex is treated as an inbox-capable provider:++- the hive protocol is injected as its initial positional prompt;+- its outbox is drained by the provider-agnostic router;+- inbox mail reaches it through the renderer's idle inbox-wake nudge.++The release notes describe this as "non-hive-aware-but-inbox-capable," which is the useful distinction. Codex+does not need Claude's hook model to become useful in the office. It needs a reliable protocol handoff and a+path for mail to reach the terminal when it is idle.++## Terminal work orders for hookless providers++Different CLIs expose different lifecycle hooks. v0.2.3 adds a practical fallback for providers that do not have+an inbox-drain path: the hive can type a terminal work order directly into the session.++When mail arrives for one of those agents, it receives a clear `WORK ORDER FROM HIVE` in its terminal. If the+renderer is not available, Munder Difflin falls back to bouncing the message to the GOD agent instead of silently+dropping it.++This is not as elegant as a native hook. It is better: it is honest about the provider's control surface and still+keeps the agent in the team.++## Schedules get their own tab++Recurring missions have been part of the system for a while: you can ask the floor to run a task every hour,+re-engage a quiet team, or keep a reviewer checking in. In v0.2.3, those missions move into a dedicated+**Schedules** tab in the Command Center.++That tab now owns recurring auto-dispatched missions and the adaptive heartbeat, instead of hiding them inside+an inline section. The change is small in code surface and large in day-to-day use: schedules are no longer a+secondary control. They are one of the main ways you run a persistent agent office.++## Slack and webhooks move to tunnelmole++The release also fixes a boring but important ingress problem.++Slack and generic webhook ingress used `localtunnel` / `loca.lt`. That path became unreliable because the public+tunnel now serves a browser interstitial. Browser interstitials are fatal for machine-to-machine POSTs: Slack's+`url_verification` request fails, and saved webhook URLs break even when the app thinks the tunnel started.++v0.2.3 moves both `slack.ts` and `webhook.ts` to **tunnelmole**. POSTs pass straight through, and if the tunnel+fails to start, the app surfaces a real error instead of pretending there is a usable public URL.++## What this release means++The v0.2.x line has been about making the floor durable enough to trust: observability, schedules, persistence,+context gauges, circuit breakers, and polish. v0.2.3 widens the actual team.++You can keep Claude Code as the orchestrator and add an Antigravity worker. You can bring Codex into the same+mailbox and memory loop. You can schedule work that lands in whichever provider makes sense. And when an outside+system sends work into the office through Slack or a webhook, the ingress path is less fragile.++The important part is not that every provider behaves identically. They do not. The important part is that the+hive now has provider-specific handoffs that make each one useful without pretending their CLIs are the same.++## Get v0.2.3++Munder Difflin is free, open source, and local-first on macOS, Windows, and Linux. Download v0.2.3 from the+[releases page](https://github.com/chaitanyagiri/munder-difflin/releases/latest), install the CLIs you want on+your `PATH` (`claude`, `agy`, and/or `codex`), and add them to the floor as workers.++Full release notes are in the [CHANGELOG](https://github.com/chaitanyagiri/munder-difflin/blob/main/CHANGELOG.md).