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

34.0 KB
Raw Blame
<!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&amp;family=Source+Serif+4:opsz,[email protected],400;8..60,600;8..60,700&amp;family=Space+Grotesk:wght@500;600;700&amp;family=JetBrains+Mono:wght@400;600&amp;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: &lt;your-secret&gt;</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: &lt;token&gt;</code> (or <code>?token=&lt;token&gt;</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&#39;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&#39;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&#39;s nothing to deploy. If the tunnel can&#39;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&#39;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&#39;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 &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 });
  })();
  // 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>