poorfish

ClaudeDot

Name: ClaudeDot
Author: poorfish

Productivity community

SOURCE https://github.com/poorfish/ClaudeDot

Description

macOS menu bar utility that monitors Claude Code session status in real-time

Installation

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

README

Claude Dot

A tiny macOS menu bar dot that shows you what Claude Code is doing in real-time — so you don't have to keep checking the terminal.

![macOS](https://img.shields.io/badge/macOS-13.0%2B-black) ![License](https://img.shields.io/badge/license-MIT-blue)

Features

Progress Visualization — The menu bar dot changes color in real-time, so you don't have to stare at the terminal.
Multi-Session Tracking — Monitors all running Claude Code instances simultaneously. The dot reflects the most urgent status, and the panel lists every session with its own state.
Proactive Alerts — Sound notifications when Claude needs your input or finishes a task.
Quick Switch — Left-click the dot to jump straight to your terminal window. With multiple sessions, click any session in the panel to jump to its specific terminal.
Zero Configuration — Auto-detects your setup, works out of the box. Supports Ghostty, iTerm2, Warp, and Terminal.app.
Multilingual — 8 languages supported, automatically matches your system language.

What It Does

A colored dot lives in your menu bar and changes based on Claude Code's current state:

Dot	Status	Meaning
	Disconnected	Claude Code is not running
	Idle	Waiting for your input
	Thinking	Processing your request
	Responding	Writing a response
	Tool Active	Running a tool (shell, file edit, etc.)
	Needs Attention	Waiting for your permission