hookdeck/hookdeck-cli

해결하는 문제

Hookdeck CLI는 외부 서비스에서 발생하는 웹훅 및 기타 이벤트를 로컬 웹 서버로 전달하여 테스트 및 개발에 활용할 수 있도록 도와줍니다. 복잡한 터널 설정이 필요 없으며, 영구적인 이벤트 URL을 제공하고, 세션 간에 이벤트 기록을 보존, 검사, 재전송할 수 있는 기능을 갖추고 있습니다.

작동 방식

CLI는 Hookdeck 이벤트 게이트웨이와 로컬 포트 또는 URL 사이에 연결을 생성합니다. 외부 서비스가 Hookdeck 이벤트 URL로 이벤트를 전송하면, CLI는 해당 이벤트를 지정된 로컬 엔드포인트로 전달합니다. 실시간 이벤트 검사, 필터링, 재전송이 가능한 터미널 사용자 인터페이스(TUI)도 포함되어 있습니다.

대상 사용자

Shopify, Stripe, GitHub 등의 타사 API와 통합을 개발하는 개발자 중, 실시간 웹훅으로 로컬 코드를 트리거해야 하는 사용자.

주요 기능

• 영구적인 이벤트 URL: 세션마다 다시 생성할 필요 없이 안정적인 URL로 이벤트를 수신할 수 있습니다.
• 인터랙티브 TUI: 전체 화면 터미널 인터페이스를 통해 명령줄에서 이벤트를 탐색, 검사, 재전송할 수 있습니다.
• 이벤트 관리: 이벤트를 조회, 재전송, 북마크할 수 있으며, 세션 간에 기록이 유지됩니다.
• AI 에이전트 통합: AI 에이전트(예: Cursor, Claude)가 게이트웨이 리소스를 도구처럼 관리할 수 있도록 하는 Event Gateway MCP 서버(hookdeck gateway mcp)를 포함합니다.
• 유연한 필터링: JSON 구문을 사용해 본문, 헤더, 쿼리 파라미터, 경로 기준으로 이벤트를 필터링하여 개발 중 노이즈를 줄일 수 있습니다.