Core

Configuration

Jeden combines operator environment, user preferences, project settings, and discovered instructions without blurring their precedence.

Precedence

Environment variables win over file configuration.
Project config at <cwd>/.jeden/config.json overrides user config.
User config loads from ~/.jeden/config.json and ~/.jeden/config.yml.
Built-in defaults apply when no value is supplied.

Configuration commands

$ jeden config list --json --cwd .
$ jeden config path --cwd .
$ jeden config get tools.approvalMode
$ jeden config set tools.approvalMode write
$ jeden config reset tools.approvalMode

Native settings

Key	Default and purpose
tools.approvalMode	`always-ask`. Allowed values: `always-ask`, `write`, `yolo`.
commands.enableClaudeUser	`true`. Load commands from `~/.claude/commands`.
commands.enableClaudeProject	`true`. Load commands from `.claude/commands`.
commands.enableOpencodeUser	`true`. Load commands from `~/.config/opencode/commands`.
commands.enableOpencodeProject	`true`. Load commands from `.opencode/commands`.
startup.showSplash	`false`. Show the startup animation.
startup.quiet	`false`. Suppress startup chrome.
context.maxBytes	`131072`. Maximum UTF-8 bytes loaded from discovered context.
context.maxTokens	`32768`. Approximate context token budget.
rules.alwaysApply	`[]`. Sticky typed rules injected whenever the system prompt is rebuilt.
secrets.mode	`redact`. Choose `redact` or `obfuscate` for known model-bound secrets.
secrets.minLength	`8`. Minimum automatically discovered environment-secret length.
secrets.discoverEnvironment	`true`. Protect secret-named environment values.

Discovered context

User context loads from ~/.jeden/instructions.md and ~/.jeden/context.md. Project discovery walks ancestors down to --cwd and reads:

JEDEN.mdAGENTS.mdCLAUDE.mdRULES.md.jeden/instructions.md.jeden/context.md

A context line such as @./extra.md imports another file under the same context root. Imports remain within that root; oversized files are skipped.