ClaudeDot

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #typescript #llm #machine-learning #deep-learning #docker #nodejs #macos #java #kubernetes #awesome-list

(★ 13)

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

ClaudeDot Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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 |
|-----|--------|---------|
| <img src="https://img.shields.io/badge/●-gray-lightgrey"/> | Disconnected | Claude Code is not running |
| <img src="https://img.shields.io/badge/●-green-brightgreen"/> | Idle | Waiting for your input |
| <img src="https://img.shields.io/badge/●-purple-blueviolet"/> | Thinking | Processing your request |
| <img src="https://img.shields.io/badge/●-blue-blue"/> | Responding | Writing a response |
| <img src="https://img.shields.io/badge/●-orange-orange"/> | Tool Active | Running a tool (shell, file edit, etc.) |
| <img src="https://img.shields.io/badge/●-yellow-yellow"/> | Needs Attention | Waiting for your permission |

Each state has a distinct animation and optional sound alert — you'll hear a chime when Claude needs your attention, and a pop when a task finishes.

## Install

### Download (Recommended)

1. Go to [Releases](../../releases) and download the latest `.dmg`
2. Open the DMG and drag **ClaudeDot** to Applications
3. Launch ClaudeDot from Applications

> **First launch note:** macOS will block unsigned apps downloaded from the internet. After dragging ClaudeDot to Applications, open Terminal and run:
>
> ```bash
> xattr -cr /Applications/ClaudeDot.app
> ```
>
> Then launch ClaudeDot normally. You only need to do this once.

### Build from Source

```bash
git clone https://github.com/poorfish/ClaudeDot.git
cd ClaudeDot
open ClaudeDot/ClaudeDot.xcodeproj
# Press Cmd+R to build and run
```

Requires Xcode 15+ and macOS 13 (Ventura) or later.

## Usage

- **Left-click** the dot — switches to your Claude Code terminal window
- **Right-click** the dot — opens a panel showing status details, sound toggle, and settings

Supports **Ghostty**, **iTerm2**, **Warp**, and **Terminal.app**.

## First Launch

ClaudeDot automatically configures itself on first launch by adding two hooks to `~/.claude/settings.json`:

- **statusLine** — polls Claude Code's idle state every 3 seconds
- **Notification hook** — detects when Claude needs your permission

No manual configuration needed. Just launch and go.

## Requirements

- macOS 13 (Ventura) or later
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI installed

## License

MIT

ClaudeDot

ClaudeDot Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

ClaudeDot

ClaudeDot Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README