hookdeck/hookdeck-cli

解決的問題

Hookdeck CLI 允許開發者將外部服務的 Webhook 和其他事件轉發至本地 Web 伺服器，用於測試與開發。它透過提供永久事件 URL，並支援在會話間保存、檢視與重播事件歷史，消除了複雜隧道設定的需求。

工作原理

CLI 在 Hookdeck 事件網關與本地端口或 URL 之間建立連接。當外部服務向 Hookdeck 事件 URL 發送事件時，CLI 會將該事件轉發至指定的本地端點。它包含一個終端使用者介面（TUI），可用於即時檢視、過濾與重播請求。

適用對象

需要使用即時 Webhook 觸發本地程式碼的開發者，例如建構與 Shopify、Stripe 或 GitHub 等第三方 API 的整合。

主要特色

• 永久事件 URL：提供穩定的 URL 用於接收事件，無需為每次會話重新建立。
• 互動式 TUI：全螢幕終端介面，可直接從命令列導航、檢視與重試事件。
• 事件管理：可檢視、重播與書籤事件，歷史記錄在會話間保持持久化。
• AI 代理整合：內建事件網關 MCP 伺服器（hookdeck gateway mcp），允許 AI 代理（如 Cursor、Claude）將網關資源作為工具進行管理。
• 靈活的過濾功能：支援使用 JSON 語法按內容、標頭、查詢參數或路徑過濾事件，以在開發過程中減少雜訊。