cctop
GitHub 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 Intel GitHub
v0.18.4macOS 13+ / Developer ID signed and notarized
cctop menubar panel showing active AI coding sessions
Tokyo Night theme
Compatibility

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 / DesktopClaude plugin + event hooks Codex CLI / DesktopCodex event hooks + trust step opencodeopencode plugin events pipi extension events
Targets the exact sessionright window, tab, and pane - or the specific thread in a desktop app
Terminal‡
Opens the projectfocuses the editor window, using the workspace file if present
Activates the appraises the app; find the tab manually

* Kitty targets the exact window when remote control is enabled in kitty.conf. Without it, falls back to app activation.
† 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.
‡ 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

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

Hit a global hotkey to overlay numbered badges on every session card, then press the number to jump instantly.

1to9jump to session
cctop navigate mode with numbered badges
Press 1-9 to jump

Draggable panel

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

cctop panel being dragged on screen
Panel position persists

Smart status icon

Lives in your macOS menubar in three states: healthy, needs attention, and a slim pill for laptops with a camera notch.

cctop status icons in the macOS menubar
All healthy / needs attention / notch pill

Recent projects

A second tab keeps session history so you can reopen past projects easily.

cctop recent projects tab
Recent sessions stay close by
Themes

Four palettes, light and dark.

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

Claude dark theme screenshot
Claude
Tokyo Night dark theme screenshot
Tokyo Night
Gruvbox dark theme screenshot
Gruvbox
Nord dark theme screenshot
Nord
Install

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.

1

Install the app

Signed with Apple Developer ID and notarized by Apple. Runs on macOS 13+. Signed release builds can check for new updates automatically.

Download for Apple SiliconIntel
$ brew install --cask st0012/cctop/cctop
2

Connect 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.

  • Use the action shown on each row to install or update that tool's plugin or hook.
  • For Codex CLI / Desktop, trust installed hooks once from a Codex CLI session.
  • New or restarted sessions appear automatically in the menubar panel after setup.
cctop Claude light theme screenshot
Claude theme / light
FAQ

Common questions.

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

Does cctop slow down my coding tool?

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?

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?

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?

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?

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.

  1. Quit cctop.
  2. Download the Intel DMG from the latest release.
  3. Replace the existing app in /Applications/.
  4. Relaunch cctop. Future updates will pick the correct architecture.

How do I uninstall?

  1. Remove the app from /Applications.
  2. Remove each plugin you installed.
  3. Wipe session data and config with rm -rf ~/.cctop.