Struct Settings 

pub struct Settings {
    pub default_provider: Option<String>,
    pub default_model: Option<String>,
    pub default_thinking_level: Option<String>,
    pub tools: Vec<String>,
    pub exclude_tools: Vec<String>,
    pub theme: Option<String>,
    pub verbose: bool,
    pub hide_thinking: Option<bool>,
    pub collapse_tool_output: Option<bool>,
    pub auto_compact: Option<bool>,
    pub compact_reserve_tokens: Option<u64>,
    pub compact_keep_recent_tokens: Option<u64>,
    /* private fields */
}

Settings schema matching pi’s settings.json format. API keys live in auth.json, not here.

Fields

default_provider: Option<String>

default_model: Option<String>

default_thinking_level: Option<String>

tools: Vec<String>

exclude_tools: Vec<String>

theme: Option<String>

verbose: bool

hide_thinking: Option<bool>

Hide thinking blocks (Ctrl+T toggle). Persisted to settings.json.

collapse_tool_output: Option<bool>

Collapse tool output (Ctrl+O toggle). Persisted to settings.json.

auto_compact: Option<bool>

Auto-compact enabled (Ctrl+Shift+C toggle).

compact_reserve_tokens: Option<u64>

Tokens to reserve for system prompt + tool defs + response.

compact_keep_recent_tokens: Option<u64>

Number of most-recent tokens to always keep.

Implementations

impl Settings

pub fn set_hide_thinking(&mut self, value: Option<bool>)

Set hide_thinking and mark it as modified.

pub fn set_collapse_tool_output(&mut self, value: Option<bool>)

Set collapse_tool_output and mark it as modified.

pub fn set_default_thinking_level(&mut self, value: Option<String>)

Set default_thinking_level and mark it as modified.

pub fn set_auto_compact(&mut self, value: Option<bool>)

Set auto_compact and mark it as modified.

pub fn set_compact_reserve_tokens(&mut self, value: Option<u64>)

Set compact_reserve_tokens and mark it as modified.

pub fn set_compact_keep_recent_tokens(&mut self, value: Option<u64>)

Set compact_keep_recent_tokens and mark it as modified.

pub fn load(cwd: &Path) -> Result<Self>

Load settings from the global agent config path and project-local path.

pub fn load_from(global_path: PathBuf, cwd: &Path) -> Result<Self>

Load settings with an explicit global config path (for testing).

pub fn save(&mut self) -> Result<()>

Save only the modified fields to the global config path. Unmodified fields are never written, preventing project-level overrides and default values from leaking into the global file.

After a successful save, modified_fields is cleared so that subsequent saves only write fields that changed since the last write. This prevents stale modifications from being re-applied when a different field is toggled later.

Uses file locking (flock on the .json.lock file) to prevent corruption when multiple rab processes access the same file. Atomic write via temp-file + rename prevents partial writes.

pub fn save_to(&mut self, path: PathBuf) -> Result<()>

Save only the modified fields to a specific path (for testing). Uses file locking and atomic write (temp file + rename).

pub fn reload(&mut self, cwd: &Path) -> Result<()>

Reload settings from disk (re-reads global + project). Clears modified_fields since the freshly loaded settings are unmodified.

pub fn model(&self) -> &str

Resolved model name (defaults to deepseek-v4-flask).

Trait Implementations

impl Clone for Settings

fn clone(&self) -> Settings

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Settings

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Settings

fn default() -> Settings

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Settings

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Settings

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.