# Keys and actions commands (/docs/v0.1/cli/keys-and-actions)



## List shortcuts [#list-shortcuts]

```bash
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 [#describe-one-sequence]

```bash
koshi keys describe "<C-p> l"
```

Shows the resolved action, mode, source layer, and whether another binding
shadows it.

## Find conflicts [#find-conflicts]

```bash
koshi keys conflicts
```

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

## Validate a file [#validate-a-file]

```bash
koshi keys validate path/to/keybinding.kdl
```

Parses and checks a keybinding file without adopting it.

## List actions [#list-actions]

```bash
koshi actions list
koshi actions list --format json
```

Lists supported bindable actions. Actions seeded for future versions stay
hidden until implemented.

## Explain one action [#explain-one-action]

```bash
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`.