Tutorial 2: Juggling Multiple Sessions
You have three projects moving in parallel. Open the TUI:
ccmuxSession states
The Dashboard shows all sessions, color-coded:
| State | Color | Meaning |
|---|---|---|
active | green | The agent is generating output right now |
idle | yellow | The agent finished, no prompt visible |
needs_input | red | The agent is showing its input box, quiet for ≥ 3s |
needs_input is the one to watch. When any session transitions to it, ccmuxd injects a terminal BEL — any iOS terminal client that maps BEL to a notification raises a push.
Useful keys on the Sessions screen
| Key | Action |
|---|---|
Enter | Attach to session |
x | Kill the highlighted session |
R | Rename |
k | Pin keep-awake (daemon holds caffeinate -s while pinned) |
? | Full keymap |
Splitting work across machines
Start a session on your laptop and another on the Mini from the same dashboard — the Projects tab lets you pick which device hosts the new project (n → select device). The remote daemon scaffolds and starts the session; ccmux ssh-attaches you in.
Spotted an error or something out of date? Edit this page on GitHub.