Highbeam · highbeam-cli v4.1
Context visibility and zero-token guards for AI coding chats.
Highbeam (highbeam) maps your live context window across a 40-cell bar, keeps warm KV caches safe from mistimed model switches, and blocks unsafe shell or file edits before tokens leave your machine.
127.0.0.1.
60-Second Quick Launch
Run the installer from your project root to wire hooks, status bars, and sidecar files safely. It backs up your current settings before saving any changes.
npx highbeam-cli init --all-hosts
npx highbeam-cli doctor
Configures Google Antigravity, Claude Code, and supported MCP hosts (Cursor, Windsurf, Codex CLI, Gemini CLI) in one pass. It merges lean hooks, sets up the ah-statusline bar, and checks every file contract.
npx highbeam-cli init --workspace
npx highbeam-cli --serve
Adds the workspace plugin manifest, wires the 8-state PreInvocation router, enables @ah-flash-scout, and starts the local WebView HUD on 127.0.0.1:62935.
npx ah-claude install --global
npx ah-claude statusline --demo
npx ah-claude receipt
Adds Highbeam hooks and statusLine to ~/.claude/settings.json. It registers the command hooks, which run every check, and prints your live context receipt.
npx highbeam-cli init --mcp
npx highbeam-cli doctor --json
Adds the zero-dependency @ctxtop/mcp stdio server to .cursor/mcp.json. That gives you all 7 tools: horizon_status, cache_gravity_check, scope_lock_claim, export_receipt_pdf, horizon_compress_cli, horizon_search_logs, and horizon_audit_sessions.
Core Capabilities
Highbeam swaps guesswork for clear facts: exact token counts, cache hit rates, live cache timers, and fast pre-run safety checks.
40-Cell Context Telemetry
See where recall drops before rules are forgotten
Plots your active prompt across 40 time-ordered cells with auto-zoom at 100k, 200k, and 1M limits. Spots middle-of-prompt clutter, repeat file reads, and cross-project memory bleed before old rules get cut off.
KV-Cache Gravity
C* & Horizon C_max Switch Protection
Checks single-turn C* and multi-turn C_max using live Stop-hook session stats. Asks before a model switch ("ask") whenever rebuilding a warm cache would cost more than it saves.
Pre-Write Circuit Breakers
32 Deterministic Detectors
Blocks unsafe git commands, secret reads, 3-strike error loops, Haiku 100k 5x price jumps, and parallel file clashes with zero extra LLM calls.
Lossless CLI Compression
SQLite FTS5 Offloader
Strips ANSI color codes, saves big test logs into local FTS5 search, and sends the model a short summary with every error line intact.
Zero-Trust Privacy
100% Read-Only Local I/O
Opens SQLite session files with SQLITE_OPEN_READONLY, binds WebViews only to 127.0.0.1, and makes zero outside network calls.
Start by Engineering Goal
Compare OFF, SILENT, COACH, and AUTO_PILOT modes, Antigravity hook_level cooldowns, and rule overrides.
Set up Highbeam across Antigravity, Claude Code, or Cursor MCP and check SHA-256 hashes.
Walk through prompt checks, Git worktree file locks, log trimming, and clean /compact runs.
See how Antigravity sidecar panels and Claude Code command hooks work together on the same repo.
Check every command, flag, exit code, and JSON output in highbeam v4.1.
Filter all 32 detectors and 8 habit rules, and set custom per-rule modes.
Call the 7 MCP stdio tools, 28 local HTTP/SSE routes, and Micro-IPC sockets.