Skip to content

README.md

Latest commit

 

History

History
157 lines (109 loc) · 5.24 KB

README.md

File metadata and controls

157 lines (109 loc) · 5.24 KB

hooksense

Capture, inspect, and forward webhooks to your local dev server.

npm version npm downloads License: MIT

Website · Documentation · Integration Guides · Issues

No signup required. Get a public webhook URL in seconds and forward requests to localhost.

npx hooksense listen --forward http://localhost:3000/webhook
  HookSense — Webhook forwarder

  Endpoint:  https://hooksense.com/w/abc12345
  Forward:   http://localhost:3000/webhook
  Status:    ● Connected

  12:34:01  POST    application/json      1.2KB  → 200 OK (23ms)
  12:34:05  POST    application/json      856B   → 200 OK (18ms)
  12:34:12  PUT     text/plain            128B   → 404 Not Found (5ms)

Features

  • Instant webhook URL — no signup, no config files
  • Real-time forwarding — webhooks hit your localhost in milliseconds via WebSocket
  • Auto-reconnect — drops connection? reconnects with backoff automatically
  • Colored output — method, content-type, size, response status at a glance
  • HMAC verification — verify Stripe, GitHub, Shopify webhook signatures on hooksense.com
  • One-click replay — resend any captured webhook from the web dashboard
  • Works with any framework — Express, Next.js, FastAPI, Rails, Django, anything on localhost

Install

npm install -g hooksense

Or run directly:

npx hooksense listen --forward http://localhost:3000/webhook

Commands

hooksense listen [slug]

Listen for incoming webhooks and forward them to your local server.

# Create new endpoint + forward
hooksense listen --forward http://localhost:3000/webhook

# Use existing endpoint
hooksense listen abc12345 --forward http://localhost:3000/webhook

# Forward to a specific path
hooksense listen --forward http://localhost:3000/api/stripe

# Just listen (no forwarding)
hooksense listen abc12345

hooksense create

Create a new webhook endpoint and print the URL.

hooksense create

hooksense login / hooksense logout

Authenticate for more endpoints and longer data retention.

hooksense login
hooksense logout

hooksense status

Show current login and connection status.

hooksense status

Options

Flag Description
-f, --forward <url> URL to forward incoming webhooks to
--api <url> Override API server URL

Set HOOKSENSE_API environment variable to change the default API URL.

Use Cases

  • Stripe webhooks — test checkout.session.completed, invoice.paid, and payment events locally (guide)
  • GitHub webhooks — debug push, pull_request, and deployment events on your machine (guide)
  • Shopify webhooks — develop apps with orders/create and products/update events without deploying (guide)
  • Twilio webhooks — test SMS delivery callbacks and voice status events (guide)
  • Slack webhooks — debug slash commands, interactive components, and Events API (guide)
  • SendGrid webhooks — capture email delivery, open, click, and bounce events (guide)
  • Any webhook provider — works with everything that sends HTTP requests

Why HookSense CLI?

Feature HookSense CLI ngrok Stripe CLI
Persistent URL ✅ ❌ (changes on free) ❌ (temporary)
Webhook history ✅ (7-90 days) ❌ ❌
One-click replay ✅ (via web) ❌ ❌
HMAC verification ✅ (via web) ❌ ❌
Works with any provider ✅ ✅ ❌ (Stripe only)
No signup required ✅ ❌ ❌
Free tier ✅ ✅ (limited) ✅

HookSense Web Dashboard

The CLI works with the HookSense web dashboard which provides:

  • Real-time webhook inspection — see headers, body, query params instantly
  • HMAC signature verification — built-in for Stripe, GitHub, Shopify
  • Request replay — resend any webhook to any URL with one click
  • Request comparison — side-by-side diff of two webhook payloads
  • Export — download as cURL, JSON, or CSV
  • Monitoring & alerts — uptime tracking, error rate alerts

Try it free — no signup required.

Links

License

MIT