ClaudeWatch

ClaudeWatch
See every Claude Code, Codex and OpenCode agent on your computer: a live dashboard, a menu-bar popover, a macOS widget, and the Office, an isometric city where each agent works at its own desk. Desktop app built with Electron, React, three.js and TypeScript.

Table of Contents

1. Overview
   - Screenshots
   - How It Works
2. Download & Install
3. The Office
4. Prerequisites
5. Quick Start
6. Development Setup
7. Architecture
8. Main Process
9. Platform Detection
10. Configuration & Settings
11. Tray & Popover
12. Notifications
13. Auto-Updates
14. Testing
15. Building for Production
16. Releasing
17. Project Structure
18. Design System
19. Troubleshooting
20. Roadmap
21. Dependencies

Overview

ClaudeWatch finds the coding agents running on your computer and shows what each one is doing. It reads Claude Code, Codex and OpenCode sessions, including subagents and agent-team teammates, and groups them by company and project.

- The Office: a live isometric office and city. Every agent works at its own desk, idle agents play in their floor's game corner, and the city around it reacts to real activity.
- Dashboard: live counts, token usage per account, company, project and agent, rate limits, and a session list with filters and search.
- Menu bar popover: a compact view that opens when you hover over the tray icon.
- macOS widget: small, medium and large WidgetKit widgets with live stats.
- Browser Office: the same live city in your browser, view-only and local to your computer.
- Notifications when a task completes, an agent goes idle or a session ends.
- Jump to the terminal: focus the agent's terminal window, or its exact Orca pane.
- Mac and Windows: Apple silicon and Intel Macs; Windows x64 from 1.4.0.

Screenshots

The Office and city shots use the…