koshi0.1.0
Using koshi

Tabs

Create, close, switch, and reorder koshi tabs with keys or shell commands.

A tab owns one pane layout. Each client chooses which tab it is viewing.

Create and close

KeysResult
<C-t> nCreate a tab with one shell pane
<C-t> xClose the current tab
koshi new-tab
koshi close-tab --tab <TAB_ID>
koshi close-tab --tab <TAB_ID> --force

new-tab prints the new tab id, then its root pane id. Inside koshi, an omitted session means the current one. Outside koshi, pass --session unless exactly one session is running.

Closing a tab closes every pane and process inside it.

Switch

KeysResult
TabNext tab
Shift+TabPrevious tab
koshi next-tab
koshi previous-tab
koshi focus-tab --index 0
koshi focus-tab --tab <TAB_ID>

Tab indexes are zero-based. Focus is per client; pass --client when choosing which attached terminal to move.

Reorder

koshi move-tab --tab <TAB_ID> --index 0

move-tab changes session order without changing the tab's pane layout.

On this page