jpars.dev

Claudvisor

A small floating pill for each Claude Code loop and session you have running: what it's working on, how far along it is, and whether it needs you. Double-click one to jump straight to its terminal. No notifications. Glance at it and get back to what you were doing.

Download for Macv0.1.5 · 10 MB · macOS 11+ · Apple Silicon & Intel
Or install with Homebrew:
$brew install jpars-dev/apps/claudvisor
WORKING

A loop's task, step, ETA and unpushed commits, or what a session is doing right now, like “Editing lib.rs”.

NEEDS YOU

A loop reported BLOCKED, went quiet, or is running far longer than usual. Or a session is waiting at a permission prompt.

IDLE

A session has finished its turn and is waiting for your next prompt, with how long it has been.

ENDED

A loop has stopped. Why and when, with a recap: tasks done, commits, failed steps.

CLICK

Opens a chip into the full pill: the task, step, ETA and the run's timeline. Click again to fold it back.

RIGHT-CLICK

Swaps its text for three buttons: refresh it now, go to it, or dismiss it until its next run or turn.

DOUBLE-CLICK

Takes you to it: a session to the terminal tab or editor window it's running in, a loop to its folder in your editor.

DRAG

Moves just that pill, snapping to the screen's edges. Or line them all up from Arrange Pills in the menu bar.

Arrange

What it watches

Loops: Claude Code loop scripts, like the ones you leave running overnight, that keep a step log and a summary in the project. Claudvisor finds them on its own in the folders you point it at.

Sessions: every Claude Code session running in a terminal on your Mac, whether it's busy, waiting on you or idle. Sessions left idle for 12 hours drop off.

It never writes to your projects. Its only network calls are a periodic git fetch (so the unpushed count stays honest) and a check here for updates, which install from the menu bar.

Menu bar

One dot that takes the most urgent pill's colour, and pulses when something needs you. For when the HUD is hidden or a full-screen app covers it.

Go to it

A session opens where it runs: its tab in Terminal or iTerm, its window in VS Code or Cursor, or the app itself.

Settings

Sessions on or off, how long an idle one stays, your editor, and the session hooks, which it offers once and never adds without asking.

Updates

New versions show up in the menu bar and install in one click.