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
release: v0.2.4 — Codex full hive parity, terminal-default sidebar, resilience
Chaitanya Giri39306df3e483
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 256fd6f5..f931d485 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -6,6 +6,25 @@ All notable changes to this project are documented here. The format is based on## [Unreleased]+## [0.2.4] — 2026-06-09++A multi-provider patch: Codex graduates to **full hive parity** via a native+lifecycle-hook bridge, the god orchestrator opens to its terminal by default, and a+handful of resilience fixes land.++### Added+- **Codex lifecycle-hook bridge — full hive parity.** Codex now joins the hive as a first-class, hive-aware provider: a native lifecycle-hook bridge maps Codex's events into the existing hook pipeline (live status + inbox-drain + outbox routing), and agy/codex dispatch is unified behind one path. Verified running hive-aware in bypass-permissions mode. (#47, #54)+- **Codex hook discovery via `config.toml [hooks]`.** The bridge registers through Codex's `config.toml [hooks]` surface rather than a bare `hooks.json`, matching how Codex actually discovers lifecycle hooks.++### Changed+- **God orchestrator opens to the Terminal sidebar by default.** Selecting the god agent no longer reopens a stale "ASK ME" tab — a leftover command-center tab request is cleared on select, so the panel mounts to its terminal default. The ASK ME tab is still one click away.+- **Landing + blog refreshed for multi-provider.** The landing page now presents Claude Code, Antigravity (Gemini), and OpenAI Codex as equal first-class providers (with a one-line mobile-friendly badge), and a grand v0.2.4 launch post + technical walkthrough replace the v0.2.3 posts.++### Fixed+- **Slack/webhook tunnel no longer crashes at load.** `tunnelmole` is ESM-only; a static `import` in the CommonJS-bundled Electron main process threw `ERR_REQUIRE_ESM`. It's now loaded via a dynamic `import()` inside `openTunnel()`, so the public ingress actually starts.+- **Heartbeat re-engages the god on an unread actionable inbox** — not only when the floor is quiet — so worker/human mail is drained promptly.+- **Slack done-summary stops retrying on terminal errors.** A permanently-failing post (e.g. the bot token missing `chat:write` → `missing_scope`) is now recorded and logged once instead of retrying every 5s and flooding the console; transient errors still retry.+## [0.2.3] — 2026-06-09A multi-provider release: the floor is no longer Claude-only. Antigravity (Gemini)diff --git a/RELEASE.md b/RELEASE.mdindex 3260de95..5ac59550 100644--- a/RELEASE.md+++ b/RELEASE.md@@ -1,26 +1,24 @@-# Munder Difflin v0.2.3+# Munder Difflin v0.2.4-**A local hive of Claude Code agents that run themselves** — messaging, routing, and-remembering, coordinated by a GOD orchestrator you talk to. Local-first and open source.+**A local hive of Claude Code, Antigravity & Codex agents that run themselves** — messaging,+routing, and remembering, coordinated by a GOD orchestrator you talk to. Local-first and open source.### → [**munderdiffl.in**](https://munderdiffl.in/) — see it in action, then grab a build below----## What's new in 0.2.3 — *multi-provider*+## What's new in 0.2.4 — *Codex gets full hive parity*-The floor is no longer Claude-only. Antigravity (Gemini) and Codex workers become-first-class hive participants, schedules get their own tab, and the Slack / webhook-ingress moves off the flaky public tunnel:+Three CLIs, one hive. v0.2.4 promotes **Codex** to a first-class, hive-aware participant+and polishes the orchestrator's first impression:-- **First-class Antigravity (Gemini · `agy`) provider** — run an Antigravity worker as a full hive participant. Since `agy` has no Claude-style hooks, the hive identity + protocol ride in as the session's initial prompt, and a native `agy-hook` bridge maps Antigravity's lifecycle events into the existing pipeline, so a Gemini worker gets the same live status + inbox-drain as Claude — on the subscription, no API key. (#54)-- **Codex workers follow the protocol and message back** — Codex spawned without the hive protocol or any hook, so it never read its inbox or wrote its outbox. Codex is now an inbox-capable provider: the protocol is injected as its initial prompt, its outbox is drained by the router, and inbox mail reaches it via the idle inbox-wake nudge. Codex and Antigravity coexist in the provider union. (#47, #54)-- **Schedules get their own Command-Center tab** — recurring auto-dispatched missions (and the adaptive heartbeat) move out of an inline section into a dedicated tab, with a boss-room calendar shortcut. (#50)-- **Terminal work-order handoff for hookless providers** — a provider with no inbox-drain path now receives hive mail as a `WORK ORDER FROM HIVE` typed into its terminal, falling back to a god-bounce only if the renderer is unavailable. (#53)-- **Slack + webhook public URL no longer silently breaks** — the ingress used loca.lt, which now serves a browser interstitial that fails Slack's URL verification and breaks saved webhook URLs. Both now use **tunnelmole** (MIT; POSTs pass straight through), and a failed tunnel surfaces a real error instead of a silent "started."+- **Codex lifecycle-hook bridge — full hive parity** — Codex now joins the floor as a fully hive-aware provider. A native lifecycle-hook bridge maps Codex's events into the existing hook pipeline (live status + inbox-drain + outbox routing), discovered through Codex's `config.toml [hooks]` surface, with agy/codex dispatch unified behind one path. Verified running hive-aware in bypass-permissions mode. (#47, #54)+- **God opens to its Terminal by default** — selecting the orchestrator no longer reopens a stale "ASK ME" tab; the command center mounts to its terminal, with ASK ME one click away.+- **Multi-provider landing & launch** — the site now presents Claude Code, Antigravity (Gemini), and OpenAI Codex as equal first-class providers (one-line mobile badge), with a fresh v0.2.4 launch post + technical walkthrough.+- **Resilience fixes** — the heartbeat re-engages the god the moment actionable mail lands (not only on a quiet floor), and the Slack done-summary no longer retries forever on a terminal error (e.g. a bot token missing `chat:write`) — it records + logs once instead of flooding the console.-Everything from **v0.2.0** (observability, control, the rebuilt Command Center, persistence),-**v0.2.1** (gentler scheduling), and **v0.2.2** (community polish) is included.+Everything from **v0.2.3** (first-class Antigravity, Codex inbox support, Schedules tab,+terminal work-orders, tunnelmole ingress) and earlier is included.See the [CHANGELOG](https://github.com/chaitanyagiri/munder-difflin/blob/main/CHANGELOG.md) for full detail.---@@ -33,22 +31,22 @@ Apple Silicon and Intel.### 🍎 macOS| Build | File ||---|---|-| Universal (Apple Silicon + Intel) | [`Munder-Difflin-0.2.3-mac-universal.dmg`](https://github.com/chaitanyagiri/munder-difflin/releases/latest/download/Munder-Difflin-0.2.3-mac-universal.dmg) |+| Universal (Apple Silicon + Intel) | [`Munder-Difflin-0.2.4-mac-universal.dmg`](https://github.com/chaitanyagiri/munder-difflin/releases/latest/download/Munder-Difflin-0.2.4-mac-universal.dmg) |### 🪟 Windows| Build | File ||---|---|-| Installer (x64) — *recommended* | [`Munder-Difflin-0.2.3-win-x64-setup.exe`](https://github.com/chaitanyagiri/munder-difflin/releases/latest/download/Munder-Difflin-0.2.3-win-x64-setup.exe) |-| Portable (x64, no install) | [`Munder-Difflin-0.2.3-win-x64-portable.exe`](https://github.com/chaitanyagiri/munder-difflin/releases/latest/download/Munder-Difflin-0.2.3-win-x64-portable.exe) |+| Installer (x64) — *recommended* | [`Munder-Difflin-0.2.4-win-x64-setup.exe`](https://github.com/chaitanyagiri/munder-difflin/releases/latest/download/Munder-Difflin-0.2.4-win-x64-setup.exe) |+| Portable (x64, no install) | [`Munder-Difflin-0.2.4-win-x64-portable.exe`](https://github.com/chaitanyagiri/munder-difflin/releases/latest/download/Munder-Difflin-0.2.4-win-x64-portable.exe) |### 🐧 Linux| Build | File ||---|---|-| AppImage (x86_64) | [`Munder-Difflin-0.2.3-linux-x86_64.AppImage`](https://github.com/chaitanyagiri/munder-difflin/releases/latest/download/Munder-Difflin-0.2.3-linux-x86_64.AppImage) |+| AppImage (x86_64) | [`Munder-Difflin-0.2.4-linux-x86_64.AppImage`](https://github.com/chaitanyagiri/munder-difflin/releases/latest/download/Munder-Difflin-0.2.4-linux-x86_64.AppImage) |### 📦 Source-[Source code (zip)](https://github.com/chaitanyagiri/munder-difflin/archive/refs/tags/v0.2.3.zip) ·-[Source code (tar.gz)](https://github.com/chaitanyagiri/munder-difflin/archive/refs/tags/v0.2.3.tar.gz)+[Source code (zip)](https://github.com/chaitanyagiri/munder-difflin/archive/refs/tags/v0.2.4.zip) ·+[Source code (tar.gz)](https://github.com/chaitanyagiri/munder-difflin/archive/refs/tags/v0.2.4.tar.gz)> **Verify your download:** [`SHA256SUMS.txt`](https://github.com/chaitanyagiri/munder-difflin/releases/latest/download/SHA256SUMS.txt) — then `shasum -a 256 -c SHA256SUMS.txt` (macOS/Linux) or `Get-FileHash` (Windows).diff --git a/package.json b/package.jsonindex 68baf835..a2840d4f 100644--- a/package.json+++ b/package.json@@ -1,6 +1,6 @@{"name": "munder-difflin",- "version": "0.2.3",+ "version": "0.2.4","private": true,"description": "Local multi-agent harness for Claude Code: autonomous agents that message, route, and remember — coordinated by a GOD orchestrator and visualized as avatars at work.","main": "out/main/index.js",diff --git a/src/main/index.ts b/src/main/index.tsindex 9ac34012..793ca570 100644--- a/src/main/index.ts+++ b/src/main/index.ts@@ -591,6 +591,16 @@ function persistSlackDoneNotified(set: Set<string>): void {catch (e) { console.error('[slack] could not persist done-notify ledger:', e); }}+/** Slack `chat.postMessage` errors that are permanent for this config — retrying+ * can never make them succeed, so a failed post with one of these is recorded+ * (not retried) to avoid flooding the log every 5s. Anything else is treated as+ * transient and left to retry. */+const TERMINAL_SLACK_ERRORS = new Set<string>([+ 'missing_scope', 'invalid_auth', 'not_authed', 'account_inactive',+ 'token_revoked', 'token_expired', 'no_permission', 'channel_not_found',+ 'not_in_channel', 'is_archived', 'restricted_action', 'org_login_required',+]);+/** The single in-thread summary for a finished task. Sourced from the task's* result/description (falling back to the title), trimmed Slack-friendly. */function slackDoneSummary(task: HiveTask): string {@@ -636,10 +646,18 @@ async function pollSlackDoneTasks(): Promise<void> {if (res.ok) {notified.add(t.id);persistSlackDoneNotified(notified); // mark-on-success → exactly one delivered reply+ } else if (res.error && TERMINAL_SLACK_ERRORS.has(res.error)) {+ // A permanent config/auth error (e.g. the bot token lacks `chat:write`)+ // will NEVER succeed — record the id so we stop hammering every tick, and+ // log the reason once. Never log the token or message body.+ notified.add(t.id);+ persistSlackDoneNotified(notified);+ console.error('[slack] done-summary post for task', t.id,+ '— giving up (terminal error:', res.error + '). Fix the Slack bot scope/permissions; later tasks post once resolved.');} else {- // Genuinely undelivered → leave unmarked so a later tick retries. Log- // the id + error only; never the token or message body.- console.error('[slack] done-summary post failed for task', t.id, '-', res.error);+ // Transient (network / rate-limit / unknown) → leave unmarked so a later+ // tick retries. Log the id + error only; never the token or message body.+ console.error('[slack] done-summary post failed for task', t.id, '-', res.error, '(will retry)');}}} finally {diff --git a/src/main/slack.ts b/src/main/slack.tsindex 53de80d0..4893e07b 100644--- a/src/main/slack.ts+++ b/src/main/slack.ts@@ -21,7 +21,11 @@import { createServer, type IncomingMessage, type Server, type ServerResponse } from 'node:http';import { request as httpsRequest } from 'node:https';import { createHmac, timingSafeEqual } from 'node:crypto';-import { tunnelmole } from 'tunnelmole';+// NOTE: `tunnelmole` is an ESM-only package. The Electron main process is bundled+// as CommonJS, so a static `import` gets externalized into `require('tunnelmole')`+// and throws ERR_REQUIRE_ESM at load. It is imported dynamically inside+// `openTunnel()` instead — Rollup preserves dynamic import() in CJS output, which+// can load ESM. Do not hoist this back to a top-level import.export interface SlackWebhookServerOptions {/** Local TCP port the HTTP server binds to (and the tunnel forwards to). */@@ -118,8 +122,10 @@ export class SlackWebhookServer {});}- private openTunnel(): Promise<string> {+ private async openTunnel(): Promise<string> {// TODO: optional persistent domain — pass `domain` here when config carries one.+ // Dynamic import keeps the ESM-only `tunnelmole` out of the CJS require graph.+ const { tunnelmole } = await import('tunnelmole');return new Promise<string>((resolve, reject) => {const timer = setTimeout(() => reject(new Error('timed out')), TUNNEL_START_TIMEOUT_MS);tunnelmole({ port: this.port })diff --git a/src/main/webhook.ts b/src/main/webhook.tsindex dba6d150..14d8c3e4 100644--- a/src/main/webhook.ts+++ b/src/main/webhook.ts@@ -29,7 +29,11 @@*/import { createServer, type IncomingMessage, type Server, type ServerResponse } from 'node:http';import { timingSafeEqual } from 'node:crypto';-import { tunnelmole } from 'tunnelmole';+// NOTE: `tunnelmole` is an ESM-only package. The Electron main process is bundled+// as CommonJS, so a static `import` gets externalized into `require('tunnelmole')`+// and throws ERR_REQUIRE_ESM at load. It is imported dynamically inside+// `openTunnel()` instead — Rollup preserves dynamic import() in CJS output, which+// can load ESM. Do not hoist this back to a top-level import./** The validated body of an accepted POST — just the work to do. The secret has* already been verified and is intentionally NOT part of this shape, so it can@@ -142,8 +146,10 @@ export class WebhookServer {});}- private openTunnel(): Promise<string> {+ private async openTunnel(): Promise<string> {// TODO: optional persistent domain — pass `domain` here when config carries one.+ // Dynamic import keeps the ESM-only `tunnelmole` out of the CJS require graph.+ const { tunnelmole } = await import('tunnelmole');return new Promise<string>((resolve, reject) => {const timer = setTimeout(() => reject(new Error('timed out')), TUNNEL_START_TIMEOUT_MS);tunnelmole({ port: this.port })