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

fix(blog): render TL;DR links as HTML; add pillar links; rebuild

Chaitanya Giricda8800b0c49
diff --git a/blog/src/posts/ai-agent-glossary.md b/blog/src/posts/ai-agent-glossary.md
index e124669a..3be4216b 100644
--- a/blog/src/posts/ai-agent-glossary.md
+++ b/blog/src/posts/ai-agent-glossary.md
@@ -23,7 +23,7 @@ faq:
<div class="callout tldr"><span class="ic">TL;DR</span><p>The agent world is thick with jargon —
<strong>harness</strong>, <strong>orchestrator</strong>, <strong>hive</strong>,
<strong>subagent</strong>, <strong>agent memory</strong>. Here's each term in one quotable line, so
-you can read (and write) about [multi-agent AI](/blog/what-is-a-multi-agent-harness/) without
+you can read (and write) about <a href="/blog/what-is-a-multi-agent-harness/">multi-agent AI</a> without
tripping. Bookmark it.</p></div>
Every fast-moving field grows its own vocabulary, and AI coding agents have grown a lot of it fast.
diff --git a/blog/src/posts/munder-difflin-faq.md b/blog/src/posts/munder-difflin-faq.md
index d859bccb..6384cb15 100644
--- a/blog/src/posts/munder-difflin-faq.md
+++ b/blog/src/posts/munder-difflin-faq.md
@@ -40,7 +40,7 @@ faq:
<div class="callout tldr"><span class="ic">TL;DR</span><p><strong>Munder Difflin</strong> is a free,
open-source (MIT), local-first desktop app that turns the Claude Code terminals you already run into a
-coordinated hive — shared memory, messaging, and a [GOD orchestrator](/#how) you talk to — on macOS,
+coordinated hive — shared memory, messaging, and a <a href="/#how">GOD orchestrator</a> you talk to — on macOS,
Windows, and Linux. The full answers to the questions people ask most are below.</p></div>
This page answers the questions we hear most about Munder Difflin, kept short and direct. If your
diff --git a/blog/src/posts/why-we-built-munder-difflin.md b/blog/src/posts/why-we-built-munder-difflin.md
index 8a065cc6..d95350c1 100644
--- a/blog/src/posts/why-we-built-munder-difflin.md
+++ b/blog/src/posts/why-we-built-munder-difflin.md
@@ -59,7 +59,7 @@ them a team.
compounds instead of resetting.
- **Messaging** — every agent has a mailbox; a router delivers between them, so they hand off work
without me in the middle.
-- **A GOD orchestrator** — a coordinator you talk to like a manager; it decomposes your intent and
+- **A [GOD orchestrator](/#how)** — a coordinator you talk to like a manager; it decomposes your intent and
routes the work.
- **A floor you can watch** — agents as avatars at their desks, so the black box becomes something you
can supervise at a glance.
diff --git a/docs/blog/ai-agent-glossary/index.html b/docs/blog/ai-agent-glossary/index.html
index f278fbeb..bd6bc7d5 100644
--- a/docs/blog/ai-agent-glossary/index.html
+++ b/docs/blog/ai-agent-glossary/index.html
@@ -135,7 +135,7 @@
<div class="callout tldr"><span class="ic">TL;DR</span><p>The agent world is thick with jargon —
<strong>harness</strong>, <strong>orchestrator</strong>, <strong>hive</strong>,
<strong>subagent</strong>, <strong>agent memory</strong>. Here's each term in one quotable line, so
-you can read (and write) about [multi-agent AI](/blog/what-is-a-multi-agent-harness/) without
+you can read (and write) about <a href="/blog/what-is-a-multi-agent-harness/">multi-agent AI</a> without
tripping. Bookmark it.</p></div>
<p>Every fast-moving field grows its own vocabulary, and AI coding agents have grown a lot of it fast.
This is a snackable reference: each term defined in a sentence you could quote, with a link out when
diff --git a/docs/blog/append-only-event-log-agents/index.html b/docs/blog/append-only-event-log-agents/index.html
new file mode 100644
index 00000000..972743a3
--- /dev/null
+++ b/docs/blog/append-only-event-log-agents/index.html
@@ -0,0 +1,384 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="UTF-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<title>An Append-Only Event Log for a Hive of Agents — Munder Difflin Blog</title>
+<meta name="description" content="How an append-only event log makes a multi-agent system debuggable and replayable — what to record per event, and why one JSON line per event beats a database." />
+<link rel="canonical" href="https://munderdiffl.in/blog/append-only-event-log-agents/" />
+
+<link rel="icon" type="image/png" href="https://munderdiffl.in/logo.png" />
+<link rel="apple-touch-icon" href="https://munderdiffl.in/logo.png" />
+<meta name="theme-color" content="#F5F2E8" />
+
+<!-- Open Graph -->
+<meta property="og:site_name" content="Munder Difflin Blog" />
+<meta property="og:type" content="article" />
+<meta property="og:title" content="An Append-Only Event Log for a Hive of Agents — Munder Difflin Blog" />
+<meta property="og:description" content="How an append-only event log makes a multi-agent system debuggable and replayable — what to record per event, and why one JSON line per event beats a database." />
+<meta property="og:url" content="https://munderdiffl.in/blog/append-only-event-log-agents/" />
+<meta property="og:image" content="https://munderdiffl.in/media/og.png" />
+<meta property="og:locale" content="en_US" />
+<meta property="article:published_time" content="2026-06-01T00:00:00.000Z" />
+<meta property="article:author" content="Chaitanya Giri" />
+<meta property="article:tag" content="Internals" />
+<meta property="article:tag" content="Observability" />
+<meta property="article:tag" content="Multi-Agent" />
+<meta property="article:tag" content="Event Log" />
+
+
+<!-- Twitter -->
+<meta name="twitter:card" content="summary_large_image" />
+<meta name="twitter:title" content="An Append-Only Event Log for a Hive of Agents — Munder Difflin Blog" />
+<meta name="twitter:description" content="How an append-only event log makes a multi-agent system debuggable and replayable — what to record per event, and why one JSON line per event beats a database." />
+<meta name="twitter:image" content="https://munderdiffl.in/media/og.png" />
+
+<link rel="alternate" type="application/atom+xml" title="Munder Difflin Blog" href="https://munderdiffl.in/blog/feed.xml" />
+<link rel="preconnect" href="https://fonts.googleapis.com" />
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+<link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600&family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet" />
+<link rel="stylesheet" href="/blog/assets/blog.css" />
+
+<script type="application/ld+json">
+{
+ "@context": "https://schema.org",
+ "@type": "BlogPosting",
+ "headline": "An Append-Only Event Log for a Hive of Agents",
+ "description": "How an append-only event log makes a multi-agent system debuggable and replayable — what to record per event, and why one JSON line per event beats a database.",
+ "image": ["https://munderdiffl.in/media/og.png"],
+ "datePublished": "2026-06-01T00:00:00.000Z",
+ "dateModified": "2026-06-01T00:00:00.000Z",
+ "author": { "@type": "Person", "name": "Chaitanya Giri" },
+ "publisher": {
+ "@type": "Organization",
+ "name": "Munder Difflin",
+ "logo": { "@type": "ImageObject", "url": "https://munderdiffl.in/logo.png" }
+ },
+ "mainEntityOfPage": { "@type": "WebPage", "@id": "https://munderdiffl.in/blog/append-only-event-log-agents/" },
+ "keywords": "ai agent event log, event sourcing, append-only log, agent observability",
+ "articleSection": "Internals",
+ "inLanguage": "en-US",
+ "url": "https://munderdiffl.in/blog/append-only-event-log-agents/"
+}
+</script>
+<script type="application/ld+json">
+{
+ "@context": "https://schema.org",
+ "@type": "BreadcrumbList",
+ "itemListElement": [
+ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://munderdiffl.in/" },
+ { "@type": "ListItem", "position": 2, "name": "Blog", "item": "https://munderdiffl.in/blog/" },
+ { "@type": "ListItem", "position": 3, "name": "An Append-Only Event Log for a Hive of Agents", "item": "https://munderdiffl.in/blog/append-only-event-log-agents/" }
+ ]
+}
+</script>
+
+<script type="application/ld+json">
+{
+ "@context": "https://schema.org",
+ "@type": "FAQPage",
+ "mainEntity": [
+ { "@type": "Question", "name": "What is an append-only event log in a multi-agent system?", "acceptedAnswer": { "@type": "Answer", "text": "It's a file that only ever grows: every meaningful thing that happens — an agent spawns, a message routes, an item escalates — is recorded as one timestamped line, never edited or deleted. It becomes the system's ground-truth history for debugging and replay." } },
+ { "@type": "Question", "name": "Why one JSON object per line instead of a database?", "acceptedAnswer": { "@type": "Answer", "text": "Line-delimited JSON (JSONL) is append-cheap, crash-safe, human-readable, and trivially tailable. Appending a line is a single, atomic-enough write; readers parse line by line and track their own position. You get observability with no schema migrations and no server." } },
+ { "@type": "Question", "name": "What should each event record?", "acceptedAnswer": { "@type": "Answer", "text": "A timestamp plus a small, typed payload: the kind of event and the few fields that matter for it — who spawned, who messaged whom, what was escalated. Keep events small and factual; the value is in the sequence, not in any one fat record." } }
+
+ ]
+}
+</script>
+
+
+</head>
+<body>
+<a class="skip-link" href="#main">Skip to content</a>
+<nav id="nav">
+ <a class="brand" href="/blog/" aria-label="Munder Difflin Blog home">
+ <span class="brand-mark">MD</span>
+ <span class="brand-word">MUNDER DIFFLIN<span class="sep">/</span><span class="blog">BLOG</span></span>
+ </a>
+ <span class="spacer"></span>
+ <div class="links">
+ <a href="/blog/">Latest</a>
+ <a href="/blog/topics/">Topics</a>
+ <a href="/blog/about/">About</a>
+ <a href="https://munderdiffl.in">↗ Product</a>
+ </div>
+ <div class="nav-actions">
+ <a class="btn sm" href="https://munderdiffl.in/blog/feed.xml" aria-label="RSS feed">⤵ RSS</a>
+ <a class="btn sm primary" href="https://munderdiffl.in/#install">⤓ Download</a>
+ </div>
+</nav>
+
+<main id="main">
+
+<article>
+ <header class="post-head wrap">
+ <nav class="crumbs" aria-label="Breadcrumb">
+ <a href="/blog/">Blog</a>
+ <span>/</span>
+ <a href="/blog/topics/internals/">Internals</a>
+ </nav>
+ <h1>An Append-Only Event Log for a Hive of Agents</h1>
+ <p class="dek">How an append-only event log makes a multi-agent system debuggable and replayable — what to record per event, and why one JSON line per event beats a database.</p>
+ <div class="byline">
+ <span class="av" aria-hidden="true">CG</span>
+ <strong>Chaitanya Giri</strong>
+ <span class="dot" aria-hidden="true">·</span>
+ <time datetime="2026-06-01">Jun 1, 2026</time>
+ <span class="dot" aria-hidden="true">·</span>
+ <span>5 min read</span>
+ <span class="tag kind">Internals</span>
+ </div>
+ </header>
+
+ <div class="post-wrap wrap">
+ <div class="prose">
+ <div class="callout tldr"><span class="ic">TL;DR</span><p>An <strong>append-only event log</strong>
+records every meaningful thing a hive does as one timestamped JSON line that's never edited or
+deleted. It turns a multi-agent system from a black box into something
+<strong>debuggable and replayable</strong>: you read the sequence back to see exactly what happened.
+One JSONL file, written by the single committer, beats a database for this job — cheap to append,
+crash-safe, and human-readable.</p></div>
+<p>When a hive of agents does something surprising, the first question is always “what actually
+happened?” Without a record, you’re guessing from terminal scrollback and vibes. The fix is the
+oldest trick in distributed systems: write down everything, in order, and never change it. This post
+covers what an append-only event log is, what to put in it, and why it’s the backbone of multi-agent
+observability.</p>
+<h2 id="append-only-in-one-sentence" tabindex="-1">Append-only, in one sentence <a class="anchor" href="#append-only-in-one-sentence" aria-hidden="true">#</a></h2>
+<p>An append-only log is a file you only ever add to. Each line is one event — a small, timestamped,
+typed record of something that happened. You never go back and edit or delete a line. The log grows
+forever (or until you rotate it), and its <em>order</em> is the truth: event N happened before event N+1,
+always.</p>
+<p>That immutability is the whole value. A mutable status table tells you the <em>current</em> state; an
+append-only log tells you the <em>story</em> — how you got to the current state, step by step. For debugging
+a system where many agents act concurrently, the story is what you need.</p>
+<h2 id="one-json-object-per-line" tabindex="-1">One JSON object per line <a class="anchor" href="#one-json-object-per-line" aria-hidden="true">#</a></h2>
+<p>The format that makes this practical is <strong>JSONL</strong> — one JSON object per line:</p>
+<pre class="language-jsonl"><code class="language-jsonl">{"ts":1717286400123,"kind":"spawn","agentId":"researcher","name":"Researcher","isGod":false}
+{"ts":1717286400456,"kind":"message","from":"researcher","to":"coder","act":"request","subject":"Need the schema","id":"…-a1b2"}
+{"ts":1717286401789,"kind":"drain","agentId":"coder","count":1}
+{"ts":1717286402111,"kind":"escalate","from":"coder","to":"human","subject":"Drop the users table?","id":"…-c3d4"}
+{"ts":1717286402999,"kind":"approval","id":"…-c3d4","approve":false}</code></pre>
+<p>Why JSONL specifically:</p>
+<ul>
+<li><strong>Appending is cheap and safe.</strong> Adding a line is a single write to the end of the file. There’s no
+index to update, no row to lock, no migration to run.</li>
+<li><strong>It’s tailable.</strong> <code>tail -f</code> the file and you have a live activity feed. The same stream drives a UI
+activity panel in real time.</li>
+<li><strong>It’s human-readable.</strong> When something breaks, you <code>cat</code> the log and read it. No query language, no
+admin tool.</li>
+<li><strong>Readers track their own position.</strong> Each consumer remembers how far it has read (a cursor) and
+picks up new lines from there. Multiple consumers, no coordination.</li>
+</ul>
+<p>A database would give you indexes and queries you mostly don’t need here, at the cost of a schema and a
+server. For an audit/observability log, plain JSONL is the right amount of technology.</p>
+<h2 id="what-to-record-per-event" tabindex="-1">What to record per event <a class="anchor" href="#what-to-record-per-event" aria-hidden="true">#</a></h2>
+<p>The art is choosing events that are <strong>small, typed, and factual.</strong> Each line carries a <code>ts</code>
+(timestamp) and a <code>kind</code>, plus only the fields that matter for that kind. In a hive, the events worth
+logging are the coordination milestones:</p>
+<ul>
+<li><strong><code>spawn</code></strong> — an agent was created (id, name, whether it’s the orchestrator).</li>
+<li><strong><code>message</code></strong> — a message routed between agents (from, to, act, subject, id).</li>
+<li><strong><code>drain</code></strong> — an agent’s inbox was drained at a lifecycle point (who, how many).</li>
+<li><strong><code>escalate</code></strong> — an item was routed to the human-approval queue (from, subject, id).</li>
+<li><strong><code>approval</code></strong> — a human resolved an escalation (id, approved or rejected).</li>
+</ul>
+<p>Notice what’s <em>not</em> there: no giant payloads, no full message bodies, no model outputs. The log is an
+index of <em>what happened and when</em>, with ids that point at the fuller artifacts (the message files,
+the memory). Keep each event a few fields wide and the log stays fast to write, cheap to store, and
+easy to read. The value is in the sequence, not in any single fat record.</p>
+<h2 id="who-writes-it-and-why-that-matters" tabindex="-1">Who writes it (and why that matters) <a class="anchor" href="#who-writes-it-and-why-that-matters" aria-hidden="true">#</a></h2>
+<p>In a multi-agent system, the log is shared state — so the same discipline that protects every other
+shared file applies: <strong>one writer.</strong> The agents don’t append to the log directly. The coordinating
+process (the harness’s main process) records each event as it routes messages, spawns agents, and
+resolves approvals, and it’s the only thing that writes the file. That keeps the log free of
+interleaved, half-written lines, and it pairs with the
+<a href="/blog/single-committer-git-pattern/">single-committer git pattern</a>: each batch of coordination is
+both appended to the log <em>and</em> committed, so the log’s history and git’s history line up.</p>
+<h2 id="replay-and-debugging" tabindex="-1">Replay and debugging <a class="anchor" href="#replay-and-debugging" aria-hidden="true">#</a></h2>
+<p>Here’s where the log earns its keep. Because it’s an ordered, immutable record, you can <strong>replay</strong> the
+system’s history:</p>
+<ul>
+<li><strong>Reconstruct any moment.</strong> Walk the log up to event N and you know exactly what the hive knew at
+that point — who existed, what had been said, what was pending.</li>
+<li><strong>Find the divergence.</strong> When the team did something wrong, you scan the log for the event where it
+went sideways — the misrouted message, the escalation that should have fired and didn’t.</li>
+<li><strong>Audit decisions.</strong> Every escalation and every human approval is in the log, so “who approved
+deleting that?” has a precise, timestamped answer.</li>
+</ul>
+<p>This is the foundation of <a href="/blog/debugging-multi-agent-systems/">debugging a multi-agent system</a>: the
+event log is the timeline you read first, before you dig into individual agents’ terminals or message
+trails. It’s also what lets the office-floor visualization stay honest — the activity stream the UI
+shows is the same event stream, not a separate, drift-prone narrative.</p>
+<h2 id="practical-notes" tabindex="-1">Practical notes <a class="anchor" href="#practical-notes" aria-hidden="true">#</a></h2>
+<p>A few things that keep an event log healthy:</p>
+<ul>
+<li><strong>Make events idempotent to read.</strong> A consumer that re-reads a line it already processed should do
+nothing. Cursors plus immutable lines make this automatic.</li>
+<li><strong>Don’t log secrets or huge blobs.</strong> The log is plain text you’ll read often and commit. Reference
+big artifacts by id; don’t inline them.</li>
+<li><strong>Rotate if it grows unbounded.</strong> For a long-running hive, cap the file (or roll it) so it stays
+readable — but never <em>edit</em> old entries; archive them.</li>
+<li><strong>Tail the end for “now.”</strong> Reading the last N lines is the cheap way to answer “what’s happening
+right now?” without parsing the whole history.</li>
+</ul>
+<h2 id="faq" tabindex="-1">FAQ <a class="anchor" href="#faq" aria-hidden="true">#</a></h2>
+<p><strong>Is this event sourcing?</strong> It’s the same family of idea — derive state from an ordered log of events
+— applied pragmatically. A full event-sourcing system rebuilds all state from the log; here the log is
+primarily for observability and audit, with live state also held in files like the registry. You get
+the debuggability benefit without committing to rebuild-everything-from-events.</p>
+<p><strong>How is this different from logging to stdout?</strong> Stdout is unstructured and ephemeral. A structured,
+append-only JSONL file is queryable, replayable, and durable — you can read it weeks later and
+reconstruct exactly what the hive did.</p>
+<hr>
+<p>Munder Difflin records every coordination step to an append-only event log that drives the live
+activity feed and makes a hive replayable — committed alongside the rest of its state.
+<a href="https://munderdiffl.in/#install">Download Munder Difflin</a> to watch a hive you can actually audit;
+it’s free and open source.</p>
+
+
+
+ <section class="faq" aria-label="Frequently asked questions">
+ <h2 id="faq">FAQ</h2>
+
+ <div class="qa">
+ <p class="q">What is an append-only event log in a multi-agent system?</p>
+ <p class="a">It&#39;s a file that only ever grows: every meaningful thing that happens — an agent spawns, a message routes, an item escalates — is recorded as one timestamped line, never edited or deleted. It becomes the system&#39;s ground-truth history for debugging and replay.</p>
+ </div>
+
+ <div class="qa">
+ <p class="q">Why one JSON object per line instead of a database?</p>
+ <p class="a">Line-delimited JSON (JSONL) is append-cheap, crash-safe, human-readable, and trivially tailable. Appending a line is a single, atomic-enough write; readers parse line by line and track their own position. You get observability with no schema migrations and no server.</p>
+ </div>
+
+ <div class="qa">
+ <p class="q">What should each event record?</p>
+ <p class="a">A timestamp plus a small, typed payload: the kind of event and the few fields that matter for it — who spawned, who messaged whom, what was escalated. Keep events small and factual; the value is in the sequence, not in any one fat record.</p>
+ </div>
+
+ </section>
+
+
+
+ <hr />
+ <div class="share">
+ <span class="lbl">Tags</span>
+ <a class="tag" href="/blog/tags/internals/">Internals</a><a class="tag" href="/blog/tags/observability/">Observability</a><a class="tag" href="/blog/tags/multi-agent/">Multi-Agent</a><a class="tag" href="/blog/tags/event-log/">Event Log</a>
+ </div>
+
+ </div>
+
+
+ <aside class="toc-rail" aria-label="Table of contents">
+ <div class="tt">On this page</div>
+ <ol>
+ <li class="lvl-2"><a href="#append-only-in-one-sentence">Append-only, in one sentence</a></li><li class="lvl-2"><a href="#one-json-object-per-line">One JSON object per line</a></li><li class="lvl-2"><a href="#what-to-record-per-event">What to record per event</a></li><li class="lvl-2"><a href="#who-writes-it-and-why-that-matters">Who writes it (and why that matters)</a></li><li class="lvl-2"><a href="#replay-and-debugging">Replay and debugging</a></li><li class="lvl-2"><a href="#practical-notes">Practical notes</a></li><li class="lvl-2"><a href="#faq">FAQ</a></li>
+ </ol>
+ </aside>
+
+ </div>
+
+ <footer class="post-foot wrap"><div class="prevnext">
+ <a class="pn prev" href="/blog/how-to-run-multiple-claude-code-agents/"><span class="k">← Older</span><span class="t">How to Run Multiple Claude Code Agents (Without Losing Track)</span></a>
+ <a class="pn next" href="/blog/why-we-built-munder-difflin/"><span class="k">Newer →</span><span class="t">Why We Built Munder Difflin</span></a>
+ </div>
+ <section class="related">
+ <h2>Related in Internals</h2>
+ <div class="post-grid">
+ <article class="card">
+ <a class="thumb t-internals" href="/blog/building-a-terminal-ui-xterm-node-pty/" aria-hidden="true" tabindex="-1">
+ <span>INTERNALS</span>
+ </a>
+ <div class="body">
+ <div class="meta">
+ <time datetime="2026-06-03">Jun 3, 2026</time>
+ <span class="dot" aria-hidden="true"></span>
+ <span>8 min</span>
+ </div>
+ <h3><a href="/blog/building-a-terminal-ui-xterm-node-pty/">Building a Terminal UI with xterm.js and node-pty</a></h3>
+ <p class="dek">Wire xterm.js to a node-pty backend: stream output, write keystrokes back, handle resize, and keep many live terminals fast with a terminal pool.</p>
+ <div class="foot">
+ <span class="tag kind">Internals</span>
+ <a class="more" href="/blog/building-a-terminal-ui-xterm-node-pty/" aria-label="Read: Building a Terminal UI with xterm.js and node-pty">Read →</a>
+ </div>
+ </div>
+</article>
+<article class="card">
+ <a class="thumb t-internals" href="/blog/claude-code-hooks-explained/" aria-hidden="true" tabindex="-1">
+ <span>INTERNALS</span>
+ </a>
+ <div class="body">
+ <div class="meta">
+ <time datetime="2026-06-03">Jun 3, 2026</time>
+ <span class="dot" aria-hidden="true"></span>
+ <span>6 min</span>
+ </div>
+ <h3><a href="/blog/claude-code-hooks-explained/">Claude Code Hooks, Explained (PreToolUse, PostToolUse, Stop)</a></h3>
+ <p class="dek">A practical tour of Claude Code hooks — the PreToolUse, PostToolUse, and Stop lifecycle — and how a Unix-socket hook shim drives a live office floor.</p>
+ <div class="foot">
+ <span class="tag kind">Internals</span>
+ <a class="more" href="/blog/claude-code-hooks-explained/" aria-label="Read: Claude Code Hooks, Explained (PreToolUse, PostToolUse, Stop)">Read →</a>
+ </div>
+ </div>
+</article>
+<article class="card">
+ <a class="thumb t-internals" href="/blog/node-pty-electron-real-terminals/" aria-hidden="true" tabindex="-1">
+ <span>INTERNALS</span>
+ </a>
+ <div class="body">
+ <div class="meta">
+ <time datetime="2026-06-03">Jun 3, 2026</time>
+ <span class="dot" aria-hidden="true"></span>
+ <span>7 min</span>
+ </div>
+ <h3><a href="/blog/node-pty-electron-real-terminals/">Real Terminals in Electron with node-pty</a></h3>
+ <p class="dek">How to run byte-for-byte authentic shells inside Electron with node-pty: the native-rebuild gotcha, the macOS PATH trap, and streaming PTY output over IPC.</p>
+ <div class="foot">
+ <span class="tag kind">Internals</span>
+ <a class="more" href="/blog/node-pty-electron-real-terminals/" aria-label="Read: Real Terminals in Electron with node-pty">Read →</a>
+ </div>
+ </div>
+</article>
+
+ </div>
+ </section>
+
+ </footer>
+</article>
+
+</main>
+<footer>
+ <div class="wrap">
+ <div class="foot-top">
+ <a class="foot-brand brand" href="/blog/">
+ <span class="brand-mark">MD</span>
+ <span class="brand-word">MUNDER DIFFLIN<span class="sep">/</span><span class="blog">BLOG</span></span>
+ </a>
+ <div class="foot-links">
+ <a href="/blog/">Latest</a>
+ <a href="/blog/topics/">Topics</a>
+ <a href="/blog/about/">About</a>
+ <a href="https://munderdiffl.in/blog/feed.xml">RSS</a>
+ <a href="https://github.com/chaitanyagiri/munder-difflin">GitHub</a>
+ <a href="https://munderdiffl.in">munderdiffl.in ↗</a>
+ </div>
+ </div>
+ <div class="foot-meta">
+ © 2026 Munder Difflin · Local-first · MIT-licensed ·
+ Built on <a href="https://munderdiffl.in">Electron, React, Pixi.js, xterm.js &amp; node-pty</a>.
+ Run an office of agents while you sleep.
+ </div>
+ </div>
+</footer>
+
+<script>
+ // sticky-nav border on scroll
+ (function () {
+ var nav = document.getElementById('nav');
+ if (!nav) return;
+ var onScroll = function () { nav.classList.toggle('scrolled', window.scrollY > 8); };
+ onScroll(); window.addEventListener('scroll', onScroll, { passive: true });
+ })();
+</script>
+
+</body>
+</html>
diff --git a/docs/blog/claude-code-git-worktrees-vs-hive/index.html b/docs/blog/claude-code-git-worktrees-vs-hive/index.html
index 15211d2e..acd4e5b7 100644
--- a/docs/blog/claude-code-git-worktrees-vs-hive/index.html
+++ b/docs/blog/claude-code-git-worktrees-vs-hive/index.html
@@ -289,56 +289,56 @@ team; it’s free and open source.</p>
<h2>Related in Orchestration</h2>
<div class="post-grid">
<article class="card">
- <a class="thumb t-orchestration" href="/blog/how-the-god-orchestrator-works/" aria-hidden="true" tabindex="-1">
+ <a class="thumb t-orchestration" href="/blog/human-in-the-loop-ai-agents/" aria-hidden="true" tabindex="-1">
<span>ORCHESTRATION</span>
</a>
<div class="body">
<div class="meta">
- <time datetime="2026-05-30">May 30, 2026</time>
+ <time datetime="2026-06-02">Jun 2, 2026</time>
<span class="dot" aria-hidden="true"></span>
- <span>6 min</span>
+ <span>5 min</span>
</div>
- <h3><a href="/blog/how-the-god-orchestrator-works/">Inside the GOD Orchestrator: Routing, Adjudication, Escalation</a></h3>
- <p class="dek">A deep dive into the Claude Code orchestrator: how a GOD agent reads requests, routes work, adjudicates routine traffic, and escalates the critical few.</p>
+ <h3><a href="/blog/human-in-the-loop-ai-agents/">Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down</a></h3>
+ <p class="dek">Design human-in-the-loop AI agents that stay autonomous: an approvals queue that escalates only spend, destructive ops, and scope — and relays your answer back.</p>
<div class="foot">
<span class="tag kind">Orchestration</span>
- <a class="more" href="/blog/how-the-god-orchestrator-works/" aria-label="Read: Inside the GOD Orchestrator: Routing, Adjudication, Escalation">Read →</a>
+ <a class="more" href="/blog/human-in-the-loop-ai-agents/" aria-label="Read: Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down">Read →</a>
</div>
</div>
</article>
<article class="card">
- <a class="thumb t-orchestration" href="/blog/coordinating-ai-coding-agents/" aria-hidden="true" tabindex="-1">
+ <a class="thumb t-orchestration" href="/blog/how-the-god-orchestrator-works/" aria-hidden="true" tabindex="-1">
<span>ORCHESTRATION</span>
</a>
<div class="body">
<div class="meta">
- <time datetime="2026-05-29">May 29, 2026</time>
+ <time datetime="2026-05-30">May 30, 2026</time>
<span class="dot" aria-hidden="true"></span>
- <span>5 min</span>
+ <span>6 min</span>
</div>
- <h3><a href="/blog/coordinating-ai-coding-agents/">The Best Way to Coordinate AI Coding Agents</a></h3>
- <p class="dek">The best way to coordinate AI coding agents: single-writer files, a message router, a one-scribe plan, and an orchestrator — cooperate, not clobber.</p>
+ <h3><a href="/blog/how-the-god-orchestrator-works/">Inside the GOD Orchestrator: Routing, Adjudication, Escalation</a></h3>
+ <p class="dek">A deep dive into the Claude Code orchestrator: how a GOD agent reads requests, routes work, adjudicates routine traffic, and escalates the critical few.</p>
<div class="foot">
<span class="tag kind">Orchestration</span>
- <a class="more" href="/blog/coordinating-ai-coding-agents/" aria-label="Read: The Best Way to Coordinate AI Coding Agents">Read →</a>
+ <a class="more" href="/blog/how-the-god-orchestrator-works/" aria-label="Read: Inside the GOD Orchestrator: Routing, Adjudication, Escalation">Read →</a>
</div>
</div>
</article>
<article class="card">
- <a class="thumb t-orchestration" href="/blog/claude-code-orchestration-guide/" aria-hidden="true" tabindex="-1">
+ <a class="thumb t-orchestration" href="/blog/coordinating-ai-coding-agents/" aria-hidden="true" tabindex="-1">
<span>ORCHESTRATION</span>
</a>
<div class="body">
<div class="meta">
- <time datetime="2026-05-28">May 28, 2026</time>
+ <time datetime="2026-05-29">May 29, 2026</time>
<span class="dot" aria-hidden="true"></span>
<span>5 min</span>
</div>
- <h3><a href="/blog/claude-code-orchestration-guide/">Orchestrating Claude Code Agents: A Practical Guide</a></h3>
- <p class="dek">How to orchestrate Claude Code agents in practice: what orchestration means, how a GOD orchestrator routes and escalates work, and how to wire it up.</p>
+ <h3><a href="/blog/coordinating-ai-coding-agents/">The Best Way to Coordinate AI Coding Agents</a></h3>
+ <p class="dek">The best way to coordinate AI coding agents: single-writer files, a message router, a one-scribe plan, and an orchestrator — cooperate, not clobber.</p>
<div class="foot">
<span class="tag kind">Orchestration</span>
- <a class="more" href="/blog/claude-code-orchestration-guide/" aria-label="Read: Orchestrating Claude Code Agents: A Practical Guide">Read →</a>
+ <a class="more" href="/blog/coordinating-ai-coding-agents/" aria-label="Read: The Best Way to Coordinate AI Coding Agents">Read →</a>
</div>
</div>
</article>
diff --git a/docs/blog/claude-code-orchestration-guide/index.html b/docs/blog/claude-code-orchestration-guide/index.html
index 12e8a353..e2facce0 100644
--- a/docs/blog/claude-code-orchestration-guide/index.html
+++ b/docs/blog/claude-code-orchestration-guide/index.html
@@ -307,38 +307,38 @@ agents; it’s free and open source.</p>
</div>
</article>
<article class="card">
- <a class="thumb t-orchestration" href="/blog/how-the-god-orchestrator-works/" aria-hidden="true" tabindex="-1">
+ <a class="thumb t-orchestration" href="/blog/human-in-the-loop-ai-agents/" aria-hidden="true" tabindex="-1">
<span>ORCHESTRATION</span>
</a>
<div class="body">
<div class="meta">
- <time datetime="2026-05-30">May 30, 2026</time>
+ <time datetime="2026-06-02">Jun 2, 2026</time>
<span class="dot" aria-hidden="true"></span>
- <span>6 min</span>
+ <span>5 min</span>
</div>
- <h3><a href="/blog/how-the-god-orchestrator-works/">Inside the GOD Orchestrator: Routing, Adjudication, Escalation</a></h3>
- <p class="dek">A deep dive into the Claude Code orchestrator: how a GOD agent reads requests, routes work, adjudicates routine traffic, and escalates the critical few.</p>
+ <h3><a href="/blog/human-in-the-loop-ai-agents/">Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down</a></h3>
+ <p class="dek">Design human-in-the-loop AI agents that stay autonomous: an approvals queue that escalates only spend, destructive ops, and scope — and relays your answer back.</p>
<div class="foot">
<span class="tag kind">Orchestration</span>
- <a class="more" href="/blog/how-the-god-orchestrator-works/" aria-label="Read: Inside the GOD Orchestrator: Routing, Adjudication, Escalation">Read →</a>
+ <a class="more" href="/blog/human-in-the-loop-ai-agents/" aria-label="Read: Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down">Read →</a>
</div>
</div>
</article>
<article class="card">
- <a class="thumb t-orchestration" href="/blog/coordinating-ai-coding-agents/" aria-hidden="true" tabindex="-1">
+ <a class="thumb t-orchestration" href="/blog/how-the-god-orchestrator-works/" aria-hidden="true" tabindex="-1">
<span>ORCHESTRATION</span>
</a>
<div class="body">
<div class="meta">
- <time datetime="2026-05-29">May 29, 2026</time>
+ <time datetime="2026-05-30">May 30, 2026</time>
<span class="dot" aria-hidden="true"></span>
- <span>5 min</span>
+ <span>6 min</span>
</div>
- <h3><a href="/blog/coordinating-ai-coding-agents/">The Best Way to Coordinate AI Coding Agents</a></h3>
- <p class="dek">The best way to coordinate AI coding agents: single-writer files, a message router, a one-scribe plan, and an orchestrator — cooperate, not clobber.</p>
+ <h3><a href="/blog/how-the-god-orchestrator-works/">Inside the GOD Orchestrator: Routing, Adjudication, Escalation</a></h3>
+ <p class="dek">A deep dive into the Claude Code orchestrator: how a GOD agent reads requests, routes work, adjudicates routine traffic, and escalates the critical few.</p>
<div class="foot">
<span class="tag kind">Orchestration</span>
- <a class="more" href="/blog/coordinating-ai-coding-agents/" aria-label="Read: The Best Way to Coordinate AI Coding Agents">Read →</a>
+ <a class="more" href="/blog/how-the-god-orchestrator-works/" aria-label="Read: Inside the GOD Orchestrator: Routing, Adjudication, Escalation">Read →</a>
</div>
</div>
</article>
diff --git a/docs/blog/coordinating-ai-coding-agents/index.html b/docs/blog/coordinating-ai-coding-agents/index.html
index 6f37bfc3..d04c8e15 100644
--- a/docs/blog/coordinating-ai-coding-agents/index.html
+++ b/docs/blog/coordinating-ai-coding-agents/index.html
@@ -294,38 +294,38 @@ your own team of Claude Code agents.</p>
</div>
</article>
<article class="card">
- <a class="thumb t-orchestration" href="/blog/how-the-god-orchestrator-works/" aria-hidden="true" tabindex="-1">
+ <a class="thumb t-orchestration" href="/blog/human-in-the-loop-ai-agents/" aria-hidden="true" tabindex="-1">
<span>ORCHESTRATION</span>
</a>
<div class="body">
<div class="meta">
- <time datetime="2026-05-30">May 30, 2026</time>
+ <time datetime="2026-06-02">Jun 2, 2026</time>
<span class="dot" aria-hidden="true"></span>
- <span>6 min</span>
+ <span>5 min</span>
</div>
- <h3><a href="/blog/how-the-god-orchestrator-works/">Inside the GOD Orchestrator: Routing, Adjudication, Escalation</a></h3>
- <p class="dek">A deep dive into the Claude Code orchestrator: how a GOD agent reads requests, routes work, adjudicates routine traffic, and escalates the critical few.</p>
+ <h3><a href="/blog/human-in-the-loop-ai-agents/">Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down</a></h3>
+ <p class="dek">Design human-in-the-loop AI agents that stay autonomous: an approvals queue that escalates only spend, destructive ops, and scope — and relays your answer back.</p>
<div class="foot">
<span class="tag kind">Orchestration</span>
- <a class="more" href="/blog/how-the-god-orchestrator-works/" aria-label="Read: Inside the GOD Orchestrator: Routing, Adjudication, Escalation">Read →</a>
+ <a class="more" href="/blog/human-in-the-loop-ai-agents/" aria-label="Read: Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down">Read →</a>
</div>
</div>
</article>
<article class="card">
- <a class="thumb t-orchestration" href="/blog/claude-code-orchestration-guide/" aria-hidden="true" tabindex="-1">
+ <a class="thumb t-orchestration" href="/blog/how-the-god-orchestrator-works/" aria-hidden="true" tabindex="-1">
<span>ORCHESTRATION</span>
</a>
<div class="body">
<div class="meta">
- <time datetime="2026-05-28">May 28, 2026</time>
+ <time datetime="2026-05-30">May 30, 2026</time>
<span class="dot" aria-hidden="true"></span>
- <span>5 min</span>
+ <span>6 min</span>
</div>
- <h3><a href="/blog/claude-code-orchestration-guide/">Orchestrating Claude Code Agents: A Practical Guide</a></h3>
- <p class="dek">How to orchestrate Claude Code agents in practice: what orchestration means, how a GOD orchestrator routes and escalates work, and how to wire it up.</p>
+ <h3><a href="/blog/how-the-god-orchestrator-works/">Inside the GOD Orchestrator: Routing, Adjudication, Escalation</a></h3>
+ <p class="dek">A deep dive into the Claude Code orchestrator: how a GOD agent reads requests, routes work, adjudicates routine traffic, and escalates the critical few.</p>
<div class="foot">
<span class="tag kind">Orchestration</span>
- <a class="more" href="/blog/claude-code-orchestration-guide/" aria-label="Read: Orchestrating Claude Code Agents: A Practical Guide">Read →</a>
+ <a class="more" href="/blog/how-the-god-orchestrator-works/" aria-label="Read: Inside the GOD Orchestrator: Routing, Adjudication, Escalation">Read →</a>
</div>
</div>
</article>
diff --git a/docs/blog/feed.xml b/docs/blog/feed.xml
index 1e151587..92597f33 100644
--- a/docs/blog/feed.xml
+++ b/docs/blog/feed.xml
@@ -135,6 +135,14 @@
<updated>2026-06-02T00:00:00.000Z</updated><category term="Comparisons" />
<summary>A decision framework for choosing a multi-agent coding tool — memory, control, visibility, cost, local-first — with a simple scoring rubric you can run.</summary>
</entry>
+ <entry>
+ <title>Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down</title>
+ <link href="https://munderdiffl.in/blog/human-in-the-loop-ai-agents/" />
+ <id>https://munderdiffl.in/blog/human-in-the-loop-ai-agents/</id>
+ <published>2026-06-02T00:00:00.000Z</published>
+ <updated>2026-06-02T00:00:00.000Z</updated><category term="Orchestration" />
+ <summary>Design human-in-the-loop AI agents that stay autonomous: an approvals queue that escalates only spend, destructive ops, and scope — and relays your answer back.</summary>
+ </entry>
<entry>
<title>Munder Difflin FAQ: Everything People Ask</title>
<link href="https://munderdiffl.in/blog/munder-difflin-faq/" />
@@ -183,6 +191,14 @@
<updated>2026-06-02T00:00:00.000Z</updated><category term="Story" />
<summary>The origin story of Munder Difflin — how the pain of juggling Claude Code terminals led to a coordinated, memory-backed hive of agents you can watch.</summary>
</entry>
+ <entry>
+ <title>An Append-Only Event Log for a Hive of Agents</title>
+ <link href="https://munderdiffl.in/blog/append-only-event-log-agents/" />
+ <id>https://munderdiffl.in/blog/append-only-event-log-agents/</id>
+ <published>2026-06-01T00:00:00.000Z</published>
+ <updated>2026-06-01T00:00:00.000Z</updated><category term="Internals" />
+ <summary>How an append-only event log makes a multi-agent system debuggable and replayable — what to record per event, and why one JSON line per event beats a database.</summary>
+ </entry>
<entry>
<title>How to Run Multiple Claude Code Agents (Without Losing Track)</title>
<link href="https://munderdiffl.in/blog/how-to-run-multiple-claude-code-agents/" />
diff --git a/docs/blog/how-the-god-orchestrator-works/index.html b/docs/blog/how-the-god-orchestrator-works/index.html
index c06b50c8..e74d5b2a 100644
--- a/docs/blog/how-the-god-orchestrator-works/index.html
+++ b/docs/blog/how-the-god-orchestrator-works/index.html
@@ -328,38 +328,38 @@ to put one in charge of your floor; it’s free and open source.</p>
</div>
</article>
<article class="card">
- <a class="thumb t-orchestration" href="/blog/coordinating-ai-coding-agents/" aria-hidden="true" tabindex="-1">
+ <a class="thumb t-orchestration" href="/blog/human-in-the-loop-ai-agents/" aria-hidden="true" tabindex="-1">
<span>ORCHESTRATION</span>
</a>
<div class="body">
<div class="meta">
- <time datetime="2026-05-29">May 29, 2026</time>
+ <time datetime="2026-06-02">Jun 2, 2026</time>
<span class="dot" aria-hidden="true"></span>
<span>5 min</span>
</div>
- <h3><a href="/blog/coordinating-ai-coding-agents/">The Best Way to Coordinate AI Coding Agents</a></h3>
- <p class="dek">The best way to coordinate AI coding agents: single-writer files, a message router, a one-scribe plan, and an orchestrator — cooperate, not clobber.</p>
+ <h3><a href="/blog/human-in-the-loop-ai-agents/">Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down</a></h3>
+ <p class="dek">Design human-in-the-loop AI agents that stay autonomous: an approvals queue that escalates only spend, destructive ops, and scope — and relays your answer back.</p>
<div class="foot">
<span class="tag kind">Orchestration</span>
- <a class="more" href="/blog/coordinating-ai-coding-agents/" aria-label="Read: The Best Way to Coordinate AI Coding Agents">Read →</a>
+ <a class="more" href="/blog/human-in-the-loop-ai-agents/" aria-label="Read: Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down">Read →</a>
</div>
</div>
</article>
<article class="card">
- <a class="thumb t-orchestration" href="/blog/claude-code-orchestration-guide/" aria-hidden="true" tabindex="-1">
+ <a class="thumb t-orchestration" href="/blog/coordinating-ai-coding-agents/" aria-hidden="true" tabindex="-1">
<span>ORCHESTRATION</span>
</a>
<div class="body">
<div class="meta">
- <time datetime="2026-05-28">May 28, 2026</time>
+ <time datetime="2026-05-29">May 29, 2026</time>
<span class="dot" aria-hidden="true"></span>
<span>5 min</span>
</div>
- <h3><a href="/blog/claude-code-orchestration-guide/">Orchestrating Claude Code Agents: A Practical Guide</a></h3>
- <p class="dek">How to orchestrate Claude Code agents in practice: what orchestration means, how a GOD orchestrator routes and escalates work, and how to wire it up.</p>
+ <h3><a href="/blog/coordinating-ai-coding-agents/">The Best Way to Coordinate AI Coding Agents</a></h3>
+ <p class="dek">The best way to coordinate AI coding agents: single-writer files, a message router, a one-scribe plan, and an orchestrator — cooperate, not clobber.</p>
<div class="foot">
<span class="tag kind">Orchestration</span>
- <a class="more" href="/blog/claude-code-orchestration-guide/" aria-label="Read: Orchestrating Claude Code Agents: A Practical Guide">Read →</a>
+ <a class="more" href="/blog/coordinating-ai-coding-agents/" aria-label="Read: The Best Way to Coordinate AI Coding Agents">Read →</a>
</div>
</div>
</article>
diff --git a/docs/blog/how-to-choose-a-multi-agent-tool/index.html b/docs/blog/how-to-choose-a-multi-agent-tool/index.html
index 0f8dba9a..30eacf75 100644
--- a/docs/blog/how-to-choose-a-multi-agent-tool/index.html
+++ b/docs/blog/how-to-choose-a-multi-agent-tool/index.html
@@ -273,7 +273,7 @@ local-first.</p>
</div>
<footer class="post-foot wrap"><div class="prevnext">
- <a class="pn prev" href="/blog/munder-difflin-faq/"><span class="k">← Older</span><span class="t">Munder Difflin FAQ: Everything People Ask</span></a>
+ <a class="pn prev" href="/blog/human-in-the-loop-ai-agents/"><span class="k">← Older</span><span class="t">Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down</span></a>
<a class="pn next" href="/blog/from-one-terminal-to-a-team/"><span class="k">Newer →</span><span class="t">From One Terminal to a Team: Scaling Your Claude Code Workflow</span></a>
</div>
<section class="related">
diff --git a/docs/blog/how-to-run-multiple-claude-code-agents/index.html b/docs/blog/how-to-run-multiple-claude-code-agents/index.html
index f99ed7f7..5d6ba34e 100644
--- a/docs/blog/how-to-run-multiple-claude-code-agents/index.html
+++ b/docs/blog/how-to-run-multiple-claude-code-agents/index.html
@@ -209,7 +209,7 @@ free and open source.</p>
<footer class="post-foot wrap"><div class="prevnext">
<a class="pn prev" href="/blog/atomic-file-mailboxes-for-agents/"><span class="k">← Older</span><span class="t">Atomic File Mailboxes: How Agents Message Each Other</span></a>
- <a class="pn next" href="/blog/why-we-built-munder-difflin/"><span class="k">Newer →</span><span class="t">Why We Built Munder Difflin</span></a>
+ <a class="pn next" href="/blog/append-only-event-log-agents/"><span class="k">Newer →</span><span class="t">An Append-Only Event Log for a Hive of Agents</span></a>
</div>
<section class="related">
<h2>Related in Guides</h2>
diff --git a/docs/blog/human-in-the-loop-ai-agents/index.html b/docs/blog/human-in-the-loop-ai-agents/index.html
new file mode 100644
index 00000000..66d532ea
--- /dev/null
+++ b/docs/blog/human-in-the-loop-ai-agents/index.html
@@ -0,0 +1,378 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="UTF-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<title>Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down — Munder Difflin Blog</title>
+<meta name="description" content="Design human-in-the-loop AI agents that stay autonomous: an approvals queue that escalates only spend, destructive ops, and scope — and relays your answer back." />
+<link rel="canonical" href="https://munderdiffl.in/blog/human-in-the-loop-ai-agents/" />
+
+<link rel="icon" type="image/png" href="https://munderdiffl.in/logo.png" />
+<link rel="apple-touch-icon" href="https://munderdiffl.in/logo.png" />
+<meta name="theme-color" content="#F5F2E8" />
+
+<!-- Open Graph -->
+<meta property="og:site_name" content="Munder Difflin Blog" />
+<meta property="og:type" content="article" />
+<meta property="og:title" content="Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down — Munder Difflin Blog" />
+<meta property="og:description" content="Design human-in-the-loop AI agents that stay autonomous: an approvals queue that escalates only spend, destructive ops, and scope — and relays your answer back." />
+<meta property="og:url" content="https://munderdiffl.in/blog/human-in-the-loop-ai-agents/" />
+<meta property="og:image" content="https://munderdiffl.in/media/og.png" />
+<meta property="og:locale" content="en_US" />
+<meta property="article:published_time" content="2026-06-02T00:00:00.000Z" />
+<meta property="article:author" content="Chaitanya Giri" />
+<meta property="article:tag" content="Orchestration" />
+<meta property="article:tag" content="Human-in-the-Loop" />
+<meta property="article:tag" content="Guardrails" />
+<meta property="article:tag" content="Multi-Agent" />
+
+
+<!-- Twitter -->
+<meta name="twitter:card" content="summary_large_image" />
+<meta name="twitter:title" content="Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down — Munder Difflin Blog" />
+<meta name="twitter:description" content="Design human-in-the-loop AI agents that stay autonomous: an approvals queue that escalates only spend, destructive ops, and scope — and relays your answer back." />
+<meta name="twitter:image" content="https://munderdiffl.in/media/og.png" />
+
+<link rel="alternate" type="application/atom+xml" title="Munder Difflin Blog" href="https://munderdiffl.in/blog/feed.xml" />
+<link rel="preconnect" href="https://fonts.googleapis.com" />
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+<link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600&family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet" />
+<link rel="stylesheet" href="/blog/assets/blog.css" />
+
+<script type="application/ld+json">
+{
+ "@context": "https://schema.org",
+ "@type": "BlogPosting",
+ "headline": "Human-in-the-Loop AI Agents: Approvals That Don't Slow You Down",
+ "description": "Design human-in-the-loop AI agents that stay autonomous: an approvals queue that escalates only spend, destructive ops, and scope — and relays your answer back.",
+ "image": ["https://munderdiffl.in/media/og.png"],
+ "datePublished": "2026-06-02T00:00:00.000Z",
+ "dateModified": "2026-06-02T00:00:00.000Z",
+ "author": { "@type": "Person", "name": "Chaitanya Giri" },
+ "publisher": {
+ "@type": "Organization",
+ "name": "Munder Difflin",
+ "logo": { "@type": "ImageObject", "url": "https://munderdiffl.in/logo.png" }
+ },
+ "mainEntityOfPage": { "@type": "WebPage", "@id": "https://munderdiffl.in/blog/human-in-the-loop-ai-agents/" },
+ "keywords": "human in the loop ai agents, human in the loop, ai approvals, agent guardrails",
+ "articleSection": "Orchestration",
+ "inLanguage": "en-US",
+ "url": "https://munderdiffl.in/blog/human-in-the-loop-ai-agents/"
+}
+</script>
+<script type="application/ld+json">
+{
+ "@context": "https://schema.org",
+ "@type": "BreadcrumbList",
+ "itemListElement": [
+ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://munderdiffl.in/" },
+ { "@type": "ListItem", "position": 2, "name": "Blog", "item": "https://munderdiffl.in/blog/" },
+ { "@type": "ListItem", "position": 3, "name": "Human-in-the-Loop AI Agents: Approvals That Don't Slow You Down", "item": "https://munderdiffl.in/blog/human-in-the-loop-ai-agents/" }
+ ]
+}
+</script>
+
+<script type="application/ld+json">
+{
+ "@context": "https://schema.org",
+ "@type": "FAQPage",
+ "mainEntity": [
+ { "@type": "Question", "name": "What does human-in-the-loop mean for AI agents?", "acceptedAnswer": { "@type": "Answer", "text": "It means a human stays in control of the decisions that matter, while the agents handle everything routine on their own. The skill is in drawing the line: escalate the few critical calls (spend, destructive ops, scope changes) and let the rest run autonomously." } },
+ { "@type": "Question", "name": "Doesn't requiring approvals make agents slow?", "acceptedAnswer": { "@type": "Answer", "text": "Only if you approve everything. A good design escalates a small, explicit set of critical actions and resolves the rest automatically, so you're tapped on the shoulder a few times a day, not a few times a minute." } },
+ { "@type": "Question", "name": "How does the human's answer get back to the agent?", "acceptedAnswer": { "@type": "Answer", "text": "The escalated item waits in an approvals queue. When you approve or reject — optionally with a note like 'yes, but cap it at $5' — that decision is relayed back to the agent that asked, as a message from the human, and it continues with your guidance." } }
+
+ ]
+}
+</script>
+
+
+</head>
+<body>
+<a class="skip-link" href="#main">Skip to content</a>
+<nav id="nav">
+ <a class="brand" href="/blog/" aria-label="Munder Difflin Blog home">
+ <span class="brand-mark">MD</span>
+ <span class="brand-word">MUNDER DIFFLIN<span class="sep">/</span><span class="blog">BLOG</span></span>
+ </a>
+ <span class="spacer"></span>
+ <div class="links">
+ <a href="/blog/">Latest</a>
+ <a href="/blog/topics/">Topics</a>
+ <a href="/blog/about/">About</a>
+ <a href="https://munderdiffl.in">↗ Product</a>
+ </div>
+ <div class="nav-actions">
+ <a class="btn sm" href="https://munderdiffl.in/blog/feed.xml" aria-label="RSS feed">⤵ RSS</a>
+ <a class="btn sm primary" href="https://munderdiffl.in/#install">⤓ Download</a>
+ </div>
+</nav>
+
+<main id="main">
+
+<article>
+ <header class="post-head wrap">
+ <nav class="crumbs" aria-label="Breadcrumb">
+ <a href="/blog/">Blog</a>
+ <span>/</span>
+ <a href="/blog/topics/orchestration/">Orchestration</a>
+ </nav>
+ <h1>Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down</h1>
+ <p class="dek">Design human-in-the-loop AI agents that stay autonomous: an approvals queue that escalates only spend, destructive ops, and scope — and relays your answer back.</p>
+ <div class="byline">
+ <span class="av" aria-hidden="true">CG</span>
+ <strong>Chaitanya Giri</strong>
+ <span class="dot" aria-hidden="true">·</span>
+ <time datetime="2026-06-02">Jun 2, 2026</time>
+ <span class="dot" aria-hidden="true">·</span>
+ <span>5 min read</span>
+ <span class="tag kind">Orchestration</span>
+ </div>
+ </header>
+
+ <div class="post-wrap wrap">
+ <div class="prose">
+ <div class="callout tldr"><span class="ic">TL;DR</span><p>Good
+<strong>human-in-the-loop AI agents</strong> don't ask permission for everything — they escalate only
+the <strong>critical few</strong> (spending money, destructive operations, scope changes,
+unresolvable conflicts) to an <strong>approvals queue</strong>, and resolve the rest themselves. Your
+answer, with an optional note, is <strong>relayed back</strong> to the agent that asked. The result:
+autonomy by default, human judgment exactly where it matters.</p></div>
+<p>“Human-in-the-loop” gets misread as “human approves every step.” That version is miserable — it turns
+a team of agents into a clicking exercise and throws away the whole point of autonomy. The version
+that works is the opposite: agents run on their own, and a human is pulled in <em>only</em> for the decisions
+that genuinely require a person. This post is about designing that line well.</p>
+<h2 id="the-trap-approval-fatigue" tabindex="-1">The trap: approval fatigue <a class="anchor" href="#the-trap-approval-fatigue" aria-hidden="true">#</a></h2>
+<p>If every file write, every command, every message needs your sign-off, two things happen. First, you
+become the bottleneck — the agents are only as fast as your reaction time. Second, you stop reading
+the approvals; after the hundredth “can I edit this file?”, you click yes on autopilot, which means the
+<em>one</em> approval that mattered slips through. Asking for everything is functionally the same as asking
+for nothing.</p>
+<p>So the goal isn’t “more approvals.” It’s <strong>fewer, better</strong> approvals — a queue that stays empty except
+when something real needs you.</p>
+<h2 id="draw-the-line-explicitly" tabindex="-1">Draw the line explicitly <a class="anchor" href="#draw-the-line-explicitly" aria-hidden="true">#</a></h2>
+<p>The core design decision is a written list of what counts as <strong>critical</strong>. Everything on the list
+escalates to a human; everything else the agents handle. A solid default:</p>
+<ul>
+<li><strong>Destructive operations</strong> — deleting data, force-pushing, anything hard to undo.</li>
+<li><strong>Spending real money</strong> — actions with a dollar cost.</li>
+<li><strong>Scope changes</strong> — work drifting from what you actually asked for.</li>
+<li><strong>Unresolvable conflicts</strong> — two agents at an impasse that can’t be settled internally.</li>
+</ul>
+<p>The power of making this <em>explicit</em> is that it becomes a control surface you can tune. Too many
+interruptions? Tighten the list. Agents doing things that scare you? Loosen what they’re allowed to
+decide alone. In a hive, this policy lives in the <a href="/blog/how-the-god-orchestrator-works/">orchestrator’s</a>
+instructions — so you adjust behavior by editing a prompt, not by shipping code.</p>
+<h2 id="how-escalation-actually-works" tabindex="-1">How escalation actually works <a class="anchor" href="#how-escalation-actually-works" aria-hidden="true">#</a></h2>
+<p>When an agent (or the orchestrator on its behalf) hits something critical, it doesn’t act. It addresses
+a message to the human — or flags the item as needing human attention — and the coordinating process
+diverts it into an <strong>approvals queue</strong> instead of delivering it normally. Mechanically it’s the same
+messaging fabric agents use for each other (<a href="/blog/atomic-file-mailboxes-for-agents/">atomic file mailboxes</a>),
+with one rule: anything marked for the human lands in the queue, not in another agent’s inbox.</p>
+<p>The queue surfaces in the UI as a short list of “I need your call on these.” Each item carries enough
+context to decide: who’s asking, what they want to do, and why it’s critical.</p>
+<h2 id="the-answer-round-trips" tabindex="-1">The answer round-trips <a class="anchor" href="#the-answer-round-trips" aria-hidden="true">#</a></h2>
+<p>Approval isn’t a dead end — it’s a conversation. When you resolve an item, two things can travel back:</p>
+<ol>
+<li><strong>The decision.</strong> Approve, and the held action proceeds. Reject, and it doesn’t.</li>
+<li><strong>A note.</strong> You can attach guidance — “yes, but cap it at $5,” “no, use the staging DB instead” —
+and that note is relayed back to the agent that asked, as a message from the human.</li>
+</ol>
+<p>That round-trip is what makes human-in-the-loop feel like <em>delegation</em> rather than <em>gatekeeping</em>. The
+agent asked a real question; you answered it; it continues with your answer in hand. You’re not
+blocking the work, you’re steering it at the one fork that needed a person.</p>
+<h2 id="guardrails-that-keep-the-queue-honest" tabindex="-1">Guardrails that keep the queue honest <a class="anchor" href="#guardrails-that-keep-the-queue-honest" aria-hidden="true">#</a></h2>
+<p>A couple of structural safeguards keep escalation from being gamed or from livelocking:</p>
+<ul>
+<li><strong>A hop cap.</strong> If two agents bounce a question back and forth past a limit, the system stops the
+ping-pong and escalates to the human instead of letting it loop forever. The cap is a fuse: when
+agents can’t resolve something between themselves, a person breaks the tie.</li>
+<li><strong>Fail toward asking.</strong> When the system is unsure whether something is critical — an edge case, an
+addressing ambiguity — the safe default is to route it to the human rather than to act. “Ask” is a
+better failure mode than “guess.”</li>
+</ul>
+<p>These mean the queue catches the things that <em>should</em> reach you even when the agents don’t explicitly
+flag them.</p>
+<h2 id="why-this-beats-approve-everything-and-approve-nothing" tabindex="-1">Why this beats “approve everything” and “approve nothing” <a class="anchor" href="#why-this-beats-approve-everything-and-approve-nothing" aria-hidden="true">#</a></h2>
+<ul>
+<li><strong>vs. approve everything:</strong> you keep autonomy and your attention. The agents do the 95% that’s
+routine without you, and the queue stays short enough that you actually read it.</li>
+<li><strong>vs. approve nothing (full autonomy):</strong> you keep control of the dangerous 5%. Money, destructive
+ops, and scope drift don’t happen behind your back — they wait for you.</li>
+</ul>
+<p>The selective-escalation model is what lets a hive run unattended for long stretches and still be
+safe, which is the foundation of <a href="/blog/claude-code-automation-while-you-sleep/">letting agents build while you sleep</a>:
+you wake up to progress plus a short approvals list, not a pile of irreversible actions. It’s also the
+core of <a href="/blog/coordinating-ai-coding-agents/">coordinating AI coding agents</a> — the orchestrator
+adjudicates the routine traffic and escalates only what it should.</p>
+<h2 id="designing-your-own-escalation-policy" tabindex="-1">Designing your own escalation policy <a class="anchor" href="#designing-your-own-escalation-policy" aria-hidden="true">#</a></h2>
+<p>If you’re building this, a few principles:</p>
+<ul>
+<li><strong>Start stricter, then loosen.</strong> Begin with a broader critical list and relax it as you learn what
+the agents handle well. Earning trust beats assuming it.</li>
+<li><strong>Make every escalation legible.</strong> An approval you can’t understand at a glance is one you’ll
+rubber-stamp. Include the <em>why</em>, not just the <em>what</em>.</li>
+<li><strong>Log every decision.</strong> Approvals and rejections belong in the <a href="/blog/append-only-event-log-agents/">event log</a>
+so “who approved this?” always has an answer.</li>
+<li><strong>Keep the human’s note actionable.</strong> The point of the round-trip is steering; make it easy to send
+guidance, not just a yes/no.</li>
+</ul>
+<h2 id="faq" tabindex="-1">FAQ <a class="anchor" href="#faq" aria-hidden="true">#</a></h2>
+<p><strong>What if I’m away when something escalates?</strong> It waits. The held item sits in the queue until you
+resolve it — the agent that asked is blocked on that one decision but the rest of the team keeps
+working. Nothing critical happens without you.</p>
+<p><strong>Can the agents escalate too much?</strong> They can, early on — which is exactly why the critical list is
+tunable. If the queue is noisy, tighten the policy so more decisions are handled autonomously.</p>
+<hr>
+<p>Munder Difflin ships human-in-the-loop the right way: a GOD orchestrator that resolves routine traffic
+itself and an approvals queue that escalates only the critical few — with your notes relayed straight
+back. <a href="https://munderdiffl.in/#install">Download Munder Difflin</a> to run agents that stay autonomous
+and ask only when they should; it’s free and open source.</p>
+
+
+
+ <section class="faq" aria-label="Frequently asked questions">
+ <h2 id="faq">FAQ</h2>
+
+ <div class="qa">
+ <p class="q">What does human-in-the-loop mean for AI agents?</p>
+ <p class="a">It means a human stays in control of the decisions that matter, while the agents handle everything routine on their own. The skill is in drawing the line: escalate the few critical calls (spend, destructive ops, scope changes) and let the rest run autonomously.</p>
+ </div>
+
+ <div class="qa">
+ <p class="q">Doesn&#39;t requiring approvals make agents slow?</p>
+ <p class="a">Only if you approve everything. A good design escalates a small, explicit set of critical actions and resolves the rest automatically, so you&#39;re tapped on the shoulder a few times a day, not a few times a minute.</p>
+ </div>
+
+ <div class="qa">
+ <p class="q">How does the human&#39;s answer get back to the agent?</p>
+ <p class="a">The escalated item waits in an approvals queue. When you approve or reject — optionally with a note like &#39;yes, but cap it at $5&#39; — that decision is relayed back to the agent that asked, as a message from the human, and it continues with your guidance.</p>
+ </div>
+
+ </section>
+
+
+
+ <hr />
+ <div class="share">
+ <span class="lbl">Tags</span>
+ <a class="tag" href="/blog/tags/orchestration/">Orchestration</a><a class="tag" href="/blog/tags/human-in-the-loop/">Human-in-the-Loop</a><a class="tag" href="/blog/tags/guardrails/">Guardrails</a><a class="tag" href="/blog/tags/multi-agent/">Multi-Agent</a>
+ </div>
+
+ </div>
+
+
+ <aside class="toc-rail" aria-label="Table of contents">
+ <div class="tt">On this page</div>
+ <ol>
+ <li class="lvl-2"><a href="#the-trap-approval-fatigue">The trap: approval fatigue</a></li><li class="lvl-2"><a href="#draw-the-line-explicitly">Draw the line explicitly</a></li><li class="lvl-2"><a href="#how-escalation-actually-works">How escalation actually works</a></li><li class="lvl-2"><a href="#the-answer-round-trips">The answer round-trips</a></li><li class="lvl-2"><a href="#guardrails-that-keep-the-queue-honest">Guardrails that keep the queue honest</a></li><li class="lvl-2"><a href="#why-this-beats-approve-everything-and-approve-nothing">Why this beats “approve everything” and “approve nothing”</a></li><li class="lvl-2"><a href="#designing-your-own-escalation-policy">Designing your own escalation policy</a></li><li class="lvl-2"><a href="#faq">FAQ</a></li>
+ </ol>
+ </aside>
+
+ </div>
+
+ <footer class="post-foot wrap"><div class="prevnext">
+ <a class="pn prev" href="/blog/munder-difflin-faq/"><span class="k">← Older</span><span class="t">Munder Difflin FAQ: Everything People Ask</span></a>
+ <a class="pn next" href="/blog/how-to-choose-a-multi-agent-tool/"><span class="k">Newer →</span><span class="t">How to Choose a Multi-Agent Coding Tool: A Buyer&#39;s Checklist</span></a>
+ </div>
+ <section class="related">
+ <h2>Related in Orchestration</h2>
+ <div class="post-grid">
+ <article class="card">
+ <a class="thumb t-orchestration" href="/blog/claude-code-git-worktrees-vs-hive/" aria-hidden="true" tabindex="-1">
+ <span>ORCHESTRATION</span>
+ </a>
+ <div class="body">
+ <div class="meta">
+ <time datetime="2026-06-04">Jun 4, 2026</time>
+ <span class="dot" aria-hidden="true"></span>
+ <span>5 min</span>
+ </div>
+ <h3><a href="/blog/claude-code-git-worktrees-vs-hive/">Git Worktrees vs a Hive: Two Ways to Parallelize Claude Code</a></h3>
+ <p class="dek">Claude Code git worktrees vs a hive: when isolated worktrees suffice for parallel agents, and when you need memory, messaging, and an orchestrator on top.</p>
+ <div class="foot">
+ <span class="tag kind">Orchestration</span>
+ <a class="more" href="/blog/claude-code-git-worktrees-vs-hive/" aria-label="Read: Git Worktrees vs a Hive: Two Ways to Parallelize Claude Code">Read →</a>
+ </div>
+ </div>
+</article>
+<article class="card">
+ <a class="thumb t-orchestration" href="/blog/how-the-god-orchestrator-works/" aria-hidden="true" tabindex="-1">
+ <span>ORCHESTRATION</span>
+ </a>
+ <div class="body">
+ <div class="meta">
+ <time datetime="2026-05-30">May 30, 2026</time>
+ <span class="dot" aria-hidden="true"></span>
+ <span>6 min</span>
+ </div>
+ <h3><a href="/blog/how-the-god-orchestrator-works/">Inside the GOD Orchestrator: Routing, Adjudication, Escalation</a></h3>
+ <p class="dek">A deep dive into the Claude Code orchestrator: how a GOD agent reads requests, routes work, adjudicates routine traffic, and escalates the critical few.</p>
+ <div class="foot">
+ <span class="tag kind">Orchestration</span>
+ <a class="more" href="/blog/how-the-god-orchestrator-works/" aria-label="Read: Inside the GOD Orchestrator: Routing, Adjudication, Escalation">Read →</a>
+ </div>
+ </div>
+</article>
+<article class="card">
+ <a class="thumb t-orchestration" href="/blog/coordinating-ai-coding-agents/" aria-hidden="true" tabindex="-1">
+ <span>ORCHESTRATION</span>
+ </a>
+ <div class="body">
+ <div class="meta">
+ <time datetime="2026-05-29">May 29, 2026</time>
+ <span class="dot" aria-hidden="true"></span>
+ <span>5 min</span>
+ </div>
+ <h3><a href="/blog/coordinating-ai-coding-agents/">The Best Way to Coordinate AI Coding Agents</a></h3>
+ <p class="dek">The best way to coordinate AI coding agents: single-writer files, a message router, a one-scribe plan, and an orchestrator — cooperate, not clobber.</p>
+ <div class="foot">
+ <span class="tag kind">Orchestration</span>
+ <a class="more" href="/blog/coordinating-ai-coding-agents/" aria-label="Read: The Best Way to Coordinate AI Coding Agents">Read →</a>
+ </div>
+ </div>
+</article>
+
+ </div>
+ </section>
+
+ </footer>
+</article>
+
+</main>
+<footer>
+ <div class="wrap">
+ <div class="foot-top">
+ <a class="foot-brand brand" href="/blog/">
+ <span class="brand-mark">MD</span>
+ <span class="brand-word">MUNDER DIFFLIN<span class="sep">/</span><span class="blog">BLOG</span></span>
+ </a>
+ <div class="foot-links">
+ <a href="/blog/">Latest</a>
+ <a href="/blog/topics/">Topics</a>
+ <a href="/blog/about/">About</a>
+ <a href="https://munderdiffl.in/blog/feed.xml">RSS</a>
+ <a href="https://github.com/chaitanyagiri/munder-difflin">GitHub</a>
+ <a href="https://munderdiffl.in">munderdiffl.in ↗</a>
+ </div>
+ </div>
+ <div class="foot-meta">
+ © 2026 Munder Difflin · Local-first · MIT-licensed ·
+ Built on <a href="https://munderdiffl.in">Electron, React, Pixi.js, xterm.js &amp; node-pty</a>.
+ Run an office of agents while you sleep.
+ </div>
+ </div>
+</footer>
+
+<script>
+ // sticky-nav border on scroll
+ (function () {
+ var nav = document.getElementById('nav');
+ if (!nav) return;
+ var onScroll = function () { nav.classList.toggle('scrolled', window.scrollY > 8); };
+ onScroll(); window.addEventListener('scroll', onScroll, { passive: true });
+ })();
+</script>
+
+</body>
+</html>
diff --git a/docs/blog/index.html b/docs/blog/index.html
index 74b2aa0b..d89eaf3e 100644
--- a/docs/blog/index.html
+++ b/docs/blog/index.html
@@ -85,17 +85,17 @@
building a self-coordinating hive of agents with a GOD orchestrator you talk to.</p>
<div class="filters" role="navigation" aria-label="Topics">
- <a class="chip" aria-current="page">All<span class="ct">33</span></a>
+ <a class="chip" aria-current="page">All<span class="ct">35</span></a>
<a class="chip" href="/blog/topics/comparisons/">comparisons<span class="ct">8</span></a>
<a class="chip" href="/blog/topics/guides/">guides<span class="ct">6</span></a>
- <a class="chip" href="/blog/topics/internals/">internals<span class="ct">5</span></a>
+ <a class="chip" href="/blog/topics/internals/">internals<span class="ct">6</span></a>
- <a class="chip" href="/blog/topics/concepts/">concepts<span class="ct">4</span></a>
+ <a class="chip" href="/blog/topics/orchestration/">orchestration<span class="ct">5</span></a>
- <a class="chip" href="/blog/topics/orchestration/">orchestration<span class="ct">4</span></a>
+ <a class="chip" href="/blog/topics/concepts/">concepts<span class="ct">4</span></a>
<a class="chip" href="/blog/topics/use-cases/">use-cases<span class="ct">3</span></a>
@@ -401,6 +401,24 @@
</div>
</div>
</article>
+<article class="card">
+ <a class="thumb t-orchestration" href="/blog/human-in-the-loop-ai-agents/" aria-hidden="true" tabindex="-1">
+ <span>ORCHESTRATION</span>
+ </a>
+ <div class="body">
+ <div class="meta">
+ <time datetime="2026-06-02">Jun 2, 2026</time>
+ <span class="dot" aria-hidden="true"></span>
+ <span>5 min</span>
+ </div>
+ <h3><a href="/blog/human-in-the-loop-ai-agents/">Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down</a></h3>
+ <p class="dek">Design human-in-the-loop AI agents that stay autonomous: an approvals queue that escalates only spend, destructive ops, and scope — and relays your answer back.</p>
+ <div class="foot">
+ <span class="tag kind">Orchestration</span>
+ <a class="more" href="/blog/human-in-the-loop-ai-agents/" aria-label="Read: Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down">Read →</a>
+ </div>
+ </div>
+</article>
<article class="card">
<a class="thumb t-concepts" href="/blog/munder-difflin-faq/" aria-hidden="true" tabindex="-1">
<span>CONCEPTS</span>
@@ -509,6 +527,24 @@
</div>
</div>
</article>
+<article class="card">
+ <a class="thumb t-internals" href="/blog/append-only-event-log-agents/" aria-hidden="true" tabindex="-1">
+ <span>INTERNALS</span>
+ </a>
+ <div class="body">
+ <div class="meta">
+ <time datetime="2026-06-01">Jun 1, 2026</time>
+ <span class="dot" aria-hidden="true"></span>
+ <span>5 min</span>
+ </div>
+ <h3><a href="/blog/append-only-event-log-agents/">An Append-Only Event Log for a Hive of Agents</a></h3>
+ <p class="dek">How an append-only event log makes a multi-agent system debuggable and replayable — what to record per event, and why one JSON line per event beats a database.</p>
+ <div class="foot">
+ <span class="tag kind">Internals</span>
+ <a class="more" href="/blog/append-only-event-log-agents/" aria-label="Read: An Append-Only Event Log for a Hive of Agents">Read →</a>
+ </div>
+ </div>
+</article>
<article class="card">
<a class="thumb t-guides" href="/blog/how-to-run-multiple-claude-code-agents/" aria-hidden="true" tabindex="-1">
<span>GUIDES</span>
diff --git a/docs/blog/munder-difflin-faq/index.html b/docs/blog/munder-difflin-faq/index.html
index df35e088..b014f3a3 100644
--- a/docs/blog/munder-difflin-faq/index.html
+++ b/docs/blog/munder-difflin-faq/index.html
@@ -143,7 +143,7 @@
<div class="prose">
<div class="callout tldr"><span class="ic">TL;DR</span><p><strong>Munder Difflin</strong> is a free,
open-source (MIT), local-first desktop app that turns the Claude Code terminals you already run into a
-coordinated hive — shared memory, messaging, and a [GOD orchestrator](/#how) you talk to — on macOS,
+coordinated hive — shared memory, messaging, and a <a href="/#how">GOD orchestrator</a> you talk to — on macOS,
Windows, and Linux. The full answers to the questions people ask most are below.</p></div>
<p>This page answers the questions we hear most about Munder Difflin, kept short and direct. If your
question isn’t here, the <a href="https://github.com/chaitanyagiri/munder-difflin">GitHub repo</a> and the rest
@@ -248,7 +248,7 @@ free, open source, and local-first.</p>
<footer class="post-foot wrap"><div class="prevnext">
<a class="pn prev" href="/blog/run-an-office-of-ai-agents/"><span class="k">← Older</span><span class="t">Run an Office of AI Agents While You Sleep</span></a>
- <a class="pn next" href="/blog/how-to-choose-a-multi-agent-tool/"><span class="k">Newer →</span><span class="t">How to Choose a Multi-Agent Coding Tool: A Buyer&#39;s Checklist</span></a>
+ <a class="pn next" href="/blog/human-in-the-loop-ai-agents/"><span class="k">Newer →</span><span class="t">Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down</span></a>
</div>
<section class="related">
<h2>Related in Concepts</h2>
diff --git a/docs/blog/tags/event-log/index.html b/docs/blog/tags/event-log/index.html
new file mode 100644
index 00000000..8aba0440
--- /dev/null
+++ b/docs/blog/tags/event-log/index.html
@@ -0,0 +1,124 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="UTF-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<title>Event Log — Munder Difflin Blog</title>
+<meta name="description" content="Munder Difflin blog posts tagged Event Log." />
+<link rel="canonical" href="https://munderdiffl.in/blog/tags/event-log/" />
+
+<link rel="icon" type="image/png" href="https://munderdiffl.in/logo.png" />
+<link rel="apple-touch-icon" href="https://munderdiffl.in/logo.png" />
+<meta name="theme-color" content="#F5F2E8" />
+
+<!-- Open Graph -->
+<meta property="og:site_name" content="Munder Difflin Blog" />
+<meta property="og:type" content="website" />
+<meta property="og:title" content="Event Log — Munder Difflin Blog" />
+<meta property="og:description" content="Munder Difflin blog posts tagged Event Log." />
+<meta property="og:url" content="https://munderdiffl.in/blog/tags/event-log/" />
+<meta property="og:image" content="https://munderdiffl.in/media/og.png" />
+<meta property="og:locale" content="en_US" />
+
+
+<!-- Twitter -->
+<meta name="twitter:card" content="summary_large_image" />
+<meta name="twitter:title" content="Event Log — Munder Difflin Blog" />
+<meta name="twitter:description" content="Munder Difflin blog posts tagged Event Log." />
+<meta name="twitter:image" content="https://munderdiffl.in/media/og.png" />
+
+<link rel="alternate" type="application/atom+xml" title="Munder Difflin Blog" href="https://munderdiffl.in/blog/feed.xml" />
+<link rel="preconnect" href="https://fonts.googleapis.com" />
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+<link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600&family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet" />
+<link rel="stylesheet" href="/blog/assets/blog.css" />
+
+</head>
+<body>
+<a class="skip-link" href="#main">Skip to content</a>
+<nav id="nav">
+ <a class="brand" href="/blog/" aria-label="Munder Difflin Blog home">
+ <span class="brand-mark">MD</span>
+ <span class="brand-word">MUNDER DIFFLIN<span class="sep">/</span><span class="blog">BLOG</span></span>
+ </a>
+ <span class="spacer"></span>
+ <div class="links">
+ <a href="/blog/">Latest</a>
+ <a href="/blog/topics/">Topics</a>
+ <a href="/blog/about/">About</a>
+ <a href="https://munderdiffl.in">↗ Product</a>
+ </div>
+ <div class="nav-actions">
+ <a class="btn sm" href="https://munderdiffl.in/blog/feed.xml" aria-label="RSS feed">⤵ RSS</a>
+ <a class="btn sm primary" href="https://munderdiffl.in/#install">⤓ Download</a>
+ </div>
+</nav>
+
+<main id="main">
+<header class="page-head wrap">
+ <p class="eyebrow">Tag</p>
+ <h1>#Event Log</h1>
+ <p class="lead">1 post tagged <strong>Event Log</strong>.</p>
+</header>
+<section class="wrap">
+ <div class="post-grid">
+ <article class="card">
+ <a class="thumb t-internals" href="/blog/append-only-event-log-agents/" aria-hidden="true" tabindex="-1">
+ <span>INTERNALS</span>
+ </a>
+ <div class="body">
+ <div class="meta">
+ <time datetime="2026-06-01">Jun 1, 2026</time>
+ <span class="dot" aria-hidden="true"></span>
+ <span>5 min</span>
+ </div>
+ <h3><a href="/blog/append-only-event-log-agents/">An Append-Only Event Log for a Hive of Agents</a></h3>
+ <p class="dek">How an append-only event log makes a multi-agent system debuggable and replayable — what to record per event, and why one JSON line per event beats a database.</p>
+ <div class="foot">
+ <span class="tag kind">Internals</span>
+ <a class="more" href="/blog/append-only-event-log-agents/" aria-label="Read: An Append-Only Event Log for a Hive of Agents">Read →</a>
+ </div>
+ </div>
+</article>
+
+ </div>
+</section>
+
+
+</main>
+<footer>
+ <div class="wrap">
+ <div class="foot-top">
+ <a class="foot-brand brand" href="/blog/">
+ <span class="brand-mark">MD</span>
+ <span class="brand-word">MUNDER DIFFLIN<span class="sep">/</span><span class="blog">BLOG</span></span>
+ </a>
+ <div class="foot-links">
+ <a href="/blog/">Latest</a>
+ <a href="/blog/topics/">Topics</a>
+ <a href="/blog/about/">About</a>
+ <a href="https://munderdiffl.in/blog/feed.xml">RSS</a>
+ <a href="https://github.com/chaitanyagiri/munder-difflin">GitHub</a>
+ <a href="https://munderdiffl.in">munderdiffl.in ↗</a>
+ </div>
+ </div>
+ <div class="foot-meta">
+ © 2026 Munder Difflin · Local-first · MIT-licensed ·
+ Built on <a href="https://munderdiffl.in">Electron, React, Pixi.js, xterm.js &amp; node-pty</a>.
+ Run an office of agents while you sleep.
+ </div>
+ </div>
+</footer>
+
+<script>
+ // sticky-nav border on scroll
+ (function () {
+ var nav = document.getElementById('nav');
+ if (!nav) return;
+ var onScroll = function () { nav.classList.toggle('scrolled', window.scrollY > 8); };
+ onScroll(); window.addEventListener('scroll', onScroll, { passive: true });
+ })();
+</script>
+
+</body>
+</html>
diff --git a/docs/blog/tags/guardrails/index.html b/docs/blog/tags/guardrails/index.html
new file mode 100644
index 00000000..165b39a5
--- /dev/null
+++ b/docs/blog/tags/guardrails/index.html
@@ -0,0 +1,124 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="UTF-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<title>Guardrails — Munder Difflin Blog</title>
+<meta name="description" content="Munder Difflin blog posts tagged Guardrails." />
+<link rel="canonical" href="https://munderdiffl.in/blog/tags/guardrails/" />
+
+<link rel="icon" type="image/png" href="https://munderdiffl.in/logo.png" />
+<link rel="apple-touch-icon" href="https://munderdiffl.in/logo.png" />
+<meta name="theme-color" content="#F5F2E8" />
+
+<!-- Open Graph -->
+<meta property="og:site_name" content="Munder Difflin Blog" />
+<meta property="og:type" content="website" />
+<meta property="og:title" content="Guardrails — Munder Difflin Blog" />
+<meta property="og:description" content="Munder Difflin blog posts tagged Guardrails." />
+<meta property="og:url" content="https://munderdiffl.in/blog/tags/guardrails/" />
+<meta property="og:image" content="https://munderdiffl.in/media/og.png" />
+<meta property="og:locale" content="en_US" />
+
+
+<!-- Twitter -->
+<meta name="twitter:card" content="summary_large_image" />
+<meta name="twitter:title" content="Guardrails — Munder Difflin Blog" />
+<meta name="twitter:description" content="Munder Difflin blog posts tagged Guardrails." />
+<meta name="twitter:image" content="https://munderdiffl.in/media/og.png" />
+
+<link rel="alternate" type="application/atom+xml" title="Munder Difflin Blog" href="https://munderdiffl.in/blog/feed.xml" />
+<link rel="preconnect" href="https://fonts.googleapis.com" />
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+<link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600&family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet" />
+<link rel="stylesheet" href="/blog/assets/blog.css" />
+
+</head>
+<body>
+<a class="skip-link" href="#main">Skip to content</a>
+<nav id="nav">
+ <a class="brand" href="/blog/" aria-label="Munder Difflin Blog home">
+ <span class="brand-mark">MD</span>
+ <span class="brand-word">MUNDER DIFFLIN<span class="sep">/</span><span class="blog">BLOG</span></span>
+ </a>
+ <span class="spacer"></span>
+ <div class="links">
+ <a href="/blog/">Latest</a>
+ <a href="/blog/topics/">Topics</a>
+ <a href="/blog/about/">About</a>
+ <a href="https://munderdiffl.in">↗ Product</a>
+ </div>
+ <div class="nav-actions">
+ <a class="btn sm" href="https://munderdiffl.in/blog/feed.xml" aria-label="RSS feed">⤵ RSS</a>
+ <a class="btn sm primary" href="https://munderdiffl.in/#install">⤓ Download</a>
+ </div>
+</nav>
+
+<main id="main">
+<header class="page-head wrap">
+ <p class="eyebrow">Tag</p>
+ <h1>#Guardrails</h1>
+ <p class="lead">1 post tagged <strong>Guardrails</strong>.</p>
+</header>
+<section class="wrap">
+ <div class="post-grid">
+ <article class="card">
+ <a class="thumb t-orchestration" href="/blog/human-in-the-loop-ai-agents/" aria-hidden="true" tabindex="-1">
+ <span>ORCHESTRATION</span>
+ </a>
+ <div class="body">
+ <div class="meta">
+ <time datetime="2026-06-02">Jun 2, 2026</time>
+ <span class="dot" aria-hidden="true"></span>
+ <span>5 min</span>
+ </div>
+ <h3><a href="/blog/human-in-the-loop-ai-agents/">Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down</a></h3>
+ <p class="dek">Design human-in-the-loop AI agents that stay autonomous: an approvals queue that escalates only spend, destructive ops, and scope — and relays your answer back.</p>
+ <div class="foot">
+ <span class="tag kind">Orchestration</span>
+ <a class="more" href="/blog/human-in-the-loop-ai-agents/" aria-label="Read: Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down">Read →</a>
+ </div>
+ </div>
+</article>
+
+ </div>
+</section>
+
+
+</main>
+<footer>
+ <div class="wrap">
+ <div class="foot-top">
+ <a class="foot-brand brand" href="/blog/">
+ <span class="brand-mark">MD</span>
+ <span class="brand-word">MUNDER DIFFLIN<span class="sep">/</span><span class="blog">BLOG</span></span>
+ </a>
+ <div class="foot-links">
+ <a href="/blog/">Latest</a>
+ <a href="/blog/topics/">Topics</a>
+ <a href="/blog/about/">About</a>
+ <a href="https://munderdiffl.in/blog/feed.xml">RSS</a>
+ <a href="https://github.com/chaitanyagiri/munder-difflin">GitHub</a>
+ <a href="https://munderdiffl.in">munderdiffl.in ↗</a>
+ </div>
+ </div>
+ <div class="foot-meta">
+ © 2026 Munder Difflin · Local-first · MIT-licensed ·
+ Built on <a href="https://munderdiffl.in">Electron, React, Pixi.js, xterm.js &amp; node-pty</a>.
+ Run an office of agents while you sleep.
+ </div>
+ </div>
+</footer>
+
+<script>
+ // sticky-nav border on scroll
+ (function () {
+ var nav = document.getElementById('nav');
+ if (!nav) return;
+ var onScroll = function () { nav.classList.toggle('scrolled', window.scrollY > 8); };
+ onScroll(); window.addEventListener('scroll', onScroll, { passive: true });
+ })();
+</script>
+
+</body>
+</html>
diff --git a/docs/blog/tags/human-in-the-loop/index.html b/docs/blog/tags/human-in-the-loop/index.html
new file mode 100644
index 00000000..007b573a
--- /dev/null
+++ b/docs/blog/tags/human-in-the-loop/index.html
@@ -0,0 +1,124 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="UTF-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<title>Human-in-the-Loop — Munder Difflin Blog</title>
+<meta name="description" content="Munder Difflin blog posts tagged Human-in-the-Loop." />
+<link rel="canonical" href="https://munderdiffl.in/blog/tags/human-in-the-loop/" />
+
+<link rel="icon" type="image/png" href="https://munderdiffl.in/logo.png" />
+<link rel="apple-touch-icon" href="https://munderdiffl.in/logo.png" />
+<meta name="theme-color" content="#F5F2E8" />
+
+<!-- Open Graph -->
+<meta property="og:site_name" content="Munder Difflin Blog" />
+<meta property="og:type" content="website" />
+<meta property="og:title" content="Human-in-the-Loop — Munder Difflin Blog" />
+<meta property="og:description" content="Munder Difflin blog posts tagged Human-in-the-Loop." />
+<meta property="og:url" content="https://munderdiffl.in/blog/tags/human-in-the-loop/" />
+<meta property="og:image" content="https://munderdiffl.in/media/og.png" />
+<meta property="og:locale" content="en_US" />
+
+
+<!-- Twitter -->
+<meta name="twitter:card" content="summary_large_image" />
+<meta name="twitter:title" content="Human-in-the-Loop — Munder Difflin Blog" />
+<meta name="twitter:description" content="Munder Difflin blog posts tagged Human-in-the-Loop." />
+<meta name="twitter:image" content="https://munderdiffl.in/media/og.png" />
+
+<link rel="alternate" type="application/atom+xml" title="Munder Difflin Blog" href="https://munderdiffl.in/blog/feed.xml" />
+<link rel="preconnect" href="https://fonts.googleapis.com" />
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+<link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600&family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet" />
+<link rel="stylesheet" href="/blog/assets/blog.css" />
+
+</head>
+<body>
+<a class="skip-link" href="#main">Skip to content</a>
+<nav id="nav">
+ <a class="brand" href="/blog/" aria-label="Munder Difflin Blog home">
+ <span class="brand-mark">MD</span>
+ <span class="brand-word">MUNDER DIFFLIN<span class="sep">/</span><span class="blog">BLOG</span></span>
+ </a>
+ <span class="spacer"></span>
+ <div class="links">
+ <a href="/blog/">Latest</a>
+ <a href="/blog/topics/">Topics</a>
+ <a href="/blog/about/">About</a>
+ <a href="https://munderdiffl.in">↗ Product</a>
+ </div>
+ <div class="nav-actions">
+ <a class="btn sm" href="https://munderdiffl.in/blog/feed.xml" aria-label="RSS feed">⤵ RSS</a>
+ <a class="btn sm primary" href="https://munderdiffl.in/#install">⤓ Download</a>
+ </div>
+</nav>
+
+<main id="main">
+<header class="page-head wrap">
+ <p class="eyebrow">Tag</p>
+ <h1>#Human-in-the-Loop</h1>
+ <p class="lead">1 post tagged <strong>Human-in-the-Loop</strong>.</p>
+</header>
+<section class="wrap">
+ <div class="post-grid">
+ <article class="card">
+ <a class="thumb t-orchestration" href="/blog/human-in-the-loop-ai-agents/" aria-hidden="true" tabindex="-1">
+ <span>ORCHESTRATION</span>
+ </a>
+ <div class="body">
+ <div class="meta">
+ <time datetime="2026-06-02">Jun 2, 2026</time>
+ <span class="dot" aria-hidden="true"></span>
+ <span>5 min</span>
+ </div>
+ <h3><a href="/blog/human-in-the-loop-ai-agents/">Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down</a></h3>
+ <p class="dek">Design human-in-the-loop AI agents that stay autonomous: an approvals queue that escalates only spend, destructive ops, and scope — and relays your answer back.</p>
+ <div class="foot">
+ <span class="tag kind">Orchestration</span>
+ <a class="more" href="/blog/human-in-the-loop-ai-agents/" aria-label="Read: Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down">Read →</a>
+ </div>
+ </div>
+</article>
+
+ </div>
+</section>
+
+
+</main>
+<footer>
+ <div class="wrap">
+ <div class="foot-top">
+ <a class="foot-brand brand" href="/blog/">
+ <span class="brand-mark">MD</span>
+ <span class="brand-word">MUNDER DIFFLIN<span class="sep">/</span><span class="blog">BLOG</span></span>
+ </a>
+ <div class="foot-links">
+ <a href="/blog/">Latest</a>
+ <a href="/blog/topics/">Topics</a>
+ <a href="/blog/about/">About</a>
+ <a href="https://munderdiffl.in/blog/feed.xml">RSS</a>
+ <a href="https://github.com/chaitanyagiri/munder-difflin">GitHub</a>
+ <a href="https://munderdiffl.in">munderdiffl.in ↗</a>
+ </div>
+ </div>
+ <div class="foot-meta">
+ © 2026 Munder Difflin · Local-first · MIT-licensed ·
+ Built on <a href="https://munderdiffl.in">Electron, React, Pixi.js, xterm.js &amp; node-pty</a>.
+ Run an office of agents while you sleep.
+ </div>
+ </div>
+</footer>
+
+<script>
+ // sticky-nav border on scroll
+ (function () {
+ var nav = document.getElementById('nav');
+ if (!nav) return;
+ var onScroll = function () { nav.classList.toggle('scrolled', window.scrollY > 8); };
+ onScroll(); window.addEventListener('scroll', onScroll, { passive: true });
+ })();
+</script>
+
+</body>
+</html>
diff --git a/docs/blog/tags/internals/index.html b/docs/blog/tags/internals/index.html
index 4d8899bf..df89e6b7 100644
--- a/docs/blog/tags/internals/index.html
+++ b/docs/blog/tags/internals/index.html
@@ -58,7 +58,7 @@
<header class="page-head wrap">
<p class="eyebrow">Tag</p>
<h1>#Internals</h1>
- <p class="lead">6 posts tagged <strong>Internals</strong>.</p>
+ <p class="lead">7 posts tagged <strong>Internals</strong>.</p>
</header>
<section class="wrap">
<div class="post-grid">
@@ -134,6 +134,24 @@
</div>
</div>
</article>
+<article class="card">
+ <a class="thumb t-internals" href="/blog/append-only-event-log-agents/" aria-hidden="true" tabindex="-1">
+ <span>INTERNALS</span>
+ </a>
+ <div class="body">
+ <div class="meta">
+ <time datetime="2026-06-01">Jun 1, 2026</time>
+ <span class="dot" aria-hidden="true"></span>
+ <span>5 min</span>
+ </div>
+ <h3><a href="/blog/append-only-event-log-agents/">An Append-Only Event Log for a Hive of Agents</a></h3>
+ <p class="dek">How an append-only event log makes a multi-agent system debuggable and replayable — what to record per event, and why one JSON line per event beats a database.</p>
+ <div class="foot">
+ <span class="tag kind">Internals</span>
+ <a class="more" href="/blog/append-only-event-log-agents/" aria-label="Read: An Append-Only Event Log for a Hive of Agents">Read →</a>
+ </div>
+ </div>
+</article>
<article class="card">
<a class="thumb t-internals" href="/blog/atomic-file-mailboxes-for-agents/" aria-hidden="true" tabindex="-1">
<span>INTERNALS</span>
diff --git a/docs/blog/tags/multi-agent/index.html b/docs/blog/tags/multi-agent/index.html
index 3755d15b..fcf98def 100644
--- a/docs/blog/tags/multi-agent/index.html
+++ b/docs/blog/tags/multi-agent/index.html
@@ -58,7 +58,7 @@
<header class="page-head wrap">
<p class="eyebrow">Tag</p>
<h1>#Multi-Agent</h1>
- <p class="lead">24 posts tagged <strong>Multi-Agent</strong>.</p>
+ <p class="lead">26 posts tagged <strong>Multi-Agent</strong>.</p>
</header>
<section class="wrap">
<div class="post-grid">
@@ -206,6 +206,24 @@
</div>
</div>
</article>
+<article class="card">
+ <a class="thumb t-orchestration" href="/blog/human-in-the-loop-ai-agents/" aria-hidden="true" tabindex="-1">
+ <span>ORCHESTRATION</span>
+ </a>
+ <div class="body">
+ <div class="meta">
+ <time datetime="2026-06-02">Jun 2, 2026</time>
+ <span class="dot" aria-hidden="true"></span>
+ <span>5 min</span>
+ </div>
+ <h3><a href="/blog/human-in-the-loop-ai-agents/">Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down</a></h3>
+ <p class="dek">Design human-in-the-loop AI agents that stay autonomous: an approvals queue that escalates only spend, destructive ops, and scope — and relays your answer back.</p>
+ <div class="foot">
+ <span class="tag kind">Orchestration</span>
+ <a class="more" href="/blog/human-in-the-loop-ai-agents/" aria-label="Read: Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down">Read →</a>
+ </div>
+ </div>
+</article>
<article class="card">
<a class="thumb t-concepts" href="/blog/munder-difflin-faq/" aria-hidden="true" tabindex="-1">
<span>CONCEPTS</span>
@@ -314,6 +332,24 @@
</div>
</div>
</article>
+<article class="card">
+ <a class="thumb t-internals" href="/blog/append-only-event-log-agents/" aria-hidden="true" tabindex="-1">
+ <span>INTERNALS</span>
+ </a>
+ <div class="body">
+ <div class="meta">
+ <time datetime="2026-06-01">Jun 1, 2026</time>
+ <span class="dot" aria-hidden="true"></span>
+ <span>5 min</span>
+ </div>
+ <h3><a href="/blog/append-only-event-log-agents/">An Append-Only Event Log for a Hive of Agents</a></h3>
+ <p class="dek">How an append-only event log makes a multi-agent system debuggable and replayable — what to record per event, and why one JSON line per event beats a database.</p>
+ <div class="foot">
+ <span class="tag kind">Internals</span>
+ <a class="more" href="/blog/append-only-event-log-agents/" aria-label="Read: An Append-Only Event Log for a Hive of Agents">Read →</a>
+ </div>
+ </div>
+</article>
<article class="card">
<a class="thumb t-guides" href="/blog/how-to-run-multiple-claude-code-agents/" aria-hidden="true" tabindex="-1">
<span>GUIDES</span>
diff --git a/docs/blog/tags/observability/index.html b/docs/blog/tags/observability/index.html
new file mode 100644
index 00000000..dc9e0dce
--- /dev/null
+++ b/docs/blog/tags/observability/index.html
@@ -0,0 +1,124 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="UTF-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<title>Observability — Munder Difflin Blog</title>
+<meta name="description" content="Munder Difflin blog posts tagged Observability." />
+<link rel="canonical" href="https://munderdiffl.in/blog/tags/observability/" />
+
+<link rel="icon" type="image/png" href="https://munderdiffl.in/logo.png" />
+<link rel="apple-touch-icon" href="https://munderdiffl.in/logo.png" />
+<meta name="theme-color" content="#F5F2E8" />
+
+<!-- Open Graph -->
+<meta property="og:site_name" content="Munder Difflin Blog" />
+<meta property="og:type" content="website" />
+<meta property="og:title" content="Observability — Munder Difflin Blog" />
+<meta property="og:description" content="Munder Difflin blog posts tagged Observability." />
+<meta property="og:url" content="https://munderdiffl.in/blog/tags/observability/" />
+<meta property="og:image" content="https://munderdiffl.in/media/og.png" />
+<meta property="og:locale" content="en_US" />
+
+
+<!-- Twitter -->
+<meta name="twitter:card" content="summary_large_image" />
+<meta name="twitter:title" content="Observability — Munder Difflin Blog" />
+<meta name="twitter:description" content="Munder Difflin blog posts tagged Observability." />
+<meta name="twitter:image" content="https://munderdiffl.in/media/og.png" />
+
+<link rel="alternate" type="application/atom+xml" title="Munder Difflin Blog" href="https://munderdiffl.in/blog/feed.xml" />
+<link rel="preconnect" href="https://fonts.googleapis.com" />
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+<link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600&family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet" />
+<link rel="stylesheet" href="/blog/assets/blog.css" />
+
+</head>
+<body>
+<a class="skip-link" href="#main">Skip to content</a>
+<nav id="nav">
+ <a class="brand" href="/blog/" aria-label="Munder Difflin Blog home">
+ <span class="brand-mark">MD</span>
+ <span class="brand-word">MUNDER DIFFLIN<span class="sep">/</span><span class="blog">BLOG</span></span>
+ </a>
+ <span class="spacer"></span>
+ <div class="links">
+ <a href="/blog/">Latest</a>
+ <a href="/blog/topics/">Topics</a>
+ <a href="/blog/about/">About</a>
+ <a href="https://munderdiffl.in">↗ Product</a>
+ </div>
+ <div class="nav-actions">
+ <a class="btn sm" href="https://munderdiffl.in/blog/feed.xml" aria-label="RSS feed">⤵ RSS</a>
+ <a class="btn sm primary" href="https://munderdiffl.in/#install">⤓ Download</a>
+ </div>
+</nav>
+
+<main id="main">
+<header class="page-head wrap">
+ <p class="eyebrow">Tag</p>
+ <h1>#Observability</h1>
+ <p class="lead">1 post tagged <strong>Observability</strong>.</p>
+</header>
+<section class="wrap">
+ <div class="post-grid">
+ <article class="card">
+ <a class="thumb t-internals" href="/blog/append-only-event-log-agents/" aria-hidden="true" tabindex="-1">
+ <span>INTERNALS</span>
+ </a>
+ <div class="body">
+ <div class="meta">
+ <time datetime="2026-06-01">Jun 1, 2026</time>
+ <span class="dot" aria-hidden="true"></span>
+ <span>5 min</span>
+ </div>
+ <h3><a href="/blog/append-only-event-log-agents/">An Append-Only Event Log for a Hive of Agents</a></h3>
+ <p class="dek">How an append-only event log makes a multi-agent system debuggable and replayable — what to record per event, and why one JSON line per event beats a database.</p>
+ <div class="foot">
+ <span class="tag kind">Internals</span>
+ <a class="more" href="/blog/append-only-event-log-agents/" aria-label="Read: An Append-Only Event Log for a Hive of Agents">Read →</a>
+ </div>
+ </div>
+</article>
+
+ </div>
+</section>
+
+
+</main>
+<footer>
+ <div class="wrap">
+ <div class="foot-top">
+ <a class="foot-brand brand" href="/blog/">
+ <span class="brand-mark">MD</span>
+ <span class="brand-word">MUNDER DIFFLIN<span class="sep">/</span><span class="blog">BLOG</span></span>
+ </a>
+ <div class="foot-links">
+ <a href="/blog/">Latest</a>
+ <a href="/blog/topics/">Topics</a>
+ <a href="/blog/about/">About</a>
+ <a href="https://munderdiffl.in/blog/feed.xml">RSS</a>
+ <a href="https://github.com/chaitanyagiri/munder-difflin">GitHub</a>
+ <a href="https://munderdiffl.in">munderdiffl.in ↗</a>
+ </div>
+ </div>
+ <div class="foot-meta">
+ © 2026 Munder Difflin · Local-first · MIT-licensed ·
+ Built on <a href="https://munderdiffl.in">Electron, React, Pixi.js, xterm.js &amp; node-pty</a>.
+ Run an office of agents while you sleep.
+ </div>
+ </div>
+</footer>
+
+<script>
+ // sticky-nav border on scroll
+ (function () {
+ var nav = document.getElementById('nav');
+ if (!nav) return;
+ var onScroll = function () { nav.classList.toggle('scrolled', window.scrollY > 8); };
+ onScroll(); window.addEventListener('scroll', onScroll, { passive: true });
+ })();
+</script>
+
+</body>
+</html>
diff --git a/docs/blog/tags/orchestration/index.html b/docs/blog/tags/orchestration/index.html
index 848ab495..d133e98f 100644
--- a/docs/blog/tags/orchestration/index.html
+++ b/docs/blog/tags/orchestration/index.html
@@ -58,7 +58,7 @@
<header class="page-head wrap">
<p class="eyebrow">Tag</p>
<h1>#Orchestration</h1>
- <p class="lead">7 posts tagged <strong>Orchestration</strong>.</p>
+ <p class="lead">8 posts tagged <strong>Orchestration</strong>.</p>
</header>
<section class="wrap">
<div class="post-grid">
@@ -134,6 +134,24 @@
</div>
</div>
</article>
+<article class="card">
+ <a class="thumb t-orchestration" href="/blog/human-in-the-loop-ai-agents/" aria-hidden="true" tabindex="-1">
+ <span>ORCHESTRATION</span>
+ </a>
+ <div class="body">
+ <div class="meta">
+ <time datetime="2026-06-02">Jun 2, 2026</time>
+ <span class="dot" aria-hidden="true"></span>
+ <span>5 min</span>
+ </div>
+ <h3><a href="/blog/human-in-the-loop-ai-agents/">Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down</a></h3>
+ <p class="dek">Design human-in-the-loop AI agents that stay autonomous: an approvals queue that escalates only spend, destructive ops, and scope — and relays your answer back.</p>
+ <div class="foot">
+ <span class="tag kind">Orchestration</span>
+ <a class="more" href="/blog/human-in-the-loop-ai-agents/" aria-label="Read: Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down">Read →</a>
+ </div>
+ </div>
+</article>
<article class="card">
<a class="thumb t-orchestration" href="/blog/how-the-god-orchestrator-works/" aria-hidden="true" tabindex="-1">
<span>ORCHESTRATION</span>
diff --git a/docs/blog/topics/comparisons/index.html b/docs/blog/topics/comparisons/index.html
index 4f98744e..ae9b4f10 100644
--- a/docs/blog/topics/comparisons/index.html
+++ b/docs/blog/topics/comparisons/index.html
@@ -72,11 +72,11 @@
<a class="chip" href="/blog/topics/guides/">guides<span class="ct">6</span></a>
- <a class="chip" href="/blog/topics/internals/">internals<span class="ct">5</span></a>
+ <a class="chip" href="/blog/topics/internals/">internals<span class="ct">6</span></a>
- <a class="chip" href="/blog/topics/concepts/">concepts<span class="ct">4</span></a>
+ <a class="chip" href="/blog/topics/orchestration/">orchestration<span class="ct">5</span></a>
- <a class="chip" href="/blog/topics/orchestration/">orchestration<span class="ct">4</span></a>
+ <a class="chip" href="/blog/topics/concepts/">concepts<span class="ct">4</span></a>
<a class="chip" href="/blog/topics/use-cases/">use-cases<span class="ct">3</span></a>
diff --git a/docs/blog/topics/concepts/index.html b/docs/blog/topics/concepts/index.html
index 0848797b..c5731d09 100644
--- a/docs/blog/topics/concepts/index.html
+++ b/docs/blog/topics/concepts/index.html
@@ -72,11 +72,11 @@
<a class="chip" href="/blog/topics/guides/">guides<span class="ct">6</span></a>
- <a class="chip" href="/blog/topics/internals/">internals<span class="ct">5</span></a>
+ <a class="chip" href="/blog/topics/internals/">internals<span class="ct">6</span></a>
- <a class="chip" href="/blog/topics/concepts/" aria-current="page">concepts<span class="ct">4</span></a>
+ <a class="chip" href="/blog/topics/orchestration/">orchestration<span class="ct">5</span></a>
- <a class="chip" href="/blog/topics/orchestration/">orchestration<span class="ct">4</span></a>
+ <a class="chip" href="/blog/topics/concepts/" aria-current="page">concepts<span class="ct">4</span></a>
<a class="chip" href="/blog/topics/use-cases/">use-cases<span class="ct">3</span></a>
diff --git a/docs/blog/topics/guides/index.html b/docs/blog/topics/guides/index.html
index 9a220f94..645a42ab 100644
--- a/docs/blog/topics/guides/index.html
+++ b/docs/blog/topics/guides/index.html
@@ -72,11 +72,11 @@
<a class="chip" href="/blog/topics/guides/" aria-current="page">guides<span class="ct">6</span></a>
- <a class="chip" href="/blog/topics/internals/">internals<span class="ct">5</span></a>
+ <a class="chip" href="/blog/topics/internals/">internals<span class="ct">6</span></a>
- <a class="chip" href="/blog/topics/concepts/">concepts<span class="ct">4</span></a>
+ <a class="chip" href="/blog/topics/orchestration/">orchestration<span class="ct">5</span></a>
- <a class="chip" href="/blog/topics/orchestration/">orchestration<span class="ct">4</span></a>
+ <a class="chip" href="/blog/topics/concepts/">concepts<span class="ct">4</span></a>
<a class="chip" href="/blog/topics/use-cases/">use-cases<span class="ct">3</span></a>
diff --git a/docs/blog/topics/index.html b/docs/blog/topics/index.html
index 1e77552f..a1530227 100644
--- a/docs/blog/topics/index.html
+++ b/docs/blog/topics/index.html
@@ -88,24 +88,24 @@
<span class="thumb t-internals" aria-hidden="true">INTERNALS</span>
<div class="body">
<h3 style="color:var(--ink)">internals</h3>
- <p class="dek">5 posts.</p>
+ <p class="dek">6 posts.</p>
<div class="foot"><span class="more">View topic →</span></div>
</div>
</a>
- <a class="card" href="/blog/topics/concepts/" style="text-decoration:none">
- <span class="thumb t-concepts" aria-hidden="true">CONCEPTS</span>
+ <a class="card" href="/blog/topics/orchestration/" style="text-decoration:none">
+ <span class="thumb t-orchestration" aria-hidden="true">ORCHESTRATION</span>
<div class="body">
- <h3 style="color:var(--ink)">concepts</h3>
- <p class="dek">4 posts.</p>
+ <h3 style="color:var(--ink)">orchestration</h3>
+ <p class="dek">5 posts.</p>
<div class="foot"><span class="more">View topic →</span></div>
</div>
</a>
- <a class="card" href="/blog/topics/orchestration/" style="text-decoration:none">
- <span class="thumb t-orchestration" aria-hidden="true">ORCHESTRATION</span>
+ <a class="card" href="/blog/topics/concepts/" style="text-decoration:none">
+ <span class="thumb t-concepts" aria-hidden="true">CONCEPTS</span>
<div class="body">
- <h3 style="color:var(--ink)">orchestration</h3>
+ <h3 style="color:var(--ink)">concepts</h3>
<p class="dek">4 posts.</p>
<div class="foot"><span class="more">View topic →</span></div>
</div>
@@ -144,20 +144,20 @@
<div class="filters" style="padding-top:36px">
<span class="eyebrow" style="align-self:center">Tags</span>
- <a class="chip" href="/blog/tags/multi-agent/">Multi-Agent<span class="ct">24</span></a>
+ <a class="chip" href="/blog/tags/multi-agent/">Multi-Agent<span class="ct">26</span></a>
<a class="chip" href="/blog/tags/claude-code/">Claude Code<span class="ct">24</span></a>
+ <a class="chip" href="/blog/tags/orchestration/">Orchestration<span class="ct">8</span></a>
+
<a class="chip" href="/blog/tags/comparisons/">Comparisons<span class="ct">8</span></a>
<a class="chip" href="/blog/tags/tools/">Tools<span class="ct">8</span></a>
- <a class="chip" href="/blog/tags/orchestration/">Orchestration<span class="ct">7</span></a>
+ <a class="chip" href="/blog/tags/internals/">Internals<span class="ct">7</span></a>
<a class="chip" href="/blog/tags/guides/">Guides<span class="ct">6</span></a>
- <a class="chip" href="/blog/tags/internals/">Internals<span class="ct">6</span></a>
-
<a class="chip" href="/blog/tags/getting-started/">Getting Started<span class="ct">5</span></a>
<a class="chip" href="/blog/tags/concepts/">Concepts<span class="ct">4</span></a>
@@ -188,8 +188,16 @@
<a class="chip" href="/blog/tags/messaging/">Messaging<span class="ct">1</span></a>
+ <a class="chip" href="/blog/tags/observability/">Observability<span class="ct">1</span></a>
+
+ <a class="chip" href="/blog/tags/event-log/">Event Log<span class="ct">1</span></a>
+
<a class="chip" href="/blog/tags/glossary/">Glossary<span class="ct">1</span></a>
+ <a class="chip" href="/blog/tags/human-in-the-loop/">Human-in-the-Loop<span class="ct">1</span></a>
+
+ <a class="chip" href="/blog/tags/guardrails/">Guardrails<span class="ct">1</span></a>
+
<a class="chip" href="/blog/tags/faq/">FAQ<span class="ct">1</span></a>
<a class="chip" href="/blog/tags/concurrency/">Concurrency<span class="ct">1</span></a>
diff --git a/docs/blog/topics/internals/index.html b/docs/blog/topics/internals/index.html
index dd8e614f..b39469b8 100644
--- a/docs/blog/topics/internals/index.html
+++ b/docs/blog/topics/internals/index.html
@@ -63,7 +63,7 @@
</nav>
<p class="eyebrow">Topic</p>
<h1>internals</h1>
- <p class="lead">5 posts in this cluster.</p>
+ <p class="lead">6 posts in this cluster.</p>
<div class="filters" role="navigation" aria-label="Topics">
<a class="chip" href="/blog/">All</a>
@@ -72,11 +72,11 @@
<a class="chip" href="/blog/topics/guides/">guides<span class="ct">6</span></a>
- <a class="chip" href="/blog/topics/internals/" aria-current="page">internals<span class="ct">5</span></a>
+ <a class="chip" href="/blog/topics/internals/" aria-current="page">internals<span class="ct">6</span></a>
- <a class="chip" href="/blog/topics/concepts/">concepts<span class="ct">4</span></a>
+ <a class="chip" href="/blog/topics/orchestration/">orchestration<span class="ct">5</span></a>
- <a class="chip" href="/blog/topics/orchestration/">orchestration<span class="ct">4</span></a>
+ <a class="chip" href="/blog/topics/concepts/">concepts<span class="ct">4</span></a>
<a class="chip" href="/blog/topics/use-cases/">use-cases<span class="ct">3</span></a>
@@ -161,6 +161,24 @@
</div>
</div>
</article>
+<article class="card">
+ <a class="thumb t-internals" href="/blog/append-only-event-log-agents/" aria-hidden="true" tabindex="-1">
+ <span>INTERNALS</span>
+ </a>
+ <div class="body">
+ <div class="meta">
+ <time datetime="2026-06-01">Jun 1, 2026</time>
+ <span class="dot" aria-hidden="true"></span>
+ <span>5 min</span>
+ </div>
+ <h3><a href="/blog/append-only-event-log-agents/">An Append-Only Event Log for a Hive of Agents</a></h3>
+ <p class="dek">How an append-only event log makes a multi-agent system debuggable and replayable — what to record per event, and why one JSON line per event beats a database.</p>
+ <div class="foot">
+ <span class="tag kind">Internals</span>
+ <a class="more" href="/blog/append-only-event-log-agents/" aria-label="Read: An Append-Only Event Log for a Hive of Agents">Read →</a>
+ </div>
+ </div>
+</article>
<article class="card">
<a class="thumb t-internals" href="/blog/atomic-file-mailboxes-for-agents/" aria-hidden="true" tabindex="-1">
<span>INTERNALS</span>
diff --git a/docs/blog/topics/memory/index.html b/docs/blog/topics/memory/index.html
index 3eb014b5..dfaf34e2 100644
--- a/docs/blog/topics/memory/index.html
+++ b/docs/blog/topics/memory/index.html
@@ -72,11 +72,11 @@
<a class="chip" href="/blog/topics/guides/">guides<span class="ct">6</span></a>
- <a class="chip" href="/blog/topics/internals/">internals<span class="ct">5</span></a>
+ <a class="chip" href="/blog/topics/internals/">internals<span class="ct">6</span></a>
- <a class="chip" href="/blog/topics/concepts/">concepts<span class="ct">4</span></a>
+ <a class="chip" href="/blog/topics/orchestration/">orchestration<span class="ct">5</span></a>
- <a class="chip" href="/blog/topics/orchestration/">orchestration<span class="ct">4</span></a>
+ <a class="chip" href="/blog/topics/concepts/">concepts<span class="ct">4</span></a>
<a class="chip" href="/blog/topics/use-cases/">use-cases<span class="ct">3</span></a>
diff --git a/docs/blog/topics/orchestration/index.html b/docs/blog/topics/orchestration/index.html
index 46f43f69..c99e5a27 100644
--- a/docs/blog/topics/orchestration/index.html
+++ b/docs/blog/topics/orchestration/index.html
@@ -63,7 +63,7 @@
</nav>
<p class="eyebrow">Topic</p>
<h1>orchestration</h1>
- <p class="lead">4 posts in this cluster.</p>
+ <p class="lead">5 posts in this cluster.</p>
<div class="filters" role="navigation" aria-label="Topics">
<a class="chip" href="/blog/">All</a>
@@ -72,11 +72,11 @@
<a class="chip" href="/blog/topics/guides/">guides<span class="ct">6</span></a>
- <a class="chip" href="/blog/topics/internals/">internals<span class="ct">5</span></a>
+ <a class="chip" href="/blog/topics/internals/">internals<span class="ct">6</span></a>
- <a class="chip" href="/blog/topics/concepts/">concepts<span class="ct">4</span></a>
+ <a class="chip" href="/blog/topics/orchestration/" aria-current="page">orchestration<span class="ct">5</span></a>
- <a class="chip" href="/blog/topics/orchestration/" aria-current="page">orchestration<span class="ct">4</span></a>
+ <a class="chip" href="/blog/topics/concepts/">concepts<span class="ct">4</span></a>
<a class="chip" href="/blog/topics/use-cases/">use-cases<span class="ct">3</span></a>
@@ -107,6 +107,24 @@
</div>
</div>
</article>
+<article class="card">
+ <a class="thumb t-orchestration" href="/blog/human-in-the-loop-ai-agents/" aria-hidden="true" tabindex="-1">
+ <span>ORCHESTRATION</span>
+ </a>
+ <div class="body">
+ <div class="meta">
+ <time datetime="2026-06-02">Jun 2, 2026</time>
+ <span class="dot" aria-hidden="true"></span>
+ <span>5 min</span>
+ </div>
+ <h3><a href="/blog/human-in-the-loop-ai-agents/">Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down</a></h3>
+ <p class="dek">Design human-in-the-loop AI agents that stay autonomous: an approvals queue that escalates only spend, destructive ops, and scope — and relays your answer back.</p>
+ <div class="foot">
+ <span class="tag kind">Orchestration</span>
+ <a class="more" href="/blog/human-in-the-loop-ai-agents/" aria-label="Read: Human-in-the-Loop AI Agents: Approvals That Don&#39;t Slow You Down">Read →</a>
+ </div>
+ </div>
+</article>
<article class="card">
<a class="thumb t-orchestration" href="/blog/how-the-god-orchestrator-works/" aria-hidden="true" tabindex="-1">
<span>ORCHESTRATION</span>
diff --git a/docs/blog/topics/story/index.html b/docs/blog/topics/story/index.html
index 0ba879a8..53278e4e 100644
--- a/docs/blog/topics/story/index.html
+++ b/docs/blog/topics/story/index.html
@@ -72,11 +72,11 @@
<a class="chip" href="/blog/topics/guides/">guides<span class="ct">6</span></a>
- <a class="chip" href="/blog/topics/internals/">internals<span class="ct">5</span></a>
+ <a class="chip" href="/blog/topics/internals/">internals<span class="ct">6</span></a>
- <a class="chip" href="/blog/topics/concepts/">concepts<span class="ct">4</span></a>
+ <a class="chip" href="/blog/topics/orchestration/">orchestration<span class="ct">5</span></a>
- <a class="chip" href="/blog/topics/orchestration/">orchestration<span class="ct">4</span></a>
+ <a class="chip" href="/blog/topics/concepts/">concepts<span class="ct">4</span></a>
<a class="chip" href="/blog/topics/use-cases/">use-cases<span class="ct">3</span></a>
diff --git a/docs/blog/topics/use-cases/index.html b/docs/blog/topics/use-cases/index.html
index c28133bc..d255dbb3 100644
--- a/docs/blog/topics/use-cases/index.html
+++ b/docs/blog/topics/use-cases/index.html
@@ -72,11 +72,11 @@
<a class="chip" href="/blog/topics/guides/">guides<span class="ct">6</span></a>
- <a class="chip" href="/blog/topics/internals/">internals<span class="ct">5</span></a>
+ <a class="chip" href="/blog/topics/internals/">internals<span class="ct">6</span></a>
- <a class="chip" href="/blog/topics/concepts/">concepts<span class="ct">4</span></a>
+ <a class="chip" href="/blog/topics/orchestration/">orchestration<span class="ct">5</span></a>
- <a class="chip" href="/blog/topics/orchestration/">orchestration<span class="ct">4</span></a>
+ <a class="chip" href="/blog/topics/concepts/">concepts<span class="ct">4</span></a>
<a class="chip" href="/blog/topics/use-cases/" aria-current="page">use-cases<span class="ct">3</span></a>
diff --git a/docs/blog/why-we-built-munder-difflin/index.html b/docs/blog/why-we-built-munder-difflin/index.html
index b85d8f87..f1cb2bae 100644
--- a/docs/blog/why-we-built-munder-difflin/index.html
+++ b/docs/blog/why-we-built-munder-difflin/index.html
@@ -156,7 +156,7 @@ them a team.</p>
compounds instead of resetting.</li>
<li><strong>Messaging</strong> — every agent has a mailbox; a router delivers between them, so they hand off work
without me in the middle.</li>
-<li><strong>A GOD orchestrator</strong> — a coordinator you talk to like a manager; it decomposes your intent and
+<li><strong>A <a href="/#how">GOD orchestrator</a></strong> — a coordinator you talk to like a manager; it decomposes your intent and
routes the work.</li>
<li><strong>A floor you can watch</strong> — agents as avatars at their desks, so the black box becomes something you
can supervise at a glance.</li>
@@ -204,7 +204,7 @@ Munder Difflin</a> — it’s open source and local-first, on macOS, Windows, an
</div>
<footer class="post-foot wrap"><div class="prevnext">
- <a class="pn prev" href="/blog/how-to-run-multiple-claude-code-agents/"><span class="k">← Older</span><span class="t">How to Run Multiple Claude Code Agents (Without Losing Track)</span></a>
+ <a class="pn prev" href="/blog/append-only-event-log-agents/"><span class="k">← Older</span><span class="t">An Append-Only Event Log for a Hive of Agents</span></a>
<a class="pn next" href="/blog/why-local-first-matters-for-ai-agents/"><span class="k">Newer →</span><span class="t">Why Local-First Matters for Your AI Agents</span></a>
</div>
</footer>
diff --git a/docs/sitemap.xml b/docs/sitemap.xml
index a46828fe..322d3ce9 100644
--- a/docs/sitemap.xml
+++ b/docs/sitemap.xml
@@ -113,6 +113,12 @@
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
+ <url>
+ <loc>https://munderdiffl.in/blog/human-in-the-loop-ai-agents/</loc>
+ <lastmod>2026-06-02</lastmod>
+ <changefreq>monthly</changefreq>
+ <priority>0.8</priority>
+ </url>
<url>
<loc>https://munderdiffl.in/blog/munder-difflin-faq/</loc>
<lastmod>2026-06-02</lastmod>
@@ -149,6 +155,12 @@
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
+ <url>
+ <loc>https://munderdiffl.in/blog/append-only-event-log-agents/</loc>
+ <lastmod>2026-06-01</lastmod>
+ <changefreq>monthly</changefreq>
+ <priority>0.8</priority>
+ </url>
<url>
<loc>https://munderdiffl.in/blog/how-to-run-multiple-claude-code-agents/</loc>
<lastmod>2026-06-01</lastmod>
@@ -218,18 +230,18 @@
<url><loc>https://munderdiffl.in/blog/topics/comparisons/</loc><changefreq>weekly</changefreq><priority>0.5</priority></url>
<url><loc>https://munderdiffl.in/blog/topics/guides/</loc><changefreq>weekly</changefreq><priority>0.5</priority></url>
<url><loc>https://munderdiffl.in/blog/topics/internals/</loc><changefreq>weekly</changefreq><priority>0.5</priority></url>
- <url><loc>https://munderdiffl.in/blog/topics/concepts/</loc><changefreq>weekly</changefreq><priority>0.5</priority></url>
<url><loc>https://munderdiffl.in/blog/topics/orchestration/</loc><changefreq>weekly</changefreq><priority>0.5</priority></url>
+ <url><loc>https://munderdiffl.in/blog/topics/concepts/</loc><changefreq>weekly</changefreq><priority>0.5</priority></url>
<url><loc>https://munderdiffl.in/blog/topics/use-cases/</loc><changefreq>weekly</changefreq><priority>0.5</priority></url>
<url><loc>https://munderdiffl.in/blog/topics/memory/</loc><changefreq>weekly</changefreq><priority>0.5</priority></url>
<url><loc>https://munderdiffl.in/blog/topics/story/</loc><changefreq>weekly</changefreq><priority>0.5</priority></url>
<url><loc>https://munderdiffl.in/blog/tags/multi-agent/</loc><changefreq>weekly</changefreq><priority>0.3</priority></url>
<url><loc>https://munderdiffl.in/blog/tags/claude-code/</loc><changefreq>weekly</changefreq><priority>0.3</priority></url>
+ <url><loc>https://munderdiffl.in/blog/tags/orchestration/</loc><changefreq>weekly</changefreq><priority>0.3</priority></url>
<url><loc>https://munderdiffl.in/blog/tags/comparisons/</loc><changefreq>weekly</changefreq><priority>0.3</priority></url>
<url><loc>https://munderdiffl.in/blog/tags/tools/</loc><changefreq>weekly</changefreq><priority>0.3</priority></url>
- <url><loc>https://munderdiffl.in/blog/tags/orchestration/</loc><changefreq>weekly</changefreq><priority>0.3</priority></url>
- <url><loc>https://munderdiffl.in/blog/tags/guides/</loc><changefreq>weekly</changefreq><priority>0.3</priority></url>
<url><loc>https://munderdiffl.in/blog/tags/internals/</loc><changefreq>weekly</changefreq><priority>0.3</priority></url>
+ <url><loc>https://munderdiffl.in/blog/tags/guides/</loc><changefreq>weekly</changefreq><priority>0.3</priority></url>
<url><loc>https://munderdiffl.in/blog/tags/getting-started/</loc><changefreq>weekly</changefreq><priority>0.3</priority></url>
<url><loc>https://munderdiffl.in/blog/tags/concepts/</loc><changefreq>weekly</changefreq><priority>0.3</priority></url>
<url><loc>https://munderdiffl.in/blog/tags/memory/</loc><changefreq>weekly</changefreq><priority>0.3</priority></url>
@@ -245,7 +257,11 @@
<url><loc>https://munderdiffl.in/blog/tags/subagents/</loc><changefreq>weekly</changefreq><priority>0.3</priority></url>
<url><loc>https://munderdiffl.in/blog/tags/coordination/</loc><changefreq>weekly</changefreq><priority>0.3</priority></url>
<url><loc>https://munderdiffl.in/blog/tags/messaging/</loc><changefreq>weekly</changefreq><priority>0.3</priority></url>
+ <url><loc>https://munderdiffl.in/blog/tags/observability/</loc><changefreq>weekly</changefreq><priority>0.3</priority></url>
+ <url><loc>https://munderdiffl.in/blog/tags/event-log/</loc><changefreq>weekly</changefreq><priority>0.3</priority></url>
<url><loc>https://munderdiffl.in/blog/tags/glossary/</loc><changefreq>weekly</changefreq><priority>0.3</priority></url>
+ <url><loc>https://munderdiffl.in/blog/tags/human-in-the-loop/</loc><changefreq>weekly</changefreq><priority>0.3</priority></url>
+ <url><loc>https://munderdiffl.in/blog/tags/guardrails/</loc><changefreq>weekly</changefreq><priority>0.3</priority></url>
<url><loc>https://munderdiffl.in/blog/tags/faq/</loc><changefreq>weekly</changefreq><priority>0.3</priority></url>
<url><loc>https://munderdiffl.in/blog/tags/concurrency/</loc><changefreq>weekly</changefreq><priority>0.3</priority></url>
<url><loc>https://munderdiffl.in/blog/tags/local-first/</loc><changefreq>weekly</changefreq><priority>0.3</priority></url>