type: decision
status: active
timestamp: 2026-06-26
tags: [decision, agent-tooling, headroom, proxy, install]
status: active
timestamp: 2026-06-26
tags: [decision, agent-tooling, headroom, proxy, install]
Headroom install: all paths (Claude Code + ScriptCat + standalone)
Headroom 3 paths: CC (CLI), ScriptCat, standalone. One binary, three entry points
Headroom install: all paths
Decision
Install Headroom proxy with all 3 access paths active: Claude Code (CLI), ScriptCat (browser bridge), and standalone (direct local proxy on a fixed port). Same binary, three entry surfaces.
Why
User locked this on 2026-06-26 (Q6). No per-path forking — one config file, three transports. Avoids version drift between Claude-only and browser-only installs.
How to apply
- One install command brings up all 3 paths.
- Config lives in a single TOML/JSON; transports are toggles, not separate processes.
- ScriptCat path uses a userscript that calls the local proxy (per
develop-userscriptsskill conventions). - Claude Code path uses MCP wire format on stdio or local socket.
- Standalone path = direct HTTP on fixed loopback port for ad-hoc curl/scripts.
Captured
2026-06-26 session, Q6 of 24-question grill.