# long-910/vscode-claude-status architecture

> Architecture diagram of the GitHub repository long-910/vscode-claude-status, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/long-910/vscode-claude-status
- Repository: https://github.com/long-910/vscode-claude-status

## Overview

vscode-claude-status is a VS Code extension for monitoring Claude Code token use, estimated cost, rate limits, and budgets. On activation, it reads local Claude session transcripts, optionally fetches rate-limit utilization, and presents results in the status bar, sidebar, and dashboard. The dashboard also covers project costs, predictions, and usage-history charts; usage can be exported. The graph captures documented capabilities and source-index relationships; unsampled implementation details are not asserted.

Main entry points: [`src/data/dataManager.ts`](https://github.com/long-910/vscode-claude-status/blob/main/src/data/dataManager.ts) (Usage data manager), [`src/extension.ts`](https://github.com/long-910/vscode-claude-status/blob/main/src/extension.ts) (Extension activation), [`src/data/jsonlReader.ts`](https://github.com/long-910/vscode-claude-status/blob/main/src/data/jsonlReader.ts) (JSONL usage reader), [`src/data/usageIndex.ts`](https://github.com/long-910/vscode-claude-status/blob/main/src/data/usageIndex.ts) (Incremental usage index)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Extension runtime"]
  node_extension["Extension activation<br/>[extension.ts]"]
  node_manager["Usage data manager<br/>[dataManager.ts]"]
end

subgraph group_collection["Usage collection"]
  node_home["Claude home resolver<br/>[claudeHome.ts]"]
  node_reader["JSONL usage reader<br/>[jsonlReader.ts]"]
  node_index["Incremental usage index<br/>[usageIndex.ts]"]
  node_cache[("Rate-limit cache<br/>[cache.ts]")]
end

subgraph group_analytics["Cost and analysis"]
  node_pricing["Model pricing<br/>[pricing.ts]"]
  node_project["Project cost tracking<br/>[projectCost.ts]"]
  node_prediction["Usage prediction<br/>[prediction.ts]"]
  node_budget["Budget calculations<br/>[budget.ts]"]
  node_heatmap["Usage history analysis<br/>[heatmap.ts]"]
end

subgraph group_surfaces["VS Code surfaces"]
  node_status["Status bar<br/>[statusBar.ts]"]
  node_tree["Sidebar tree view<br/>[treeView.ts]"]
  node_panel["Dashboard panel<br/>[panel.ts]"]
  node_export["Usage export<br/>[exportUsage.ts]"]
end

subgraph group_settings["Settings and integrations"]
  node_config["Extension settings<br/>[config.ts]"]
  node_api["Rate-limit API client<br/>[apiClient.ts]"]
  node_account["Account detection<br/>[accountInfo.ts]"]
end

node_user(("VS Code user"))
node_transcripts[("Claude session files")]
node_anthropic{{"Anthropic API"}}

node_user -->|"activates"| node_extension
node_extension -->|"reads settings"| node_config
node_extension -->|"initializes"| node_manager
node_extension -->|"creates"| node_status
node_extension -->|"registers"| node_tree
node_extension -->|"opens"| node_panel
node_extension -->|"exports via"| node_export
node_extension -->|"checks alerts"| node_budget
node_manager -->|"reads usage"| node_reader
node_manager -->|"requests limits"| node_api
node_manager -->|"reads cache"| node_cache
node_manager -->|"gets costs"| node_project
node_manager -->|"computes"| node_prediction
node_manager -->|"gets history"| node_heatmap
node_reader -->|"resolves directory"| node_home
node_reader -->|"reads files"| node_transcripts
node_reader -->|"loads records"| node_index
node_reader -->|"prices tokens"| node_pricing
node_api -->|"detects account"| node_account
node_api -->|"fetches utilization"| node_anthropic
node_manager -->|"uses settings"| node_config
node_status -->|"displays usage"| node_manager
node_tree -->|"displays usage"| node_manager
node_panel -->|"requests dashboard data"| node_manager
node_heatmap -->|"reads transcripts"| node_reader
node_heatmap -->|"deduplicates records"| node_index
node_prediction -->|"analyzes records"| node_index
node_project -->|"analyzes records"| node_index
node_budget -->|"uses budget settings"| node_config
node_panel -->|"shows budget costs"| node_budget

click node_extension "https://github.com/long-910/vscode-claude-status/blob/main/src/extension.ts"
click node_config "https://github.com/long-910/vscode-claude-status/blob/main/src/config.ts"
click node_manager "https://github.com/long-910/vscode-claude-status/blob/main/src/data/dataManager.ts"
click node_home "https://github.com/long-910/vscode-claude-status/blob/main/src/data/claudeHome.ts"
click node_reader "https://github.com/long-910/vscode-claude-status/blob/main/src/data/jsonlReader.ts"
click node_index "https://github.com/long-910/vscode-claude-status/blob/main/src/data/usageIndex.ts"
click node_pricing "https://github.com/long-910/vscode-claude-status/blob/main/src/data/pricing.ts"
click node_api "https://github.com/long-910/vscode-claude-status/blob/main/src/data/apiClient.ts"
click node_account "https://github.com/long-910/vscode-claude-status/blob/main/src/data/accountInfo.ts"
click node_cache "https://github.com/long-910/vscode-claude-status/blob/main/src/data/cache.ts"
click node_project "https://github.com/long-910/vscode-claude-status/blob/main/src/data/projectCost.ts"
click node_prediction "https://github.com/long-910/vscode-claude-status/blob/main/src/data/prediction.ts"
click node_budget "https://github.com/long-910/vscode-claude-status/blob/main/src/data/budget.ts"
click node_heatmap "https://github.com/long-910/vscode-claude-status/blob/main/src/webview/heatmap.ts"
click node_status "https://github.com/long-910/vscode-claude-status/blob/main/src/statusBar.ts"
click node_tree "https://github.com/long-910/vscode-claude-status/blob/main/src/treeView.ts"
click node_panel "https://github.com/long-910/vscode-claude-status/blob/main/src/webview/panel.ts"
click node_export "https://github.com/long-910/vscode-claude-status/blob/main/src/data/exportUsage.ts"

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_extension,node_manager,node_user toneBlue
class node_home,node_reader,node_index,node_cache,node_transcripts toneAmber
class node_pricing,node_project,node_prediction,node_budget,node_heatmap,node_anthropic toneMint
class node_status,node_tree,node_panel,node_export toneRose
class node_config,node_api,node_account toneIndigo
```

## Components

### Extension runtime

- [Extension activation](https://github.com/long-910/vscode-claude-status/blob/main/src/extension.ts): `src/extension.ts`
- [Usage data manager](https://github.com/long-910/vscode-claude-status/blob/main/src/data/dataManager.ts): `src/data/dataManager.ts`

### Usage collection

- [Claude home resolver](https://github.com/long-910/vscode-claude-status/blob/main/src/data/claudeHome.ts): `src/data/claudeHome.ts`
- [JSONL usage reader](https://github.com/long-910/vscode-claude-status/blob/main/src/data/jsonlReader.ts): `src/data/jsonlReader.ts`
- [Incremental usage index](https://github.com/long-910/vscode-claude-status/blob/main/src/data/usageIndex.ts): `src/data/usageIndex.ts`
- [Rate-limit cache](https://github.com/long-910/vscode-claude-status/blob/main/src/data/cache.ts): `src/data/cache.ts`

### Cost and analysis

- [Model pricing](https://github.com/long-910/vscode-claude-status/blob/main/src/data/pricing.ts): `src/data/pricing.ts`
- [Project cost tracking](https://github.com/long-910/vscode-claude-status/blob/main/src/data/projectCost.ts): `src/data/projectCost.ts`
- [Usage prediction](https://github.com/long-910/vscode-claude-status/blob/main/src/data/prediction.ts): `src/data/prediction.ts`
- [Budget calculations](https://github.com/long-910/vscode-claude-status/blob/main/src/data/budget.ts): `src/data/budget.ts`
- [Usage history analysis](https://github.com/long-910/vscode-claude-status/blob/main/src/webview/heatmap.ts): `src/webview/heatmap.ts`

### VS Code surfaces

- [Status bar](https://github.com/long-910/vscode-claude-status/blob/main/src/statusBar.ts): `src/statusBar.ts`
- [Sidebar tree view](https://github.com/long-910/vscode-claude-status/blob/main/src/treeView.ts): `src/treeView.ts`
- [Dashboard panel](https://github.com/long-910/vscode-claude-status/blob/main/src/webview/panel.ts): `src/webview/panel.ts`
- [Usage export](https://github.com/long-910/vscode-claude-status/blob/main/src/data/exportUsage.ts): `src/data/exportUsage.ts`

### Settings and integrations

- [Extension settings](https://github.com/long-910/vscode-claude-status/blob/main/src/config.ts): `src/config.ts`
- [Rate-limit API client](https://github.com/long-910/vscode-claude-status/blob/main/src/data/apiClient.ts): `src/data/apiClient.ts`
- [Account detection](https://github.com/long-910/vscode-claude-status/blob/main/src/data/accountInfo.ts): `src/data/accountInfo.ts`

### Other components

- **VS Code user**
- **Claude session files**
- **Anthropic API**

## Connections

- VS Code user → Extension activation: activates (evidence: `src/extension.ts`)
- Extension activation → Extension settings: reads settings (evidence: `src/extension.ts`)
- Extension activation → Usage data manager: initializes (evidence: `src/extension.ts`)
- Extension activation → Status bar: creates (evidence: `src/extension.ts`)
- Extension activation → Sidebar tree view: registers (evidence: `src/extension.ts`)
- Extension activation → Dashboard panel: opens (evidence: `src/extension.ts`)
- Extension activation → Usage export: exports via (evidence: `src/extension.ts`)
- Extension activation → Budget calculations: checks alerts (evidence: `src/extension.ts`)
- Usage data manager → JSONL usage reader: reads usage (evidence: `src/data/dataManager.ts`)
- Usage data manager → Rate-limit API client: requests limits (evidence: `src/data/dataManager.ts`)
- Usage data manager → Rate-limit cache: reads cache (evidence: `src/data/dataManager.ts`)
- Usage data manager → Project cost tracking: gets costs (evidence: `src/data/dataManager.ts`)
- Usage data manager → Usage prediction: computes (evidence: `src/data/dataManager.ts`)
- Usage data manager → Usage history analysis: gets history (evidence: `src/data/dataManager.ts`)
- JSONL usage reader → Claude home resolver: resolves directory (evidence: `src/data/jsonlReader.ts`)
- JSONL usage reader → Claude session files: reads files (evidence: `src/data/jsonlReader.ts`)
- JSONL usage reader → Incremental usage index: loads records (evidence: `src/data/jsonlReader.ts`)
- JSONL usage reader → Model pricing: prices tokens (evidence: `src/data/jsonlReader.ts`)
- Rate-limit API client → Account detection: detects account (evidence: `src/data/apiClient.ts`)
- Rate-limit API client → Anthropic API: fetches utilization (evidence: `src/data/apiClient.ts`)
- Usage data manager → Extension settings: uses settings (evidence: `src/data/dataManager.ts`)
- Status bar → Usage data manager: displays usage (evidence: `src/statusBar.ts`)
- Sidebar tree view → Usage data manager: displays usage (evidence: `src/treeView.ts`)
- Dashboard panel → Usage data manager: requests dashboard data (evidence: `src/webview/panel.ts`)
- Usage history analysis → JSONL usage reader: reads transcripts (evidence: `src/webview/heatmap.ts`)
- Usage history analysis → Incremental usage index: deduplicates records (evidence: `src/webview/heatmap.ts`)
- Usage prediction → Incremental usage index: analyzes records (evidence: `src/data/prediction.ts`)
- Project cost tracking → Incremental usage index: analyzes records (evidence: `src/data/projectCost.ts`)
- Budget calculations → Extension settings: uses budget settings (evidence: `src/config.ts`)
- Dashboard panel → Budget calculations: shows budget costs (evidence: `src/webview/panel.ts`)
