hookdeck/hookdeck-cli

What it solves

Hookdeck CLI allows developers to forward webhooks and other events from external services to a local web server for testing and development. It eliminates the need for complex tunnel setups by providing permanent event URLs and a way to preserve, inspect, and replay event history between sessions.

How it works

The CLI creates a connection between the Hookdeck Event Gateway and a local port or URL. When an external service sends an event to a Hookdeck event URL, the CLI forwards that event to the specified local endpoint. It includes a Terminal User Interface (TUI) for real-time event inspection, filtering, and replaying of requests.

Who it’s for

Developers building integrations with third-party APIs (like Shopify, Stripe, or GitHub) who need to trigger local code with real-time webhooks.

Highlights

• Permanent Event URLs: Provides stable URLs for receiving events, avoiding the need to recreate them for every session.
• Interactive TUI: A full-screen terminal interface to navigate, inspect, and retry events directly from the command line.
• Event Management: Ability to view, replay, and bookmark events, with history preserved across sessions.
• AI Agent Integration: Includes an Event Gateway MCP server (hookdeck gateway mcp) that allows AI agents (e.g., Cursor, Claude) to manage gateway resources as tools.
• Flexible Filtering: Supports filtering events by body, headers, query parameters, or path using JSON syntax to reduce noise during development.