Koshi 0.6.0 — Default keymap

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>` `f`	New floating pane
`<C-p>` `u`	Float the focused pane, or dock it when it floats
`<C-p>` `i`	Pin or unpin the focused floating pane
`<C-p>` `Tab` / `Shift+Tab`	Show and focus the next / previous floating pane
`<C-p>` `w`	Open or close the floating pane tray
`<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
`Alt+n`	Open or close the notification center
`Tab`	Next tab
`Shift+Tab`	Previous tab

Focus, resize, and floating-pane focus actions repeat from an open prefix: <C-s> ← ← ← moves the border three cells, and <C-p> Tab Tab steps two floating panes. Esc closes the prefix.

Move a pane

<C-p> m opens the move preview for tiled panes. When this client shows a floating pane it did not pin, it first opens a chooser (MOVE):

Keys	Result
`t`	Move a tiled pane
`f`	Move a floating pane
`Enter`	Move the focused floating pane, or a tiled pane when a tiled pane is focused
`Esc`	Cancel

In the tiled move preview:

Keys	Result
`←↓↑→`	Choose a pane to swap with
`Shift+←↓↑→`	Choose an edge to insert beside a pane or stack
`s`	Switch the target between the pane and its 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.

In floating pane move mode (MOVE FLOAT):

Keys	Result
`←↓↑→`	Move the selected floating pane one cell
`Tab` / `Shift+Tab`	Select the next / previous floating pane
`Enter`	Accept the move
`Esc`	Discard the move

A floating pane move changes only this client's view.

Floating pane tray

After <C-p> w (TRAY):

Keys	Result
`←↓↑→`	Select a tile
`Enter`	Minimize a shown pane, show a minimized one, or create a pane on `+ new`
`a`	Minimize every floating pane this client shows, or show them all when none shows
`Esc` or `<C-p>` `w`	Close the tray

Notification center

After Alt+n (NOTIFICATIONS):

Keys	Result
`↑` / `↓`	Select a newer / older notification
`x`	Dismiss the selected notification
`c`	Clear every notification and close
`Esc` or `Alt+n`	Close the center

<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

Every other key passes to the focused program. A locked client can start a move by dragging a pane's grab handle.

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 user

See keybinding.kdl to customize it.

Default keymap