| name | tmux-monitor |
| description | Use when the user mentions a tmux window, pane, or panel — including "what's in that panel", "look at that window" — or asks to monitor a process running in tmux. Do NOT use peek (scrot screenshots) for tmux content — tmux panes are text, not GUI. |
$ARGUMENTS — [interval=10] [pane=0:0.1]
interval — seconds between checks (default: 10)pane — tmux pane target in session:window.pane format (default: 0:0.1)
How it works
Each iteration:
- Run
sleep <interval> && tmux capture-pane -p -t <pane> -S -60 as a single Bash call (timeout: <interval> + 20 seconds)
- Compare output to the previous capture
- If changed: report what happened in plain text — one short sentence per notable event
- If unchanged: say nothing, go to next iteration
Repeat until the user interrupts or says to stop.
Starting
Parse $ARGUMENTS. If the pane argument is not provided, run:
tmux list-panes -a
and pick the pane that is NOT the one Claude is running in (i.e. not the active pane of the current window).
Announce once before starting:
Monitoring pane <pane> every <interval>s. Interrupt to stop.
Then begin the loop immediately — no further confirmation needed.
Reporting
- Report only meaningful changes: new commands, output, errors, prompts, status changes
- Skip noise: cursor movement, progress bars updating in place, unchanged content
- Keep each report to 1–2 sentences maximum
- If an error is detected (non-zero exit, error message), flag it explicitly
