CCMissionControl

A macOS menu bar app that monitors running Claude Code sessions in WezTerm.

Features

• Detects running Claude Code sessions via WezTerm CLI and process tree inspection
• Menu bar icon showing session count with running/idle status
• macOS notifications and unread badges when sessions complete in the background
• Click to switch WezTerm tabs, auto-clear on focus return
• Dropdown and floating window modes
• Settings: notifications, Launch at Login, custom WezTerm path

Requirements

• macOS 26.0+
• WezTerm installed at /Applications/WezTerm.app
• Claude Code running in WezTerm

Download

Download the latest release from GitHub Releases.

Build

xcodebuild -scheme CCMissionControl -configuration Debug build

How it works

The app periodically (every 2 seconds) runs:

1. wezterm cli list --format json to discover terminal panes
2. wezterm cli list-clients --format json to determine the focused pane
3. ps -eo pid,ppid,tty,comm to inspect the process tree

It matches WezTerm panes to Claude Code processes by normalizing TTY names and walking the process ancestor chain. A Claude Code session is considered "running" if it has a caffeinate child process.

Menu bar icons

Icon	Meaning
bolt.fill + N	N sessions actively running
powersleep + N	All N sessions idle
bell.badge.fill	A session completed while you were on another tab

Acknowledgments

Inspired by wez-cc-viewer.

License

Apache 2.0 License