Skip to content

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

release: v0.2.4 — Codex full hive parity, terminal-default sidebar, resilience

Chaitanya Giri39306df3e483
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 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-09
A multi-provider release: the floor is no longer Claude-only. Antigravity (Gemini)
diff --git a/RELEASE.md b/RELEASE.md
index 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.json
index 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.ts
index 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.ts
index 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.ts
index 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 })