CLI
node plugins/concise/scripts/concise-config.mjs <command> [arguments] [options]In an installed plugin, the script is ${CLAUDE_PLUGIN_ROOT}/scripts/concise-config.mjs. It needs Node.js only.
| Command | Result |
|---|---|
show | The effective settings and every config layer file, with BEC_ overrides and load problems. |
keys [query] | The documented keys, defaults, and descriptions from configuration.md. |
get <key> | One key: its default, the effective value, and the value in each layer file. |
set <key> <value> | Sets a key. The value is JSON, or a plain string when it does not parse. |
unset <key> | Removes a key and any parent object left empty. |
add <key> <value> | Adds items to a list key. Items already in the list are skipped. |
remove <key> <value> | Removes items from a list key. |
validate | Validates every layer file and reports load problems. |
check [text] | Runs the checks over text from the argument, --file, or stdin. Retry and confirmation state stay unchanged. |
dict list | Dictionary entries and the layer that sets each one. |
dict add | Adds an entry from --value, --fix, --match, --on, --id, --hooks, --scopes, --flags, and --case-sensitive. |
dict remove <id> | Removes an entry from a layer. --disable switches off an entry that another layer sets. |
dict test [text] | Runs an entry built from the flags over text without saving it. |
tune <path>... | Proposes settings that fit writing samples. See Tuner. |
| Option | Meaning |
|---|---|
--cwd <dir> | Project directory. Default: the current directory. |
--layer <name> | project (default), user, or a layer id from show. |
--apply | Writes the change. Without it, edit commands print the diff only. |
--json | Prints the raw result. |
--scope, --hook, --path | The text scope, the hook to imitate, and the file path for check and dict test. |
--kind, --preset | The sample kind and the base preset for tune. |
--layer project writes the project file in effect. When no project file exists, it writes .claude/concise.json, or .codex/concise.json when only .codex/ exists. --layer user writes the user file in effect, else $XDG_CONFIG_HOME/concise/concise.json or ~/.config/concise/concise.json.
A write compares the file with the version the preview read. When the file changed in between, the write stops with Configuration changed on disk.
Exit status: 0 on success, 1 when check finds something or validate finds an invalid file, 2 on an error. Errors go to stderr as concise-config: <reason>.