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

docs(readme): 0.5.3, Cancel your Granola and Whispr subscriptions

chaitanyagiri4e423fc2981b
diff --git a/README.md b/README.md
index a717a50d..32f3053c 100644
--- a/README.md
+++ b/README.md
@@ -13,14 +13,14 @@
<img src="./docs/media/floor.png" alt="The Munder Difflin office floor: agents at desks working in parallel, with the Command Center and a live agent terminal on the right" width="1240">
-**Free, open source and performant** — a multi-agent harness that works with the
+**Free, open source and performant.** A multi-agent harness that works with the
subscriptions you already pay for, on their hourly limits. It turns the terminal coding CLI
you already run into a clone of you, one that keeps working while you're away and
coordinates a whole office of agents on your own machine.
Wraps [Claude Code](https://claude.com/claude-code), Antigravity (Gemini), OpenAI Codex,
**xAI Grok**, **Kimi Code**, **Gemini CLI**, **Qwen**, **OpenCode**, **Crush**,
-**pi.dev**, **GitHub Copilot CLI**, and **Cursor** — with bring-your-own keys and local LLMs.
+**pi.dev**, **GitHub Copilot CLI**, and **Cursor**, with bring-your-own keys and local LLMs.
Agents that message, route, and remember, coordinated by **your clone** (Michael) and
visualized as avatars at work on a shared office floor.
@@ -30,7 +30,10 @@ visualized as avatars at work on a shared office floor.
<p>
<a href="./LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-F4D35E.svg?style=flat-square&labelColor=6E1423"></a>
- <a href="./CHANGELOG.md"><img alt="Version: 0.4.6" src="https://img.shields.io/badge/version-0.4.6-F4D35E.svg?style=flat-square&labelColor=6E1423"></a>
+ <a href="./CHANGELOG.md"><img alt="Version: 0.5.3" src="https://img.shields.io/badge/version-0.5.3-F4D35E.svg?style=flat-square&labelColor=6E1423"></a>
+ <!-- The badge is correct at merge time: Phase 3 merges this README in step 5, after the founder
+ tags the public v0.5.3 release in step 4. The line below guards the case where that slips. -->
+ <code>Do not merge before the public v0.5.3 tag exists.</code>
<a href="https://github.com/chaitanyagiri/munder-difflin/releases"><img alt="Downloads across all releases" src="https://img.shields.io/github/downloads/chaitanyagiri/munder-difflin/total?style=flat-square&label=downloads&color=F4D35E&labelColor=6E1423"></a>
<img alt="Status: pre-release" src="https://img.shields.io/badge/status-pre--release-F4F1EA.svg?style=flat-square&labelColor=6E1423">
<img alt="Platform: macOS | Windows | Linux" src="https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-F4F1EA.svg?style=flat-square&labelColor=6E1423">
@@ -48,9 +51,16 @@ visualized as avatars at work on a shared office floor.
<br><br>
-**[⬇ Download for macOS, Windows or Linux](https://github.com/chaitanyagiri/munder-difflin/releases/latest)**
+**[⬇ Download 0.5.3 for macOS, Windows or Linux](https://harnessmd.com/download)**
-<sub>macOS builds are signed and notarized. You do not need to build from source to use it.</sub>
+<sub>macOS builds are signed and notarized. You do not need to build from source to use it.
+The open source build is on the <a href="https://github.com/chaitanyagiri/munder-difflin/releases/latest">GitHub releases page</a>.</sub>
+
+**Cancel your Granola and Whispr subscriptions.** 0.5.3 dictates into any app and transcribes your
+meetings, all running locally.
+
+<sub><b>Launch offer:</b> the Pro annual plan for $150 USD, adjusted for purchasing power in different
+countries and as low as $100 a year. <a href="https://app.harnessmd.com/console/license">Get Pro</a></sub>
</div>
@@ -58,10 +68,10 @@ 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 terminal-agent CLIs you already run — `claude`, `agy`, `codex`, `grok`,
-> `kimi`, `qwen`, `opencode`, `crush`, `pi`, and `copilot` — and turns them
+> Munder Difflin takes the terminal-agent CLIs you already run (`claude`, `agy`, `codex`, `grok`,
+> `kimi`, `qwen`, `opencode`, `crush`, `pi`, and `copilot`) 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 **your clone** (Michael) routes work between them while you watch. He's the
+> office floor, and **your clone** (Michael) routes work between them while you watch. He's the
> boss of the floor; you're still the boss of him.
## Contents
@@ -105,13 +115,13 @@ Plus **bring your own keys** and **local models** through Ollama, LM Studio or v
## What it is
Munder Difflin is a desktop app that wraps **real terminal-agent CLIs** as fully-capable agents,
-wires them into a **hive mind**, and puts **your clone** in charge — Michael, the one agent *you*
+wires them into a **hive mind**, and puts **your clone** in charge. Michael is the one agent *you*
talk to in order to get things done. Under the hood it runs the **fastest memory layer in the
world** so every agent remembers what it learns and recalls it instantly.
- **Every terminal is an agent.** Each `claude`, `agy`, `codex`, `grok`, `kimi`, `qwen`, `opencode`, `crush`, `pi`, `copilot`, 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 walk
+- **Every agent is an avatar.** Sessions appear as characters on a Pixi.js office floor. They walk
to 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
messages between inboxes; the GOD agent adjudicates, assigns, and escalates only when it needs you.
@@ -137,15 +147,15 @@ world** so every agent remembers what it learns and recalls it instantly.
└──────── shared hive: memory · mailbox · blackboard · log ───────┘
```
-1. **You spawn agents** — each is a normal terminal process (`claude`, `agy`, `codex`, or custom)
+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
+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).
-3. **The GOD agent runs the floor** — it reads every request, resolves routine ones itself (keeping
+3. **The GOD agent runs the floor**: it reads every request, resolves routine ones itself (keeping
the system fully autonomous), and only escalates *critical* items (spend, destructive ops, scope
changes) into an approvals queue you act on.
-4. **Everything is visible** — you watch avatars move, envelopes fly, and the live terminal stream;
+4. **Everything is visible**: you watch avatars move, envelopes fly, and the live terminal stream;
you can type back into any session, browse its files, and read its git history.
See [`HIVE.md`](./HIVE.md) for the full multi-agent design, [`SPEC.md`](./SPEC.md) for the
@@ -157,6 +167,42 @@ terminal/event plane, and [`DESIGN.md`](./DESIGN.md) for the visual system.
<tr>
<td width="50%" valign="middle">
+### Cancel your Granola and Whispr subscriptions
+
+**Dictate into any app.** Hold Option on the Mac, or Control+Alt+Space on Windows and Linux (X11),
+talk, and let go. The words land in whatever field is in front of you, and in every text box inside
+Munder Difflin. The message box mic works in the free build too.
+
+**Meetings hear both sides**, in Stapler, part of Pro. Your microphone is written as You and the
+call's audio as Them, on Mac, Windows and Linux. Shift+Command+Space starts and stops a meeting on
+the Mac, Control+Shift+Space on Windows and Linux. Correct the transcript, add a description, and
+send it to any of your agents.
+
+**Transcription on your machine.** A Whisper model ships inside the app and is the default engine.
+A larger model is one download away, Apple's on device recogniser works on macOS 26, and Groq stays
+off unless you add a key. 126 built in technical names plus your own words. English for now.
+
+<img src="./docs/media/stapler-053.png" alt="Stapler, the yellow puck, with its ring open and Record meeting ready" width="360">
+
+</td>
+<td width="50%" valign="middle">
+
+### One row per agent, and it tells you everything
+
+Classic, the free skin, gets the new agent cards: status, engine, model, a context gauge, the
+ticket it is on and the action it is taking right now, a crash strip instead of a silent
+terminal, and a right click menu for the common jobs.
+
+Pro gets the new sidebar: Tasks, Inbox, Automations, Memory, Capabilities and the Stapler at the
+top, agents grouped under their projects, a live line per agent, **Asked you** on the row when an
+agent has a question, notes you can search, and **Keep my agent order** to drag agents and projects
+where you want them.
+
+</td>
+</tr>
+<tr>
+<td width="50%" valign="middle">
+
### Talk to one agent, not twelve
Michael is your clone and the only agent you brief. He assigns the work, routes the traffic, and
@@ -236,57 +282,78 @@ than sending you to a docs page.
</table>
**The floor**
-- **Every terminal is a real agent.** Claude Code, Antigravity (Gemini), OpenAI Codex, xAI Grok, Kimi Code, Gemini CLI, Qwen, OpenCode, Crush, pi.dev, GitHub Copilot CLI, Cursor, or a custom command — each in its own `node-pty` PTY, rendered with xterm.js.
+- **Every terminal is a real agent.** Claude Code, Antigravity (Gemini), OpenAI Codex, xAI Grok, Kimi Code, Gemini CLI, Qwen, OpenCode, Crush, pi.dev, GitHub Copilot CLI, Cursor, or a custom command, each in its own `node-pty` PTY, rendered with xterm.js.
- **Every agent is an avatar.** A Pixi.js office floor where agents walk to stations, envelopes fly desk to desk, and avatar state reflects real work.
- **A GOD orchestrator you talk to.** It routes tasks, adjudicates traffic, and escalates only what needs a human. Or press **Talk** and run the floor by voice.
- **Per-agent git worktrees.** Optional isolation so parallel agents never collide on branches.
**Memory & coordination**
-- **The hive** — per-agent memory, atomic-file mailboxes, a shared blackboard, an append-only event log, single-committer git.
-- **Semantic recall** — markdown memory mined into a shared palace, searchable from the UI, with condensation so it doesn't grow forever.
-- **Enterprise Knowledge Graph** — your own documents and policies, queryable by any agent.
+- **The hive**: per-agent memory, atomic-file mailboxes, a shared blackboard, an append-only event log, single-committer git.
+- **Semantic recall**: markdown memory mined into a shared palace, searchable from the UI, with condensation so it doesn't grow forever.
+- **Enterprise Knowledge Graph**: your own documents and policies, queryable by any agent.
**Control & safety**
-- **Human gates** — spend, scope, and destructive ops escalate to you. Steer mid-run or stop gracefully.
-- **Circuit breaker** — a steer → constrain → stop ladder for agents that loop, storm errors, or blow their budget.
-- **Budgets & telemetry** — per-agent token budgets, real cost from transcripts, a durable ledger, OTel spans, and a tool waterfall.
+- **Human gates**: spend, scope, and destructive ops escalate to you. Steer mid-run or stop gracefully.
+- **Circuit breaker**: a steer → constrain → stop ladder for agents that loop, storm errors, or blow their budget.
+- **Budgets & telemetry**: per-agent token budgets, real cost from transcripts, a durable ledger, OTel spans, and a tool waterfall.
**Command Center**
- Kanban tasks with dependencies, scheduled missions + heartbeat, live fleet monitoring, memory search, activity log, and a CI watcher.
-- **Skills** — what every agent can already do across Claude Code, OpenCode and Codex, plus a browsable catalog of 227 more with search, filters, install and uninstall.
-- **Built-in Monaco IDE** — file tree, editor tabs, save, plus CHANGES · HISTORY · COMPARE git rails with commit graph, diffs, branch compare, and guarded checkout. All fs/git access brokered through main.
+- **Skills**: what every agent can already do across Claude Code, OpenCode and Codex, plus a browsable catalog of 227 more with search, filters, install and uninstall.
+- **Built-in Monaco IDE**: file tree, editor tabs, save, plus CHANGES · HISTORY · COMPARE git rails with commit graph, diffs, branch compare, and guarded checkout. All fs/git access brokered through main.
**Getting work in and out**
-- **Slack & webhooks** — message a channel or POST a webhook; Michael can spawn an ephemeral worker, reply in-thread, and tear it down.
-- **Shareable hires + Agent Gallery** — import a role from a `munderdifflin://hire` link; import only pre-fills the form, a human still spawns it. Browse roles at the [Agent Gallery](https://munderdiffl.in/hires/).
-- **BYOK keys + local LLMs** — per-provider keys in a write-only secret broker, plus Ollama / LM Studio / vLLM base URLs. Guides: [open models](https://munderdiffl.in/blog/run-munder-difflin-on-open-models/) · [Mac Mini](https://munderdiffl.in/blog/run-munder-difflin-on-a-mac-mini/).
+- **Slack & webhooks**: message a channel or POST a webhook; Michael can spawn an ephemeral worker, reply in-thread, and tear it down.
+- **Shareable hires + Agent Gallery**: import a role from a `munderdifflin://hire` link; import only pre-fills the form, a human still spawns it. Browse roles at the [Agent Gallery](https://munderdiffl.in/hires/).
+- **Local transcription and dictation** (0.5.3): dictate into any app (Option on the Mac,
+ Control+Alt+Space on Windows and Linux X11), and Stapler in Pro transcribes meetings with You and
+ Them on Mac, Windows and Linux. A bundled Whisper model is the default engine; Apple's on device
+ recogniser on macOS 26 and Groq with your own key are options. A built in vocabulary of 126
+ technical names keeps Anthropic, Claude, Kubernetes and ARR spelled right, and you can add your own.
+- **Tell an agent from the Stapler** (Pro): Record message, several screenshots per message, PDFs,
+ videos and folders, and a To menu that remembers who you picked.
+- **BYOK keys + local LLMs**: per-provider keys in a write-only secret broker, plus Ollama / LM Studio / vLLM base URLs. Guides: [open models](https://munderdiffl.in/blog/run-munder-difflin-on-open-models/) · [Mac Mini](https://munderdiffl.in/blog/run-munder-difflin-on-a-mac-mini/).
- **Updates in one click**: the title-bar badge runs the real update. It downloads the build for your machine, then restarts and installs it, and it reads `latest` once a check confirms you are current. A manual download is the fallback for when the updater cannot fetch the build itself. The first run afterwards opens that release's notes as a designed page rather than a version number.
- **Your language**: English, Simplified Chinese and Arabic, with right to left layout for Arabic. English is the default and nothing changes until you pick another one in Settings. The app does not read your OS locale. All three app fonts ship inside the bundle, so nothing is fetched at boot.
-- **Prerequisites** — one Settings page showing which supporting tools (uv, git, Node, MemPalace, each agent CLI) you have, what each is for, and a button that asks Michael to install what is missing.
+- **Prerequisites**: one Settings page showing which supporting tools (uv, git, Node, MemPalace, each agent CLI) you have, what each is for, and a button that asks Michael to install what is missing.
> [!NOTE]
-> **Status: v0.4.6, the release where the app stops assuming everyone reads English left to right.**
-> The interface now runs in Simplified Chinese and Arabic, with right to left support. English
-> stays the default and nothing changes until you pick a language in Settings, under General; the
-> app never reads your operating system locale. All three app fonts now ship inside the bundle
-> instead of loading from Google, which is blocked in mainland China and was breaking the interface
-> for exactly the people the Chinese translation was for. An input method Enter no longer fires a
-> send, a search or a rename while a candidate word is still being composed.
-> Every string is translated, with nothing falling back to English, and the terminals read right to
-> left. Some screens still need their padding and icons mirrored, and that is the next piece of
-> work. No Arabic reader has reviewed the wording yet.
-> Also in this release: the update badge runs the real download and restart instead of handing you
-> a disk image, the update check can no longer spin forever, Settings persists through one Save
-> button, the model lists moved into a checked in catalog, and the ASK ME card renders markdown.
-> On the security side: the name of the CLI an agent launches is validated before it is resolved
-> against your PATH, the OS sandbox stays on in auto mode, and analytics stopped sending IP and
-> derived location. Telemetry now counts the messages you send to an agent, a count and nothing
-> else, with no text, length or hash of the body in any shape.
-> 16 community pull requests from 13 contributors landed in this release, one of them (#213)
-> re-implemented rather than merged.
+> **Status: v0.5.3. Cancel your Granola and Whispr subscriptions.**
+> The Stapler does both, all running locally, and every agent gets easier to start, restart and steer.
+> **Dictate into any app**: hold Option on the Mac (Microphone and Accessibility permissions), or
+> Control+Alt+Space on Windows and Linux X11, talk, and let go. Wayland says why it cannot.
+> **Meetings hear both sides** in Stapler, part of Pro: You and Them, on Mac, Windows and Linux,
+> transcribed locally, then corrected, described and sent to any of your agents.
+> **Transcription on your machine**: a bundled Whisper model by default, an optional 190 MB larger
+> model, Apple's on device recogniser on macOS 26, and Groq only if you add a key.
+> 0.5.3 transcribes English. The bundled model is English only; on macOS 26 dictation runs on Apple's engine, which follows the Mac's language and we have tested it in English. Other languages arrive as a model download in a later release.
+> **A missing CLI is a card, not an error**: install and sign in from inside the app for every
+> engine, with Set up manually when either fails. **Ask me** on every agent's Inbox, answered from
+> one box over the composer. **Two floors on one machine**: New Floor runs a second office on its
+> own hive, one Pro licence for the machine. **Send now** goes straight in, **Restart & Continue**
+> keeps the conversation for every engine, and **Opus 5.5** is the default Claude model.
+> **Settings, redesigned**: one Save for everything, inbound webhooks for GitHub, Linear, Telegram
+> and your own, each with the agent that answers it, and custom secrets stored encrypted beside
+> your provider keys. **Crashes keep your work**: a crashed agent keeps its uncommitted work and
+> restarts in that folder. The IDE opens on Command+I with find and replace, and Arabic reads right
+> to left across the app and the terminal.
+> Automatic compaction runs every 40 minutes at 30 percent of the context window, the same bar on
+> every model size, where the previous default was every two hours at 60 percent. A rule you have
+> edited yourself keeps your own numbers.
+> Fixes: a restarted agent's terminal takes the mouse again, the hive repository no longer swallows
+> agent git folders into its object database and the disk space comes back, and one hook event now
+> renders one sidebar row with the task ledger read once.
+> Not in this release: the Kimi scroll and queue bug, which we could not reproduce, and it is first
+> on the 0.5.4 list.
+> **Launch offer**: the Pro annual plan for $150 USD, adjusted for purchasing power in different
+> countries and as low as $100 a year. [Get Pro](https://app.harnessmd.com/console/license)
+> Before that, v0.4.6 brought a Simplified Chinese and Arabic interface with right to left support
+> and self hosted fonts, the update badge that runs the real download and restart, and the security
+> work on CLI name validation and analytics.
> **If you're on 0.3.8, update:** that build's usage-limit guard never released the agents it held,
> and it has been removed entirely.
> macOS (signed & notarized), Windows, and Linux builds are on the
+> [download page](https://harnessmd.com/download). The open source build is on the
> [releases page](https://github.com/chaitanyagiri/munder-difflin/releases/latest).
<div align="right">(<a href="#munder-difflin">↑ back to top</a>)</div>
@@ -295,13 +362,19 @@ than sending you to a docs page.
### Download the app
-**Most people want this one.** Signed and notarized macOS builds, plus Windows and Linux, are on
-the [latest release](https://github.com/chaitanyagiri/munder-difflin/releases/latest). Install it,
+**Most people want this one.** Munder Difflin is free and open source. Signed and notarized macOS
+builds of 0.5.3, plus Windows and Linux, are on the [download page](https://harnessmd.com/download).
+The open source build is on the [latest GitHub release](https://github.com/chaitanyagiri/munder-difflin/releases/latest). Install it,
open it, and the wizard takes you the rest of the way. You do not need Node, a toolchain, or this
repository.
-You do still need at least one agent CLI on your machine, and the app can install missing ones for
-you from **Settings → Prerequisites**.
+You do still need at least one agent CLI on your machine. From 0.5.3 a missing CLI shows as a card
+in the agent's terminal: Install runs the command, you sign in inside the app, and the agent starts.
+**Settings → Prerequisites** lists the rest.
+
+**Pro** adds Stapler, the new sidebar and two floors on one machine. Launch offer: the annual plan
+for $150 USD, adjusted for purchasing power, as low as $100 a year.
+[Get Pro](https://app.harnessmd.com/console/license)
### Build from source
@@ -311,18 +384,18 @@ Everything below is for contributors and for people who want to run an unrelease
- **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:
+- A **C/C++ toolchain** for `node-pty`'s native addon. On macOS, install Xcode Command Line Tools:
```bash
xcode-select --install
```
-- At least one supported agent CLI on your `PATH` — **[Claude Code](https://claude.com/claude-code)**
+- At least one supported agent CLI on your `PATH`, one of **[Claude Code](https://claude.com/claude-code)**
(`claude`, the default), **Antigravity** (`agy`), **OpenAI Codex** (`codex`), **xAI Grok** (`grok`),
**Kimi Code** (`kimi`), **Gemini CLI** (`gemini`), **Qwen** (`qwen`), **OpenCode** (`opencode`),
**Crush** (`crush`), **pi.dev** (`pi`), **GitHub Copilot** (`copilot`), or **Cursor** (`cursor-agent`).
Most missing CLIs self-heal: the harness runs the installer in the
terminal and continues into the new binary.
- *Optional:* **your own API keys and local LLMs** in **Settings → AI Engines** (Ollama / LM Studio / vLLM).
-- *Optional:* the semantic memory index for instant cross-session recall — markdown memory works without it.
+- *Optional:* the semantic memory index for instant cross-session recall. Markdown memory works without it.
### Install & run
@@ -334,7 +407,7 @@ npm run dev # launches the Electron app with hot reload
```
On first launch you'll go through the onboarding wizard, then land on the floor. Use **Add agent** to
-spawn your first session — the GOD agent seats itself in Michael's office automatically.
+spawn your first session. The GOD agent seats itself in Michael's office automatically.
### Other scripts
@@ -363,7 +436,12 @@ visual system.
## Roadmap
-Shipped through **v0.4.6**: a Simplified Chinese and Arabic interface with right to left support
+Shipped through **v0.5.3**: local dictation into any app and meetings with both sides of the call,
+with the model in the installer, the new agent cards in the free build and a new Pro sidebar, a
+missing CLI you install and sign in to from inside the app, Ask me on every Inbox, two floors on one
+machine, redesigned Settings with inbound webhooks and custom secrets, Opus 5.5 as the default Claude
+model, one compaction bar for every model size, a Simplified Chinese and Arabic interface with right to left
+support
and self-hosted fonts, twelve agent engines with BYOK keys and local LLMs, voice orchestration,
the hive (memory · mailboxes · blackboard · event log), Command Center with kanban and weekday
schedules, a built-in Monaco IDE with git rails, integrations registry + secret broker,
@@ -375,23 +453,23 @@ Full history in [`CHANGELOG.md`](./CHANGELOG.md).
Next up:
-- [ ] **More chat integrations** — Telegram and richer chat bridges that pipe a channel into Michael's queue and route replies back out.
-- [ ] **More engines & integration templates** — keep growing the engine roster and the integrations registry.
-- [ ] **Fuller avatar coverage** — drive the remaining station visits and tool-bubbles entirely from real hook events.
-- [ ] **Durable layout & command history** — extend persistence to agent layout and per-session history.
+- [ ] **More chat integrations**: Telegram and richer chat bridges that pipe a channel into Michael's queue and route replies back out.
+- [ ] **More engines & integration templates**: keep growing the engine roster and the integrations registry.
+- [ ] **Fuller avatar coverage**: drive the remaining station visits and tool-bubbles entirely from real hook events.
+- [ ] **Durable layout & command history**: extend persistence to agent layout and per-session history.
<div align="right">(<a href="#munder-difflin">↑ back to top</a>)</div>
## Contributing
-Contributions are welcome — this is pre-release software with a lot of surface area. Start with
+Contributions are welcome. This is pre-release software with a lot of surface area. Start with
[`CONTRIBUTING.md`](./CONTRIBUTING.md). The short version: fork, `npm install && npm run dev`, keep
`npm run typecheck` green, and **derive any new UI from [`DESIGN.md`](./DESIGN.md) tokens**. Good
first areas: wiring real hook events, the add-agent flow, the config drawer, and cross-platform work.
> [!IMPORTANT]
-> **Every pull request must show a before and an after** — screenshots, or a recording when the
-> thing moves — under the `### Before` and `### After` headings in the PR template. This is checked
+> **Every pull request must show a before and an after**: screenshots, or a recording when the
+> thing moves, under the `### Before` and `### After` headings in the PR template. This is checked
> automatically and a PR without it does not merge. "My change has no UI" is not an exemption; it
> just changes what the evidence looks like. See
> [Evidence is mandatory](./CONTRIBUTING.md#evidence-is-mandatory).
@@ -415,9 +493,9 @@ and not theirs to explain.
## Telemetry
Official builds send a **small set of anonymous usage events** (app opened, agent spawned, feature
-used) — never prompts, code, file paths, or agent output. The complete event list, the anonymity
+used), never prompts, code, file paths, or agent output. The complete event list, the anonymity
guarantees, and the three ways to opt out (Settings toggle, `DO_NOT_TRACK`, or building from
-source — forks compile with no key and send nothing) are documented in
+source, forks compile with no key and send nothing) are documented in
[`TELEMETRY.md`](./TELEMETRY.md).
## License
@@ -430,7 +508,7 @@ source — forks compile with no key and send nothing) are documented in
> is drawn procedurally in `portraitArt.ts`. See
> [`src/renderer/src/assets/ATTRIBUTION.md`](./src/renderer/src/assets/ATTRIBUTION.md).
-The **source code** is licensed under the **MIT License** — see [`LICENSE`](./LICENSE). The MIT grant
+The **source code** is licensed under the **MIT License**. See [`LICENSE`](./LICENSE). The MIT grant
covers the code only; the bundled pixel art is licensed separately from LimeZu and is carved out in
[`LICENSE-ASSETS`](./LICENSE-ASSETS). *Munder Difflin* is an affectionate parody and is not affiliated with NBC's *The Office* or
Dunder Mifflin.
diff --git a/docs/media/stapler-053.png b/docs/media/stapler-053.png
new file mode 100644
index 00000000..702c6560
Binary files /dev/null and b/docs/media/stapler-053.png differ