CLI command
jeden config set
Validate and persist one user configuration setting.
Exact invocation#
jeden config set <key> <value> [--json]Inputs and options#
- Required: exact schema key and value. Multi-token values are joined with spaces before type parsing; JSON arrays and records must be valid JSON. A boolean setting takes
trueorfalse. - Use
contracts.communicationto say how Jeden writes to you: your text replaces Jeden's default (plain language, then what was done, blockers, next steps) andnoneturns it off. Usecontracts.functionalityfor execution and completion instructions; quote each contract as one shell argument. - Use
communication.modeto choosenormal,debug, orquiet, andcommunication.toolCalls,communication.toolResults,communication.reasoning, orcommunication.codewithauto,show, orhideto override one item. A configuration file that names any other value is refused when it loads, naming the value and the ones there are. - Use
ui.languageto pin the language of Jeden's screens (picker, settings, badges, footers and the GitHub star request) to one of the fleet's languages, the list every Wisent product offers (wisent-textslanguages.json), orautofor English; every screen text reads in each of them, and a test fails the build when a language lacks one or a translation drops a placed value. - Automatically discovered secret-named environment values are protected regardless of their length unless you explicitly set
secrets.minLengthto a nonnegative whole byte length. A threshold deliberately leaves shorter discovered values unprotected; explicitly configured values, environment names and secret files remain protected.jeden config reset secrets.minLengthremoves the threshold by restoringnull. The shared setting schema used by the terminal and RPC settings reports that unset default.secrets.moderedactputs the configured replacement in place of each secret;obfuscateputs one*per character, keeping only its length. taskScheduler.maxOutputBytesis the declared output budget for delegated jobs, including the platform command that merges a captured workspace into its parent. Merge diagnostics use this same setting rather than a separate hidden byte ceiling. The CLI configuration, Desktop Settings → Delegated tasks and RPCconfig/task-limits/setupdate the same declaration.
Output and state effect#
Parses the schema type, updates the nested user configuration object, atomically writes the user config, and prints the key/path or structured mutation result. A non-empty contract is added to every new or rebuilt system prompt; a communication setting applies from the next turn, including in a running session.
Refusals and boundaries#
- Read before any file:
key-missing,key-unknown,value-missing(config set requires a value for <key>, and the command line ends after the key, observed: what the key takes) andvalue-invalid(<key> takes <what it takes>, and `<value>` is not that, observed: what the reader answered), each exit2: an invalid boolean, a number that is not finite, a value outside an enum's choices, JSON that is not an array or object where one is taken, or task limitsconfig/task-limits/setwould refuse.type-unreadable(exit1) guards a schema type without its reader. - Writing is
jeden.config.write, shared withjeden workspace adopt|forgetand RPCconfig/language/set; each refusal exits1and leaves the files as they were:table-occupied(a key on the way holds a value that is not a table; it is not replaced),config-unmigratable(the file cannot be brought to this build's schema version, such as one a newer Jeden wrote),config-unwritable(the file could not be replaced whole, with what the system answered) andlegacy-unremovable(the superseded~/.jeden/config.jsoncould not be removed after its keys moved). secrets.minLengthrefuses negative, fractional and nonnumeric values before writing. The real redaction journey isnode tests/secrets/discovery.mjswithJEDEN_BIN,JEDEN_TEST_SOURCE_REVISION,JEDEN_TEST_STADOandJEDEN_TEST_SECRET_MIN_LENGTHabove the synthetic secret's byte length. Each case runs under its own HOME, where the model is played through Stado's attestation alternative and answers the value it was handed between the delimiters, so the final answer shows whether Jeden redacted the secret before the request left. It checks a short discovered secret, an explicit threshold, an explicit protected value, reset and invalid-setting refusal; commands, replies and session exports remain under.build/secret-discovery.- 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) exits69; any other refusal or failure exits1. A refusal a functionality declares ends withfix: …andcause: <operation>.<cause>, andjeden errors show <operation>lists every cause of that functionality.