HookSpy CLI

Forward webhooks from HookSpy.net to your local development server in real-time.

Stop deploying just to test webhooks! HookSpy captures webhooks from services like Stripe, GitHub, Twilio, and more, then forwards them directly to your localhost.

Features

• Real-time webhook forwarding via SignalR
• Works with any webhook provider (Stripe, GitHub, Shopify, Twilio, etc.)
• Preserves headers, body, and HTTP method
• Colorful CLI output showing request details
• Automatic reconnection on connection loss

Installation

dotnet tool install -g hookspy

Quick Start

hookspy -e <endpoint-slug> -t http://localhost:3000/webhook -k <api-key>

Usage

hookspy --endpoint <slug> --target <local-url> --api-key <your-api-key>

Example

# Forward webhooks to your local Express server hookspy -e abc123 -t http://localhost:3000/webhooks -k hspy_xxxx # Forward to ASP.NET Core app hookspy -e my-endpoint -t https://localhost:5001/api/webhooks -k hspy_xxxx

Options

Option	Alias	Description
--endpoint	-e	Your HookSpy endpoint slug
--target	-t	Local URL to forward webhooks to
--api-key	-k	Your HookSpy API key
--server	-s	HookSpy server URL (default: https://hookspy.net)

Getting Started

1. Sign up at hookspy.net
2. Create an endpoint to get a unique webhook URL
3. Generate an API key from your dashboard
4. Point your webhook provider to your HookSpy URL
5. Run the CLI to forward webhooks to localhost

How It Works

1. Configure your webhook provider (Stripe, GitHub, etc.) to send webhooks to your HookSpy endpoint URL
2. HookSpy captures and stores incoming webhooks
3. Run the CLI on your development machine
4. Webhooks are forwarded to your local server in real-time

License

MIT