Monitor and control all your Claude Code sessions from one place.
c9watch (short for claude code watch, like k8s for Kubernetes) is a macOS desktop app that gives you a real-time dashboard of every Claude Code session running on your machine. No more switching between terminals to check which agent needs permission, which one is working, and which one is idle.
Unlike other Claude Code management tools that require you to launch sessions from within their app, c9watch doesn't care where you start your sessions. It discovers them automatically by scanning running processes at the OS level.
Start Claude Code from any terminal or IDE you already use -- VS Code, Zed, iTerm2, Antigravity, you name it -- and c9watch picks them all up. No plugins to install. No workflows to change. No vendor lock-in.
Just open c9watch and see everything.
Built with Tauri, Rust, and Svelte -- not Electron. The app binary is small, memory usage is minimal, and the UI stays snappy. Rust handles process scanning and file parsing at native speed. Svelte compiles away the framework overhead. You're already running multiple Claude Code agents eating up resources -- your monitoring tool shouldn't add to the pile.
curl -fsSL https://raw.githubusercontent.com/minchenlee/c9watch/main/install.sh | bashGrab the latest .dmg from the Releases page.
Prerequisites: Rust, Node.js (v18+), and the Tauri CLI.
git clone https://github.com/minchenlee/c9watch.git
cd c9watch
npm install
npm run tauri buildThe built .app will be in src-tauri/target/release/bundle/macos/.
Sessions grouped by status. Permission requests surface to the top so you never leave an agent stuck waiting.
Search all past sessions with instant metadata filter and deep content search. Click a result to view the full conversation.
Daily, per-project, and per-model spending breakdowns across all your Claude Code sessions.
Expand any session to see the full conversation with formatted markdown, code blocks, inline images, and a navigation sidebar.
A quick-glance overlay showing all active sessions and their status directly from the menu bar.
View and inspect all Claude Code memory files in a two-panel layout with quick access to Claude commands.
See your total token usage as a rice stack towering past real-world landmarks. Share the result as an Instagram-ready PNG.
- Zero-integration setup -- Works with any terminal or IDE, no plugins or extensions required
- Auto-discovery -- Detects all running Claude Code sessions by scanning processes at the OS level
- Real-time status -- See at a glance which sessions are Working, Need Permission, or Idle
- Conversation viewer -- Expand any session to view the full conversation with formatted markdown, code blocks, and inline images
- Session control -- Stop sessions, open their parent terminal/IDE, or rename them for easier tracking
- Multi-project view -- Sessions grouped by project with git branch info
- Tray popover -- Click the menu bar icon for a quick-glance overlay with session status indicators and latest messages
- Status notifications -- Get a native macOS notification when a session needs your attention
- Mobile/Web client -- Connect from any browser or mobile device via WebSocket; scan the QR code to monitor sessions remotely
- Session history -- Browse and search all past sessions with instant metadata filter and deep content search; click a result to scroll to and highlight the matching message
- Memory viewer -- Browse and inspect Claude Code memory files with a two-panel layout and quick Claude command access
- Cost tracker -- Track Claude Code spending with daily, per-project, and per-model breakdowns using cached JSONL scanning
- Token distance visualizer -- See your token usage as a rice stack towering past 17 real-world landmarks, with animated stacking, native share sheet, and Instagram-ready PNG export
- Debug console -- Hidden diagnostic panel (
Cmd+Shift+D) for troubleshooting session detection issues
Live monitoring -- A background thread polls every 2 seconds, scanning for running claude processes using sysinfo. Each process is matched to its session file in ~/.claude/projects/ via path encoding and timestamp correlation. The last N entries of each session's JSONL file are parsed to determine status:
- Working -- Claude is generating a response or executing tools
- Needs Permission -- A tool is pending that requires user approval
- Idle -- Session is waiting for your next prompt
Status updates are pushed to the Svelte frontend via Tauri events. The UI reactively updates, sorting sessions by priority (permission requests surface first).
Session history -- Reads ~/.claude/history.jsonl for the session index, then scans individual JSONL files across all project directories for deep content search. Results link back to the full conversation viewer with scroll-to-match highlighting.
Cost tracking -- Parses assistant message metadata from JSONL files to extract model usage and token counts. Costs are computed using per-model pricing tables and cached by file mtime to avoid re-scanning unchanged sessions.
| Layer | Technology |
|---|---|
| Desktop framework | Tauri 2 |
| Frontend | SvelteKit + Svelte 5 |
| Backend | Rust |
| Process discovery | sysinfo |
| Design system | Vercel Noir (true black, Geist fonts) |
npm install
npm run tauri devThis starts both the Vite dev server (hot-reload for the frontend) and the Tauri Rust backend.
c9watch/
├── src/ # SvelteKit frontend
│ ├── routes/
│ │ ├── (app)/ # Main dashboard (monitor, history, cost tabs)
│ │ └── popover/ # Tray popover window
│ ├── lib/
│ │ ├── components/ # Svelte components
│ │ │ ├── SessionCard # Live session cards with status
│ │ │ ├── SessionHistory # History browser with search
│ │ │ ├── CostTracker # Spending dashboard
│ │ │ ├── MessageBubble # Conversation message rendering
│ │ │ └── ... # Overlays, nav map, status bar, etc.
│ │ ├── stores/ # Reactive state management
│ │ ├── demo/ # Demo mode with mock data
│ │ ├── api.ts # Tauri command wrappers
│ │ └── types.ts # TypeScript type definitions
│ └── app.css # Global styles (Vercel Noir theme)
├── src-tauri/ # Rust backend (Tauri)
│ └── src/
│ ├── lib.rs # App setup, tray icon, NSPanel popover
│ ├── polling.rs # Background session detection loop
│ ├── actions.rs # Stop/open session, IDE detection
│ ├── web_server.rs # WebSocket server for mobile clients
│ ├── auth.rs # Token generation, local IP discovery
│ └── session/
│ ├── parser.rs # JSONL file parsing and message extraction
│ ├── detector.rs # Process-to-session matching
│ ├── status.rs # Status determination from JSONL entries
│ ├── history.rs # Session history index and deep search
│ ├── cost.rs # Cost aggregation with mtime caching
│ ├── permissions.rs # Auto-approval rule checking
│ └── custom_names.rs # User-defined session titles
Press Cmd+D to toggle demo mode, which loads simulated sessions with animated status transitions. Useful for testing the UI without running real Claude Code sessions.
Contributions are welcome! Please read CONTRIBUTING.md for guidelines on:
- Setting up the development environment
- Coding standards and commit message format
- Pull request process
- Platform-specific contributions (Windows, Linux)
Thanks to these wonderful people who have contributed to c9watch:
 Min-Chen Lee 💻 📖 🎨 |
 Ray Lee 💻 📦 |
 Grimmer Kang 💻 |
 Stanimir 💻 |
 josh.dev 💻 |
See CONTRIBUTORS.md for the full list and contribution details.
MIT