{"id":17249,"library":"hookdeck-cli","title":"Hookdeck CLI","description":"The Hookdeck CLI, currently at stable version 2.1.1, provides a command-line interface for interacting with the Hookdeck platform. It enables developers to manage webhooks locally, forward them to the Hookdeck service, and control various aspects of their Hookdeck account, including connections, issues, and metrics. The project maintains an active release cadence with regular patch and minor updates, often accompanied by beta pre-releases for early testing. Key differentiators include its ability to securely expose local development environments to webhook traffic via the `hookdeck listen` command, manage webhook connections by name or ID, and integrate with the Event Gateway MCP for advanced scenarios. Recent updates have focused on improving authentication flows, gateway reliability, and security patches.","status":"active","version":"2.1.1","language":"javascript","source_language":"en","source_url":"https://github.com/hookdeck/hookdeck-cli","tags":["javascript","hookdeck","webhooks"],"install":[{"cmd":"npm install hookdeck-cli","lang":"bash","label":"npm"},{"cmd":"yarn add hookdeck-cli","lang":"bash","label":"yarn"},{"cmd":"pnpm add hookdeck-cli","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[],"quickstart":{"code":"npm install -g hookdeck-cli\n\n# Log in to your Hookdeck account via browser\nhookdeck login\n\n# Listen for webhooks on local port 8080, forwarding them via Hookdeck\n# This command sets up a temporary connection to expose your local server\nhookdeck listen 8080","lang":"javascript","description":"Installs the Hookdeck CLI globally, authenticates the user, and sets up local webhook forwarding."},"warnings":[{"fix":"Update all scripts and commands using the global configuration flag to use `--hookdeck-config` instead of `--config`.","message":"The global configuration flag `--config` was renamed to `--hookdeck-config` in v2.0.0 to avoid conflicts with other command-specific flags.","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Upgrade `hookdeck-cli` to v2.0.2 or a later version to ensure the security patch is applied. Use `npm install -g hookdeck-cli@latest`.","message":"Version v2.0.2 patched a security vulnerability (GHSA-q382-vc8q-7jhj) related to improper handling of null Unicode characters when parsing JSON within an internal Go SDK dependency. This primarily affected the Event Gateway MCP component.","severity":"gotcha","affected_versions":"<2.0.2"},{"fix":"Review any automation or scripting that parses `hookdeck` CLI output, especially for `hookdeck gateway mcp` commands, to ensure `stderr` is correctly monitored for authentication error messages.","message":"Starting from v2.1.1, authentication failures (HTTP 401 responses) now provide clearer, more actionable error messages. For `hookdeck gateway mcp`, these messages are directed to `stderr` to maintain clean `stdout` for JSON-RPC clients.","severity":"gotcha","affected_versions":">=2.1.1"}],"env_vars":null,"last_verified":"2026-04-22T00:00:00.000Z","next_check":"2026-07-21T00:00:00.000Z","problems":[{"fix":"Run `hookdeck login` in your terminal to authenticate your Hookdeck CLI session. This will typically open a browser window for you to log in.","cause":"The user attempted to execute a CLI command that requires authentication without an active login session.","error":"Error: You are not logged in. Please run 'hookdeck login' to authenticate."},{"fix":"Replace `--config` with `--hookdeck-config` in your command. For example, `hookdeck listen --hookdeck-config ~/.hookdeck/config.json`.","cause":"The user is attempting to use the deprecated global `--config` flag, which was renamed in v2.0.0.","error":"Error: unknown flag: --config"},{"fix":"Either stop the process currently using the desired port, or specify a different available port for `hookdeck listen` (e.g., `hookdeck listen 3000`).","cause":"The local port specified for `hookdeck listen` (e.g., 8080) is currently being used by another application or process.","error":"Error: listen EADDRINUSE: address already in use :::8080"}],"ecosystem":"npm","meta_description":null}