Sessions & Panes
Splits, focus, resize, zoom, swap, rotate, and pane numbers.
Kumo manages panes as a binary split tree: every split divides a pane into
two, vertically or horizontally. Sessions are independent webs of panes, and
the sidebar's project layout (default) lists every worktree flat —
session name with its branch dimmed and every agent inline — the active
worktree expanded with all agents sharing its block highlight, inactive
minimized to one line. Drag the sidebar's right edge to resize (20–50 cols).
The classic SESSIONS/AGENTS panels remain via [sidebar] layout = "divided" | "tabs".
Pane operations
All operations live behind the leader key (Ctrl+B by default):
| Keys | Action |
|---|---|
| leader+v | Split the focused pane vertically |
| leader+- | Split the focused pane horizontally |
| leader+h/j/k/l | Move focus left/down/up/right |
| leader+Tab | Cycle focus between panes |
| leader+H/J/K/L | Resize the focused pane |
| leader+z | Zoom the focused pane |
| leader+s | Swap the focused pane with its sibling |
| leader+o | Rotate the pane layout |
| leader+q | Show pane numbers — press a number to jump |
| leader+x | Close the focused pane |
Mouse gestures
Mouse gestures are positional hit-testing, not key sequences — they are deliberately not remappable:
- 🖐️ Drag selects text (copied on release) — works even in apps with mouse reporting.
- 👆 Click is forwarded to the app when it owns the mouse.
- 🎚️ Scroll is forwarded to reporting apps; otherwise it scrolls the pane's scrollback.
- ↔️ Drag a splitter to resize.
- 🧭 The MENU button (right of the mode chip in the status bar) opens a
dropdown with
keybinds(the same showcase as leader+?) andexit.
Sessions
| Keys | Action |
|---|---|
| leader+c | Create a new session (name it in the popup) |
| leader+n / leader+p | Next / previous session |
| leader+1…9 | Jump to the session at that sidebar position |
| leader+b | Toggle the sidebar |
From the sessions list you can also create and open git worktrees directly.
Tabs
Tabs (windows) let one session hold several named pane trees. Use
kumo tab list, kumo tab new, kumo tab focus, kumo tab rename, and
kumo tab kill to manage them, or use the tab bar in the TUI.