An Antigravity plugin (sidecar UI extension + lightweight lifecycle hooks) that docks in the right auxiliary pane to monitor real-time session context occupancy, full interaction traces, and project/global token analytics.
- Adaptive Context Occupancy & Ring Gauge: Circular occupancy gauge (
≥80%amber warning,≥90%red critical), full-window horizontal bar with free space, cache hit rate, compaction counter, and real-time latest-call speed in the top bar. Defaults to500kper session, adapts to observed compaction ceilings, and tracks the historical session peak when exceeded. - Current-Window Context Breakdown: Mutually exclusive breakdown of live context occupancy across
System prompt,System tools,User messages(merged byText input,Image input,File / Media),Injected context(grouped byTime,Image,Compaction,Settings,Other),Skills(merged by skill name),Tool results(split by tool name & success/error), and per-model output (Thinking&Text output) with post-compaction average speed. - Session Telemetry & Breakdowns: 4-metric KPI strip (
Total Tokens,Cache Read,Output,Active Timewithavg&maxtok/s), Models, Token Breakdown (cumulative session totals), Time Breakdown, Context Trend (smooth Bezier curve cleanly broken at every compaction drop), Tool Execution (succeeded/failed counts, ratio bar, total & average duration), and Recent Trace. - Project & Global Insights: Workspace-scoped and cross-workspace dashboards featuring a free
Start → Enddate range picker + quick presets (Today,7d,30d,All), adaptive usage charts (hour/day/week/month/year), Token & Time Breakdown, Models, Tool Execution, ranked Skills / Tools / Commands (sorted byCount,Time, orContext), and searchable session cards with one-click jump.
- Standalone Auxiliary Tab: Open Trace alongside Context from the
+or Extensions menu to watch requests and tool calls stream live. - 3-Track Timeline Strip: Fixed left lane labels (
Input/Model/Tool) with vertical grey dashed divider lines for Context Compaction events and dimmed markers for Reverted branches. - Exclusive Type Toggles & Revert Detection: Independently filter
Input,Injected,Skill,Model,Tool,Compaction, andError, with automatic detection andRevertedbadge / strikethrough marking for superseded branches. - Progressive History Loading & Live Generation: Automatically loads earlier history as you scroll back to Step
#0, while displaying a pulsing live generating row at the bottom during active model calls. - Master-Detail Inspector: Multi-tag model rows (
Thinking,Tool Call,Output), click-to-toggle detail drawer, in-place expandable Markdown preview, raw content blocks, tool arguments/results, host errors, and real measured request timing.
- Bilingual UI & Theme Sync: English and Simplified Chinese (
EN / 简), automatically matching Antigravity's light and dark themes. - Context Modules & Order Editor: Show/hide and drag-or-move modules independently for both Session and Project & Global, with responsive 2-column independent-stack layout on wide screens.
- Disk-Persisted Settings: Stored atomically in
$PLUGIN_DATA/settings.jsonso preferences survive disable/enable, restarts, and updates. - One-Click Self-Update: Automatically checks GitHub Releases and updates + reloads in-place.
agy plugin install https://github.com/keleus/agy-contextgit clone https://github.com/keleus/agy-context.git
cd agy-context
./install.sh --link # symlink into ~/.gemini/config/plugins/agy-context
# or
./install.sh --copy # copy into ~/.gemini/config/plugins/agy-contextTo uninstall:
./install.sh --uninstall- Confirm AGY Context is enabled under Skills & Customizations -> Plugins in Antigravity.
- Open Context (
Session | Project | Global) and/or Trace (live interaction history) from the conversation header's+menu or Overview -> Extensions. - Both views share one lightweight background sidecar and automatically track the active conversation.
- Local-only sidecar & hooks: Reads local conversation transcripts under
~/.gemini/antigravity/brain/<conversationId>/.system_generated/logs/and stores lightweight timing telemetry & settings under$PLUGIN_DATA/. Never modifies conversation files or intercepts tool approval permissions. - Zero external runtime dependencies: Runs directly on Antigravity's bundled Node.js runtime (
sidecar_sdk) and systempython3.
Licensed under the Apache License 2.0.