Tabs
Create, close, switch, and reorder koshi tabs with keys or shell commands, by name or by id.
A tab owns one pane layout. Each client chooses which tab it is viewing.
Create and close
| Keys | Result |
|---|---|
| <C-t> n | Create a tab with one shell pane |
| <C-t> x | Close the current tab |
koshi new-tab
koshi new-tab --client <CLIENT_ID>
koshi close-tab --tab <NAME_OR_ID>
koshi close-tab --tab <NAME_OR_ID> --forcenew-tab prints the new tab id, then its root pane id. --client chooses the
attached terminal that switches onto the new tab. 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. Closing the last tab ends the session.
Name or id
--tab takes the tab's generated name or its printed tab-<uuid> id. A value
that reads as an id is used as an id and never looked up as a name. A name that
several tabs share is refused, and the error lists every matching id.
Switch
| Keys | Result |
|---|---|
| Tab | Next tab |
| Shift+Tab | Previous tab |
koshi next-tab
koshi previous-tab
koshi focus-tab --index 0
koshi focus-tab --tab <NAME_OR_ID>Tab indexes are zero-based. Focus is per client; pass --client when choosing
which attached terminal to move.
Reorder
koshi move-tab --tab <NAME_OR_ID> --index 0move-tab changes session order without changing the tab's pane layout. The
order belongs to the session, so every attached terminal sees the move.