an open-source alternative to the dots, bots and muses of the world, run an office of claude code/codex like agents on your laptop, sandboxes or anywhere, uses your existing subscriptions
HTML agent-harnessagent-orchestrationagentsai-agentsautonomous-agentsclaude-codecodexcoding-agentsdesktop-appdeveloper-toolselectrongemini-cliharnessharness-engineeringlocal-firstmemorymulti-agentopencodeorchestrationtypescript
<!doctype html>
<html lang="en">
<head>
<!-- Google tag (gtag.js), Google Ads AW-18388216863. Loaded only when Do Not Track is
off, so it follows the same rule as the PostHog block on this site. -->
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){ dataLayer.push(arguments); }
if (navigator.doNotTrack !== '1') {
var gtagScript = document.createElement('script');
gtagScript.async = true;
gtagScript.src = 'https://www.googletagmanager.com/gtag/js?id=AW-18388216863';
document.head.appendChild(gtagScript);
gtag('js', new Date());
gtag('config', 'AW-18388216863');
}
</script>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Visualizing AI Agents with Pixi.js: An Office You Can Watch — Munder Difflin Blog</title>
<meta name="description" content="How we render AI agents as avatars on a Pixi.js office floor — driven by real hook and message events, with seat assignment, pathing, and flying envelopes." />
<link rel="canonical" href="https://munderdiffl.in/blog/visualizing-ai-agents-pixijs/" />
<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="Visualizing AI Agents with Pixi.js: An Office You Can Watch — Munder Difflin Blog" />
<meta property="og:description" content="How we render AI agents as avatars on a Pixi.js office floor — driven by real hook and message events, with seat assignment, pathing, and flying envelopes." />
<meta property="og:url" content="https://munderdiffl.in/blog/visualizing-ai-agents-pixijs/" />
<meta property="og:image" content="https://munderdiffl.in/blog/assets/media/visualizing-ai-agents-pixijs/hero.png" />
<meta property="og:image:width" content="1600" />
<meta property="og:image:height" content="900" />
<meta property="og:image:alt" content="Illustration: Visualizing AI Agents with Pixi.js: An Office You Can Watch" />
<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="Internals" />
<meta property="article:tag" content="Pixi.js" />
<meta property="article:tag" content="Visualization" />
<meta property="article:tag" content="Observability" />
<!-- Twitter -->
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:title" content="Visualizing AI Agents with Pixi.js: An Office You Can Watch — Munder Difflin Blog" />
<meta name="twitter:description" content="How we render AI agents as avatars on a Pixi.js office floor — driven by real hook and message events, with seat assignment, pathing, and flying envelopes." />
<meta name="twitter:image" content="https://munderdiffl.in/blog/assets/media/visualizing-ai-agents-pixijs/hero.png" />
<meta name="twitter:image:alt" content="Illustration: Visualizing AI Agents with Pixi.js: An Office You Can Watch" />
<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=Fraunces:opsz,[email protected],500;9..144,600;9..144,700;9..144,900&family=Source+Serif+4:opsz,[email protected],400;8..60,600;8..60,700&family=Space+Grotesk:wght@500;600;700&family=JetBrains+Mono:wght@400;600&display=swap" rel="stylesheet" />
<link rel="stylesheet" href="/blog/assets/blog-press.css" />
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "BlogPosting",
"headline": "Visualizing AI Agents with Pixi.js: An Office You Can Watch",
"description": "How we render AI agents as avatars on a Pixi.js office floor — driven by real hook and message events, with seat assignment, pathing, and flying envelopes.",
"image": ["https://munderdiffl.in/blog/assets/media/visualizing-ai-agents-pixijs/hero.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/visualizing-ai-agents-pixijs/" },
"keywords": "ai agent visualization, pixijs, agent observability, ai agent visualization",
"articleSection": "Internals",
"inLanguage": "en-US",
"url": "https://munderdiffl.in/blog/visualizing-ai-agents-pixijs/"
}
</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": "Visualizing AI Agents with Pixi.js: An Office You Can Watch", "item": "https://munderdiffl.in/blog/visualizing-ai-agents-pixijs/" }
]
}
</script>
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{ "@type": "Question", "name": "Why visualize AI agents instead of just reading logs?", "acceptedAnswer": { "@type": "Answer", "text": "A spatial view answers 'what is everyone doing right now?' at a glance — who's working, who's idle, who's blocked, and who's messaging whom. Logs answer that too, but slowly; a floor you can watch turns a multi-agent system from a wall of text into something you can supervise." } },
{ "@type": "Question", "name": "Is the office floor a simulation or real activity?", "acceptedAnswer": { "@type": "Answer", "text": "Real. Avatars move in response to actual Claude Code hook events (PreToolUse, PostToolUse, Stop) and real routed messages — not a scripted animation. When an avatar walks to the terminal station, an agent really did run a command." } },
{ "@type": "Question", "name": "Why Pixi.js for an agent visualization?", "acceptedAnswer": { "@type": "Answer", "text": "Pixi.js is a fast 2D WebGL renderer that handles many sprites smoothly, which suits a floor of avatars, tile maps, and animated envelopes. It gives game-quality rendering inside an Electron app without a heavy engine." } }
]
}
</script>
<script>
// Anonymous blog analytics (PostHog) — same posture as the main site and the
// app's TELEMETRY.md: public write-only token ('' = inert), anonymous-only
// (person_profiles 'never'), no autocapture/recording, DNT respected.
(function () {
var PH_KEY = 'phc_qJzsokwcbtTGHemnvywR3nSqivNNgMjHeNVEWkZNydFB';
if (!PH_KEY || navigator.doNotTrack === '1') return;
var s = document.createElement('script');
s.async = true;
s.src = 'https://us-assets.i.posthog.com/static/array.js';
s.onload = function () {
if (!window.posthog) return;
window.posthog.init(PH_KEY, {
api_host: 'https://us.i.posthog.com',
person_profiles: 'never',
autocapture: false,
before_send: function (event) {
// PostHog fills $ip from the connection unless the event carries one.
// Null it here and disable the GeoIP lookup so no IP, city, postal
// code or lat/long is ever derived or stored for this page view.
if (event && event.properties) {
event.properties.$ip = null;
event.properties.$geoip_disable = true;
}
return event;
},
disable_session_recording: true,
respect_dnt: true
});
};
document.head.appendChild(s);
})();
</script>
</head>
<body class="theme-press">
<a class="skip-link" href="#main">Skip to content</a>
<nav id="nav">
<a class="brand" href="https://munderdiffl.in" aria-label="Munder Difflin home">
<img class="brand-logo" src="https://munderdiffl.in/logo.png" width="1318" height="840" alt="Munder Difflin, Inc. — Multi-Agent Harness" />
</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 class="t-internals">
<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>Visualizing AI Agents with Pixi.js: An Office You Can Watch</h1>
<p class="dek">How we render AI agents as avatars on a Pixi.js office floor — driven by real hook and message events, with seat assignment, pathing, and flying envelopes.</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">Internals</span>
</div>
</header>
<div class="hero-wrap wrap"><figure class="fig fig-hero"><img src="/blog/assets/media/visualizing-ai-agents-pixijs/hero.png" alt="Illustration: Visualizing AI Agents with Pixi.js: An Office You Can Watch" loading="lazy" decoding="async" /></figure></div>
<div class="post-wrap wrap">
<div class="prose">
<div class="callout tldr"><span class="ic">TL;DR</span><p>An <strong>AI agent visualization</strong>
turns "what is the team doing?" into something you can see. Munder Difflin renders agents as avatars
on a <strong>Pixi.js</strong> office floor, driven by <strong>real events</strong>: Claude Code hooks
move an avatar to the station matching its current tool, and routed hive messages fly as envelopes
desk-to-desk. It's not a simulation — every motion reflects something an agent actually did.</p></div>
<p>A multi-agent system is, by default, a wall of text: many terminals, many logs, no spatial sense of
who’s doing what. The office floor exists to fix that — to make a hive <em>legible at a glance</em>. This post
is how it’s built with Pixi.js, and the one principle that keeps it honest: it’s driven by real
activity, not animation.</p>
<h2 id="why-a-floor-at-all" tabindex="-1">Why a floor at all <a class="anchor" href="#why-a-floor-at-all" aria-hidden="true">#</a></h2>
<p>The value of a visualization is answering “what is everyone doing right now?” instantly. On the floor:</p>
<ul>
<li>an avatar at the terminal station = an agent running a command,</li>
<li>an avatar at the file shelf = an agent reading or writing,</li>
<li>an avatar waving at the mailbox = an agent blocked, needing you,</li>
<li>an avatar at its desk = idle, awaiting work,</li>
<li>an envelope flying between desks = a message being routed.</li>
</ul>
<p>You get the team’s state in one look. That’s not a gimmick — it’s
<a href="https://munderdiffl.in/#how">an office you can actually see</a>, the visible counterpart to reading the
<a href="/blog/append-only-event-log-agents/">event log</a>.</p>
<h2 id="the-pixijs-setup" tabindex="-1">The Pixi.js setup <a class="anchor" href="#the-pixijs-setup" aria-hidden="true">#</a></h2>
<p>The renderer is a Pixi <code>Application</code>, tuned for crisp pixel art rather than smooth gradients:</p>
<pre class="language-ts"><code class="language-ts"><span class="token keyword">const</span> app <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">Application</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token keyword">await</span> app<span class="token punctuation">.</span><span class="token function">init</span><span class="token punctuation">(</span><span class="token punctuation">{</span>
antialias<span class="token operator">:</span> <span class="token boolean">false</span><span class="token punctuation">,</span> <span class="token comment">// hard pixel edges, no blur</span>
roundPixels<span class="token operator">:</span> <span class="token boolean">true</span><span class="token punctuation">,</span> <span class="token comment">// snap sprites to integer positions</span>
resolution<span class="token operator">:</span> <span class="token number">1</span>
<span class="token punctuation">}</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token comment">// nearest-neighbour scaling keeps the pixel art sharp when zoomed</span>
texture<span class="token punctuation">.</span>source<span class="token punctuation">.</span>scaleMode <span class="token operator">=</span> <span class="token string">'nearest'</span><span class="token punctuation">;</span></code></pre>
<p>On top of the stage sits a single <code>world</code> container that everything else lives in — the tile map, the
character layer, the envelopes. Putting it all under one container means the <strong>camera</strong> can pan and
zoom the entire scene by transforming just that one node, with map-edge clamping and a smooth lerp so
following a selected agent feels natural rather than jumpy.</p>
<p>One more structural choice: a <strong>single shared ticker</strong> drives all animation. Every frame, the ticker
hands out a delta-time and each live thing (avatars, envelopes, camera) advances by <code>dt</code>. One loop,
not dozens of timers — which keeps motion synchronized and the frame budget predictable.</p>
<figure class="fig fig-inline"><img src="/blog/assets/media/visualizing-ai-agents-pixijs/note-1.png" alt="Hand-drawn sketch from “Visualizing AI Agents with Pixi.js: An Office You Can Watch”" loading="lazy" decoding="async" /></figure>
<h2 id="the-floor-is-a-tiled-map" tabindex="-1">The floor is a Tiled map <a class="anchor" href="#the-floor-is-a-tiled-map" aria-hidden="true">#</a></h2>
<p>The office isn’t hand-coded geometry; it’s a <strong>Tiled</strong> map (<code>.tmj</code>) — the same format 2D game
designers use. The renderer parses its layers:</p>
<ul>
<li><strong>Tile layers</strong> (floor, walls, furniture) are drawn from tileset textures, resolved by each tile’s
global id.</li>
<li>A <strong>collision layer</strong> marks which tiles are walls vs. walkable floor.</li>
<li>A <strong>spawn-points</strong> object layer names the desks and seats.</li>
</ul>
<p>Editing the office is therefore a design task, not a code change — open the map in Tiled, move a desk,
re-export. The renderer just reads it.</p>
<h2 id="seats-giving-each-agent-a-desk" tabindex="-1">Seats: giving each agent a desk <a class="anchor" href="#seats-giving-each-agent-a-desk" aria-hidden="true">#</a></h2>
<p>When an agent joins the hive, it needs a home. A small <strong>seat pool</strong> reserves the next free desk from
the map’s spawn points and hands it to that agent; release it when the agent is gone. First-come,
first-served, one desk each — so a dynamically growing team fills the office in order instead of
piling onto one desk.</p>
<h2 id="avatars-sprites-driven-by-state" tabindex="-1">Avatars: sprites driven by state <a class="anchor" href="#avatars-sprites-driven-by-state" aria-hidden="true">#</a></h2>
<p>Each avatar is a sprite sliced from a character walk sheet. The frames are mapped into walk / type /
read / idle animations for three facing directions (left is just the right-facing row flipped), and a
small <strong>leg-crop mask</strong> tucks a seated agent under its desk so it reads as <em>sitting</em> rather than
standing on the furniture. The cast is recolored per character, so the team is visually
distinguishable at a glance.</p>
<p>But the sprites are just the <em>body</em>. What makes them meaningful is what drives them.</p>
<figure class="fig fig-inline"><img src="/blog/assets/media/visualizing-ai-agents-pixijs/note-2.png" alt="Hand-drawn sketch from “Visualizing AI Agents with Pixi.js: An Office You Can Watch”" loading="lazy" decoding="async" /></figure>
<h2 id="the-honest-part-real-events-not-a-script" tabindex="-1">The honest part: real events, not a script <a class="anchor" href="#the-honest-part-real-events-not-a-script" aria-hidden="true">#</a></h2>
<p>This is the design principle that matters most. The avatars are <strong>not</strong> playing a canned animation —
they move in response to real signals from two sources:</p>
<p><strong>Claude Code hooks.</strong> Each agent runs lifecycle hooks that report its activity. A <code>PreToolUse</code> event
(“about to run a tool”) sends the avatar walking toward the station that matches the tool — the
terminal station for a shell command, the file shelf for an edit. <code>PostToolUse</code> walks it back.
<code>Stop</code> drops it to idle at its desk; a notification sends it to the mailbox to wave for you. Because
these come straight from Claude, the floor reflects <em>real</em> tool use, with no fragile log-scraping. (The
hook lifecycle is covered in <a href="/blog/claude-code-hooks-explained/">Claude Code hooks, explained</a>.)</p>
<p><strong>Hive messages.</strong> When the router delivers a message between agents, it emits an event the floor turns
into a flying <strong>envelope</strong> — a little pixel letter that arcs from the sender’s desk to the recipient’s,
tinted by the message’s speech act (asks are cool-colored, agreements warm, refusals red, escalations
to a human a distinct color), with a small burst on arrival. You don’t just know a message was sent;
you see <em>who asked whom, and what kind of ask it was</em>.</p>
<p>Getting from a station to a desk uses a tiny <strong>breadth-first pathfinder</strong> on the map’s walkability
grid — short, predictable shortest paths around the furniture. Nothing fancier is needed at office
scale, and BFS on an unweighted grid gives the shortest route for free.</p>
<h2 id="why-this-scales" tabindex="-1">Why this scales <a class="anchor" href="#why-this-scales" aria-hidden="true">#</a></h2>
<p>A floor of avatars, a tile map, and animated envelopes is a lot of sprites — which is exactly what
Pixi.js is good at. The single-ticker design keeps the per-frame work bounded, the camera transforms
one container instead of every node, and the pixel-art settings (no antialias, nearest scaling) are
cheap to render. The same performance discipline shows up next door in
<a href="/blog/rendering-many-live-terminals-performance/">rendering many live terminals</a> — keep the hot loop
tight and let the renderer do what it’s fast at.</p>
<p>For the deeper game-dev mechanics — Tiled maps, pathfinding, sprite recoloring — see
<a href="/blog/building-an-ai-office-floor/">building an AI office floor</a>.</p>
<h2 id="faq" tabindex="-1">FAQ <a class="anchor" href="#faq" aria-hidden="true">#</a></h2>
<p><strong>Does the visualization slow the agents down?</strong> No — the agents run as normal Claude Code processes;
the floor is a read-only consumer of events they already emit. Rendering happens in the UI, separate
from the agents’ work.</p>
<p><strong>Can I still see the raw terminals?</strong> Yes. The floor is one view; the actual xterm.js terminals are
another. The avatars tell you <em>what</em> at a glance; the terminals show you the byte-for-byte detail when
you want it.</p>
<hr>
<p>Munder Difflin renders your hive of Claude Code agents as a live Pixi.js office floor — real avatars,
driven by real events, that you can actually watch. <a href="https://munderdiffl.in/#install">Download Munder Difflin</a>
to see your agents at work; 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">Why visualize AI agents instead of just reading logs?</p>
<p class="a">A spatial view answers 'what is everyone doing right now?' at a glance — who's working, who's idle, who's blocked, and who's messaging whom. Logs answer that too, but slowly; a floor you can watch turns a multi-agent system from a wall of text into something you can supervise.</p>
</div>
<div class="qa">
<p class="q">Is the office floor a simulation or real activity?</p>
<p class="a">Real. Avatars move in response to actual Claude Code hook events (PreToolUse, PostToolUse, Stop) and real routed messages — not a scripted animation. When an avatar walks to the terminal station, an agent really did run a command.</p>
</div>
<div class="qa">
<p class="q">Why Pixi.js for an agent visualization?</p>
<p class="a">Pixi.js is a fast 2D WebGL renderer that handles many sprites smoothly, which suits a floor of avatars, tile maps, and animated envelopes. It gives game-quality rendering inside an Electron app without a heavy engine.</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/pixijs/">Pixi.js</a><a class="tag" href="/blog/tags/visualization/">Visualization</a><a class="tag" href="/blog/tags/observability/">Observability</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="#why-a-floor-at-all">Why a floor at all</a></li><li class="lvl-2"><a href="#the-pixijs-setup">The Pixi.js setup</a></li><li class="lvl-2"><a href="#the-floor-is-a-tiled-map">The floor is a Tiled map</a></li><li class="lvl-2"><a href="#seats-giving-each-agent-a-desk">Seats: giving each agent a desk</a></li><li class="lvl-2"><a href="#avatars-sprites-driven-by-state">Avatars: sprites driven by state</a></li><li class="lvl-2"><a href="#the-honest-part-real-events-not-a-script">The honest part: real events, not a script</a></li><li class="lvl-2"><a href="#why-this-scales">Why this scales</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/what-are-claude-code-agents/"><span class="k">← Older</span><span class="t">What Are Claude Code Agents? And How to Use Many at Once</span></a>
<a class="pn next" href="/blog/single-committer-git-pattern/"><span class="k">Newer →</span><span class="t">The Single-Committer Pattern: Multi-Agent Git Without Corruption</span></a>
</div>
<section class="related">
<h2>Related in Internals</h2>
<div class="post-grid">
<article class="card t-internals">
<a class="thumb t-internals" href="/blog/the-spend-counter-that-went-back-to-zero/" aria-hidden="true" tabindex="-1"><img src="/blog/assets/media/the-spend-counter-that-went-back-to-zero/hero.png" alt="" loading="lazy" decoding="async" /></a>
<div class="body">
<div class="meta">
<time datetime="2026-08-22">Aug 22, 2026</time>
<span class="dot" aria-hidden="true"></span>
<span>10 min</span>
</div>
<h3><a href="/blog/the-spend-counter-that-went-back-to-zero/">The Spend Counter That Went Back to Zero</a></h3>
<p class="dek">Our own floor was under reporting what it cost by 59 percent. The counter was cumulative since process start, the app restarts, and the session id stayed the same. Here is how a monotonic invariant let us recover the real number from an append-only log.</p>
<div class="foot">
<span class="tag kind">Internals</span>
<a class="more" href="/blog/the-spend-counter-that-went-back-to-zero/" aria-label="Read: The Spend Counter That Went Back to Zero">Read →</a>
</div>
</div>
</article>
<article class="card t-internals">
<a class="thumb t-internals" href="/blog/the-newline-that-silenced-windows-agents/" aria-hidden="true" tabindex="-1"><img src="/blog/assets/media/the-newline-that-silenced-windows-agents/hero.png" alt="" loading="lazy" decoding="async" /></a>
<div class="body">
<div class="meta">
<time datetime="2026-08-19">Aug 19, 2026</time>
<span class="dot" aria-hidden="true"></span>
<span>4 min</span>
</div>
<h3><a href="/blog/the-newline-that-silenced-windows-agents/">The Newline That Silenced Every Windows Agent</a></h3>
<p class="dek">A cmd.exe parsing rule from the 1980s meant Windows agents received exactly one line of their multi-line startup protocol — and nothing errored. The anatomy of our worst silent failure, and the fix.</p>
<div class="foot">
<span class="tag kind">Internals</span>
<a class="more" href="/blog/the-newline-that-silenced-windows-agents/" aria-label="Read: The Newline That Silenced Every Windows Agent">Read →</a>
</div>
</div>
</article>
<article class="card t-internals">
<a class="thumb t-internals" href="/blog/why-our-auto-update-never-ran/" aria-hidden="true" tabindex="-1"><img src="/blog/assets/media/why-our-auto-update-never-ran/hero.png" alt="" loading="lazy" decoding="async" /></a>
<div class="body">
<div class="meta">
<time datetime="2026-08-08">Aug 8, 2026</time>
<span class="dot" aria-hidden="true"></span>
<span>5 min</span>
</div>
<h3><a href="/blog/why-our-auto-update-never-ran/">Our Auto-Update Never Ran Once: A CommonJS Export That Vanished Into an ESM Namespace</a></h3>
<p class="dek">Munder Difflin shipped auto-update in v0.3.4 and it silently never worked in a single packaged build. The cause was one destructuring assignment across the CommonJS/ESM boundary — and a catch block that threw the evidence away. Here's how we found it, and what v0.3.7 changes.</p>
<div class="foot">
<span class="tag kind">Internals</span>
<a class="more" href="/blog/why-our-auto-update-never-ran/" aria-label="Read: Our Auto-Update Never Ran Once: A CommonJS Export That Vanished Into an ESM Namespace">Read →</a>
</div>
</div>
</article>
</div>
</section>
</footer>
</article>
</main>
<footer class="site-foot">
<div class="wrap">
<div class="foot-top">
<a class="foot-brand brand" href="https://munderdiffl.in" aria-label="Munder Difflin home">
<img class="brand-logo" src="https://munderdiffl.in/logo.png" width="1318" height="840" alt="Munder Difflin, Inc. — Multi-Agent Harness" />
</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 & 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 });
})();
// YouTube click-to-load: thumbnail button → youtube-nocookie iframe
(function () {
document.addEventListener('click', function (e) {
var btn = e.target.closest('.yt-load');
if (!btn) return;
var box = btn.closest('.yt');
var id = box && box.getAttribute('data-yt');
// Only an 11 character YouTube video id may reach the iframe URL.
if (!id || !/^[A-Za-z0-9_-]{11}$/.test(id)) return;
var frame = document.createElement('iframe');
frame.src = 'https://www.youtube-nocookie.com/embed/' + encodeURIComponent(id) + '?autoplay=1';
frame.title = box.getAttribute('data-title') || 'YouTube video';
frame.allow = 'accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share';
frame.setAttribute('allowfullscreen', '');
box.replaceChildren(frame);
});
})();
</script>
</body>
</html>