Reference

Keys and mouse

Every key binding in the TUI, grouped by where it applies. Press ? in conch to see them all; the prefix ctrl+b can be changed with [keys] prefix in config.toml.

Tree

Create

Other keys on tree items:

Pane

Changes

Sessions

Files

Click a line to select it and again to open it; the wheel moves the selection, or scrolls the preview under the pointer; click a folder in the path above the list to go back up to it.

Splits and tabs

These follow tmux's default bindings; ctrl+b 1 is the first tab and 0 the tenth. ctrl+b ! jumps to the next agent waiting for you instead of breaking a pane out.

Scroll mode

ctrl+b [ (or ctrl+b pgup) enters scroll mode with a cursor.

Git panel

Mouse

• Click to select; click a selected folder (or its arrow) to fold. A click on a branch shows its changes; b or $ opens the git window over them.
• Double-click to open.
• With [ui] hover on (Settings → Theme), the row or tab under the pointer is tinted before you click it, a link in a pane is underlined while alt or ctrl is held, and in Ghostty or kitty the pointer becomes a hand over it. It asks the terminal to report every pointer move rather than only drags — a message per cell crossed — so it is off until asked for, and a program in a pane still receives only the mouse it asked for.
• Right-click for a context menu. On an agent's pane it holds Prompt…, which sends that agent its next message and tells you when the work it started ends (see Agents working together).
• A row's menu also holds Actions… when you have configured any: your own commands from config.toml, run in that row's checkout on that row's machine. See [[actions]].
• Wheel to scroll; over a pane, the wheel scrolls back through its history.
• Drag the sidebar's edge to resize, or a border between splits.
• A pane with history keeps a bar on its right edge: how far back the screen is, and how much there is. Drag it to go there directly, rather than turning the wheel through a long conversation. Borders shared with another split still resize — the outer edge is the one that scrolls.
• Drag a row into a folder of its own section, or back out onto the section itself to leave it. The row under the pointer is marked while you hold; a folder of another section does not take it, since a pane listed under Terminals belongs in a Terminals folder.
• With the tree grouped by tab, drag an agent or terminal row in the tree onto a tab's section to put it in that tab — the same move, reached from the tree. A pane that was in another tab leaves it, and that tab closes if it was the last split in it; one that was in no tab is opened there. The section under the pointer is marked while you hold; let go anywhere else and nothing moves.
• Drag a split by its title onto a tab in the bar to move it into that tab: it leaves the split it was in, which closes as closing a split does, and the tab it was dropped on is the one shown afterwards. A tab that held nothing else goes with it. Dropped on the + it goes to a tab of its own, beside the one it left — conch has no "break this split out" key, since ctrl+b ! jumps to the next agent waiting. The tab or + under the pointer is marked while you hold. Let go on the space between tabs and nothing moves; nor does the + take the only split of a tab, which is already a tab of its own.
• Drag a split by its title onto another split to swap the two — the layout stays as it is, so the halves keep the sizes you gave them, and each view keeps what it was holding (a diff its scroll, a file explorer its folder). While you hold, the split being carried is marked and so is the one it would land on; after you let go, both stay marked for a moment, since two panes full of text swapping is otherwise hard to see happen.
• Drag a tab along the bar to reorder it — the bar reorders under the pointer as you go, and letting go anywhere keeps it (ctrl+b < > and ctrl+b . do the same from the keyboard).
• Drag across a pane or a page (a diff, a file, a list) to select and copy; double-click copies a word in a pane, triple-click the whole line (without the blanks it is padded to). A line too long for the pane is several rows on screen but one line when copied: conch joins the rows it wrapped over, so a command pasted into a shell runs as one command. Dragging past the top or bottom edge, or turning the wheel mid-drag, scrolls and keeps selecting.
• Drop files on a remote machine's pane to upload them there and paste their paths there.
• alt+click (option+click) or ctrl+click a link an agent printed to open it in the browser; it is copied as well. A plain click never opens a link: it selects, or belongs to the program when it asked for the mouse. A link wrapped over several rows opens whole. ctrl+b u still lists every link on the screen, which is the way to reach one that has scrolled away.
• Click ⚑ N waiting · N done to jump to the next agent that needs you.
• Click the plan chip (Claude 5h 42% · 7d 18%) for a window with all of it, at the bottom right beside the chip: every agent that has reported on every machine, and every window it named — the five-hour, the week, a weekly allowance for one model, a spend limit — each with a bar that fills as it opens, the percentage, when it resets (both how long and at what time), when the agent last said so, and what conch itself has seen that machine spend — which counts whole conversations, as each agent counts them, with the prompt, cache-read, cache-write and output tokens kept apart. That is not the same as the agent's own usage panel, which counts the run it is on: a conversation days old reads as hundreds of dollars here and a few in a panel opened a minute ago, and both are right. Click it again or press esc to close.

Clicks inside a pane go to programs that use the mouse. Hold shift (option in iTerm2) to select text with your terminal, or set [ui] mouse = false.