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>How to Trigger Your AI Agent Hive from a GitHub Webhook — Munder Difflin Blog</title>
<meta name="description" content="Wire a GitHub webhook to Munder Difflin: a secret-gated local endpoint turns each repo event into a task for your GOD orchestrator — POST a message, get a token, poll the result. No server to host." />
<link rel="canonical" href="https://munderdiffl.in/blog/trigger-ai-agents-from-github-webhook/" />
<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="How to Trigger Your AI Agent Hive from a GitHub Webhook — Munder Difflin Blog" />
<meta property="og:description" content="Wire a GitHub webhook to Munder Difflin: a secret-gated local endpoint turns each repo event into a task for your GOD orchestrator — POST a message, get a token, poll the result. No server to host." />
<meta property="og:url" content="https://munderdiffl.in/blog/trigger-ai-agents-from-github-webhook/" />
<meta property="og:image" content="https://munderdiffl.in/blog/assets/media/trigger-ai-agents-from-github-webhook/hero.png" />
<meta property="og:image:width" content="1600" />
<meta property="og:image:height" content="900" />
<meta property="og:image:alt" content="Illustration: How to Trigger Your AI Agent Hive from a GitHub Webhook" />
<meta property="og:locale" content="en_US" />
<meta property="article:published_time" content="2026-06-10T00:00:00.000Z" />
<meta property="article:author" content="Chaitanya Giri" />
<meta property="article:tag" content="Guides" />
<meta property="article:tag" content="Automation" />
<meta property="article:tag" content="GitHub" />
<meta property="article:tag" content="Webhooks" />
<meta property="article:tag" content="Hive" />
<!-- Twitter -->
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:title" content="How to Trigger Your AI Agent Hive from a GitHub Webhook — Munder Difflin Blog" />
<meta name="twitter:description" content="Wire a GitHub webhook to Munder Difflin: a secret-gated local endpoint turns each repo event into a task for your GOD orchestrator — POST a message, get a token, poll the result. No server to host." />
<meta name="twitter:image" content="https://munderdiffl.in/blog/assets/media/trigger-ai-agents-from-github-webhook/hero.png" />
<meta name="twitter:image:alt" content="Illustration: How to Trigger Your AI Agent Hive from a GitHub Webhook" />
<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": "How to Trigger Your AI Agent Hive from a GitHub Webhook",
"description": "Wire a GitHub webhook to Munder Difflin: a secret-gated local endpoint turns each repo event into a task for your GOD orchestrator — POST a message, get a token, poll the result. No server to host.",
"image": ["https://munderdiffl.in/blog/assets/media/trigger-ai-agents-from-github-webhook/hero.png"],
"datePublished": "2026-06-10T00:00:00.000Z",
"dateModified": "2026-06-10T00: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/trigger-ai-agents-from-github-webhook/" },
"keywords": "github webhook ai agent, trigger ai agents from github, github webhook automation, webhook to ai orchestrator, ci ai agent trigger",
"articleSection": "Guides",
"inLanguage": "en-US",
"url": "https://munderdiffl.in/blog/trigger-ai-agents-from-github-webhook/"
}
</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": "How to Trigger Your AI Agent Hive from a GitHub Webhook", "item": "https://munderdiffl.in/blog/trigger-ai-agents-from-github-webhook/" }
]
}
</script>
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{ "@type": "Question", "name": "Can you trigger an AI agent from a GitHub webhook?", "acceptedAnswer": { "@type": "Answer", "text": "Yes. Munder Difflin runs a small, opt-in local webhook that turns an inbound POST into a task. Point a GitHub webhook (or a one-line curl from a GitHub Action) at the public URL with the shared secret in an x-md-webhook-secret header and a JSON body of { message, title? }, and the GOD orchestrator picks it up, files a kanban card, and routes it to an agent." } },
{ "@type": "Question", "name": "Is the Munder Difflin webhook secure?", "acceptedAnswer": { "@type": "Answer", "text": "It's built to be. Every POST must carry your shared secret in x-md-webhook-secret, compared in constant time, and the secret is verified before the body is even buffered. A 1 MB body cap and a fixed-window rate limit (120 requests/minute) bound abuse ahead of any parsing. The response hands back a 192-bit capability token; a GET reveals only that one task's status — no listing, no enumeration." } },
{ "@type": "Question", "name": "Do I need to host a public server to receive GitHub webhooks?", "acceptedAnswer": { "@type": "Answer", "text": "No. The endpoint runs on your own machine inside the desktop app. A best-effort local tunnel (tunnelmole) gives GitHub a public URL to reach your local port, so there's nothing to deploy. If the tunnel can't start, the local handler still runs — the tunnel is a doorbell, not the security boundary." } }
]
}
</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-guides">
<header class="post-head wrap">
<nav class="crumbs" aria-label="Breadcrumb">
<a href="/blog/">Blog</a>
<span>/</span>
<a href="/blog/topics/guides/">Guides</a>
</nav>
<h1>How to Trigger Your AI Agent Hive from a GitHub Webhook</h1>
<p class="dek">Wire a GitHub webhook to Munder Difflin: a secret-gated local endpoint turns each repo event into a task for your GOD orchestrator — POST a message, get a token, poll the result. No server to host.</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-10">Jun 10, 2026</time>
<span class="dot" aria-hidden="true">·</span>
<span>7 min read</span>
<span class="tag kind">Guides</span>
</div>
</header>
<div class="hero-wrap wrap"><figure class="fig fig-hero"><img src="/blog/assets/media/trigger-ai-agents-from-github-webhook/hero.png" alt="Illustration: How to Trigger Your AI Agent Hive from a GitHub Webhook" 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>Munder Difflin can <strong>turn a GitHub
webhook into a task for your hive</strong>. Flip on the webhook trigger, copy the public URL it opens via
a local tunnel, and have GitHub (or a GitHub Action) <strong>POST <code>{ message, title? }</code></strong>
with your shared secret in an <code>x-md-webhook-secret</code> header. The GOD orchestrator files a kanban
card, routes it to an agent, and hands back a <strong>capability token</strong> you can poll for status.
The endpoint lives <em>on your machine</em>; the tunnel is just a doorbell. Off by default until you switch
it on.</p></div>
<p>Most of the time you brief your agents from the app. But a lot of work <em>starts</em> in GitHub — a PR opens, an
issue gets a label, a release tag lands. Munder Difflin’s webhook trigger lets you bridge that gap: a GitHub
event becomes a task in your hive’s queue, triaged and routed by <a href="/blog/how-the-god-orchestrator-works/">the GOD
orchestrator</a> like any other piece of work. This is a hands-on
walkthrough using GitHub as the concrete example, but the same endpoint accepts a POST from anything that
can speak HTTP.</p>
<h2 id="what-the-webhook-trigger-actually-does" tabindex="-1">What the webhook trigger actually does <a class="anchor" href="#what-the-webhook-trigger-actually-does" aria-hidden="true">#</a></h2>
<p>The contract is small and worth stating exactly, because everything downstream depends on it.</p>
<ul>
<li><strong><code>POST</code></strong> to the endpoint with an <code>x-md-webhook-secret: <your-secret></code> header and a JSON body of
<code>{ message, title? }</code>. On success the message is routed to god/Michael, a stamped kanban card is created,
and you get back <code>{ ok: true, token, taskId }</code>.</li>
<li><strong><code>GET</code></strong> the endpoint with <code>x-md-webhook-token: <token></code> (or <code>?token=<token></code>) and you get back
<code>{ ok, status, title, result }</code> — <strong>only</strong> for that one token’s task.</li>
</ul>
<p>That’s the whole surface. <code>message</code> is the work to do (a required, non-empty string); <code>title</code> is an optional
label for the card. Note what is <em>not</em> in that body: the secret. It’s verified at the door and never forwarded
into the routed message, the card, or the response — so it can’t leak downstream.</p>
<p>This is <strong>inbound</strong> automation — the outside world asking your hive to <em>do</em> something. It’s the mirror of
<a href="/blog/human-in-the-loop-approving-ai-agents/">human-in-the-loop approvals</a>, where an agent reaches <em>out</em> to a
person mid-run. One starts work remotely; the other checks with you. Together they let a hive run while you’re
not at the keyboard.</p>
<h2 id="step-1-enable-the-webhook-trigger-and-get-the-public-url" tabindex="-1">Step 1 — Enable the webhook trigger and get the public URL <a class="anchor" href="#step-1-enable-the-webhook-trigger-and-get-the-public-url" aria-hidden="true">#</a></h2>
<p>In Munder Difflin, switch on the webhook trigger and set a <strong>shared secret</strong> (treat it like a password — long
and random). When it starts, two things happen:</p>
<ol>
<li>A bare HTTP server binds to a local port inside the app’s main process. This is the security boundary, and
it’s live the instant the port is bound.</li>
<li>The app opens a <strong>best-effort local tunnel</strong> (via <code>tunnelmole</code>) and hands you a <strong>public URL</strong> that forwards
to that local port. That’s the URL you give GitHub.</li>
</ol>
<p>The tunnel is non-fatal by design. If it can’t be established, the local handler keeps running and the app
reports the tunnel error without a URL — so you’re never in a half-broken state where the endpoint is exposed
but unguarded. The tunnel is a doorbell; it is not what keeps strangers out.</p>
<p>Copy the public URL. You’ll paste it into GitHub next.</p>
<figure class="fig fig-inline"><img src="/blog/assets/media/trigger-ai-agents-from-github-webhook/note-1.png" alt="Hand-drawn sketch from “How to Trigger Your AI Agent Hive from a GitHub Webhook”" loading="lazy" decoding="async" /></figure>
<h2 id="step-2-point-github-at-it" tabindex="-1">Step 2 — Point GitHub at it <a class="anchor" href="#step-2-point-github-at-it" aria-hidden="true">#</a></h2>
<p>You have two clean ways to do this, depending on how literal you want to be.</p>
<p><strong>Option A — A GitHub Action (recommended).</strong> GitHub’s native webhooks send GitHub’s <em>own</em> payload shape, but
our endpoint wants <code>{ message, title? }</code>. The simplest, most accurate bridge is a one-step workflow that POSTs
exactly the body the endpoint expects. Drop this in <code>.github/workflows/notify-hive.yml</code>:</p>
<pre class="language-yaml"><code class="language-yaml"><span class="token key atrule">name</span><span class="token punctuation">:</span> Notify Hive
<span class="token key atrule">on</span><span class="token punctuation">:</span>
<span class="token key atrule">pull_request</span><span class="token punctuation">:</span>
<span class="token key atrule">types</span><span class="token punctuation">:</span> <span class="token punctuation">[</span>opened<span class="token punctuation">,</span> reopened<span class="token punctuation">]</span>
<span class="token key atrule">jobs</span><span class="token punctuation">:</span>
<span class="token key atrule">ping</span><span class="token punctuation">:</span>
<span class="token key atrule">runs-on</span><span class="token punctuation">:</span> ubuntu<span class="token punctuation">-</span>latest
<span class="token key atrule">steps</span><span class="token punctuation">:</span>
<span class="token punctuation">-</span> <span class="token key atrule">name</span><span class="token punctuation">:</span> POST to Munder Difflin
<span class="token key atrule">run</span><span class="token punctuation">:</span> <span class="token punctuation">|</span><span class="token scalar string">
curl -sS -X POST "$HIVE_URL" \
-H "x-md-webhook-secret: $HIVE_SECRET" \
-H "content-type: application/json" \
-d "{\"message\": \"Review PR #$: $ — $\", \"title\": \"PR #$\"}"</span>
<span class="token key atrule">env</span><span class="token punctuation">:</span>
<span class="token key atrule">HIVE_URL</span><span class="token punctuation">:</span> $
<span class="token key atrule">HIVE_SECRET</span><span class="token punctuation">:</span> $</code></pre>
<p>Store the public URL as the <code>HIVE_URL</code> repo secret and your shared secret as <code>HIVE_SECRET</code> (Settings →
Secrets and variables → Actions). Now every opened or reopened PR composes a one-sentence brief and posts it
to your hive. Because <em>you</em> author the <code>message</code>, you control exactly what the orchestrator is asked to do.</p>
<p><strong>Option B — A raw repository webhook.</strong> If you’d rather use Settings → Webhooks, you can — but be aware GitHub
controls the payload there, and our endpoint reads only the top-level <code>message</code> and <code>title</code> strings. GitHub’s
event payload doesn’t contain those keys, so a raw webhook won’t produce a usable task on its own. Use the
Action approach when you want the hive to receive a clean, purposeful instruction rather than a raw event dump.</p>
<blockquote>
<p>Tip: GitHub webhooks have their own <code>secret</code> field that signs the body with HMAC. That’s GitHub’s scheme,
not ours — our endpoint authenticates on the <code>x-md-webhook-secret</code> <em>header</em>, which the Action sets
explicitly. Don’t confuse the two.</p>
</blockquote>
<h2 id="step-3-confirm-a-triggering-post-works" tabindex="-1">Step 3 — Confirm a triggering POST works <a class="anchor" href="#step-3-confirm-a-triggering-post-works" aria-hidden="true">#</a></h2>
<p>Before wiring CI, prove the round trip with <code>curl</code>:</p>
<pre class="language-bash"><code class="language-bash"><span class="token function">curl</span> <span class="token parameter variable">-sS</span> <span class="token parameter variable">-X</span> POST <span class="token string">"https://your-tunnel-url.example"</span> <span class="token punctuation">\</span>
<span class="token parameter variable">-H</span> <span class="token string">"x-md-webhook-secret: YOUR_SECRET"</span> <span class="token punctuation">\</span>
<span class="token parameter variable">-H</span> <span class="token string">"content-type: application/json"</span> <span class="token punctuation">\</span>
<span class="token parameter variable">-d</span> <span class="token string">'{"message": "Triage the newest open issue and draft a first response.", "title": "Issue triage"}'</span></code></pre>
<p>A good response looks like:</p>
<pre class="language-json"><code class="language-json"><span class="token punctuation">{</span> <span class="token property">"ok"</span><span class="token operator">:</span> <span class="token boolean">true</span><span class="token punctuation">,</span> <span class="token property">"token"</span><span class="token operator">:</span> <span class="token string">"…192-bit token…"</span><span class="token punctuation">,</span> <span class="token property">"taskId"</span><span class="token operator">:</span> <span class="token string">"…card id…"</span> <span class="token punctuation">}</span></code></pre>
<p>Hang onto that <code>token</code>. To check what the hive did with it, <code>GET</code> the same endpoint:</p>
<pre class="language-bash"><code class="language-bash"><span class="token function">curl</span> <span class="token parameter variable">-sS</span> <span class="token string">"https://your-tunnel-url.example"</span> <span class="token parameter variable">-H</span> <span class="token string">"x-md-webhook-token: YOUR_TOKEN"</span>
<span class="token comment"># → { "ok": true, "status": "…", "title": "Issue triage", "result": "…" }</span></code></pre>
<p>The token is the <em>only</em> key to that task. A <code>GET</code> returns only the status, title, and result for the one task
it maps to — it can’t list or enumerate any other work. An unknown token gets the same <code>404</code> as a malformed
one, so a probe can’t tell “valid but unknown” from “wrong shape.”</p>
<h2 id="what-the-hive-does-with-it" tabindex="-1">What the hive does with it <a class="anchor" href="#what-the-hive-does-with-it" aria-hidden="true">#</a></h2>
<p>Once a POST passes the secret check, the handler hands <code>{ message, title }</code> to the app, which <strong>routes the
message to god/Michael</strong> — the orchestrator’s inbox — and <strong>files a stamped kanban card</strong>. From there it’s
just another task: the orchestrator reads it, decides who should handle it, and dispatches to the right agent,
exactly like work that arrives through <a href="/blog/coordinating-ai-coding-agents/">the hive’s normal message
routing</a>. A reviewer agent might read the PR; a writer might draft the
issue response. The webhook doesn’t pick the agent — it just gets the work onto the board.</p>
<figure class="fig fig-inline"><img src="/blog/assets/media/trigger-ai-agents-from-github-webhook/note-2.png" alt="Hand-drawn sketch from “How to Trigger Your AI Agent Hive from a GitHub Webhook”" loading="lazy" decoding="async" /></figure>
<h2 id="security-in-one-breath" tabindex="-1">Security, in one breath <a class="anchor" href="#security-in-one-breath" aria-hidden="true">#</a></h2>
<p>A public endpoint that can enqueue work for autonomous agents is exactly what you don’t want strangers poking,
so the handler treats every request as hostile until proven otherwise:</p>
<ul>
<li><strong>Secret-gated, constant-time.</strong> A POST must carry the exact secret in <code>x-md-webhook-secret</code>, compared in
constant time. A length mismatch fails immediately.</li>
<li><strong>Authenticate before buffering.</strong> The secret is checked <em>before</em> the request body is read, so an
unauthenticated peer can’t make the server buffer anything (within the cap).</li>
<li><strong>Bounded before any work.</strong> A <strong>1 MB body cap</strong> and a <strong>fixed-window rate limit</strong> (120 requests/minute,
globally — the remote IP is the tunnel’s, so per-IP would be meaningless) reject abuse ahead of any parse
or crypto.</li>
<li><strong>Capability tokens, not listings.</strong> The 192-bit token a POST returns is unguessable, and a GET scoped to
it reveals only that single task.</li>
</ul>
<p>The secret stays local and is never logged, echoed, or forwarded. The principle is the one every trust
boundary should follow: authenticate at the edge, fail closed, keep verification cheap and constant-time.</p>
<h2 id="why-this-fits-a-local-first-hive" tabindex="-1">Why this fits a local-first hive <a class="anchor" href="#why-this-fits-a-local-first-hive" aria-hidden="true">#</a></h2>
<p>It would’ve been easier to host this as a cloud function. Doing it as a <strong>local</strong> endpoint is the point. Your
agents, their memory, and your git history never leave your machine — GitHub is only a <em>trigger</em>, a thin remote
surface for starting and watching work. Nothing to deploy, nothing to pay for, no third party sitting between
a repo event and your code. It’s the same philosophy behind <a href="/blog/local-first-ai-agent-orchestration/">local-first
orchestration</a>: keep the control plane on your box, and let the
outside world knock politely at the door.</p>
<p>Pair it with <a href="/blog/scheduling-autonomous-agent-missions/">scheduled missions</a> and the picture rounds out:
timers put recurring work in the queue, GitHub puts event-driven work in the queue, and the orchestrator runs
both — whether or not you’re watching.</p>
<h2 id="faq" tabindex="-1">FAQ <a class="anchor" href="#faq" aria-hidden="true">#</a></h2>
<p><strong>Can you trigger an AI agent from GitHub?</strong> Yes — point a GitHub Action’s curl (or any HTTP client) at the
webhook URL with your secret in <code>x-md-webhook-secret</code> and a <code>{ message, title? }</code> body, and the orchestrator
files a card and routes it to an agent.</p>
<p><strong>Is it secure?</strong> The secret is checked in constant time before the body is buffered, a 1 MB cap and a
120/minute rate limit bound abuse first, and the POST returns a 192-bit capability token whose GET reveals only
that one task. The secret is never logged or forwarded.</p>
<p><strong>Do I need a public server?</strong> No. The endpoint runs locally; a best-effort tunnel gives GitHub a URL to reach
it, and the handler runs even if the tunnel doesn’t.</p>
<hr>
<p>Munder Difflin turns a GitHub event into a remote control for a hive that still lives entirely on your machine
— <a href="https://munderdiffl.in/#how">orchestrated by GOD</a>, verified at the edge, queued like any other task.
<a href="https://munderdiffl.in/#install">Download Munder Difflin</a> to wire your repo into your agents; 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">Can you trigger an AI agent from a GitHub webhook?</p>
<p class="a">Yes. Munder Difflin runs a small, opt-in local webhook that turns an inbound POST into a task. Point a GitHub webhook (or a one-line curl from a GitHub Action) at the public URL with the shared secret in an x-md-webhook-secret header and a JSON body of { message, title? }, and the GOD orchestrator picks it up, files a kanban card, and routes it to an agent.</p>
</div>
<div class="qa">
<p class="q">Is the Munder Difflin webhook secure?</p>
<p class="a">It's built to be. Every POST must carry your shared secret in x-md-webhook-secret, compared in constant time, and the secret is verified before the body is even buffered. A 1 MB body cap and a fixed-window rate limit (120 requests/minute) bound abuse ahead of any parsing. The response hands back a 192-bit capability token; a GET reveals only that one task's status — no listing, no enumeration.</p>
</div>
<div class="qa">
<p class="q">Do I need to host a public server to receive GitHub webhooks?</p>
<p class="a">No. The endpoint runs on your own machine inside the desktop app. A best-effort local tunnel (tunnelmole) gives GitHub a public URL to reach your local port, so there's nothing to deploy. If the tunnel can't start, the local handler still runs — the tunnel is a doorbell, not the security boundary.</p>
</div>
</section>
<hr />
<div class="share">
<span class="lbl">Tags</span>
<a class="tag" href="/blog/tags/guides/">Guides</a><a class="tag" href="/blog/tags/automation/">Automation</a><a class="tag" href="/blog/tags/github/">GitHub</a><a class="tag" href="/blog/tags/webhooks/">Webhooks</a><a class="tag" href="/blog/tags/hive/">Hive</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="#what-the-webhook-trigger-actually-does">What the webhook trigger actually does</a></li><li class="lvl-2"><a href="#step-1-enable-the-webhook-trigger-and-get-the-public-url">Step 1 — Enable the webhook trigger and get the public URL</a></li><li class="lvl-2"><a href="#step-2-point-github-at-it">Step 2 — Point GitHub at it</a></li><li class="lvl-2"><a href="#step-3-confirm-a-triggering-post-works">Step 3 — Confirm a triggering POST works</a></li><li class="lvl-2"><a href="#what-the-hive-does-with-it">What the hive does with it</a></li><li class="lvl-2"><a href="#security-in-one-breath">Security, in one breath</a></li><li class="lvl-2"><a href="#why-this-fits-a-local-first-hive">Why this fits a local-first hive</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/why-cli-agents-are-powerful/"><span class="k">← Older</span><span class="t">Why CLI Agents Are So Powerful — and How Munder Difflin Spends Fewer Tokens Doing the Same Work</span></a>
<a class="pn next" href="/blog/the-clone-army-trap-mixed-swarm-vs-identical-agents/"><span class="k">Newer →</span><span class="t">The Clone Army Is a Trap: Why a Mixed Swarm Beats Ten Identical Agents</span></a>
</div>
<section class="related">
<h2>Related in Guides</h2>
<div class="post-grid">
<article class="card t-guides">
<a class="thumb t-guides" href="/blog/claude-md-best-practices/" aria-hidden="true" tabindex="-1"><img src="/blog/assets/media/claude-md-best-practices/hero.png" alt="" loading="lazy" decoding="async" /></a>
<div class="body">
<div class="meta">
<time datetime="2026-10-26">Oct 26, 2026</time>
<span class="dot" aria-hidden="true"></span>
<span>4 min</span>
</div>
<h3><a href="/blog/claude-md-best-practices/">CLAUDE.md Best Practices: What to Write, Where It Lives, How Long (Oct 2026)</a></h3>
<p class="dek">CLAUDE.md best practices from Anthropic's docs, checked 26 Oct 2026: what to put in it, where each file lives, the 200 line target and how AGENTS.md loads.</p>
<div class="foot">
<span class="tag kind">Guides</span>
<a class="more" href="/blog/claude-md-best-practices/" aria-label="Read: CLAUDE.md Best Practices: What to Write, Where It Lives, How Long (Oct 2026)">Read →</a>
</div>
</div>
</article>
<article class="card t-guides">
<a class="thumb t-guides" href="/blog/codex-computer-use/" aria-hidden="true" tabindex="-1"><img src="/blog/assets/media/codex-computer-use/hero.png" alt="" loading="lazy" decoding="async" /></a>
<div class="body">
<div class="meta">
<time datetime="2026-10-26">Oct 26, 2026</time>
<span class="dot" aria-hidden="true"></span>
<span>4 min</span>
</div>
<h3><a href="/blog/codex-computer-use/">Codex Computer Use: How to Turn It On, Plans and Limits (Oct 2026)</a></h3>
<p class="dek">Codex computer use lets the ChatGPT desktop app see and click apps on macOS and Windows. Setup, which plans get it, locked use and how Claude's compares.</p>
<div class="foot">
<span class="tag kind">Guides</span>
<a class="more" href="/blog/codex-computer-use/" aria-label="Read: Codex Computer Use: How to Turn It On, Plans and Limits (Oct 2026)">Read →</a>
</div>
</div>
</article>
<article class="card t-guides">
<a class="thumb t-guides" href="/blog/cursor-pricing/" aria-hidden="true" tabindex="-1"><img src="/blog/assets/media/cursor-pricing/hero.png" alt="" loading="lazy" decoding="async" /></a>
<div class="body">
<div class="meta">
<time datetime="2026-10-26">Oct 26, 2026</time>
<span class="dot" aria-hidden="true"></span>
<span>5 min</span>
</div>
<h3><a href="/blog/cursor-pricing/">Cursor Pricing (Oct 2026): Every Plan After the 12 Oct Change</a></h3>
<p class="dek">Cursor pricing as of 26 Oct 2026: Free, Plus $8, Premium $30, Super $100, Ultra $200, Teams seats, what changed on 12 Oct and what old plans keep.</p>
<div class="foot">
<span class="tag kind">Guides</span>
<a class="more" href="/blog/cursor-pricing/" aria-label="Read: Cursor Pricing (Oct 2026): Every Plan After the 12 Oct Change">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>