# lavich99/antigravity-usage-monitor-th architecture

> Architecture diagram of the GitHub repository lavich99/antigravity-usage-monitor-th, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lavich99/antigravity-usage-monitor-th
- Repository: https://github.com/lavich99/antigravity-usage-monitor-th

## Overview

This is an offline, read-only Antigravity Desktop usage monitor. Its main workflow is to collect local app activity, derive usage, speed, context, and quota telemetry, expose it through the panel sidecar API, and present it in a compact live panel plus detailed usage, step, and settings views. The README documents these capabilities, but most backend implementation was not excerpted; uncertain backend connections are therefore dashed and unevidenced.

Main entry points: [`sidecars/panel/src/App.js`](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/App.js) (Panel App), [`sidecars/panel/src/store/telemetryStore.js`](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/store/telemetryStore.js) (Telemetry Store), [`sidecars/panel/backend/usage-aggregator.mjs`](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/backend/usage-aggregator.mjs) (Usage Aggregator), [`sidecars/panel/backend/api-actions.mjs`](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/backend/api-actions.mjs) (API Actions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_collection["Local Collection"]
  node_scanner["Local Scanner<br/>[local-scanner.mjs]"]
  node_discovery["Language Discovery<br/>[ls-discovery.mjs]"]
  node_rpc["Language RPC<br/>[ls-rpc.mjs]"]
  node_sqlite["SQLite Reader"]
end

subgraph group_processing["Telemetry Processing"]
  node_speed["Speed Metrics<br/>[speed-metrics.mjs]"]
  node_aggregator["Usage Aggregator"]
  node_context["Context Windows"]
  node_quota["Quota Pools<br/>[quota-pools.mjs]"]
  node_pricing["Pricing Catalog"]
end

subgraph group_panel["Panel Experience"]
  node_telemetry["Telemetry Store<br/>[telemetryStore.js]"]
  node_uistore["UI State<br/>[uiStore.js]"]
  node_app["Panel App<br/>[App.js]"]
  node_overlay["Window Overlay"]
  node_capsule["Capsule Bar"]
  node_live["Live Overview"]
  node_consumption["Usage Analytics<br/>[ConsumptionView.js]"]
  node_steps["Step Details<br/>[StepsDetailView.js]"]
  node_settings["Settings<br/>[SettingsView.js]"]
  node_metrics["Metric Registry<br/>[metricRegistry.js]"]
  node_columns["Step Columns"]
end

subgraph group_runtime["Runtime Bridge"]
  node_api["API Actions<br/>[api-actions.mjs]"]
  node_worker["Sidecar Worker<br/>[sidecar-worker.mjs]"]
  node_main["Panel Main<br/>[main.mjs]"]
  node_bridge["Window Bridge<br/>[bridge-daemon.mjs]"]
  node_http["HTTP Client<br/>[httpClient.js]"]
end

node_antigravity(("Antigravity Desktop"))
node_localdata[("Local App Data")]

node_antigravity -.->|"writes activity"| node_localdata
node_localdata -.->|"scans locally"| node_scanner
node_scanner -.->|"reads records"| node_sqlite
node_scanner -.->|"discovers services"| node_discovery
node_discovery -.->|"resolves RPC"| node_rpc
node_aggregator -.->|"derives speed"| node_speed
node_aggregator -.->|"derives context"| node_context
node_aggregator -.->|"summarizes quotas"| node_quota
node_aggregator -.->|"estimates cost"| node_pricing
node_api -.->|"requests summaries"| node_aggregator
node_main -->|"imports actions"| node_api
node_worker -->|"imports actions"| node_api
node_http -.->|"requests API"| node_api
node_http -.->|"uses bridge transport"| node_bridge
node_telemetry -->|"calls API client"| node_http
node_main -->|"starts panel"| node_app
node_main -->|"loads overlay"| node_overlay
node_app -->|"creates view"| node_live
node_app -->|"creates view"| node_consumption
node_app -->|"creates view"| node_steps
node_app -->|"creates view"| node_settings
node_app -->|"resolves conversation"| node_telemetry
node_app -->|"reads navigation"| node_uistore
node_overlay -->|"renders widget"| node_capsule
node_live -.->|"reads telemetry"| node_telemetry
node_consumption -->|"reads telemetry"| node_telemetry
node_steps -->|"reads telemetry"| node_telemetry
node_steps -->|"uses columns"| node_columns
node_consumption -.->|"uses metrics"| node_metrics
node_settings -.->|"reads settings"| node_telemetry

click node_scanner "https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/backend/local-scanner.mjs"
click node_discovery "https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/backend/ls-discovery.mjs"
click node_rpc "https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/backend/ls-rpc.mjs"
click node_sqlite "https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/backend/cli-sqlite-reader.mjs"
click node_speed "https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/speed-metrics.mjs"
click node_aggregator "https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/backend/usage-aggregator.mjs"
click node_context "https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/backend/context-windows.mjs"
click node_quota "https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/backend/quota-pools.mjs"
click node_pricing "https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/backend/pricing-catalog.mjs"
click node_api "https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/backend/api-actions.mjs"
click node_worker "https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/backend/sidecar-worker.mjs"
click node_main "https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/main.mjs"
click node_bridge "https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/bridge-daemon.mjs"
click node_http "https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/core/httpClient.js"
click node_telemetry "https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/store/telemetryStore.js"
click node_uistore "https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/store/uiStore.js"
click node_app "https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/App.js"
click node_overlay "https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/components/layout/WindowOverlayShell.js"
click node_capsule "https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/components/widgets/CapsuleBarWidget.js"
click node_live "https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/views/LiveOverviewView.js"
click node_consumption "https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/views/ConsumptionView.js"
click node_steps "https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/views/StepsDetailView.js"
click node_settings "https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/views/SettingsView.js"
click node_metrics "https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/registries/metricRegistry.js"
click node_columns "https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/registries/stepColumnRegistry.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_scanner,node_discovery,node_rpc,node_sqlite toneBlue
class node_speed,node_aggregator,node_context,node_quota,node_pricing,node_localdata toneAmber
class node_telemetry,node_uistore,node_app,node_overlay,node_capsule,node_live,node_consumption,node_steps,node_settings,node_metrics,node_columns toneMint
class node_api,node_worker,node_main,node_bridge,node_http toneRose
class node_antigravity toneIndigo
```

## Components

### Local Collection

- [Local Scanner](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/backend/local-scanner.mjs): `sidecars/panel/backend/local-scanner.mjs`
- [Language Discovery](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/backend/ls-discovery.mjs): `sidecars/panel/backend/ls-discovery.mjs`
- [Language RPC](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/backend/ls-rpc.mjs): `sidecars/panel/backend/ls-rpc.mjs`
- [SQLite Reader](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/backend/cli-sqlite-reader.mjs): `sidecars/panel/backend/cli-sqlite-reader.mjs`

### Telemetry Processing

- [Speed Metrics](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/speed-metrics.mjs): `sidecars/panel/speed-metrics.mjs`
- [Usage Aggregator](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/backend/usage-aggregator.mjs): `sidecars/panel/backend/usage-aggregator.mjs`
- [Context Windows](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/backend/context-windows.mjs): `sidecars/panel/backend/context-windows.mjs`
- [Quota Pools](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/backend/quota-pools.mjs): `sidecars/panel/backend/quota-pools.mjs`
- [Pricing Catalog](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/backend/pricing-catalog.mjs): `sidecars/panel/backend/pricing-catalog.mjs`

### Panel Experience

- [Telemetry Store](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/store/telemetryStore.js): `sidecars/panel/src/store/telemetryStore.js`
- [UI State](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/store/uiStore.js): `sidecars/panel/src/store/uiStore.js`
- [Panel App](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/App.js): `sidecars/panel/src/App.js`
- [Window Overlay](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/components/layout/WindowOverlayShell.js): `sidecars/panel/src/components/layout/WindowOverlayShell.js`
- [Capsule Bar](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/components/widgets/CapsuleBarWidget.js): `sidecars/panel/src/components/widgets/CapsuleBarWidget.js`
- [Live Overview](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/views/LiveOverviewView.js): `sidecars/panel/src/views/LiveOverviewView.js`
- [Usage Analytics](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/views/ConsumptionView.js): `sidecars/panel/src/views/ConsumptionView.js`
- [Step Details](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/views/StepsDetailView.js): `sidecars/panel/src/views/StepsDetailView.js`
- [Settings](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/views/SettingsView.js): `sidecars/panel/src/views/SettingsView.js`
- [Metric Registry](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/registries/metricRegistry.js): `sidecars/panel/src/registries/metricRegistry.js`
- [Step Columns](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/registries/stepColumnRegistry.js): `sidecars/panel/src/registries/stepColumnRegistry.js`

### Runtime Bridge

- [API Actions](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/backend/api-actions.mjs): `sidecars/panel/backend/api-actions.mjs`
- [Sidecar Worker](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/backend/sidecar-worker.mjs): `sidecars/panel/backend/sidecar-worker.mjs`
- [Panel Main](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/main.mjs): `sidecars/panel/main.mjs`
- [Window Bridge](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/bridge-daemon.mjs): `sidecars/panel/bridge-daemon.mjs`
- [HTTP Client](https://github.com/lavich99/antigravity-usage-monitor-th/blob/main/sidecars/panel/src/core/httpClient.js): `sidecars/panel/src/core/httpClient.js`

### Other components

- **Antigravity Desktop**
- **Local App Data**

## Connections

- Antigravity Desktop → Local App Data: writes activity (evidence: `README.md`)
- Local App Data → Local Scanner: scans locally
- Local Scanner → SQLite Reader: reads records
- Local Scanner → Language Discovery: discovers services
- Language Discovery → Language RPC: resolves RPC
- Usage Aggregator → Speed Metrics: derives speed
- Usage Aggregator → Context Windows: derives context
- Usage Aggregator → Quota Pools: summarizes quotas
- Usage Aggregator → Pricing Catalog: estimates cost (evidence: `README.md`)
- API Actions → Usage Aggregator: requests summaries
- Panel Main → API Actions: imports actions (evidence: `sidecars/panel/main.mjs`)
- Sidecar Worker → API Actions: imports actions (evidence: `sidecars/panel/backend/sidecar-worker.mjs`)
- HTTP Client → API Actions: requests API
- HTTP Client → Window Bridge: uses bridge transport (evidence: `sidecars/panel/src/core/httpClient.js`)
- Telemetry Store → HTTP Client: calls API client (evidence: `sidecars/panel/src/store/telemetryStore.js`)
- Panel Main → Panel App: starts panel
- Panel Main → Window Overlay: loads overlay
- Panel App → Live Overview: creates view (evidence: `sidecars/panel/src/App.js`)
- Panel App → Usage Analytics: creates view (evidence: `sidecars/panel/src/App.js`)
- Panel App → Step Details: creates view (evidence: `sidecars/panel/src/App.js`)
- Panel App → Settings: creates view (evidence: `sidecars/panel/src/App.js`)
- Panel App → Telemetry Store: resolves conversation (evidence: `sidecars/panel/src/App.js`)
- Panel App → UI State: reads navigation (evidence: `sidecars/panel/src/App.js`)
- Window Overlay → Capsule Bar: renders widget (evidence: `sidecars/panel/src/components/layout/WindowOverlayShell.js`)
- Live Overview → Telemetry Store: reads telemetry
- Usage Analytics → Telemetry Store: reads telemetry (evidence: `sidecars/panel/src/views/ConsumptionView.js`)
- Step Details → Telemetry Store: reads telemetry (evidence: `sidecars/panel/src/views/StepsDetailView.js`)
- Step Details → Step Columns: uses columns (evidence: `sidecars/panel/src/views/StepsDetailView.js`)
- Usage Analytics → Metric Registry: uses metrics
- Settings → Telemetry Store: reads settings
