Tip
TRY AGENT-WATCH - AN IMPROVED, NEWER VERSION OF CLAUDE-WATCH.
agent-watch is the successor to claude-watch and supports both Copilot and Claude in one dashboard.
What you get with agent-watch:
- New features and active development
- Better state tracking
- A much better UX
- Improved PS Max / psmux integration
This repository is no longer under maintenance, and all new development is happening in agent-watch.
A zero-setup CLI dashboard for monitoring Claude Code agents in real time.
Run claude-watch and instantly see what all your running Claude Code sessions are doing -- which project, current action, status, and how long they've been running. Designed to live in a tmux/psmux pane as your agent task manager.
Expand any row to preview the last prompt and Claude's latest response without leaving the dashboard:
claude-watch discovers running Claude processes from the OS process list, matches each to its most recent session transcript in ~/.claude/projects/, and renders a continuously-updating dashboard.
No hooks to configure, no agents to register, no setup. It discovers running Claude processes and reads what's already on disk.
Install Go 1.21 or later:
# macOS
brew install go
# Windows
winget install GoLang.Go
# Linux (Debian/Ubuntu)
sudo apt install golang-go
# Linux (Fedora)
sudo dnf install golanggo install github.com/tarikguney/agent-watch@latest# Just run it
claude-watch
# Custom refresh interval
claude-watch --refresh 1s
# Custom Claude directory
claude-watch --claude-dir /path/to/.claude
# Compact mode for narrow tmux panes
claude-watch --compact| Key | Action |
|---|---|
↑ / ↓ (or k / j) |
Move the cursor between sessions |
Enter / Space |
Toggle expansion for the selected session (show last prompt + response) |
e |
Expand all rows |
c |
Collapse all rows |
g |
Go to the session's tmux/psmux window (jumps the active client) |
q / Ctrl+C |
Quit |
- PID — the OS process ID of the running
claudeprocess. A>marker highlights the cursor. - TMUX SESSION/WINDOW — the
session/windowname when the session is running inside tmux, psmux, or pmux. Hidden automatically when no session is in a multiplexer. - PROJECT — the project name derived from the session's working directory.
- STATUS — what Claude is doing right now (see below).
- CURRENT ACTION — the active tool call or a human-readable description of the current phase.
- DURATION — elapsed time since the session started.
When a row is expanded, two extra lines appear beneath it:
» prompt:— the most recent user prompt (or the original task if no new prompt has been sent).» response:— the latest response text from Claude.
| Status | Meaning |
|---|---|
| Thinking | Claude is in an extended-thinking block |
| Tool Use | A tool call is in flight (the tool name shows in Current Action) |
| Streaming | Claude is streaming a response token by token |
| Responding | Claude is actively producing a reply (generic working state) |
| Waiting | Process is up but the session has not received its first prompt yet |
| Idle | Process is running and Claude is waiting for user input |
| Interrupted | The last turn was cancelled by the user |
| Done | Session completed normally |
| Error | The last tool call returned an error |
claude-watch detects tmux, psmux, and pmux automatically (set CLAUDE_WATCH_TMUX_BIN to override). When a Claude process lives inside a multiplexer pane, the dashboard shows its session/window name and lets you jump straight to it with g. If programmatic switching fails (e.g. you're attached from a different client), the status bar prints the manual Ctrl+B, s navigation hint for that session.
Works on Windows, macOS, and Linux. Process discovery uses:
- Windows: PowerShell (
Get-CimInstance Win32_Process) - macOS/Linux:
pswith command-line flag parsing
MIT