Real-time visibility into Claude Code sessions — context usage, savings score, and suggested actions.
Works in VS Code, Cursor, Antigravity, and other VS Code-compatible IDEs via .vsix install.
Features
v0.5
- Notifications (critical context, weekly budget, low savings)
- Session history (running / idle / stopped)
- Export report to
.md/.txt - Configure thresholds via Quick Pick
- Better weekly usage (
tokens/cost/hybrid) - Improved idle detection and plugin attribution
v0
- Status bar:
🟢 Claude 41% | 82k | 4 SA - Dashboard (native text, no webview / no React)
- Savings Score (0–100) with reasons
- Suggested actions
- Offline, read-only, no Anthropic API
Install
Marketplace / Open VSX (recommended — auto-update)
- VS Code / Cursor: search Claude Session Monitor-GS in Extensions, or install
gustavimsantana.claude-usage-insights - Antigravity: install from Open VSX (same extension id)
First publish checklist: see
docs/PUBLISHING.md.
Manual .vsix
- Download the latest
.vsixfrom Releases or build locally. - In the IDE: Extensions → ⋯ → Install from VSIX…
- Reload the window.
Build locally
npm install
npm run build:vsix
Commands
| Command | Description |
|---|---|
Claude Monitor: Open Dashboard |
Open the session summary |
Claude Monitor: Show Session History |
List recent sessions |
Claude Monitor: Export Report |
Save a Markdown/text report |
Claude Monitor: Configure Thresholds |
Quick Pick for settings |
Claude Monitor: Refresh |
Force refresh |
Claude Monitor: Copy Report |
Copy a short report |
Settings
| Setting | Default |
|---|---|
claudeMonitor.refreshIntervalSec |
5 |
claudeMonitor.compactThreshold |
100000 |
claudeMonitor.criticalContext |
150000 |
claudeMonitor.maxContext |
200000 |
claudeMonitor.warningSessions |
4 |
claudeMonitor.warningSubagents |
4 |
claudeMonitor.idleTimeoutMin |
30 |
claudeMonitor.weeklyTokenBudget |
40000000 |
claudeMonitor.weeklyBudgetUsd |
200 |
claudeMonitor.weeklyUsageMode |
tokens |
claudeMonitor.notificationsEnabled |
true |
claudeMonitor.lowSavingsThreshold |
50 |
claudeMonitor.claudeHome |
~/.claude |
Data sources
Read-only local files under ~/.claude:
sessions/*.json— active sessions + idle statusprojects/<encoded-path>/<sessionId>.jsonl— transcript / contextprojects/.../<sessionId>/subagents/— subagent countmetrics/costs.jsonl— cost + token snapshotssettings.json— enabled plugins
License
MIT