Open the Claude Sessions panel in the activity bar (left sidebar)
Click Auto-Detect from Claude History to find your projects, or add them manually
Optionally run Claude Sessions: Install Status Hooks from the command palette for instant status updates
How It Works
The extension reads session files from ~/.claude/sessions/ to discover Claude Code CLI sessions, then uses ps to check process status and CPU usage. Sessions are matched to projects by comparing working directories.
Status
Meaning
Green dot
Claude is actively working (high CPU)
Yellow dot
Claude is waiting for input
Gray dot
No active session
Window switching on macOS uses AppleScript to capture the current window position before opening a new project, then repositions the new window to the same coordinates.
Configuration
Setting
Default
Description
claudeSessions.pollingInterval
3000
How often to check session status (ms)
claudeSessions.cpuThreshold
5
CPU% threshold for active vs waiting
claudeSessions.showStatusBar
true
Show session count in status bar
Requirements
macOS (window positioning and process detection use AppleScript and ps)
