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.3.4 — changelog, release notes, landing REL fallback, version bump
Chaitanya Girif68af8eea07e
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 4609836b..b795ed7c 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -4,21 +4,51 @@ All notable changes to this project are documented here. The format is based on[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to[Semantic Versioning](https://semver.org/spec/v2.0.0.html).-## [Unreleased]--Terminal reliability: the blank pane and the message queue that silently stopped-delivering are both fixed, and fullscreen gets a proper agent roster.+## [0.3.4] — 2026-08-06++**The queue you can trust, two new engines, and an app that updates itself.** A community+release: the headline terminal/queue/roster reliability wave is by+[@gts-47](https://github.com/gts-47) (Vyapak Goyal), with major fixes by+[@qschmick](https://github.com/qschmick) ([#110](https://github.com/chaitanyagiri/munder-difflin/pull/110),+[#111](https://github.com/chaitanyagiri/munder-difflin/pull/111),+[#112](https://github.com/chaitanyagiri/munder-difflin/pull/112),+[#114](https://github.com/chaitanyagiri/munder-difflin/pull/114)). Plus **xAI Grok and Kimi+Code as first-class engines**, **auto-update from GitHub releases**, and a **scheduled+auto-compact switch (default off)**.### Added+- **Auto-update.** Packaged builds check GitHub releases on boot and every ~6 hours, download the new+ version in the background, and show a small "restart to update" toast — installation is always your+ click; the app never restarts on its own. Installs that can't self-update (the Windows portable exe)+ get a notify-only toast linking the release page. Settings → General → **Auto-update** turns the+ whole thing off. (Auto-update starts working for users **on 0.3.4+**; 0.3.3 and earlier have no+ updater — grab this release from the site once more.)+- **xAI Grok, a first-class agent engine** (`grok`) — worker *and* orchestrator-eligible. Grok's+ lifecycle events are Claude-compatible but camelCase on the wire; an AGENT_ID-scoped hook adapter+ (`installGrokHooks`) normalizes them into the hive's contract, so live status, guarded inbox+ delivery, and operator gates all work. `grok [PROMPT]` takes the protocol positionally and+ `--resume` continues a session. *(gts-47)*+- **Kimi Code engine** (`kimi`) — spawn Kimi workers with `--auto` autonomy and the K3/K2.7 model+ aliases. No hook bridge yet, so routed mail bounces to the god rather than silently dropping. *(gts-47)*+- **Scheduled auto-compact switch — default OFF.** The dedicated compact-maintenance schedule (v0.3.2)+ now ships disabled: scheduled `/compact` is opt-in. Flip it in Settings → General → **Scheduled+ auto-compact** or the Schedules tab (which keeps its interval picker and its warning when off).+ Existing installs keep whatever state they already chose. Scheduled compaction is now also+ **provider-aware** — each engine gets its own compact command instead of Claude's only. *(founder decision + gts-47)*- **Fullscreen agent roster rail.** The horizontal tab bar ran out of room past a handful of agents and hid the operator controls; it's replaced by a left rail — `+ agent` pinned at the top, god agents ungrouped above everything, workers bucketed under repository headers, restore-team and its dismiss chips pinned at the bottom. An isolated agent's cwd is its own git worktree, so a new `mainRepoRoot` helper follows a linked worktree back to its main checkout (cached per cwd) and groups key on the absolute repo root, so two checkouts with the same name stay separate. Notes render on the row (one line per bullet) instead of behind a hover popover, the note editor becomes a textarea so Enter makes a new bullet instead of dropping every bullet but the first, pause/halt/steer come back in fullscreen, god agents render the full Command Center, and drag-to-reorder carries over (confined to an agent's own repository group). The destructive kill button is gone.- **`typing` badge — see why a queue is held.** A message queue held by your own unsent text on an agent's prompt used to look identical to an idle agent with nothing to do. Agent cards and the fullscreen roster now show a **"your draft"** badge whenever you have unsubmitted text on that agent's prompt. It's derived at render from the same check the delivery gate uses, so the badge can never disagree with the reason nothing is being delivered.- **[`docs/message-queue.md`](./docs/message-queue.md)** — the delivery contract: who may type into an agent's terminal, when, and what automation is never allowed to do to your text.+- **Remote Control sessions are named after the agent** ([#81](https://github.com/chaitanyagiri/munder-difflin/pull/81)). claude.ai / the mobile app now shows "Michael", "Jim", … instead of `<hostname>-<random>`, so a floor full of RC sessions is finally tellable-apart. *(gts-47)*+- **Roster shared between dev and a packaged build.** The roster (agents + notes + queues + selection) mirrors to a file beside the hive (`src/main/roster.ts`), so the dev build and the installed app see the same team; localStorage remains the per-origin fallback. Restore-team also runs **in parallel**, fires **on open**, and each restorable agent gets its own ✕ dismiss. *(gts-47)*+- **Fable 5 + Sonnet 5** in the Claude model picker (Fable 5 is the new default model). The two "default" entries — the harness's configured default vs the CLI's own — are now labeled distinctly in every picker, and every Claude option names a real model. *(gts-47)*+- **New test suites** — queue delivery, terminal automation + recovery, roster persistence, provider config/automation, codex remote, agent env, and PID release (`npm run test:focused` + `test/proc-kill.test.cjs`). *(gts-47, qschmick)*### Changed- **One gate for every automatic writer.** The queue kept breaking because two loops each decided for themselves when it was safe to type into a terminal. The inbox-wake nudge now enqueues like scheduled `/compact` already did, so a single drain loop owns every "is this terminal free?" decision — idle, off cooldown, past boot grace, delivery not paused, no user draft in the way.- **Automation never destroys or closes what you own.** A draft block lasts half an hour rather than a minute, a picker block half an hour rather than three minutes, and when either expires delivery simply types *after* whatever is on the line (the two fuse into one prompt). Wiping the line first, and sending Escape at an open picker, are both gone — deleting text is worse than garbling one prompt, and we can't verify that Escape closed anything. Both keys remain on the composer's own button, where you asked for them.- **Terminal zoom scales the whole pane.** Cmd +/- moved out of `PtyTerminalView` into a shared subscribable module, so it now scales the message composer and the roster along with the terminal instead of leaving them pinned at sizes tuned for a 14" display.-- **Changing an agent's model within the same provider resumes its session** instead of starting fresh (best-effort — an agent with no recorded session still gets its model changed).+- **Changing an agent's model within the same provider resumes its session** instead of starting fresh (best-effort — an agent with no recorded session still gets its model changed). The Command Center picker is now **cross-provider** (switch an agent between engines from one dropdown).+- **Codex resume actually resumes.** Codex has no `--resume` flag — it resumes via the `codex resume` subcommand — and its rollout transcript + sqlite index live together in a per-agent `CODEX_HOME`. Respawns now use the subcommand, and resuming by a pasted session id points `CODEX_HOME` at the agent home whose state DB actually indexes that session (a stray rollout copy without an index can't be opened). Codex workers also get **Codex Remote**: the app-server daemon is started under the agent's isolated home so the thread shows up in ChatGPT mobile. *(gts-47)*- **Restore team runs in parallel** and the login-shell capture is memoised, so rebuilding a roster no longer serialises one shell probe per agent. Agents are added in roster order rather than completion order.### Fixed@@ -28,6 +58,14 @@ delivering are both fixed, and fullscreen gets a proper agent roster.- **A queued message could be typed into an open picker and acked as delivered.** Clearing the input line no longer clears the picker latch — Ctrl-U kills the input line, it does not close a menu — so automation is no longer told the prompt is free while a picker still owns it.- **A model or command change died on reload.** `updateAgent` now persists when a durable field changes (volatile run-state fields — status, action, progress, context counters — still skip the write, so a burst of terminal output doesn't rewrite storage).- **The roster stopped spawning `git rev-parse` on every chunk of terminal output** — failed and in-flight repo lookups are cached, so an agent outside a repo is looked up once.+- **Killed processes actually die** ([#110](https://github.com/chaitanyagiri/munder-difflin/pull/110)). Every explicit kill was a bare node-pty `proc.kill()` — one SIGHUP to the direct child only, so a TUI that traps SIGHUP lived on and its children (MCP servers, helper daemons) reparented to PID 1 and kept running for the machine's uptime. Every kill path now routes through `ensureKilled`: a grace signal, then SIGKILL of the whole process group (POSIX) / `taskkill /T /F` (Windows). *(qschmick)*+- **Circuit-breaker false-positive storm on idle/compacting agents** ([#109](https://github.com/chaitanyagiri/munder-difflin/issues/109) → [#112](https://github.com/chaitanyagiri/munder-difflin/pull/112)). Compaction and inbox-ack token bursts no longer read as looping. *(qschmick)*+- **Shell-capture fencing.** The interactive login shell used for PATH/`which` capture runs the user's rc files, which are free to print (zsh's "Restored session: …" plugin chatter was being prepended to every agent's PATH). Capture output is now fenced between markers, with a multi-line sanity check before a PATH is trusted. *(gts-47)*+- **Fullscreen surfaces notes and modals** (they stacked under the overlay); **an un-echoed keystroke no longer reads as an empty prompt**; **expired automation blocks are acted on** instead of typed through. *(gts-47)*++### Performance+- **~350× faster warm usage reads** — an incremental per-file transcript cache replaces re-reading every transcript on each poll ([#111](https://github.com/chaitanyagiri/munder-difflin/pull/111)). *(qschmick)*+- **Spawns stopped freezing the app.** Command resolution is memoized (with on-disk revalidation) and the login-shell PATH is captured once per session — each interactive-shell launch cost ~1s of blocked main thread, paid twice per spawn, ×N on a team restore ([#114](https://github.com/chaitanyagiri/munder-difflin/pull/114) + gts-47's equivalent, merged). *(qschmick + gts-47)*## [0.3.3] — 2026-07-03diff --git a/RELEASE.md b/RELEASE.mdindex bdb6e35b..4f7cb048 100644--- a/RELEASE.md+++ b/RELEASE.md@@ -1,12 +1,56 @@-# Munder Difflin v0.3.3+# Munder Difflin v0.3.4-**A local hive of Claude Code, Antigravity, Codex & Copilot agents that run themselves** — messaging,+**A local hive of Claude Code, Antigravity, Codex, Grok & Copilot 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.3.4 — *The queue you can trust, two new engines & auto-update*++**A community release.** The headline terminal/queue reliability wave is by+[**@gts-47**](https://github.com/gts-47) (Vyapak Goyal), with major fixes by+[**@qschmick**](https://github.com/qschmick).++- **Auto-update.** The app now checks GitHub releases, downloads the new version in the background,+ and offers a **"restart to update"** toast — installation is always your click; nothing restarts on+ its own. Toggle in Settings → General. (Starts working for installs **on 0.3.4+** — grab this one+ from the site once more.)+- **One delivery gate for every automatic writer.** The message queue kept breaking because multiple+ loops each decided when it was safe to type into a terminal. Now a single drain loop owns that+ decision — and automation **never wipes your draft or closes your menus**: a user draft or open+ picker holds delivery (visible as a new **"your draft"** badge), and expired blocks type *after*+ your text instead of over it. The full contract is written down in+ [`docs/message-queue.md`](https://github.com/chaitanyagiri/munder-difflin/blob/main/docs/message-queue.md). *(gts-47)*+- **Blank-terminal pane fixed at all three roots** — WebGL contexts are leased per attached terminal+ (Chromium silently kills the oldest past ~16 live contexts, which is exactly what a big+ restore-team did), the initial-redraw latch only arms on success, and the repaint marker survives a+ failed refresh. *(gts-47)*+- **xAI Grok + Kimi Code join the engine roster** — Grok as a full hive citizen (lifecycle-hook+ adapter, guarded inbox delivery, `--resume`), Kimi as a worker engine. Plus **Fable 5 and+ Sonnet 5** in the Claude picker (Fable 5 is the new default), and the two "default" entries are+ finally tellable-apart. *(gts-47)*+- **A fullscreen agent roster rail** — repo-grouped (worktree-aware), inline notes, drag-to-reorder,+ restore-team built in; **Remote Control sessions are named after the agent**; the **roster is+ shared between dev and packaged builds**; restore-team runs in parallel and on open. *(gts-47)*+- **Codex resume actually resumes** (subcommand + session-owner `CODEX_HOME` detection) and Codex+ workers get **Codex Remote** — threads visible in ChatGPT mobile. *(gts-47)*+- **Killed processes actually die** — every kill path escalates to a process-group kill, so trapped+ SIGHUPs and reparented MCP servers no longer leak PIDs+ ([#110](https://github.com/chaitanyagiri/munder-difflin/pull/110), qschmick). Also from qschmick:+ the **breaker false-positive storm on idle/compacting agents** is gone+ ([#112](https://github.com/chaitanyagiri/munder-difflin/pull/112)), warm usage reads are **~350×+ faster** ([#111](https://github.com/chaitanyagiri/munder-difflin/pull/111)), and spawns no longer+ freeze the app ([#114](https://github.com/chaitanyagiri/munder-difflin/pull/114)).+- **Scheduled auto-compact is now opt-in (default OFF)** with a switch in Settings → General and the+ Schedules tab — and it's provider-aware when on.++Full details in the+[CHANGELOG](https://github.com/chaitanyagiri/munder-difflin/blob/main/CHANGELOG.md).++---+## What's new in 0.3.3 — *A built-in Monaco IDE + GitHub Copilot CLI***Read your agents' work where it happens.** The title bar gains an **IDE** button that opens adiff --git a/docs/index.html b/docs/index.htmlindex f9009566..5197f0e1 100644--- a/docs/index.html+++ b/docs/index.html@@ -1677,7 +1677,7 @@// download picker — pick macOS / Windows / Linux, click starts the download(function () {var REPO = 'chaitanyagiri/munder-difflin';- var REL = '0.3.3'; // fallback version; live links are resolved from the GitHub API below+ var REL = '0.3.4'; // fallback version; live links are resolved from the GitHub API belowvar BASE = 'https://github.com/' + REPO + '/releases/latest/download/';var PLATFORMS = [{ key: 'mac', icon: '🍎', os: 'macOS', sub: 'Universal · Apple Silicon + Intel', match: 'mac-universal.dmg', file: 'Munder-Difflin-' + REL + '-mac-universal.dmg' },diff --git a/package.json b/package.jsonindex e9d1d1b3..c3be1bc4 100644--- a/package.json+++ b/package.json@@ -1,6 +1,6 @@{"name": "munder-difflin",- "version": "0.3.3",+ "version": "0.3.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",