Tab commands

--tab and --session take a generated name or a printed id. A value that reads as an id is used as an id and never looked up as a name.

new-tab

koshi new-tab
koshi new-tab --session <NAME_OR_ID>
koshi new-tab --client <CLIENT_ID>

Creates one tab with one shell pane. Output contains the tab id first, then the root pane id. --client names the attached terminal that switches to the new tab. With several terminals attached, name a client when the command needs to change one terminal's view.

close-tab

koshi close-tab
koshi close-tab --tab <NAME_OR_ID>
koshi close-tab --tab <NAME_OR_ID> --session <NAME_OR_ID> --force

Closing a tab closes every pane and process inside it. Closing the last tab ends the session. --force skips the normal close guard.

Cycle tabs

koshi next-tab
koshi previous-tab
koshi next-tab --client <CLIENT_ID>

Cycling changes one client's view. --client chooses the attached terminal.

Focus one tab

koshi focus-tab --index 0
koshi focus-tab --tab <NAME_OR_ID>
koshi focus-tab --tab <NAME_OR_ID> --client <CLIENT_ID>

--index is zero-based. Use either --index or --tab.

Reorder

koshi move-tab --index 0
koshi move-tab --tab <NAME_OR_ID> --index 2

Moves the chosen tab to a zero-based index without changing its pane layout. The order belongs to the session, so every attached terminal sees the move.