Pane commands
Create, run, close, resize, focus, fullscreen, and write to panes from any shell.
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 --stackedMain flags:
| Flag | Meaning |
|---|---|
--direction right|down|left|up | Place the new pane beside its target |
--stacked | Add it to the target's stack |
--pane <PANE_ID> | Split this pane |
--tab <TAB> | Create inside this tab |
--session <SESSION> | Choose the session |
--client <CLIENT_ID> | Use this client's current view |
--direction and --stacked are alternatives. The command prints one pane id.
run
Open a pane running one command:
koshi run -- htop
koshi run --direction down -- cargo watch -x testPlacement 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> --forceClosing 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 -2Directions 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-fullscreenFill the current tab with its focused pane, or restore the prior layout.
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.