Agent Webhook Bridge — Git skill for Claude Code

agent-webhook-bridge

A standalone HTTP broker that receives external webhooks (CI, GitHub, Flowise…) and wakes up a coding agent — either as a brand-new session or by resuming an existing one — without the agent having to be running beforehand.

Two runtimes are supported in the spawn adapter: **Claude Code** (the default) and **[free-code](https://github.com/EnmaSuamkf/free-code)**. They share the same hook protocol (`secret`/`callbackUrl`/`sessionId`), so the broker, the AgentMesh hub, and the caller code stay runtime-agnostic — you just pick which CLI a hook spawns with `--runner`.

This is phase 1 of the roadmap (see [`PLAN.md`](PLAN.md)): broker + spawn adapter. The full guide with more examples lives in [`web-docs/index.html`](web-docs/index.html) (open it in a browser); this README is the condensed version.

Table of contents

• Requirements
• Installation
• Quickstart
• Registering a hook
• New session vs. resuming (`sessionId`)
• Result callback (`callbackUrl`)
• Started callback (`startedCallbackUrl`) and workdir serialization
• Aborting an in-flight run (`jobId` + `POST /hook//abort`)
• Permissions in headless mode
• Visible mode
• Examples
• Checking status
• Security
• Current limitations
• free-code adapter
• Command reference

Requirements

• Node.js 24 or newer. The broker uses node:sqlite (no native dependencies) and runs the .ts files directly — there's no build step.
• Claude Code CLI and/or free-code CLI installed and authenticated, with the claude and/or free-code binary on the PATH