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, 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.