How long-910/vscode-claude-status works
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: dataManager.ts Usage data manager · extension.ts Extension activation · jsonlReader.ts JSONL usage reader · usageIndex.ts Incremental usage index
Components 21
Extension runtime
- Extension activation
src/extension.ts - Usage data manager
src/data/dataManager.ts
Usage collection
- Claude home resolver
src/data/claudeHome.ts - JSONL usage reader
src/data/jsonlReader.ts - Incremental usage index
src/data/usageIndex.ts - Rate-limit cache
src/data/cache.ts
Cost and analysis
- Model pricing
src/data/pricing.ts - Project cost tracking
src/data/projectCost.ts - Usage prediction
src/data/prediction.ts - Budget calculations
src/data/budget.ts - Usage history analysis
src/webview/heatmap.ts
VS Code surfaces
- Status bar
src/statusBar.ts - Sidebar tree view
src/treeView.ts - Dashboard panel
src/webview/panel.ts - Usage export
src/data/exportUsage.ts
Settings and integrations
- Extension settings
src/config.ts - Rate-limit API client
src/data/apiClient.ts - Account detection
src/data/accountInfo.ts
Other components
- VS Code user
- Claude session files
- Anthropic API
Connections 30
- VS Code user → Extension activation: activates
src/extension.ts - Extension activation → Extension settings: reads settings
src/extension.ts - Extension activation → Usage data manager: initializes
src/extension.ts - Extension activation → Status bar: creates
src/extension.ts - Extension activation → Sidebar tree view: registers
src/extension.ts - Extension activation → Dashboard panel: opens
src/extension.ts - Extension activation → Usage export: exports via
src/extension.ts - Extension activation → Budget calculations: checks alerts
src/extension.ts - Usage data manager → JSONL usage reader: reads usage
src/data/dataManager.ts - Usage data manager → Rate-limit API client: requests limits
src/data/dataManager.ts - Usage data manager → Rate-limit cache: reads cache
src/data/dataManager.ts - Usage data manager → Project cost tracking: gets costs
src/data/dataManager.ts - Usage data manager → Usage prediction: computes
src/data/dataManager.ts - Usage data manager → Usage history analysis: gets history
src/data/dataManager.ts - JSONL usage reader → Claude home resolver: resolves directory
src/data/jsonlReader.ts - JSONL usage reader → Claude session files: reads files
src/data/jsonlReader.ts - JSONL usage reader → Incremental usage index: loads records
src/data/jsonlReader.ts - JSONL usage reader → Model pricing: prices tokens
src/data/jsonlReader.ts - Rate-limit API client → Account detection: detects account
src/data/apiClient.ts - Rate-limit API client → Anthropic API: fetches utilization
src/data/apiClient.ts - Usage data manager → Extension settings: uses settings
src/data/dataManager.ts - Status bar → Usage data manager: displays usage
src/statusBar.ts - Sidebar tree view → Usage data manager: displays usage
src/treeView.ts - Dashboard panel → Usage data manager: requests dashboard data
src/webview/panel.ts - Usage history analysis → JSONL usage reader: reads transcripts
src/webview/heatmap.ts - Usage history analysis → Incremental usage index: deduplicates records
src/webview/heatmap.ts - Usage prediction → Incremental usage index: analyzes records
src/data/prediction.ts - Project cost tracking → Incremental usage index: analyzes records
src/data/projectCost.ts - Budget calculations → Extension settings: uses budget settings
src/config.ts - Dashboard panel → Budget calculations: shows budget costs
src/webview/panel.ts