Pane commands

Inside koshi, omitted targets use the current session, tab, pane, or client. Outside koshi, pass a target unless exactly one running session can be chosen.

new-pane

Open a shell pane:

koshi new-pane
koshi new-pane --direction left
koshi new-pane --stacked

Main flags:

--direction and --stacked are alternatives. The command prints one pane id.

A new pane's working directory and environment come from the terminal that issued the command.

run

Open a pane running one command:

koshi run -- htop
koshi run --direction down -- cargo watch -x test

Placement flags match new-pane. Everything after -- is the command and its arguments. The command prints one pane id.

close-pane

koshi close-pane
koshi close-pane --pane <PANE_ID>
koshi close-pane --pane <PANE_ID> --force

Closing the last pane closes its tab. --force skips the normal close guard.

resize-pane

koshi resize-pane --direction right
koshi resize-pane --direction left --size 4 --pane <PANE_ID>
koshi resize-pane --direction right --size -2

Directions are right, down, left, and up. A positive size grows toward that direction; a negative size shrinks from that side.

focus-pane

koshi focus-pane --pane <PANE_ID>
koshi focus-pane --pane <PANE_ID> --client <CLIENT_ID>

Focus belongs to a client. --client chooses which attached terminal moves.

toggle-pane-fullscreen

koshi toggle-pane-fullscreen

Fill the current tab with its focused pane, or restore the prior layout. The fullscreen view belongs to one client.

input

koshi input --pane <PANE_ID> "cargo test"
koshi input --pane <PANE_ID> --no-enter "git status"

Text is followed by Enter unless --no-enter is present. Input reaches only panes visible to the issuing client.