Config commands

Find the directory

koshi config path

Prints the config directory for the current platform.

Explain a setting

koshi config explain koshi.pane.min-cols
koshi config explain keybinding.chord-timeout-ms
koshi config explain theme.colors.accent
koshi config explain profile.version

Keys include their file kind. An unknown key exits with a usage error and suggests the nearest known key.

Check every file

koshi config check

Scans:

koshi.kdl
keybinding.kdl
themes/*.kdl
profile/*.kdl

It reports all read and schema errors together and changes nothing. Each path must be a regular file or a symlink to one.

Migrate schemas

koshi config migrate

Migration validates every file before writing, applies each registered version step in order, and validates after each step. Bad KDL, bad values, or a missing step stops the run before any file is written.

Changed files use atomic replacement one at a time. Symlinks remain symlinks and their targets change. A write error lists files already completed and marks the failed file as possibly changed.

Current schema version is 1, so valid version 1 files stay unchanged.