# Headroom CLI MCP server headroom package

Status: search-observed
Product: Headroom
Last verified: 2026-06-25
Canonical HTML: https://gitdocs.org/fix/headroom-cli-mcp-server-headroom-package
Machine JSON: https://gitdocs.org/api/fixes/headroom-cli-mcp-server-headroom-package.json

## Exact Symptom

See the observed Codex queries below.

## Diagnosis

The local repository can expose the failure, but the decisive repair depends on the current host, package, runtime, or API contract.

## Fix

```
Use the source trail below to align the local install, host, API, or runtime configuration with the current external contract.
```

## Avoid

- Changing local code without checking the current external contract.
- Retrying the same install, build, or API call with no version/source change.
- Applying a broad unsafe bypass when a narrow compatibility fix is available.

## Observed Codex Queries

- Headroom CLI MCP server headroom package
- headroom-ai package MCP command headroom
- uv tool headroom MCP command absolute path

## Sources

- Headroom installation and MCP launch issue: https://github.com/chopratejas/headroom/issues/768