Releases: hookdeck/hookdeck-cli
v2.1.0
Summary
This release improves Event Gateway MCP project context in tool descriptions and responses, and lets you pause or unpause connections by name or ID from both the CLI and MCP tools.
New features
CLI
hookdeck connection pauseandhookdeck connection unpauseaccept a connection name or ID, with the same resolution behavior (ID lookup, then list-by-name) (#277).
Event Gateway MCP
- Clearer active project context in tool descriptions and static help (#274).
- JSON tool responses include active project metadata:
active_project_organd short project name where applicable (#274). hookdeck_connectionsget, pause, and unpause accept name or ID with the same resolution rules as the CLI (#277).
Full Changelog: v2.0.2...v2.1.0
v2.0.2
Summary
Patch since v2.0.1: bumps the MCP Go SDK to address GHSA-q382-vc8q-7jhj, and adds in-repo agent skills for maintainers (Cursor / Claude Code).
Security
- GHSA-q382-vc8q-7jhj — Improper handling of null Unicode character when parsing JSON in
github.com/modelcontextprotocol/go-sdk(affected ≤ v1.4.0). This release bumpsgithub.com/modelcontextprotocol/go-sdkto v1.4.1 (#268), which pulls in the fixedgithub.com/segmentio/encodingv0.5.4 per upstream guidance.
Internal / repository
- Agent skills for CLI releases:
skills/hookdeck-cli-release/, symlinks under.cursor/skillsand.claude/skills,CLAUDE.md, and relatedAGENTS.md/ README pointers (#272). No change to shipped CLI behavior for end users beyond the dependency update above.
Full Changelog: v2.0.1...v2.0.2
v2.0.1
Summary
Patch release since v2.0.0: telemetry invocation ID is consistent for a single CLI run, CI adjustments for acceptance tests, refreshed connection command examples in help and REFERENCE.md, and a dependency update.
Breaking changes
None.
Fixes
- Telemetry: Use one invocation ID per CLI run so API calls in the same process share the same ID (fixes multiple IDs when gateway
PreRunand connectionPreRunboth initialized telemetry). (#271)
Improvements
- Docs: Connection command examples in Cobra help now use
hookdeck gateway connection; REFERENCE.md regenerated. (#271)
Internal / CI
- Disable telemetry for acceptance tests in GitHub Actions where appropriate. (#270)
- Bump
golang.org/x/termfrom 0.40.0 to 0.41.0. (#269)
Full Changelog: v2.0.0...v2.0.1
v2.0.0
Summary
This PR delivers the bulk of the Hookdeck CLI v2.0.0 release on top of the last GA tag (v1.9.1). Main user-facing additions: an MCP server for the Event Gateway, first-class Issues CLI commands, consolidated Metrics queries, and new telemetry instrumentation with a supported opt-out.
Breaking Changes / Migration
-
Global
--configflag renamed to--hookdeck-config- Reason: avoids conflicts with source/destination commands that accept JSON objects via flags also named
--config. - Update scripts: replace
hookdeck --config /pathwithhookdeck --hookdeck-config /path.
- Reason: avoids conflicts with source/destination commands that accept JSON objects via flags also named
-
New
--localflag forloginandcihookdeck login --localandhookdeck ci --localsave credentials/config to the current directory under.hookdeck/config.toml.--localcannot be used together with--hookdeck-config.
New Features
Hookdeck Event Gateway MCP Server (beta): hookdeck gateway mcp
- Starts a stdio JSON-RPC MCP server exposing Event Gateway capabilities as tools for LLM clients.
- Tooling focuses on investigation workflows (inspect/query most resources; no broad write access beyond what is intentionally scoped).
- Auth behavior:
- If already authenticated: resource tools are available immediately.
- If unauthenticated: a
hookdeck_logintool is registered to perform browser-based device auth inside the MCP flow.
- Tools exposed (high level):
hookdeck_help,hookdeck_sources,hookdeck_destinations,hookdeck_connections,hookdeck_requests,hookdeck_events,hookdeck_attempts,hookdeck_transformations,hookdeck_issues,hookdeck_metrics,hookdeck_projects,hookdeck_login.
Issues Command (Event Gateway)
New hookdeck gateway issue command group (alias: hookdeck gateway issues) with:
list(filters:--type,--status,--issue-trigger-id, sorting, pagination)get <issue-id>count(filters via type/status)update <issue-id> --status <OPENED|IGNORED|ACKNOWLEDGED|RESOLVED>dismiss <issue-id> [--force](confirmation prompt unless--force)
Metrics Consolidation
- Consolidated metrics queries into resource-aligned subcommands:
hookdeck gateway metrics eventshookdeck gateway metrics requestshookdeck gateway metrics attemptshookdeck gateway metrics transformations
- Common behavior:
--startand--endare required (ISO 8601 date-time)- Supports
--measuresand--dimensionsto choose/shape the returned metrics. - Per-issue metrics require
--issue-idwhen routing needs an explicit issue dimension.
CLI Telemetry Instrumentation + Opt-out
- Telemetry is automatically initialized before command execution and sent with identifying context (CLI source, environment, command context, and invocation correlation).
- Manage opt-out via:
- Command:
hookdeck telemetry enabled|disabled - Config/env:
HOOKDECK_CLI_TELEMETRY_DISABLED(and corresponding config setting)
- Command:
Improvements / Behavior Changes
-
Project types + gateway gating
hookdeck project useand related commands now account for project types (Gateway/Outpost/Console) and ensure gateway-only commands run against a Gateway project.- Outbound project mode is treated as Gateway for gating purposes.
-
Connection rules CLI fixes
- Improved handling/parsing for certain rule flag inputs, including JSON parsing behavior for
--rule-filter-headers.
- Improved handling/parsing for certain rule flag inputs, including JSON parsing behavior for
-
Login/CI UX updates
- Added
--localoption for bothhookdeck loginandhookdeck cito pin credentials/config under the current directory.
- Added
Internal / Reliability / Infrastructure
- Deprecated Hookdeck Go SDK removed and replaced with a direct HTTP API client (new API version), aligning CLI runtime behavior with the current backend.
- MCP and CLI test coverage was expanded significantly (including MCP server unit/integration tests).
- Acceptance test infrastructure was improved for parallel execution.
v2.0.0-beta.3
Beta: v2.0.0-beta.3
v2.0.0-beta.2
Beta: project type (Gateway/Outpost/Console), gateway gating, whoami …
v2.0.0-beta.1
Beta: v2.0.0 (breaking change)
v1.10.0-beta.4
fix(mcp): make hookdeck_login non-blocking so browser URL is shown im…
v1.10.0-beta.3
Merge branch 'claude/hookdeck-gateway-mcp-Xe6WQ' of https://github.co…
v1.10.0-beta.2
Beta: Gateway MCP (destination types, docs)