# 使用 Homebrew 安装 hookdeck

查看 hookdeck 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:hookdeck
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install hookdeck
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:hookdeck
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/hookdeck>
- **版本:** 2.3.1
- **来源摘要:** Forward webhook events from Hookdeck to a local server
- **主页:** <https://hookdeck.com>
- **仓库:** <https://github.com/hookdeck/hookdeck-cli>
- **上游文档:** <https://hookdeck.com>
- **许可证:** Apache-2.0
- **源码归档:** <https://github.com/hookdeck/hookdeck-cli/archive/refs/tags/v2.3.1.tar.gz>
- **最后更新:** 2026-07-30T12:46:44Z
- **已生成:** 2026-08-04T22:13:35+00:00

## 可执行文件

- hookdeck (cli)
- hookdeck (别名)

## 构建依赖

- go

## 安装行为

- post-install 钩子: 未定义
- Bottle: 可用 于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## 版本和新鲜度

- 页面生成时间: 2026-08-04
- 管理器版本: 2.3.1
- 管理器更新时间: 2026-07-30
- 本地数据: OK
- 上游仓库: https://github.com/hookdeck/hookdeck-cli
- 检测到的最新版本: v2.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。软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 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
## 源数据库详情

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** hookdeck
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## 相关链接

- [MCP tool packages](https://pkg.so/zh-hans/mcp-tools/) - Mentions MCP or Model Context Protocol.
- [AI and agent packages](https://pkg.so/zh-hans/ai-agent-tools/) - Matched AI model, agent, coding-agent, orchestration, or MCP metadata.
- [Terminal utility packages](https://pkg.so/zh-hans/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://pkg.so/zh-hans/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [go](https://pkg.so/zh-hans/brew/go/) - Build dependency declared by Homebrew.
- [libgit2](https://pkg.so/zh-hans/brew/libgit2/) - Shares pkgdb curated category or tags: api, cli, developer-tools.
- [grpc](https://pkg.so/zh-hans/brew/grpc/) - Shares pkgdb curated category or tags: api, cli, developer-tools.
- [buf](https://pkg.so/zh-hans/brew/buf/) - Shares pkgdb curated category or tags: api, cli, developer-tools.
- [supabase](https://pkg.so/zh-hans/brew/supabase/) - Shares pkgdb curated category or tags: cli, developer-tools, local-development.
- [stripe-cli](https://pkg.so/zh-hans/brew/stripe-cli/) - Shares pkgdb curated category or tags: api, cli, developer-tools.
- [mailpit](https://pkg.so/zh-hans/brew/mailpit/) - Shares pkgdb curated category or tags: api, cli, developer-tools.
- [localstack](https://pkg.so/zh-hans/brew/localstack/) - Shares pkgdb curated category or tags: cli, developer-tools, local-development.
- [fastapi](https://pkg.so/zh-hans/brew/fastapi/) - Shares pkgdb curated category or tags: api, cli, developer-tools.
- [dory](https://pkg.so/zh-hans/brew/dory/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tools, development, local.
- [lando-cli](https://pkg.so/zh-hans/brew/lando-cli/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tools, development, local.
- [webhook](https://pkg.so/zh-hans/brew/webhook/) - Local metadata places this package in an adjacent workflow. Shared terms: cli, developer, developer-tools, server, webhook.

## 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
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- cross-ecosystem install command graph