sirioctl

Workspaces, panes and surfaces

The cmux-compatible command groups for worktrees, panes and surfaces.

Beyond panel, sirioctl mirrors cmux’s flat command names so existing scripts port with little change.

Workspaces

A workspace is a worktree row in the sidebar.

sirioctl list-workspaces --json
sirioctl new-workspace --path /path/to/worktree
sirioctl select-workspace --id <uuid>
sirioctl current-workspace
sirioctl close-workspace --id <uuid>

Panes and tabs

pane split | focus | close and tab cycle | select operate on the centre column of the selected workspace. pane split and pane focus take a direction; tab select takes a one-based index.

Surfaces

A surface is one rendered thing inside a pane: a terminal, an editor, a diff, a browser. The CLI addresses two of them by name. surface changes open | read | stage | unstage | discard | stage-all | discard-all drives the Changes view of a worktree, and surface settings open | select | read drives the Settings surface. The browser surface is available in the app; driving it from an agent is not part of the shipped CLI.