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.

Highbeam Dual-Host Architecture across Google Antigravity and Claude Code Google Antigravity Host plugin.json + hooks.json PreInvocation 8-State Router Sidecar WebView 127.0.0.1:62935 @ah-flash-scout + 6 Skills Claude Code Host In-process module (not loaded today) Command hooks (hooks.json) ah-statusline (80/110/144 col) 6 Slash Commands + Docked HUD Isomorphic Core (@ctxtop/core) Pure ESM · Zero node:* imports · Zero npm deps Primacy (0–30%) · Trough (30–70%) · Recency (70–100%) Algebraic C* Cache Gravity 5m Ephemeral + 1h Billing Dual-TTL DET-01..DET-32 Circuit Breakers Ring-0 Secret, Shell & Scope Guards @ctxtop/engine-node SQLITE_OPEN_READONLY JSONL Offset Tail Fallback FTS5 Lossless CLI Offloader Micro-IPC Pipe / Socket @ctxtop/mcp + @ctxtop/pro 7 Stdio JSON-RPC 2.0 Tools Ed25519 Offline Licensing SHA-256 PDF 1.4 Receipts
Every check runs locally in memory using built-in Node.js modules. No chat text, file paths, or API keys ever leave 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.

Terminal · Dual-Host Setup
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.

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.

Highbeam HUD · Mode: Multi-File Refactor Cache Hit 87.5% · TTL 04:12
64,000 / 200,000 tok (32.0%) Waste: 4,200 tok · Saved: +$1.84
[S] System & MCP (8k) [C] Warm Cache (46.8k) [D] Stale Debt (4.2k) [W] 1.25x Write (5k)

KV-Cache Gravity

C* & Horizon C_max Switch Protection

~0.2ms p95 rule engine

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.

Explore C* & C_max physics →

Pre-Write Circuit Breakers

32 Deterministic Detectors

DET-01..32

Blocks unsafe git commands, secret reads, 3-strike error loops, Haiku 100k 5x price jumps, and parallel file clashes with zero extra LLM calls.

Browse full catalog →

Lossless CLI Compression

SQLite FTS5 Offloader

>4,096 chars

Strips ANSI color codes, saves big test logs into local FTS5 search, and sends the model a short summary with every error line intact.

How compression works →

Zero-Trust Privacy

100% Read-Only Local I/O

0 Dependencies

Opens SQLite session files with SQLITE_OPEN_READONLY, binds WebViews only to 127.0.0.1, and makes zero outside network calls.

Review security model →

Start by Engineering Goal