Cmux Claude Code

cmux-claude-pro

the definitive claude code + cmux integration. real-time status pills, progress bars, sidebar logs, desktop notifications, git integration, subagent tracking — all wired up through 16 claude code hooks and cmux's unix socket.

built by studying how [cmux's core team](https://github.com/manaflow-ai/cmux) does their official claude integration, then going way further.

    

demo

https://github.com/user-attachments/assets/placeholder-demo-video

paste the [test prompt](#try-it-yourself) into a fresh claude code session and watch the sidebar light up.

the sidebar, explained

here's every state you'll see while claude works:

status pill (top of sidebar)

state	icon	color	when it appears
Ready	checkmark.circle	green	session started, waiting for input
Thinking...	brain	gold	you submitted a prompt, claude is processing
Working: Read: handler.ts	hammer.fill	blue	claude is reading a file
Working: Edit: config.ts	hammer.fill	blue	claude is editing a file
Working: Bash: npm test	hammer.fill	blue	claude is running a command
Working: Grep: "TODO"	hammer.fill	blue	claude is searching code
Working: Glob: **/*.ts	hammer.fill	blue	claude is finding files
Working (2 agents): ...	hammer.fill	blue	subagents are active
Waiting: Bash	hand.raised.fill	orange	permission requested
Needs input	bell.fill	blue	claude sent a notification
Done	checkmark.seal	green	response complete
Error	xmark.circle	red	response failed
Compacting...