Registry / http-networking / hookdeck-cli

hookdeck-cli

library2.1.1jsnpmunverified

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.

http-networking devops communication

npm install hookdeck-cli

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · HOOKDECK-CLI

hookdeck-cli

http-networkingjavascriptv2.1.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Installs the Hookdeck CLI globally, authenticates the user, and sets up local webhook forwarding.

npm install -g hookdeck-cli # Log in to your Hookdeck account via browser hookdeck login # Listen for webhooks on local port 8080, forwarding them via Hookdeck # This command sets up a temporary connection to expose your local server hookdeck listen 8080

hookdeck --version

Debug

Known issues

breakingThe global configuration flag `--config` was renamed to `--hookdeck-config` in v2.0.0 to avoid conflicts with other command-specific flags.

fix

Update all scripts and commands using the global configuration flag to use `--hookdeck-config` instead of `--config`.

affects: >=2.0.0

gotchaVersion 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.

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`.

affects: <2.0.2

gotchaStarting 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.

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.

affects: >=2.1.1

Errors

Common errors & fixes

Error: You are not logged in. Please run 'hookdeck login' to authenticate.

The user attempted to execute a CLI command that requires authentication without an active login session.

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.

Error: unknown flag: --config

The user is attempting to use the deprecated global `--config` flag, which was renamed in v2.0.0.

fix

Replace `--config` with `--hookdeck-config` in your command. For example, `hookdeck listen --hookdeck-config ~/.hookdeck/config.json`.

Error: listen EADDRINUSE: address already in use :::8080

The local port specified for `hookdeck listen` (e.g., 8080) is currently being used by another application or process.

fix

Either stop the process currently using the desired port, or specify a different available port for `hookdeck listen` (e.g., `hookdeck listen 3000`).

Upgrade

Version history

2.1.1latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

31 hits · last 30 days

node

Bingbot

OpenAI (training)

Resources

githubhttps://github.com/hookdeck/hookdeck-cli ↗

packagehttps://www.npmjs.com/package/hookdeck-cli ↗

homepagehttps://hookdeck.com ↗