Jeden/Docs

CLI command

jeden config unset

Remove one setting from the user configuration, so the file says nothing about it again.

Exact invocation#

Shell
jeden config unset <key> [--json]

Inputs and options#

  • Required: an exact schema key. Optional: --json for the key, whether anything was removed, the value it reads now, type, description, and path.

Output and state effect#

Deletes the nested user key and any object the deletion leaves empty, atomically writes the user config, and reports the schema default the key reads again. This is the difference from config reset, which writes the default into the file: after unset the key is absent, so a later change of the schema default applies. Removing a key that was never written is reported as &lt;key&gt; was not written in &lt;path&gt; and is not an error.

Refusals and boundaries#

  • key-missing, key-unknown and argument-unexpected, exit 2, before any file is read; then the causes of jeden.config.write listed on the config set page.
  • A command line of the wrong form (an unknown command or option, a missing, unexpected or invalid argument, a missing confirmation) prints the error and the usage and exits 2; a refusal that retrying unchanged can help (a dependency down or not answering, a rate limit) exits 69; any other refusal or failure exits 1. A refusal a functionality declares ends with fix: … and cause: &lt;operation&gt;.&lt;cause&gt;, and jeden errors show &lt;operation&gt; lists every cause of that functionality.