cc-status-bar

CC Status Bar

A native macOS menu bar app for real-time monitoring of Claude Code sessions.

- Never miss a prompt — Red/yellow alerts when sessions need your attention
- One-click focus — Click a session to jump to the right terminal, tab, or editor window
- Multi-session at a glance — Monitor all Claude Code and Codex sessions from a single icon

Features

Core

Menu Bar Display
- 🟢 Green = Sessions running
- 🔴 Red = Permission prompt waiting (highest priority)
- 🟡 Yellow = Command completion waiting
- ⚪ White = Idle (no active sessions)

Session List
Click the menu to see session details:

Access the submenu for quick actions:
- Open in Finder - Open the project directory
- Copy Path/TTY - Copy to clipboard
- Copy Attach Command - For detached tmux sessions

Global Hotkey
Invalid saved key codes or overflowing modifier values fall back to the default shortcut; displaying an unknown
key code does not crash the app.

Enable ⌘⇧C (Cmd+Shift+C) in Settings to quickly focus waiting sessions without using the menu bar.

When triggered:
1. Focuses the highest priority waiting session (red > yellow)
2. If no waiting sessions, focuses the most recent session
3. If no sessions, opens the menu

Autofocus
Enable in Settings → Autofocus to automatically bring the waiting terminal
to the front. When Claude needs permission or finishes a command, the right
terminal window appears — no manual switching needed.

- Focuses the highest priority session (red > yellow, most recent first)
- 500ms debounce prevents rapid focus switching
- 30s per-session cooldown avoids repeated focus on the same session
- Suppressed while typing (3s cooldown, includes IME toggle keys)
- Skips detached tmux sessions (no terminal to focus)
- Auto-acknowledges the focused session

Notification…