What is ccmux?

ccmux is a command line tool for people who run several AI coding agents at once inside tmux, a terminal multiplexer that lets you split your terminal into multiple panes. If you have Claude Code, Codex, Cursor, or a similar agent running in several panes at the same time, it becomes hard to remember which one finished its work, which one is stuck waiting for you to approve something, and which one is still busy. ccmux solves that by running a background process that watches all your panes and showing you a live list of every agent session, each marked as idle, working, or waiting for a permission, plan approval, or answer. From that list, called the picker, you can jump straight into whichever session needs your attention, see a live preview of what is happening in a pane before switching to it, and even type or approve things directly from the preview without fully switching over. It also supports desktop notifications you can act on immediately, a permanently visible sidebar mode, fuzzy search across your sessions by project or branch, and awareness of git branches, worktrees, and open pull requests including their CI status. You can review a session's code changes as a diff without leaving ccmux, and spawn, restart, or kill agent sessions directly from the tool. It supports Claude Code, Codex, Cursor, OpenCode, and several other agents out of the box, with the option to add custom agent definitions through configuration. Setup mainly means installing ccmux, running its setup command to register hooks with your agents for more reliable session tracking, and starting your usual agent sessions inside tmux as before, since ccmux discovers what is already running rather than changing how you launch anything. The project is written in TypeScript, requires tmux and Bun if installing from source, and offers a Homebrew installation option as well.