Keybindings
Actions
Built-in action names available to keybindings and how to inspect their scope and targets.
A binding names a full action reference such as core:new-pane-right. Run:
koshi actions list
koshi actions explain core:new-pane-rightlist shows actions implemented by the running version. explain shows one
action's description, scope, accepted targets, and related CLI command.
Pane actions
| Action | Result |
|---|---|
core:new-pane | New shell pane in configured direction |
core:new-pane-left | New shell pane left |
core:new-pane-down | New shell pane below |
core:new-pane-up | New shell pane above |
core:new-pane-right | New shell pane right |
core:new-pane-stacked | Add shell pane to focused stack |
core:run | Run a command in a new pane |
core:close-pane | Close focused pane |
core:close-pane-tree | Close pane and every process it started |
core:resize-pane | Resize along an explicit edge |
core:resize-pane-left | Move border left |
core:resize-pane-down | Move border down |
core:resize-pane-up | Move border up |
core:resize-pane-right | Move border right |
core:focus-pane | Focus an explicit pane |
core:focus-pane-left | Focus pane left |
core:focus-pane-down | Focus pane below |
core:focus-pane-up | Focus pane above |
core:focus-pane-right | Focus pane right |
core:toggle-pane-fullscreen | Toggle focused-pane fullscreen |
core:write-to-pane | Send text to a pane |
Tab, session, and client actions
| Action | Result |
|---|---|
core:new-tab | Create tab |
core:close-tab | Close focused tab |
core:focus-tab | Focus explicit tab |
core:next-tab | Focus next tab |
core:previous-tab | Focus previous tab |
core:move-tab | Move tab to another index |
core:lock | Enable pass-through lock mode |
core:unlock | Disable pass-through lock mode |
core:toggle-lock | Toggle pass-through lock mode |
core:mouse-select | Toggle mouse-selection mode |
core:quit | End koshi |
Binding rules
Write the namespace: core:new-tab, not new-tab. Bindings accept no action
arguments. Fixed choices belong in the action name; open values such as a pane
id, tab index, or text belong to the CLI.
version 1
mode "normal" {
bind "<A-h>" "core:focus-pane-left"
bind "<A-l>" "core:focus-pane-right"
}