Claude Session Monitor-GS

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

1. Download the latest .vsix from Releases or build locally.
2. In the IDE: Extensions → ⋯ → Install from VSIX…
3. Reload the window.

Build locally

npm install
npm run build:vsix

Commands

Settings

Data sources

Read-only local files under ~/.claude:

1. sessions/*.json — active sessions + idle status
2. projects/<encoded-path>/<sessionId>.jsonl — transcript / context
3. projects/.../<sessionId>/subagents/ — subagent count
4. metrics/costs.jsonl — cost + token snapshots
5. settings.json — enabled plugins

License

MIT