Zum Inhalt springen
TakoAPI
Zurück zu den Skills

hookaido

von 7schmiede

Web & Frontend Development
605Downloadzahlen laut clawskills.sh
0Aufrufe
0 LikesMelde dich an, um diesen Skill zu liken
—Noch nicht bewertet
Deine Bewertung

Kurzbeschreibung

Operate Hookaido inbound/outbound webhook flows, queue triage, MCP workflows, and gRPC-pull workers.

Beschreibung

Was dieser Skill macht

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.

Wann du ihn einsetzt

  • 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

Beispiel-Workflow

EINGABE

User asks: Set up GitHub webhook ingestion with HTTP pull consumption using a SQLite queue

AGENT
  1. 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. 2

    Run hookaido config fmt --config ./Hookaidofile then hookaido config validate --config ./Hookaidofile

  3. 3

    Start the runtime with hookaido run --config ./Hookaidofile --db ./.data/hookaido.db

  4. 4

    Verify health via curl http://127.0.0.1:2019/healthz?details=1

  5. 5

    Send a test webhook payload and exercise the dequeue/ack cycle against the pull API

AUSGABE

GitHub webhook events are accepted, queued in SQLite, and available for workers to dequeue and acknowledge over HTTP

Voraussetzungen

  • 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

Installation

clawhub install 7schmiede/hookaido

Führe den CLI-Befehl aus oder füge den Prompt in Claude Code, Cursor, Codex oder deinen Coding-Agenten ein.

Links