cctop - monitor and jump between AI coding sessions

GitHub<br>Download

cctop status

Keep an eye on your AI coding sessions.

See which session is waiting on you. Jump there with a keystroke.

Download for Apple Silicon<br>Intel<br>GitHub

v0.18.4 macOS 13+ / Developer ID signed and notarized

Tokyo Night theme

Compatibility<br>What tools does it work with?

Each tool reports session events locally; cctop turns them into one menubar view and jumps you back to the right editor or terminal window.

Claude Code / Desktop Claude plugin + event hooks<br>Codex CLI / Desktop Codex event hooks + trust step<br>opencode opencode plugin events<br>pi pi extension events

Targets the exact session right window, tab, and pane - or the specific thread in a desktop app<br>iTerm2cmuxKitty*Ghostty&dagger;Terminal&Dagger;Codex DesktopZellijtmux

Opens the project focuses the editor window, using the workspace file if present<br>VS CodeCursorWindsurfZed

Activates the app raises the app; find the tab manually<br>Claude DesktopWarp

*&thinsp;Kitty targets the exact window when remote control is enabled in kitty.conf. Without it, falls back to app activation.<br>&dagger;&thinsp;Ghostty 1.3.0+ targets the session terminal by writing a temporary OSC 7 cwd marker to its TTY, matching that marker via AppleScript, then restoring the real cwd. If the TTY is unavailable, it falls back to working-directory matching.<br>&Dagger;&thinsp;Apple Terminal targets the tab by tty via AppleScript. Falls back to app activation inside a multiplexer (tmux, screen), where the captured tty is the multiplexer pane's pty rather than the Terminal tab's.

Features<br>Designed for scanning, then jumping.

The app stays compact in the menubar, but keeps enough context visible that you can decide where to go next.

Navigate mode<br>Hit a global hotkey to overlay numbered badges on every session card, then press the number to jump instantly.<br>1to9jump to session

Press 1-9 to jump

Draggable panel<br>Drag the header to reposition the panel anywhere on screen. Position persists across launches, and double-click snaps it back to the menubar anchor.

Panel position persists

Smart status icon<br>Lives in your macOS menubar in three states: healthy, needs attention, and a slim pill for laptops with a camera notch.

All healthy / needs attention / notch pill

Recent projects<br>A second tab keeps session history so you can reopen past projects easily.

Recent sessions stay close by

Themes<br>Four palettes, light and dark.

Color schemes inspired by developer tools. Switch in Settings, then choose light, dark, or system mode.

Claude

Tokyo Night

Gruvbox

Nord

Install<br>Install the app, then connect your tools.

Download the latest release, open the DMG, and drag cctop.app into /Applications. Signed release builds can check for new updates automatically.

1Install the app

Signed with Apple Developer ID and notarized by Apple. Runs on macOS 13+. Signed release builds can check for new updates automatically.<br>Download for Apple SiliconIntel<br>$ brew install --cask st0012/cctop/cctopcopycopied

2Connect your coding tools

Open Settings > Tools. cctop shows the setup action for each detected tool: Copy Install Command, Install Plugin, Install Hooks, or Trust Hooks.<br>Use the action shown on each row to install or update that tool's plugin or hook.<br>For Codex CLI / Desktop, trust installed hooks once from a Codex CLI session.<br>New or restarted sessions appear automatically in the menubar panel after setup.

Claude theme / light

FAQ<br>Common questions.

Short answers for performance, privacy, setup, and platform details.

Does cctop slow down my coding tool?<br>No. Each integration does minimal work on session events: it calls the bundled helper, writes a small JSON file, and returns immediately.

Does cctop send any data anywhere?<br>No analytics, no telemetry, and no session upload. Signed release builds use network access for automatic update checks and downloads, but session data stays on your machine in ~/.cctop/sessions/ as plain JSON.

Do I need to configure anything per project?<br>No. Once your tools are connected, new sessions are automatically tracked. There's no per-project setup.

Why does Codex Desktop need an extra trust step?<br>Codex only runs hooks you've explicitly reviewed and trusted. cctop can install the hooks, but Codex Desktop does not currently surface the hook-review prompt. Start one Codex CLI session in a terminal and trust the hooks; Codex Desktop shares that trust state.

Why does the app need to live in /Applications?<br>Plugins look for the cctop helper inside /Applications/cctop.app or ~/Applications/cctop.app. Installing elsewhere breaks the integration.

I am on an Intel Mac and the updater installed the wrong architecture.<br>Quit cctop.<br>Download the Intel DMG from the latest release.<br>Replace the existing app in /Applications/.<br>Relaunch cctop. Future updates will pick the correct architecture.

How do I uninstall?<br>Remove the app from /Applications.<br>Remove each plugin you installed.<br>Wipe session data and...