Conductor
Real-time VS Code dashboard for monitoring Claude Code AI agent activity, tool usage, and token consumption.
Features
- Live Session Monitoring — See all active Claude Code sessions with real-time status updates (active, idle, waiting for input)
- Sub-Agent Tracking — Hierarchical view of parent sessions and their spawned sub-agents
- Tool Usage Analytics — Track which tools are being called, how often, error rates, and average duration
- Token Consumption — Per-session and per-model token counts with USD cost estimates
- Activity Feed — Scrolling feed of tool calls, text outputs, and user inputs across all sessions
- Incremental Parsing — Efficient JSONL parsing that reads only new data, not entire files
- Hybrid File Watching — VS Code FileSystemWatcher + 1-second polling fallback for reliability across platforms
Requirements
- VS Code 1.85.0 or later
- Claude Code CLI installed and active (sessions must exist in
~/.claude/projects/)
- Node.js 20.0.0 or later (for development)
Getting Started
- Install the extension from the VS Code Marketplace (or build from source)
- Open the Command Palette (
Cmd+Shift+P / Ctrl+Shift+P)
- Run "Conductor: Open"
- Start a Claude Code session — the dashboard updates automatically
You can also click the $(pulse) Conductor status bar item to open the dashboard.
Commands
| Command |
Description |
Conductor: Open |
Open the monitoring dashboard |
Conductor: Refresh |
Force refresh all session data |
Token Pricing
Cost estimates use the following rates (per million tokens):
| Model |
Input |
Output |
Cache Read |
Cache Creation |
| Claude Opus 4.6 |
$15.00 |
$75.00 |
$1.50 |
$18.75 |
| Claude Sonnet 4.6 |
$3.00 |
$15.00 |
$0.30 |
$3.75 |
| Claude Haiku 4.5 |
$0.80 |
$4.00 |
$0.08 |
$1.00 |
Pricing is hardcoded and may not reflect current Anthropic rates. See src/analytics/TokenCounter.ts for details.
Architecture
The extension reads JSONL transcript files from ~/.claude/projects/ and processes them through a pipeline:
JSONL Files → ProjectScanner → TranscriptWatcher → JsonlParser → SessionTracker → Dashboard UI
- Extension backend (Node.js): Watches files, parses records, tracks session state
- Webview frontend (React + Zustand): Renders the dashboard UI via IPC messages
For detailed architecture documentation, see docs/architecture.md.
Development
# Install all dependencies
npm install && cd webview-ui && npm install
# Build everything
npm run build
# Watch mode (extension)
npm run watch
# Webview dev server (separate terminal)
cd webview-ui && npm run dev
# Run tests
npm test
# Type checking
npm run lint
# Generate API docs
npm run docs
Press F5 in VS Code to launch the Extension Development Host for debugging.
Contributing
See CONTRIBUTING.md for development setup, coding standards, and PR guidelines.
Known Limitations
- Terminal capture requires macOS or Windows — Full terminal capture uses native
node-pty bindings, which have prebuilds for macOS (ARM64/x64) and Windows (x64/ARM64). Linux users can still use the extension, but terminal capture falls back to VS Code's built-in terminal API.
- Token pricing is hardcoded — must update source code when Anthropic changes rates
- Tool input summaries only cover 9 built-in tools — custom tools show empty summaries
- No webview dev stub — running
npm run dev in webview-ui/ crashes outside VS Code
- Session focus state can drift between extension and webview stores
License
MIT
