Pane CLI

rimz pane exposes the public pane primitives that humans and scripts share: see the room as panes, measure pane output, read what is on screen, type into one, and move focus. pane send is the same explicit input path as message --steer — literal keystrokes into a real pane, nothing more — and pane capture reads back the visible buffer, so a script observes and drives a pane exactly as a person at the keyboard would. It targets panes by id, by the agent-address grammar, or by the literal sidebar. The operator-facing safety rules for treating captured text as untrusted are in security.md.

rimz pane list
rimz pane bandwidth --secs 5
rimz pane capture @codex#auth-refresh --lines 80                             # read an agent's visible buffer
rimz pane capture zellij:terminal_4 --lines 80                                # read a precise pane id
rimz pane capture sidebar --lines 80                                           # read this view's sidebar
rimz pane send @codex#auth-refresh --key ctrl-u --enter -- "cargo xtask test" # clear line, type, run
rimz pane focus tmux:%3
rimz pane split
rimz pane detach

list is the room seen as panes: every pane grouped under its native tab, each row labelled with the agent that lives in it (@kind#worktree), sidebar for RimZ chrome, or process for a plain pane, with status and working directory. Each tab carries its own sidebar row. The pane running the command carries a faint (self) mark; this identifies the caller, not the focused pane. The topology carries no per-tab active mark; attached selection lives in the optional session register consumed by the sidebar. On Zellij, listing a named session requires a known RimZ workspace record because the pane roster comes from RimZ's presence-plugin topology cache.

#auth-refresh
 sidebar                -         ~/code/qe-wt/auth-refresh   zellij:terminal_2
 @claude#auth-refresh   running   ~/code/qe-wt/auth-refresh   zellij:terminal_3
 @codex#auth-refresh    idle      ~/code/qe-wt/auth-refresh   zellij:terminal_4 (self)
 process                -         ~/code/qe-wt/auth-refresh   zellij:terminal_5

The agent labels are a best-effort overlay folded from the workspace snapshot, so a pane the multiplexer has handed back to a shell reads process; the tab grouping always works, even with no snapshot reachable. --json emits the tab tree with a per-pane kind of "agent", "process", or "sidebar", plus command, cwd, and pid, an agent object for agent panes, and "self": true on the calling pane.

capture prints visible pane text and changes nothing. send types literal text and named keys in order — the write your keyboard would make. focus moves attention. These three target a pane id, an agent address, or the literal sidebar; sidebar resolves the sidebar in the caller's own view first, then the focused tab's sidebar, then any sidebar in the session. Pane ids choose their own backend (tmux:%3 uses tmux, zellij:terminal_4 uses Zellij) instead of the ambient session. Named keys are enter, escape, tab, shift-tab, backspace, the four arrows, ctrl-c, ctrl-d, and ctrl-u, with aliases like return, esc, backtab, and bs.

split opens a shell beside the current pane along its longer visual edge, matching the room's native new-pane behavior. detach detaches the attached client; the session keeps running in the background and comes back on the next attach.

Because pane capture returns untrusted terminal text, a script should match bounded patterns before sending anything back. The operator-facing safety rules are in security.md.

Bandwidth

rimz pane bandwidth [--secs N] [--json] runs on the Linux host serving the room and samples VFS write-rate counters to attribute per-pane terminal output on both backends. tmux reports pane pids natively, while Zellij pane pids resolve through RimZ's process matcher. Use it inside the room when a remote attach looks chatty; full-screen TUIs such as agents mid-turn or system monitors should dominate the report. Remote rooms also include SSH WIRE rows when socket counters are available; the bandwidth attribution internals explain the measurements.