Foundations
Google Antigravity vs. Claude Code
Highbeam runs one shared context engine across Google Antigravity, Claude Code, and MCP editors. Each host uses its fastest local hook path while sharing the same guard rules and file locks on disk.
Host Capability Matrix
| Dimension | Google Antigravity | Claude Code | Cursor / Windsurf (@ctxtop/mcp) |
|---|---|---|---|
| Manifest Root | plugin.json & .antigravity-plugin/plugin.json |
.claude-plugin/plugin.json & settings.json |
.cursor/mcp.json (stdio JSON-RPC 2.0) |
| Install Locations | .agents/plugins/ (workspace) or ~/.gemini/config/plugins/ (global) |
.claude/settings.json (project) or ~/.claude/settings.json (global) |
.cursor/mcp.json or global MCP config |
| Execution Path | CLI Hooks + Local HTTP/SSE Sidecar Server + Micro-IPC | Command hooks (hooks/handlers/*.mjs, one short Node process per call) |
On-demand MCP tool calls (highbeam-mcp / ah-mcp / ctxtop-mcp) |
| Primary Visual UI | Live Side-Pane WebView (127.0.0.1:62935) + Studio <agent-embed> |
Width-aware ah-statusline bar + Docked Mod View + Local HTML |
JSON tool replies + PDF/HTML receipts |
| Telemetry Source | SQLITE_OPEN_READONLY on conversations/*.db + JSONL offset reads |
statusLine stdin JSON + .claude/cache/ah_live_state_<id>.json |
Shared live-state files + 30-day quota ledger |
| Subagent Strategy | @ah-flash-scout (<200 tok), /browser, /swarm (inherit|branch|share) |
Task / Agent workers + Git worktrees + DET-19 input scrubber |
Cross-editor scope_lock_claim file locks |
Google Antigravity Surface Architecture
Inside Google Antigravity (App, IDE, and agy CLI), Highbeam runs as a sidecar plugin under attention-horizon-antigravity (and workspace mirror agy-horizon-flightcheck).
Sidecar Daemon & Simple / Advanced WebView
sidecars/horizon-daemon/sidecar.json starts node --no-warnings server.mjs on local port 62935 (trying 62935..62945 if busy). It mounts straight into Antigravity's side pane via SIDECAR_UI_ENTRYPOINT_AUX_PANE. You can also open it from chat via the sidecar://agy-horizon-flightcheck/horizon-daemon/ pill or run npx highbeam-cli --serve in a browser.
The panel offers a clean Simple View (#argonSimpleSurface) and a full Advanced Workbench (#argonAdvancedSurface). Both fit narrow 360px side panes with auto light/dark themes and strict UI safeguards tested in test/top10_token_wasters_ui.test.mjs:
- Zone A–D Simple View & Clutter Drawer: Shows the Signal vs. Clutter bar (
#tsBarSignal,#tsBarClutter,#tsStatusLabel), clearDO/AVOID/MODEL/EFFORTcards (#tsDoText,#tsAvoidText,#tsModelCard,#tsEffortCard), and a What/compactclears list (#tsWhyClears,#tsWhyList,#tsWhyTotal). - 1-Click Compaction Copy: Keeps
#btnCompactPrimaryand#btnCopyParameterizedCompactright beside#compactInstructionand#compactReclaim(plus Simple View#tsBtnCleanPrimary) for 1-click/compactcopy. - Active Source File Protection: In the Advanced Top Consumers list (
#taConsumersBody), theIgnore file(.antigravityignore) button shows up only on lockfiles, logs, build outputs, and scratch files (isIgnorablePath). It never shows onActive Sourcecode files. - 3-Way Mirror Parity: When local plugin folders (
~/.gemini/config/plugins/agy-horizonandagy-horizon-flightcheck) exist on disk,node scripts/sync_mirrors.mjskeepshorizon_panel.htmlandsrc/core/*.mjsbyte-for-byte matched via SHA-256 checks.
Subagents, /browser, /swarm & Workspace Modes
Antigravity includes built-in multi-agent tools that Highbeam tracks and guards:
- Delegation Scout (
@ah-flash-scout): Set inagents/ah-flash-scout.mdwithmodel: flash,commandExecutionPolicy: off, and read-only search tools (view_file,grep_search,find_by_name,list_dir). It returns shortFile:StartLine-EndLinehits in under200tokens so your main model skips raw grep noise. /browserIsolation: Live web checks run inside Antigravity's sandboxed webview on Flash by default. Files stage inbrowser_sandbox/without cluttering your repo./swarm& Workspace Modes: Parallel workers pick one of three Workspace Modes:inherit: Shares your main folder; best for read-only scouts, reviewers, and checkers.share: Opens a separate Git worktree sharing your repo's git objects so multiple writers can edit and build at once without extra disk copies.branch: Clones a full isolated copy when total folder separation is needed.
Claude Code Dual-Tier Architecture
Highbeam ships two hook paths for Claude Code. Today only the command hooks (Tier-2) run: Claude Code 2.1.325 has no hooks.modules setting, so the in-process module (Tier-1) is not loaded. It stays in the package for a future Claude Code in-process plugin API.
Responsive Single-Line ah-statusline Tiers
In Claude Code, bin/ah-statusline.mjs reads Claude Code's statusLine JSON after each turn. It saves a snapshot to .claude/cache/ah_live_state_<sessionId>.json (with cached hostCapabilities and any PreModelSwitch binary notes from inspectClaudeBinaryCapabilities()). Then it prints a one-line ANSI bar sized to your terminal width (set via --columns <N> or AH_COLUMNS):
# Compact Tier (80 columns)
AH [██▓▓▓▓▓▓░░░░] 64k/200k · Hit 88% · TTL 04:12 · +$1.84
# Standard Tier (110 columns, default fallback)
AH sonnet-5.5 [██▓▓▓▓▓▓▓▓▒█░░░░░░░░] 64.0k/200k (32%) · Cache 87.5% · 5m TTL 04:12 · Saved +$1.84
# Wide Workbench Tier (144+ columns)
AH sonnet-5.5 [COACH] [██▓▓▓▓▓▓▓▓▓▓▓▓▒█░░░░░░░░░░░░░░░░] 64.0k/200k (32%) · Hit 87.5% · 5m 04:12 | 1h 51:08 · C* Hold · Saved +$1.84
Side-by-Side Workflow Switcher
Select a host below to see the exact command sequence for common daily tasks:
# 1. Inspect 40-cell window as an embedded Studio widget
/horizon
# 2. Score a complex refactor prompt before spending frontier quota
#check Refactor src/core/classifier.mjs to extract span categorization
# 3. Delegate fast file discovery to Gemini Flash (<200 tokens returned)
@ah-flash-scout Locate all callers of classifyHorizonWindow
# 4. Compress state into task.md before running /compact
/handoff
# 1. Open docked Mod pane or print the 4-rank terminal receipt
/horizon
npx ah-claude receipt --advanced
# 2. Check warm KV-cache gravity and C* break-even before switching models
/precheck
# 3. Render self-contained Cost Radar SVG timeline for the active session
/cost-radar
# 4. Flush State Baton to .claude/cache/HANDOFF_LATEST.md before /compact
/handoff