# 使用 Homebrew 安装 hookdeck 查看 hookdeck 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。 ## 安装 ```sh sudo av install brew:hookdeck ``` 其他安装命令: ### macOS - Homebrew (100%): ```sh brew install hookdeck ``` 证据: local Homebrew formula metadata ## 软件包事实 - **软件包键:** brew:hookdeck - **软件包管理器:** Homebrew - **版本:** 2.3.1 - **来源摘要:** Forward webhook events from Hookdeck to a local server - **主页:** - **仓库:** - **最后更新:** 2026-07-30T12:46:44Z - **已生成:** 2026-08-03T19:37:03+00:00 ## 可执行文件 - hookdeck (别名) ## 安装行为 - Bottle: 不可用 ## 版本和新鲜度 - 页面生成时间: 2026-08-03 - 管理器版本: 2.3.1 ## 项目历史与用法 Hookdeck CLI is the command-line companion to Hookdeck's webhook/event-gateway platform. It began from the practical local-development problem of receiving third-party webhook traffic on a developer machine, then expanded into a broader CLI for event inspection, replay, project selection, connection management, and Event Gateway resource operations. ### 项目历史 The official README describes the original center of gravity: forward webhooks and other events to a local web server using free, permanent event URLs, while preserving event history for inspection, replay, and testing. The docs explicitly position the CLI as an alternative to ngrok-style tunnels for webhook development. The generated command reference shows the project evolving beyond `listen`. It includes authentication, project management, local development, sources, destinations, connections, transformations, events, requests, attempts, metrics, and a Gateway MCP command group. That puts the CLI in both local-development and infrastructure-management roles. The configuration model also matured into profile-based TOML files. Global flags include `--hookdeck-config`, defaulting to `$HOME/.config/hookdeck/config.toml`, and login/project commands can save local state in `.hookdeck/config.toml` for repository-scoped workflows. ### 采用历史 Hookdeck CLI is distributed through npm, Homebrew, Scoop, direct Linux archives/packages, and Docker. That packaging spread is important for a webhook tool because teams use it across macOS laptops, Windows development machines, Linux CI workers, and containerized test jobs. The docs and README frame the CLI as part of a team workflow rather than a one-off tunnel: event history persists between sessions, teammates can inspect or replay events, and the CLI can manage Event Gateway resources for CI/CD and testing. ### 使用方式 For local development, `hookdeck listen` forwards incoming events for one or more Hookdeck sources to a local port or URL. Interactive mode provides a terminal UI with event history and request/response inspection, while compact and quiet output modes support scripts and CI logs. For platform management, command groups operate on projects, sources, destinations, connections, transformations, events, requests, attempts, and metrics. `hookdeck login` persists credentials; `hookdeck project use --local` pins project selection into a repository-local config file. The CLI also supports agent-oriented workflows through `hookdeck gateway mcp`, exposing Event Gateway capabilities to MCP-compatible clients. ### 为什么软件包爱好者会关心 Hookdeck CLI sits in a recognizable package-manager category: developer tunnel tools that become operational CLIs. Package maintainers care about it because it ships across several distribution channels and because a single executable touches credentials, local config, browser login, terminal UI behavior, and CI automation. It is also a useful example of a vendor CLI that moved from a narrow local webhook listener into a control plane for platform resources. That expansion changes how package users think about upgrades: new releases can affect both localhost development and infrastructure automation. ### 时间线 - 2021: Hookdeck-authored local-development material describes the CLI as a webhook proxy and ngrok alternative. - 2024: Official connection-management guide documents CLI-driven Infrastructure as Code, CI/CD, and production automation workflows for CLI v1.2.0 and later. - 2026: Generated CLI reference covers local development, Event Gateway resource management, metrics, and MCP integration. ### Related projects - ngrok and other HTTP tunnel tools are related because Hookdeck positions the CLI as an alternative for webhook development. - Hookdeck Console and Hookdeck Event Gateway are the platform surfaces the CLI manages. - MCP-compatible clients are related through the `hookdeck gateway mcp` command group. ### 来源 - Generated REFERENCE.md: command groups, global flags, login/project local config, and MCP support. - Hookdeck CLI README: package distribution, event history, Event Gateway management, Docker usage, and config paths. - Official CLI docs: local development, webhook forwarding, replay, inspection, and ngrok-alternative positioning. ## 安全说明 没有找到 hookdeck 的匹配本地密钥处理 manifest。Nucleus 软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 URL。 ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ~/.config/hookdeck/config.toml, .hookdeck/config.toml ## Credential files - Unix: ~/.config/hookdeck/config.toml, .hookdeck/config.toml ## Combined YAML source View the package source record on GitHub. [combined/hookdeck.yml](https://github.com/mxcl/pkgdb/blob/main/combined/hookdeck.yml) ## 来源 - pkg.so package database - curated configuration and credential file locations - curated package history - pkgdb category and tag curation - cross-ecosystem install command graph