hookaido
di 7schmiede
Web & Frontend DevelopmentSintesi
Operate Hookaido inbound/outbound webhook flows, queue triage, MCP workflows, and gRPC-pull workers.
Descrizione
Cosa fa questa skill
Hookaido is a webhook gateway that accepts inbound HTTP requests, queues them, and delivers them to consumers via pull or push. It supports sqlite, memory, and postgres queue backends and exposes HTTP and gRPC pull APIs. Config is declarative via Hookaidofile with built-in auth, retry, and dead-letter queue handling.
Unlike generic message brokers, Hookaido covers the full webhook lifecycle, ingress auth, queuing, pull or push delivery, and DLQ management, without requiring a separate broker deployment for common webhook scenarios.
Quando usarla
- Ingesting GitHub push events and letting workers dequeue at their own pace
- Retrying failed Stripe webhook deliveries with exponential backoff
- Draining a dead-letter queue after a downstream service outage
- Running MCP mode to let an AI agent inspect queue health and backlog
- Switching from in-memory queuing to Postgres for a shared multi-worker setup
Esempio di workflow
User asks: Set up GitHub webhook ingestion with HTTP pull consumption using a SQLite queue
- 1
Write a Hookaidofile with an ingress listener, pull_api block, and a /webhooks/github route with HMAC auth pointing to a pull path
- 2
Run
hookaido config fmt --config ./Hookaidofilethenhookaido config validate --config ./Hookaidofile - 3
Start the runtime with
hookaido run --config ./Hookaidofile --db ./.data/hookaido.db - 4
Verify health via
curl http://127.0.0.1:2019/healthz?details=1 - 5
Send a test webhook payload and exercise the dequeue/ack cycle against the pull API
GitHub webhook events are accepted, queued in SQLite, and available for workers to dequeue and acknowledge over HTTP
Requisiti
- hookaido CLI binary (v2.0.0)
- HOOKAIDO_PULL_TOKEN env var for pull API auth
- HOOKAIDO_INGRESS_SECRET env var for ingress HMAC auth
- HOOKAIDO_POSTGRES_DSN env var when using postgres queue backend
Installazione
clawhub install 7schmiede/hookaidoEsegui il comando CLI oppure incolla il prompt in Claude Code, Cursor, Codex o nell'agente di coding che usi.