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:

Subagents, /browser, /swarm & Workspace Modes

Antigravity includes built-in multi-agent tools that Highbeam tracks and guards:

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.

Claude Code in-process module (not loaded today) and command hook architecture Tier-1: In-Process Module (not loaded) hooks/register.js (dormant) on('tool.call') / on('turn.step') on('command.horizon') / ui.render Zero node:* imports (Mod Laws 1-5) Would set AH_TIER1_MOD_ACTIVE=1 Tier-2: Command Hooks (active) hooks/handlers/*.mjs (~60-80ms Linux, ~200-275ms Win) PreToolUse / PostToolUse / Stop PreModelSwitch / PreCompact Runs every check itself Full filesystem & IPC access Live State Bridge .claude/cache/ ah_live_state_<id>.json Feeds ah-statusline, highbeam receipt, panel, and @ctxtop/mcp tools

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):

Claude Code StatusLine Layout Tiers (80 / 110 / 144 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:

Google Antigravity Chat & Terminal Workflow
# 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