Tmux Ccm

[](https://docs.anthropic.com/en/docs/claude-code) [](LICENSE) [](https://github.com/tmux/tmux)

ccm is a tmux plugin for developers who run [Claude Code](https://docs.anthropic.com/en/docs/claude-code) across several projects at once. Each Claude session becomes a tagged tmux window with live state detection — so you stop tabbing through windows trying to remember which is mid-response, which is waiting for your approval, and which is idle.

It's effectively an **attention manager**: every project gets a state (BUSY / IDLE / waiting for permission), the dashboard sorts them by urgency, and one keystroke takes you to whichever needs you next.

A popup dashboard shows every project's state (busy / idle / waiting for permission), git branch, and listening ports at a glance. Snapshots restore your full layout after a tmux restart. Desktop notifications surface only the projects that need attention.

ccm's value scales with parallelism: useful with 2–3 projects, daily infrastructure with 4+. Best fit for Max-tier users running agents across multiple projects in parallel.

How ccm models your work

One **project** = one **folder** = one **tmux window**. A window holds any number of panes (Claude Code, a shell, a dev server, an Agent Teams teammate, …). The state of each Claude Code pane (PERMIT / BUSY / IDLE) aggregates up to its window, and ccm dashboard (`prefix + Tab`) switches between windows.

![ccm mental model: a tmux session contains windows (each window = one project =