Expand description
Settings system - Persistent user preferences
Settings are stored at ~/.codewhale/settings.toml, with legacy fallbacks.
There is one persisted settings store. The historical tui.toml second
store is folded into it on load and moved aside with a receipt — see
TuiPrefsMigration.
Structs§
- Agent
Quota Setting - Agent
Settings - Pinned
Model - User settings with defaults
- Settings
- Settings
Transaction - Proof that the caller is inside the settings critical section.
- TuiPrefs
Migration - What the one-time
tui.tomlfold did, so a session can say it out loud.
Enums§
- Inline
Diff Mode - How successful structured file mutations are represented in the live transcript. Exact evidence is retained for inspection in every mode.
- Motion
Override - The runtime overlay that forces
low_motionon, when one wins over the persisted value. Mirrors the precedence ofSettings::apply_env_overridesso a settings surface can name the real owner instead of calling a forced value “saved”.
Constants§
- AGENT_
QUOTA_ KEY_ PREFIX - CALM_
PRESET_ FIELDS - The
calmtranscript preset (#3478): a coherent “beautiful/calm” bundle that favors a quiet, readable transcript over debug-dense output. Presentation only, and evidence-preserving —show_thinkingis deliberately left untouched (thinking stays visible) and tool runs only have their inline detail collapsed, never hidden. Keyed bySettings::setnames so the preset and a single-key/configset share one validation path. - WORK_
SURFACE_ TOP_ HEIGHT_ MAX - WORK_
SURFACE_ TOP_ HEIGHT_ MIN - Smallest Top work surface that can show its divider plus the compact goal / to-do / Agent projection without turning the rail into invisible keyboard state. Older releases accepted two rows, which left only one content row and could hide every actionable item behind the goal title.
Functions§
- detect_
low_ motion_ override - Detect which runtime overlay forces
low_motion, in the orderSettings::apply_env_overridesapplies them. - detected_
legacy_ windows_ console_ host - Returns
truefor the unmarked Windows console-host path used by plain PowerShell / cmd.exe. Modern Windows terminals set at least one marker that lets us keep the richer rendering path. - detected_
ptyxis_ terminal - Returns
truewhen the active terminal is Ptyxis (the new default terminal on Ubuntu 26.04). Used bySettings::apply_env_overridesto flipsynchronized_outputfromautotooffso DEC mode 2026 flicker on Ptyxis 50.x + VTE 0.84.x stops at the source. - preset_
fields - The
(key, value)fields a named preset applies, orNonefor an unknown name. Single source of truth shared bySettings::apply_presetand the/config presetcommand so the bundle is never defined twice. - with_
settings_ transaction - Run
operationas one whole-file settings critical section.