# 使用 Homebrew Cask 安装 headroom

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

## 安装

```sh
sudo av install cask:headroom
```

其他安装命令:

### macOS

- Homebrew Cask (100%):

```sh
brew install --cask headroom
```

  证据: local Homebrew cask metadata

## 软件包事实

- **软件包键:** cask:headroom
- **软件包管理器:** Homebrew Cask
- **软件包管理器页面:** <https://formulae.brew.sh/cask/headroom>
- **版本:** 0.9.55
- **来源摘要:** Reduce token usage for Claude Code and Codex
- **主页:** <https://extraheadroom.com/>
- **仓库:** <https://github.com/gglucass/headroom-desktop>
- **上游文档:** <https://extraheadroom.com/>
- **源码归档:** <https://github.com/gglucass/headroom-desktop/releases/download/v0.9.55/Headroom_0.9.55_mac.dmg>
- **已生成:** 2026-11-04T12:20:42+00:00

## 安装行为

- post-install 钩子: 未定义
- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-11-04
- 管理器版本: 0.9.55
- 本地数据: OK
- 上游仓库: https://github.com/gglucass/headroom-desktop
- 信息: No package-manager update timestamp was available.
- 信息: No cached GitHub release or tag data was available.
## 项目历史与用法

Headroom is a macOS utility that locally compresses tool output and other prompt material to reduce token consumption by AI coding agents.

### 项目历史

Headroom Desktop was built on the open-source Headroom CLI with the CLI maintainer's endorsement, adding a native menu-bar interface, automatic updates, usage statistics, and one-click integrations.

### 采用历史

The desktop edition packages the open-source Headroom compression engine as a signed macOS menu-bar application with connectors for Claude Code and Codex.

### 使用方式

Developers enable a Claude Code or Codex connector and let Headroom's local proxy compress verbose tool output and boilerplate before it enters conversation history.

### 为什么软件包爱好者会关心

Headroom reflects a newer package niche created by metered AI coding agents: local middleware that reduces repeated or verbose context before it consumes model tokens.

### 时间线

- Current era: Headroom Desktop packaged the existing Headroom CLI compression engine for one-click macOS use.
- 2026: Official product materials describe first-class support for both Claude Code and Codex.

### Related projects

- The official FAQ identifies Headroom CLI as the underlying engine and Claude Code and OpenAI Codex as its principal client integrations.

### 来源

- Official FAQ: https://extraheadroom.com/faq
- Official desktop repository identified by source_facts.repo: https://github.com/gglucass/headroom-desktop
- Official engine repository linked by the FAQ: https://github.com/headroomlabs-ai/headroom/
- Official guide index: https://extraheadroom.com/articles


## 安全说明

没有找到 headroom 的匹配本地密钥处理 manifest。软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 URL。


## 源数据库详情

- **Source Database:** Homebrew cask API
- **Tap:** homebrew/cask
- **Full Token:** headroom
- **Names:** Headroom
- **Depends On:** Arch: {'type': 'arm', 'bits': 64}, Macos: >=: 14
- **Artifacts:** App: 1, Target: 1, Uninstall: 1, Zap: 1
- **Auto Updates:** yes
- **Deprecated:** no
- **Disabled:** no


## 相关链接

- [Homebrew Cask packages](https://pkg.so/zh-hans/homebrew-cask-packages/) - Generated from Homebrew Cask package-manager metadata.
- [Homebrew Cask applications](https://pkg.so/zh-hans/homebrew-cask-applications/) - Cask artifact metadata includes an app bundle.
- [Desktop app packages](https://pkg.so/zh-hans/desktop-app-packages/) - Matched curated package taxonomy and local package facts.
- [openusage](https://pkg.so/zh-hans/cask/openusage/) - Local package facts share a topical domain. Shared terms: claude, code, codex, usage.
- [ccusage](https://pkg.so/zh-hans/brew/ccusage/) - Local package facts share a topical domain. Shared terms: claude, code, token, usage.
- [nimbalyst](https://pkg.so/zh-hans/cask/nimbalyst/) - Local package facts share a topical domain. Shared terms: claude, code, codex.

## Combined YAML source

View the package source record on GitHub. [combined/headroom.yml](https://github.com/mxcl/pkgdb/blob/main/combined/headroom.yml)


## 来源

- package-page enrichment
- curated package history
- package version freshness
- package relationship graph
- cross-ecosystem install command graph