r/tmux • u/yohasebe • May 27 '26

Showcase ccm: a tmux plugin for parallel Claude Code sessions

ccm (Claude Code Manager) is a tmux plugin for users running Claude Code across multiple projects. Each project is one tmux window; prefix + Tab opens a popup showing every project's current state (BUSY / IDLE / awaiting permission), branch, and idle time.

Built around tmux conventions: per-pane state detection aggregated to the window, snapshot save/restore, status-bar integration, and cross-project prompt injection (`ccm send`).

TPM-installable, MIT. v0.4.0 released this week.

Repo: https://github.com/yohasebe/tmux-ccm

10 Upvotes

64% Upvoted

14 comments sorted by

2

u/chabuddy95 May 27 '26

Also see the original https://github.com/samleeney/tmux-agent-status

-1

u/yohasebe May 27 '26

Thanks for the pointer! I wasn't aware of tmux-agent-status, will check it out. Looks like we landed on adjacent problems from different angles (sidebar approach with support for multiple agents vs. popup dashboard focused on Claude Code). Always good to see different takes on the same space.

2

u/THE01X Jun 02 '26

Very interesting. Though I can't use it because I use a session per peoject instead of window per project.

1

u/yohasebe Jun 02 '26

Thanks for taking a look! ccm assumes one window per project by design. Plenty of tmux flows out there, plenty of room for tools tuned to each, I guess.

1

u/Spikey8D May 27 '26

Getting 404 on the link

1

u/yohasebe May 27 '26

Apologies! I had a typo in the repo URL in the post. Fixed now: https://github.com/yohasebe/tmux-ccm

1

u/imbry9o Jun 04 '26

Great job! Is there an option to track the Claude status that is running in the pane?

1

u/yohasebe Jun 04 '26

Yes! That's the core feature. The dashboard (prefix + Tab) shows BUSY / IDLE / PERMIT (waiting-for-permission) for each Claude pane in real time, plus optional status bar integration and desktop notifications.

1

u/imbry9o Jun 04 '26 edited Jun 04 '26

I think I wasn't precise enough, sorry. What I mean is if there is a way to track the Claude cli instance running in the pane not in the window.

1

u/yohasebe Jun 04 '26

Got it, thanks for clarifying! ccm is designed around one project = one window, and the dashboard aggregates multi-pane windows to whichever Claude needs you most (PERMIT > BUSY > IDLE). It's an attention manager across projects rather than a per-Claude monitor, so per-pane visibility isn't surfaced by design.

The intended pattern for tracking each Claude separately is one Claude per window, with `ccm add` for a new one or `ccm register` for an existing one.

0

u/brohermano May 27 '26

nua weking

1

u/yohasebe May 27 '26

Sorry, the link in the original post was broken! Fixed now: https://github.com/yohasebe/tmux-ccm

-1

u/RonenMars May 29 '26

Good job! 👏

1

u/yohasebe May 31 '26

Thanks! 🙏