Quick start

Open a koshi session, split a pane, add a tab, and quit — the whole loop in a minute.

Open a session

koshi

That gives you one tab with one shell pane. The bar at the top lists tabs; the bar at the bottom shows key hints once a shortcut is pending.

Split a pane

The default leader is Ctrl. Press the leader chord, then the direction:

Keys	Result
`<C-p>` `l`	Open a pane to the right
`<C-p>` `h`	Open a pane to the left
`<C-p>` `j`	Open a pane below
`<C-p>` `k`	Open a pane above
`<C-p>` `n`	Open a pane in the configured direction

A new pane inherits the working directory of the pane you split from.

Move around and resize

Keys	Result
`<C-p>` `←↓↑→`	Focus a nearby pane
`<C-s>` `←↓↑→`	Move the pane border one cell
`Alt+f`	Fill the tab with the focused pane, and back
`<C-p>` `x`	Close the pane and its process tree

Add a tab

Keys	Result
`<C-t>` `n`	Open a tab
`Tab` / `Shift+Tab`	Next / previous tab
`<C-t>` `x`	Close the tab

Get out of the way

When a program needs the keys koshi is holding, lock input with <C-l>. Every keystroke then goes straight to the program until you unlock. <C-q> quits koshi.

See the live keymap

koshi keys list
koshi actions list

Nothing above needs a config file. When you want to change it, start at Configuration.

Start from a saved layout

Write a profile once and open the whole desk with one command:

koshi --profile dev

See Profiles.