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

Glance at the menubar. Jump back when a session needs you.

cctop turns every AI coding session into a menubar signal: green means work is moving, orange or red means one session needs attention.

Menubar status

The icon stays visible while you work, including a compact pill for notched MacBooks. When the color changes, you know when to open cctop and jump back.

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

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

Worktree cleanup

Cleanup finds ended agent worktrees that still exist on disk, especially CLI or manual worktree runs. cctop checks Git state before offering the right remove action.

cctop cleanup tab listing ended worktrees with Git safety state
Ended worktrees with Git safety checks

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 do some archived desktop sessions not appear in Cleanup?

Some desktop clients remove their managed worktree when you archive a session. In that case, there is nothing left for cctop to remove, so Cleanup stays quiet. Cleanup is most useful for CLI and manual-worktree sessions where the linked Git worktree remains on disk after the session ends.

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.