Claude Watch

claude-watch

[!TIP] **TRY [AGENT-WATCH](https://github.com/tarikguney/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:


How it works

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.

Prerequisites

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 golang

Installation

go install github.com/tarikguney/agent-watch@latest

Usage

# 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

Keyboard shortcuts

Key	Action
↑ / ↓ (or k / j)