hookaido
bởi 7schmiede
Web & Frontend DevelopmentTóm tắt
Operate Hookaido inbound/outbound webhook flows, queue triage, MCP workflows, and gRPC-pull workers.
Mô tả
Kỹ năng này làm gì
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.
Khi nào nên dùng
- 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
Quy trình ví dụ
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
Yêu cầu
- 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
Cài đặt
clawhub install 7schmiede/hookaidoChạy lệnh CLI, hoặc dán prompt vào Claude Code, Cursor, Codex hay coding agent bạn đang dùng.