Board basics
Columns side by side, how to start them, arrange them, and the keys that move you around.
Starting a column
Everything on a board is a column: an agent, a terminal, a database, a preview. Cmd+P on a Mac, or Ctrl+P elsewhere, opens Start from anywhere; so do A, the rail's + and the slot at the end of the board. Cmd+K, or Ctrl+K, searches every agent's conversation and jumps to what it finds; on a phone, the search button at the right of the bar does.
Write a prompt in Start and Enter starts an agent with it. Its chips pick the coding agent, the model and the effort. Or pick a kind's tile, or press its letter. A kind with an agent of its own, like Database, can be asked first: Shift-click its tile, or hold it.
Start in, at the top, is where the column starts: a runner, a folder and a branch, each a click to change. Worktree starts it on a new branch in a worktree of its own, so two agents can work in one repository without meeting.
A column starts where you were working: on the runner of the column you're on, in its directory, a terminal's being wherever its shell is now. If that's one of a repository's worktrees, it starts in the repository's main worktree instead, leaving the branch to the column on it. On a board you emptied, it starts where the last column was; on a new board, on your default runner, in its working directory.
The bar under the header
Every column has a bar under its header with the runner and directory it works in, and its own buttons. Its + opens columns that start where it works, right after it: Open terminal here on an agent is the quickest way to a shell in the agent's worktree.
Arranging
Drag a header to move a column, or press Shift+Left and Shift+Right on the column you're on. Drag a column's right edge to resize it; double-click the edge for the default width.
A column's menu has Rename, Move to board..., Stack with left and right (Take out of stack in a stack), Later..., File away and Take off the board for an agent or Fold for another kind, the kind's own items, and Remove. Drag the header to move a column and its edge to change its width; W changes the width too, and a double-click on the header makes it as wide as the board.
- Fold,
Z, makes a column that isn't an agent a tab in a row above the board, with its title and its state. Click the tab to open the column again where it was. An agent doesn't fold: take it off the board instead, and it waits in the inbox. - Stack with left or right,
[and], puts columns in one place, one on top of the other.UpandDownstep through a stack,Eshows it side by side or as one again,Utakes a column out, andShift+Rnames it.
Double-click a title to rename it. Agents name themselves after their conversation unless you've renamed them, or turned that off in Settings.
The inbox
The inbox, in the sidebar, lists your agents on every board by what they need: Needs Attention, Unread, Running, Read and Later, each with the agent that did something last at the top. Its search box finds an agent by its title, its last message or its board, and This board shows only the agents of the board you're on. The sidebar opens from the rail when you point at it; its button keeps it open beside the board. An agent on another board opens over this one, so you can answer it without leaving. I opens the next agent that needs attention, then the next unread one.
Otakes the agent you're on off the board, into the inbox.Pplaces the agent open over the board after the column you were on, andSfiles it away.- Later...,
N, snoozes an agent until a time you pick: in an hour, this evening, tomorrow, next week or one of your own. It leaves the board and waits under Later, then comes back as Unread. A question from it or a message to it brings it back sooner. - New agent, at the top of the inbox, or
Shift+A, starts an agent in the background, off the board. - An agent off the board that nobody touches for 3 days is filed away, but never while it's under Later. The inbox's Cabinet shows filed agents. A message to one brings it back into the inbox, and
P, or the Place button in its header, puts it on the board you're on.
In Settings, Agents, ORI can write the line under each agent, on your credits: what you asked while it runs, what it waits on you for, and what its turn came to. Filing an agent away cancels its wakeups and waits unless you turn that off there.
Removing
Remove in a column's menu, or Backspace on a Mac and Delete elsewhere, removes the column you're on. Cmd+Z brings it back. An agent can be filed away instead: it keeps its conversation, the inbox's Cabinet lists it, and a message to it brings it back.
Keys
LeftandRight, orHandL, move between columns;HomeandEndgo to the first and the last.Astarts a column,Cmd+Pstarts one from anywhere,Cmd+Ksearches every agent's conversation,Cmd+Jjumps to a board,,opens settings,?lists every key.- On the column you're on:
Rrenames,Wchanges the width,Zfolds a column that isn't an agent to a tab above the board,Spacescrolls to the newest entry. Entergoes into the column you're on, where every key is the column's, andEsc Esccomes back out to the board.
Settings, Keyboard changes any of them, and turns modal navigation off: then going to a column goes into it, and Esc is always the column's. Settings, Interface sets the text size for each kind of display, the colors, the clock, the arrow for the next column in a stack, and a chime when an agent starts needing you.