Board & split
Up to four conversations on one screen, and the sidebar around them.
The board is the Workspace
Every Workspace has its own board, and switching Workspaces swaps the whole thing: the panes, the tabs, which pane had focus. Splitting happens inside one board, so the panes are always different agents, files or diffs on the same folder. Two folders side by side is not a thing yet.
Splitting
Drag a tab onto the edge of a pane (the outer quarter, on any of the four sides) and that
pane splits. Left and right split it side by side, top and bottom one above the other; a corner
takes the nearer edge. Drop it in the middle instead, or on another pane’s tab bar, and the tab
just moves. ⌘← ⌘→ ⌘↑ ⌘↓ split the current tab off in that direction from the keyboard.
Up to four panes. After that the edge zones stop lighting up and everything lands in the middle. Since each split is free to go either way, you can end up with one tall pane on the left and three stacked on the right.
Drag a divider to resize; double-click it to go back to even. Dragging a tab within its own tab bar reorders it.
Close or drag away a pane’s last tab and the pane disappears; its neighbour takes over the space. The last pane never disappears, it just goes empty.
Focus
One pane has focus. Click a pane’s body or its tab bar to move it; the others fade one step, with no overlay and no desaturation.
Each agent pane has its own composer, so what you type goes to the tab you are typing in. Focus decides the rest:
Escstops the turn in the focused pane only.⌘Wcloses the focused pane’s current tab only.- Cite and
@land in the focused pane’s draft. - The
@list, the slash panel and the@new:card open on the focused pane only.
File and diff tabs have no composer. Cite from one of them goes to the agent this board last spoke to, and switches to its tab so you can see where it landed.
Clicking an agent somewhere else
Clicking a row in the AGENTS list, or a notification, takes you to that agent even if it is on a different folder: the board switches, then the tab is focused wherever it lives. If it is not in any pane, it goes into the focused one.
The sidebar
⌘B, or the button at the top of the sidebar, collapses the left column to nothing. With the
sidebar collapsed, move the pointer to the very left edge of the window and it floats back over
the board without pushing anything; move away and it goes.
Collapsed, agents that need you or have finished get a small pill in the bottom-left corner. It
names one (alpha needs you), counts several (3 Agents need you), and glows gently while there
is something in it. A soft chime plays when a new one arrives, once, however many finish at the
same moment.
Clicking the pill opens the list rather than jumping, because one click on a pill should not
silently change what is on screen. Click a row in that list to jump. A ‹ Back to alpha pill
appears underneath to take you back to exactly where you were; jump again and it remembers the
whole trail, × drops it. It disappears the moment you move on yourself.
Layout is remembered
Each Workspace’s split, focused pane and tab order are stored on this Mac, per Workspace, including file and diff tabs. Reopening Kumo puts you back where you were, unless what you were looking at is gone. Then you get an empty board rather than some other folder chosen for you.
Shortcuts
The ones you will use most:
⌘N | New agent |
⌘W | Close the current tab |
⌘1–⌘9 | Jump to a tab |
⌃⇥ / ⌃⇧⇥ | Next / previous tab |
⌘←→↑↓ | Split |
⌘L | Focus the composer |
⌘B | Sidebar |
⌘F ⌘G ⌘T ⇧⌘T | Files, Git, Terminal, Task panel |
Every command, and how to rebind it, is on Settings, keys & plans.