git404hub

what is claude-watcher fr?

jeremyinthebay/claude-watcher — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 2/5LicenseSetup · easy

tl;dr

A zero-dependency Mac tool that watches Claude Code and Cowork sessions from outside, showing live status in a dashboard and menu bar icon.

vibe map

mindmap
  root((repo))
    What it does
      Watches sessions from outside
      Checks file activity
      Reads transcript tails
    Tech stack
      Python script
      SwiftBar menu bar
      Zero dependencies
    Use cases
      Spot stalled sessions
      Monitor subagents
      Track token spend
    Audience
      Claude Code users
      Cowork users
    Platform
      macOS only
      Local dashboard

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Check at a glance whether a long-running Claude Code session is stuck or still working.

VIBE 2

Watch multiple agent sessions and their subagents from a single dashboard.

VIBE 3

Get a menu bar signal when a background session needs your attention.

what's the stack?

PythonBashSwiftBar

how it stacks up fr

jeremyinthebay/claude-watcher0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity2/52/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Mac only, the optional menu bar icon needs the free SwiftBar app.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

Claude Watcher is a small tool for Mac users who run Claude Code or Cowork sessions and want to know, at a glance, whether those sessions are actually working or stuck. Instead of asking a session how it is doing, which can be unreliable since a stalled session cannot answer for itself, the tool watches from the outside. Every sixty seconds it checks two things: whether a session's files are still being written, and what the latest line in that session's on disk transcript says. From that it can tell you what each agent, and any of its subagents, is doing right now, who it is, how long it has been running, and how many tokens it has used. The project gives you three ways to see this information. A dashboard, saved as a local HTML file, shows one card per session with filters for working, quiet, idle, or command line sessions, along with an hourly activity chart. A menu bar icon, built with the free SwiftBar app, shows a simple colored dot so you can check status without opening anything. A status.json file exposes the same data in machine readable form for anyone who wants to build their own view. It covers both Cowork desktop agent sessions and Claude Code command line runs. Sessions that run in Anthropic's own cloud sandbox are not visible, since they leave no files on your local disk. Setup requires a Mac and takes two commands: cloning the repository and running the install script, which sets up a background job and prints the dashboard's file path. The menu bar piece is optional and needs SwiftBar installed separately. The tool itself is a short, roughly 250 line Python script with no external dependencies, and it spends no AI tokens because it only reads files that already exist on disk. The project also ships a set of written prompts that can rebuild the same dashboard and menu bar system from scratch inside a Claude session, along with notes on mistakes to avoid while doing so. It is released under the MIT license and is part of a larger set of tools called relay skills by the same author.

prompts (copy fr)

prompt 1
Set up Claude Watcher on my Mac so I can monitor all my Claude Code sessions from one dashboard.
prompt 2
Add the SwiftBar menu bar icon from Claude Watcher so I get a quick status glyph for my agent sessions.
prompt 3
Use the prompts in Claude Watcher's prompts folder to rebuild its dashboard from scratch in a Claude session.
prompt 4
Explain how Claude Watcher tells a working session apart from a stalled one without asking the session itself.

Frequently asked questions

what is claude-watcher fr?

A zero-dependency Mac tool that watches Claude Code and Cowork sessions from outside, showing live status in a dashboard and menu bar icon.

What language is claude-watcher written in?

Mainly Python. The stack also includes Python, Bash, SwiftBar.

What license does claude-watcher use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is claude-watcher to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is claude-watcher for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.