EventDock CLI

Local webhook development without the hassle. No signup required.

Receive Stripe, GitHub, Shopify, and other webhooks on localhost with instant provider detection and replay.

Quick Start

npx eventdock-cli listen

That's it. You'll get a public URL instantly:

EventDock CLI v0.1.0
● Online  https://api.eventdock.app/hook/k3oxcpq3  →  http://localhost:3000/webhooks

Waiting for webhooks...

16:34:35  ✓ 200  POST [stripe] payment_intent.succeeded  5ms
16:34:38  ✓ 200  POST [github] push.completed  12ms

Installation

# Using npx (no install needed)
npx eventdock-cli listen

# Or install globally
npm install -g eventdock-cli
eventdock listen

Features

• Zero friction - No account, no signup, just run it
• Provider detection - Automatically identifies Stripe, GitHub, Shopify, Paddle, Twilio, SendGrid
• Event inspection - View full headers and body of any webhook
• Instant replay - Fix a bug, replay the webhook, test again
• Session history - Review past events with history, inspect, and replay commands

Commands

listen

Start receiving webhooks on your local machine.

eventdock listen [port] [options]

Arguments:
  port                 Local port (default: 3000)

Options:
  -p, --path <path>    Local path to forward to (default: /webhooks)
  --source <provider>  Filter events by provider
  --no-color           Disable colored output
  --json               Output events as JSON (for piping)

Examples:

# Forward to port 3000
npx eventdock-cli listen

# Forward to port 8080 with custom path
npx eventdock-cli listen 8080 --path /api/webhooks

# JSON output for scripting
npx eventdock-cli listen --json | jq '.eventType'

history

View recent webhook events from your session.

eventdock history [options]

Options:
  --limit <n>       Number of events to show (default: 20)
  --session <id>    Session ID (uses last session if not specified)

Example:

npx eventdock-cli history

Recent events (3 of 3):

1. 49d68d3d 16:34:38 POST [github] push.completed (46 B)
2. 08a96929 16:34:35 POST [stripe] payment_intent.succeeded (156 B)
3. a1b2c3d4 16:34:12 POST [shopify] orders/create (892 B)

inspect

View full details of a webhook event.

eventdock inspect [event-id] [options]

Arguments:
  event-id          Event ID to inspect (first 8 chars is enough)

Options:
  --last            Inspect the most recent event
  --session <id>    Session ID

Example:

npx eventdock-cli inspect --last

Event Details
──────────────────────────────────────────────────
ID:       08a96929-3753-441d-a806-fc7d3eafacc0
Time:     16:34:35
Method:   POST
Provider: stripe
Event:    payment_intent.succeeded

Headers
──────────────────────────────────────────────────
content-type: application/json
stripe-signature: t=1234567890,v1=abc123...

Body (156 B)
──────────────────────────────────────────────────
{
  "type": "payment_intent.succeeded",
  "data": {
    "object": {
      "amount": 2000
    }
  }
}

replay

Replay a webhook event to your local server.

eventdock replay [event-id] [options]

Arguments:
  event-id          Event ID to replay

Options:
  --last            Replay the most recent event
  --session <id>    Session ID
  --port <port>     Local port (default: 3000)
  --path <path>     Local path (default: /webhooks)

Example:

npx eventdock-cli replay --last

↻ Replaying event 08a96929...
16:35:02  ✓ 200  POST [stripe] payment_intent.succeeded  3ms

Supported Providers

EventDock automatically detects webhooks from:

• Stripe - stripe-signature header
• GitHub - x-github-event header
• Shopify - x-shopify-hmac-sha256 header
• Paddle - paddle-signature header
• Twilio - x-twilio-signature header
• SendGrid - x-twilio-email-event-webhook-signature header

Other webhooks are shown with their event type if available in the JSON body.

How It Works

1. eventdock listen establishes a WebSocket connection to EventDock's edge network
2. You receive a public HTTPS URL (e.g., https://api.eventdock.app/hook/k3oxcpq3)
3. Configure this URL in your webhook provider's dashboard
4. Webhooks are forwarded to your local server in real-time
5. Your server's response is sent back to the webhook provider

Environment Variables

• EVENTDOCK_API_URL - Override the API URL (for development)

Links

• Website: https://eventdock.app
• Issues: https://github.com/eventdock/cli/issues

License

MIT