Skip to content

Headroom: run the MCP server with its usage beacon off (HEADROOM_OFFLINE=1, DO_NOT_TRACK=1) - #304

Merged
seathatflowsinourveins merged 1 commit into
mainfrom
claude/headroom-offline-20260925
Sep 25, 2026
Merged

seathatflowsinourveins merged 1 commit into
mainfrom
claude/headroom-offline-20260925

Conversation

@seathatflowsinourveins

Copy link
Copy Markdown
Collaborator

Scope

  • What this PR changes: the Headroom recipe (recipes/README.md) and the token-stack row (docs/token-efficiency-stack.json) now start the MCP server with HEADROOM_OFFLINE=1 DO_NOT_TRACK=1, and the recipe shows the native claude mcp add registration with both variables. The Token stack inside Ultracode subagents: 16/16 tools E2E with lifetime counters, exact comparisons and five new host receipts #296 E2E README now records that Headroom's beacon was at its default (on) during that run.
  • Base commit: efa32d92
  • Lane: lane:foundation
  • Owned paths touched: recipes/README.md, docs/token-efficiency-stack.json, evidence/artifacts/token-e2e-ultracode-20260925/README.md, and their registrations.

SOTA sources

  • headroom-ai 0.37.0, the stack pin (https://github.com/chopratejas/headroom; PyPI headroom-ai==0.37.0), as installed:
    • headroom/telemetry/beacon.py: BEACON_DEFAULT_ON = True. is_beacon_enabled() returns False when offline, when DO_NOT_TRACK is set, or when HEADROOM_BEACON=off.
    • headroom/offline.py: HEADROOM_OFFLINE is the master switch for the beacon, the update check, the license/usage reporter and HF downloads.
    • headroom/ccr/mcp_server.py:799: the MCP compress path calls the beacon.
  • Claude Code claude mcp add options: -e KEY=value is variadic, so the server name must come before it. Observed: Invalid environment variable format: headroom when the name came after.

Evidence-class table

Claim Evidence class Command
The beacon is on by default, and offline mode or DO_NOT_TRACK turns it off source_review the installed 0.37.0 files above
With HEADROOM_OFFLINE=1, headroom_compress over MCPorter still returns compressed output local_integration mcporter call --stdio "headroom mcp serve --proxy-url http://127.0.0.1:1" --env HEADROOM_OFFLINE=1 --tool headroom_compress …: exit 0
This host's Claude user-scope headroom server now carries both variables native_proven (host config, read back) claude mcp get headroom: Environment HEADROOM_OFFLINE=1, DO_NOT_TRACK=1; Connected

The token-report service on this host also got Environment=HEADROOM_OFFLINE=1 DO_NOT_TRACK=1; a manual run succeeded. The Codex user-scope registration (#289) is mirrored by that PR's owner.

Local commands run

$ uv run … scripts/validate.py; build_ecosystem.py --check; new_host_grand_list.py --check   # passed
$ uv run … -m unittest <modules that read recipes/README or token-efficiency-stack>   # Ran 420, OK (skipped=21)

Checklist

  • No workflow changes. [x] No secrets. [x] No paid surface. [x] Peer files preserved.

🤖 Generated with Claude Code

… DO_NOT_TRACK=1)

headroom-ai 0.37.0 uploads an anonymous usage beacon by default
(telemetry/beacon.py BEACON_DEFAULT_ON = True; ccr/mcp_server.py calls it on
every MCP compression). offline.py's HEADROOM_OFFLINE is the master no-egress
switch (beacon, update check, usage reporter, HF downloads); DO_NOT_TRACK also
disables the beacon. The recipe and token-stack row now set both, with the
native Claude registration command; the #296 E2E README records that the
beacon was at its default during that run.

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>
@seathatflowsinourveins seathatflowsinourveins added the lane:foundation Foundation lane: Claude/Codex setup, hosts, memory, RAG, research, workers label Sep 25, 2026
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@seathatflowsinourveins
seathatflowsinourveins merged commit 59bb242 into main Sep 25, 2026
24 checks passed
@seathatflowsinourveins
seathatflowsinourveins deleted the claude/headroom-offline-20260925 branch September 25, 2026 23:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

lane:foundation Foundation lane: Claude/Codex setup, hosts, memory, RAG, research, workers

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant