Agent-native webhooks

Describe the transform.
Deploy /h/<id>.

Hooksmith is local-first. An agent writes the YAML, you approve it in the terminal. The cloud runtime stays dumb and fast. The dashboard only watches.

bun add -g @thelacanians/hooksmith --registry https://packages.buildkite.com/the-lacanians/hooksmith/npm/

Read the docs Open the dashboard

~/notifylive

Understands the webhooks you already have

buildkitevercelgithubstripegenericcustom

The CLI creates

Tell the agent what you want in one sentence. It writes a hooksmith/v1 hook, you review the YAML and approve in the TUI. Nothing is ever authored in the browser.

hooksmith new buildkite-agents

apiVersion: hooksmith/v1
kind: Hook
metadata:
  name: buildkite-agent-disconnected
spec:
  source: buildkite
  conditions:
    - path: event
      equals: agent.disconnected
  transform:
    fields:
      title: "🚨 {{event}} · {{agent.name}}"
      sound: emergency

The runtime delivers

POST /h/<id> verifies the signature, checks your conditions, renders the transform and delivers to anything HTTP — brrr, Slack, Discord — with retries and quiet hours.

POST /h/hk_7f2a

verify   ✓ buildkite token
match    ✓ event = agent.disconnected
render   title: "🚨 agent.disconnected · mac-mini-2"
deliver  → brrr · 200 · 142ms

The dashboard observes

Events, deliveries and usage, live. When something fails, "Fix with Agent" hands the broken event straight back to your terminal.

app / logs

14:32:08agent.disconnected · mac-mini-2delivered
14:19:41build.finished · passedskipped
14:02:17invoice.paid · acmefailed
13:56:03deployment.succeeded · webdelivered
03:12:55build.failed · maindeferred

webhook.site timed out · attempt 3 Fix with Agent

spec.quietHours

quietHours:
  timezone: America/Mexico_City
  window: "22:00-08:00"
  mode: defer      # queue until morning
  applyTo:
    - brrr

Loud by day, quiet by night

mode: defer queues overnight events and delivers them at 08:00 with the original payload intact. mode: mute delivers now, silently. Your on-call phone decides which.

Built for agents, not just people

Every CLI command is also an MCP tool. Point your agent at hooksmith mcp serve and it can create, test, deploy and repair hooks without leaving the conversation.

list_hooksget_hookgenerate_transformcreate_hookedit_transformtest_hookdeploy_hooklist_eventsreplay_eventfix_with_agentget_usage

Your next webhook takes one sentence

Already installed it above? Then you're three commands from a live hook.

quick start

hooksmith init
hooksmith new my-first-hook
hooksmith deploy my-first-hook

Free for 10k events a month. See pricing