Keys and actions commands

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 resolved action, mode, source layer, and whether another binding shadows it.

Find conflicts

koshi keys conflicts

Reports duplicate sequences, shorter prefixes that make longer bindings unreachable, reserved unlock problems, and warnings.

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 supported bindable actions. Actions seeded for future versions stay hidden until implemented.

Explain one action

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

Shows canonical name, description, scope, accepted targets, and examples. Action references need their namespace: core:new-pane, not new-pane.