Panes and docks: files, workers, and music

CLIO Coder in the terminal can open panes of its own beside the conversation: a file browser below, a live view of workers on the right, and a small radio. Each is a dock. One key shows or hides it, and hiding keeps it running. Herdr, a terminal multiplexer, hosts the panes.

Turn panes on

Panes are on whenever the terminal allows them. Start CLIO Coder in your project:

clio-coder

It opens its own pane host and hands the terminal back when you quit. The host is CLIO Coder's own pinned copy of Herdr; a Herdr of yours on PATH, with its config and sessions, is never used or touched.

Inside your own Herdr session, bare clio-coder opens its host nested in that pane; clio-coder --with-panes joins your session as a guest instead. A session started inside tmux, Zellij, or screen stays in the plain terminal with no docks: /files becomes a one-time full-screen picker and Alt+W opens the worker list inside CLIO Coder.

Three docks, one habit

Press the key once to show a dock and again to hide it. A hidden dock moves to a parked tab and keeps its state: the file browser stays in its directory and the radio keeps playing. Press the key twice quickly to close the dock and end its program. Quitting CLIO Coder closes all of them.

Drag a divider to resize a dock; the size is kept when you hide and show it. A dock never takes more than half the window, and one that cannot fit says how much room it needs. /panes prints which docks are visible, hidden, or closed. The same keys are under Ctrl+G, then w, e, or a.

Pick files with Yazi

/files or Alt+E opens Yazi and moves the keyboard into it. Select files and press Ctrl+Y. CLIO Coder appends them to your draft as @path references and returns you to the composer without sending anything. One pick carries up to 32 paths.

Yazi runs on a profile and theme that CLIO Coder generates, so your own Yazi configuration is untouched. Set interface.panes.files.profile: user to use yours instead. /files hide and /files close do what the key does.

Watch workers live

Alt+W opens a dashboard with one card per worker in this session: the agent and task, its state, the model, tool calls against its budget, tokens, cost when it is known, and what the worker is doing now. Running workers come first.

Move with the arrow keys and press Enter to fill the dock with one worker's live stream; Escape returns to the cards. q hides the dock. The dashboard only reads recorded run files, so it cannot change a run, and it does not open by itself when a worker starts.

Play focus radio

/music or Alt+A opens cliamp in a strip tall enough for its spectrum bars and starts a lo-fi stream.

/music pause
/music next
/music station Groove Salad
/music off

next steps through six built-in focus stations. station takes a stream URL or a station name; a name that is not built in is looked up in the public Radio Browser directory. CLIO Coder keeps its player configuration separate from your own cliamp setup.

The model cannot touch the player unless you also set integrations.music.agentControl: true and restart. Then a music tool can play, pause, skip, and stop, but not choose stations. When to use it is up to your project instructions.