macOS
Homebrew Caskverified · 100%
brew install --cask headroomlocal Homebrew cask metadata
cask
Install headroom with Homebrew Cask
Reduce token usage for Claude Code and Codex. Version 0.9.55 via Homebrew Cask; verified from local package data.
install
Additional install commands
overview
Package summary
Reduce token usage for Claude Code and Codex
Project links
Commands and aliases
No executable aliases were found in the local package database.
history
Project history and usage
Headroom is a macOS utility that locally compresses tool output and other prompt material to reduce token consumption by AI coding agents.
Project history
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.
Adoption history
The desktop edition packages the open-source Headroom compression engine as a signed macOS menu-bar application with connectors for Claude Code and Codex.
How it is used
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.
Why package nerds care
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.
Timeline
- 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.
Sources
- 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
security posture
No protected-tool coverage found yet
No matching local secret-handling manifest was found for headroom. Package metadata is still published here so future coverage has a stable package URL.
Install behavior
- No Homebrew post-install hook is recorded in formula metadata.
- No Homebrew bottle metadata was recorded.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
| No executable data was present. | |||
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-11-04
manager version0.9.55
manager updated
local dataok
upstreamnot checked
latest detectednot detected
https://github.com/gglucass/headroom-desktop
- infoNo package-manager update timestamp was available.low confidence
- infoNo cached GitHub release or tag data was available.https://github.com/gglucass/headroom-desktopnone confidence
install metadata
Package metadata
| Package key | cask:headroom |
|---|---|
| Version | 0.9.55 |
| Package manager | Homebrew Cask |
| Package manager page | https://formulae.brew.sh/cask/headroom |
| Homepage | https://extraheadroom.com/ |
| Repository | https://github.com/gglucass/headroom-desktop |
| Upstream docs | https://extraheadroom.com/ |
| Source archive | https://github.com/gglucass/headroom-desktop/releases/download/v0.9.55/Headroom_0.9.55_mac.dmg |
| SHA-256 | 9b63b0e1df63e42a74127aed386352ab4d9e1cd8865a3cf3ce02345637819acb |
| Bottle | not recorded |
| Homebrew post-install | not defined |
| Service | none declared |
registry facts
Source database details
| Source Database | Homebrew cask API |
|---|---|
| Tap | homebrew/cask |
| Full Token | headroom |
| Names |
|
| Depends On | |
| Artifacts | |
| Auto Updates | yes |
| Deprecated | no |
| Disabled | no |
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- cross-ecosystem install command graph
- curated package history
- package relationship graph
- package version freshness
- package-page enrichment