31mahadi

Claude Watcher — Development skill for Claude Code

Development community

Live dashboard of what Claude Code is doing: usage, status, plan, agents and history.

How to install Claude Watcher

This entry records only its repository, not the path inside it, so there is no exact command to give. Open 31mahadi/claude-watcher and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Claude Watcher does

Live dashboard of what Claude Code is doing: usage, status, plan, agents and history.

Alternatives in Development

  • Claude Usage — A local dashboard for tracking your Claude Code token usage, costs, and session history 864 ★
  • Claude Dashboard — Comprehensive status line plugin for Claude Code with context usage, API rate limits, and cost tracking 258 ★
  • Job Watcher — Monitor and manage VASP jobs 155 ★

README

Claude Watcher

A Claude Code mod that shows what Claude is doing in one place: the current turn, the plan, subagents, your other sessions and the session's health. It works in the terminal, the Desktop app and VS Code.

  • Spinner suffix: npm test · 2:14 · ~1:46 left · 3/5 tasks
  • Dashboard pane (/watch) with six tabs: Turn, Plan, Agents, Sessions, Health and Config
  • Attention band above the prompt when Claude needs you, plus an optional toast and desktop notification
  • Visuals: Svg bars, Gantt, sparkline and donut on Desktop and VS Code; Raster bars, swimlanes and a heat strip in the terminal; a text fallback everywhere
  • Time-left estimates learned from your own command history: ~ with 3 or more samples, ? with fewer, up to when only a timeout bounds the call

Claude Watcher only observes. Every hook passes the event on unchanged, and it never blocks or denies anything.

![Watcher pane in VS Code: usage, status, now and history](assets/screenshot.png)

Install

Requires Claude Code 2.1.304 or later.

At the prompt of a terminal session:

/plugin install watcher --marketplace 31mahadi/claude-watcher

From a shell:

claude plugin install watcher --marketplace 31mahadi/claude-watcher

To run it from a checkout:

claude --plugin-dir ./claude-watcher

Updating

Watcher checks GitHub for a new release once a day. When one is out, it shows a toast once with the version and the update commands. The check sends no data and stays quiet when you are offline.

Update by hand

At the prompt of a terminal session:

/plugin marketplace update claude-watcher
/plugin update watcher@claude-watcher

From a shell:

claude plugin marketplace update claude-watcher
claude plugin update watcher@claude-watcher

Restart Claude Code afterwards so the new version loads.

Update automatically

Auto-update is off by default for marketplaces outside Anthropic. To turn it on:

  1. Run /plugin.
  2. Open **Marke