Default keymap
The default shortcuts for opening, moving, resizing, and closing panes, tabs, and sessions.
The default leader is the Ctrl modifier run, so <leader>p becomes
<C-p>.
Normal mode
| Keys | Action |
|---|---|
| <C-l> | Lock input |
| <C-q> | Quit — leave the session, which keeps running |
| <C-g> | Toggle mouse-selection mode |
| <C-p> n | New pane in configured direction |
| <C-p> h | New pane left |
| <C-p> j | New pane below |
| <C-p> k | New pane above |
| <C-p> l | New pane right |
| <C-p> s | New pane in the focused pane's stack |
| <C-p> m | Move an existing pane |
| <C-p> x | Close pane and its process tree |
| <C-p> ←↓↑→ | Focus nearby pane |
| <C-s> ←↓↑→ | Resize pane one cell |
| <C-t> n | New tab |
| <C-t> x | Close tab |
| Alt+f | Toggle pane fullscreen |
| Tab | Next tab |
| Shift+Tab | Previous tab |
Focus and resize actions repeat from an open prefix: <C-s> ← ← ← moves the border three cells.
Move a pane
After <C-p> m, use these keys to preview a move:
| Keys | Result |
|---|---|
| ←↓↑→ | Choose a pane to swap with |
| Shift+←↓↑→ | Choose an edge to insert beside a pane or stack |
| Space | Cycle split spans |
| Tab / Shift+Tab | Preview the next / previous visible tab |
| Enter | Accept the move |
| Esc | Cancel the preview |
The preview appears only on the client that started the move. Every attached client sees the changed layout after it is accepted. You can also drag a pane; hold Shift when starting the drag to insert it beside the target.
<C-q> detaches this terminal; it never ends a session on its
own. With auto-close-session #true, it ends the session when no other
terminal is attached. To end a session whatever that setting says, run
koshi kill-session.
Locked mode
| Keys | Action |
|---|---|
| <C-l> | Unlock input |
| <C-q> | Quit — leave the session |
| <C-g> | Toggle mouse-selection mode |
| <C-p> m | Move an existing pane |
Every other key passes to the focused program.
Inspect effective bindings
User config can replace or remove defaults. Check the merged result:
koshi keys list
koshi keys list --mode normal
koshi keys list --scope default
koshi keys list --scope userSee keybinding.kdl to customize it.