Overview
Open-source webhook ingest, relay, and CLI — self-host with Clerk, Supabase, Redis, and Go services
Hookie is an open-source hobby project: a monorepo for webhook ingest (Go), Redis streams, a relay (gRPC), a Next.js dashboard (Clerk + Supabase), and a Go CLI that streams events to your machine.
There is no hosted product or billing. To use the UI and authenticated CLI flows, you run the stack yourself.
What you get
- Local and self-hosted workflows — Point webhooks at your ingest URL, stream events through the relay, and inspect them in the CLI or dashboard.
- Inspect payloads — See method, path, headers, query string, and body for each delivery.
- Apps and topics — Model multiple endpoints and categories in the database; the dashboard and CLI read the same data.
- Real-time streaming — The relay pushes events to connected CLI clients over gRPC.
Architecture (when you run the repo)
- Web app (
apps/web) — Next.js UI for apps/topics; Clerk for auth; Supabase for data. - Ingest (
backend/ingest) — HTTP ingress, publishes to Redis. - Relay (
backend/relay) — Consumes Redis, streams to subscribers. - CLI (
cli) — Login against your web app, thenlistenagainst your relay.
Self-hosting
Prerequisites, env vars, and pointers to CONTRIBUTING
CLI documentation
Install, authenticate, listen, and configure hookie.yml
Authentication
Browser login against your deployed or local web app
Listen
Stream events and optional anonymous ingest URLs
Next steps
- Follow Self-hosting and the repo CONTRIBUTING for Docker, Supabase, and local dev.
- Install and use the CLI with your own
HOOKIE_WEB_APP_URLand relay address.