gitwtfhub

wtf is claudewatch?

renereose/claudewatch — explained in plain English

Analysis updated 2026-07-25

1SwiftAudience · developerComplexity · 2/5Setup · easy

TL;DR

A macOS app that shows a floating status board for multiple Claude Code sessions, so you can see which ones need your attention without switching between terminal tabs.

Mindmap

mindmap
  root((repo))
    What it does
      Shows session status
      Floating window
      Click to jump
    Status types
      Working
      Waiting for input
      Done or interrupted
    Display modes
      Full list view
      Compact bubble
      Menu-bar widget
    Tech stack
      Swift
      macOS frameworks
      No external deps
    Audience
      Power users
      Multi-session coders

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

Why would anyone build with this?

REASON 1

Monitor multiple AI coding sessions at once and instantly see which one needs your input.

REASON 2

Jump straight to the terminal tab or editor window of a session that is waiting for approval.

REASON 3

Keep an unobtrusive bubble in a corner that glows when a session needs your attention.

What's in the stack?

SwiftmacOS

How it stacks up

renereose/claudewatchaakarsh-goyal/macjuicealan13367/opensnapx
Stars111
LanguageSwiftSwiftSwift
Setup difficultyeasyeasymoderate
Complexity2/51/53/5
Audiencedevelopergeneraldeveloper

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

How do you spin it up?

Difficulty · easy Time to first run · 5min

The app is not notarized by Apple, so you must manually approve it in System Settings or clear the quarantine flag via terminal on first launch.

Wtf does this do

{"i":0,"repo":"renereose/claudewatch","stars":1,"lang":"Swift","ok":true,"char_count":1863,"text":"claudewatch is a small macOS app for people who run multiple Claude Code sessions at the same time. Claude Code is an AI coding assistant, and when you have several sessions going in different terminal tabs or editor windows, it is easy to lose track of which one finished its task and which one is sitting idle waiting for you to answer a question or approve a permission prompt. claudewatch solves this by showing a floating window that summarizes the status of every active session at a glance.\n\nThe widget reads Claude Code's own local session logs, which live under the .claude directory in your home folder. It does not run a server, does not send data anywhere, and does not require any extra dependencies. It links only against built-in macOS system frameworks, so there is no separate runtime to install.\n\nEach session appears as a card showing whether it is working, waiting for input, done, or interrupted. When a session needs your attention, the app surfaces the specific reason, such as an open dialog or a permission prompt, and moves that session to the top of the list. Cards also display the model being used, the permission mode, optional CPU and memory usage, and a host badge indicating where the session runs, such as Terminal, iTerm2, Warp, Cursor, or VS Code. You can click any card to jump directly to that terminal tab or editor window.\n\nThere are two display modes: a full list view and a compact bubble mode that can sit unobtrusively in a corner. The bubble glows amber when a session needs input. A menu-bar widget is also available, showing a live count of sessions with a small status symbol. Settings let you control opacity, notifications, whether the window floats above everything else, and more.\n\nInstallation involves downloading a zip file from the GitHub releases page and dragging the app to your Applications folder. Because the app is not notarized by Apple, macOS will block it on first launch, and you need to approve it through System Settings or run a terminal command to clear the quarantine flag. You can also build the app from source using a provided build script, which requires only the Xcode Command Line Tools.","error":null}

Yoink these prompts

Prompt 1
I run several Claude Code sessions across different terminals. Help me set up claudewatch on macOS so I can monitor all of them from one floating window.
Prompt 2
My claudewatch app is blocked by macOS Gatekeeper because it is not notarized. Walk me through the exact steps to approve it in System Settings or clear the quarantine flag from the terminal.
Prompt 3
Show me how to build claudewatch from source using the Xcode Command Line Tools and the included build script.

Frequently asked questions

wtf is claudewatch?

A macOS app that shows a floating status board for multiple Claude Code sessions, so you can see which ones need your attention without switching between terminal tabs.

What language is claudewatch written in?

Mainly Swift. The stack also includes Swift, macOS.

How hard is claudewatch to set up?

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

Who is claudewatch for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.