CLI Reference

The CLI exposes user tasks, not internal conversion stages. Most users need:

jue init
jue apply --all
jue apply --adapter claude --scope user

Core commands

Command	Purpose	Default side effect
jue init	Create minimal project config	Write config
jue apply	Diff and produce Artifacts	Write changes
jue inspect	Explain Presets, Capabilities, Adapters, and Artifacts	None

apply performs validation, comparison, and writing:

• preview: jue apply --dry-run
• CI: jue apply --check
• user installation: jue apply --adapter claude --scope user
• diagnostics: jue inspect --diagnostics

Author commands

Namespace	Subcommands
jue capability	update
jue preset	Planned: create, validate, pack
jue extension	validate

Resource queries use jue list [presets|prompts|skills|all] (list Preset, prompt, and skill inventories) and jue inspect --extension <id> (Extension diagnostics).

Global options

Option	Meaning
--lang (alias -l)	Runtime language override (e.g. en, zh)
--verbose (alias -v)	Log Adapter decisions and detailed output

Exit codes

Code	Meaning
0	Success, or --check found no required change
1	Config validation failure, internal error, or apply rollback
2	Unsupported Artifact kind or scope
3	Drift, ownership, or write conflict
4	Required action not approved

See implementation status for gaps between this target contract and current code.