Keys and actions commands

Keys belong to the terminal you run these from — they read that terminal's keybinding.kdl.

List shortcuts

koshi keys list
koshi keys list --mode normal
koshi keys list --scope default
koshi keys list --scope user

--mode filters one mode. --scope separates built-in bindings from user overrides.

Describe one sequence

koshi keys describe "<C-p> l"

Shows the mode, the action with its display name and description, its scope and arguments, the layer it comes from (defaults or your keybinding.kdl), and whether it repeats from an open prefix. A sequence that binds nothing in any mode is refused.

Find conflicts

koshi keys conflicts

Reports duplicate sequences, shorter prefixes that make longer bindings unreachable, reserved unlock problems, and warnings. A clean keymap prints verdict: apply.

Validate a file

koshi keys validate path/to/keybinding.kdl

Parses and checks a keybinding file without adopting it.

List actions

koshi actions list
koshi actions list --format json

Lists every action with its internal command and scope.

Explain one action

koshi actions explain core:new-pane
koshi actions explain core:new-pane --format json

Shows the action's name, description, scope, accepted targets, internal command, and examples. It takes a bare name (new-pane) or a full reference (core:new-pane). A binding in keybinding.kdl needs the full reference.