ccdock
One sidebar. Every agent, every window.
Stop Alt-Tabbing. Start orchestrating.
Problem
- Running multiple Claude Code agents across git worktrees is powerful — but managing the VS Code windows that go with them is a nightmare.
- You end up Alt-Tabbing through a dozen windows, losing track of which agent is doing what, and manually arranging editors every time you switch context.
- Existing hub tools either force you into a CLI-only workflow or require a proprietary editor.
Solution
ccdock sits in a narrow terminal sidebar and takes care of the rest: auto-positioning VS Code windows, tracking every Claude Code agent in real time, and letting you switch between sessions with a single click.
How It Works
Step 1
Install ccdock via bun and configure your workspace directories
Step 2
Add Claude Code hooks to enable real-time agent monitoring
Step 3
Run `ccdock` to open the sidebar TUI
Step 4
Create sessions, open editors, and watch agents — all from one place
Key Features
VS Code Orchestration
Auto-open, position, and switch VS Code (or Cursor) windows next to the sidebar. Click a session, and the right editor snaps into focus.
Real-time Agent Monitoring
See exactly what each Claude Code agent is doing: which tool it's calling, what file it's reading, what command it's running.
Git Worktree Management
Create, switch, and delete worktrees via git-wt integration. Each worktree gets its own session.
Activity Log
Live feed of tool invocations with session numbers across all active agents.
Mouse + Keyboard
Click to select sessions, scroll wheel to navigate, or use vim-style j/k keys.
Auto-layout
VS Code windows automatically resize and reposition when the terminal resizes.
Use Cases
Developers running multiple Claude Code agents in parallel across git worktrees.
Teams that need instant context switching between feature branches without losing their editor layout.
Anyone who wants real-time visibility into what their AI agents are doing.
FAQ
How do I install ccdock?
Install via Bun: `bun install -g ccdock`. You'll also need git-wt for worktree creation: `go install github.com/k1LoW/git-wt@latest`.
Which editors are supported?
VS Code and Cursor are supported. Set the `editor` field in `~/.config/ccdock/config.json` to `"code"` or `"cursor"`.
How does agent monitoring work?
Add Claude Code hooks to your `~/.claude/settings.json`. ccdock provides a `ccdock hook claude-code` command that captures hook events and writes agent state files, which the sidebar polls every 2 seconds.
Is it free?
Yes. ccdock is free and open source under the MIT license.
Which operating systems are supported?
macOS only. Window management relies on AppleScript, which is macOS-specific.