Struct Settings 

pub struct Settings {

    pub version: u32,
    pub thinking_level: ThinkingLevel,
    pub theme: String,
    pub default_model: Option<String>,
    pub default_provider: Option<String>,
    pub max_tokens: Option<u32>,
    pub temperature: Option<f32>,
    pub default_temperature: Option<f64>,
    pub max_response_tokens: Option<usize>,
    pub session_history_size: usize,
    pub session_dir: Option<PathBuf>,
    pub stream_responses: bool,
    pub extensions_enabled: bool,
    pub auto_compaction: bool,
    pub tool_timeout_seconds: u64,
    pub extensions: Vec<String>,
    pub skills: Vec<String>,
    pub prompts: Vec<String>,
    pub themes: Vec<String>,
}

Application settings

Fields

version: u32

Settings format version. Used for automatic migration.

thinking_level: ThinkingLevel

Thinking level for agent responses

theme: String

Color theme (e.g., “default”, “monokai”, “dracula”)

default_model: Option<String>

Default model to use (e.g., “anthropic/claude-sonnet-4-20250514”)

default_provider: Option<String>

Default provider to use (e.g., “anthropic”, “openai”)

max_tokens: Option<u32>

Max tokens for responses

temperature: Option<f32>

Temperature for generation (0.0–2.0)

default_temperature: Option<f64>

Default temperature as f64 (higher precision, takes precedence over temperature)

max_response_tokens: Option<usize>

Maximum tokens for generation (usize variant, takes precedence over max_tokens)

session_history_size: usize

Session history size (entries to keep in memory)

session_dir: Option<PathBuf>

Directory for storing sessions (default: ~/.oxi/sessions)

stream_responses: bool

Whether to stream responses

extensions_enabled: bool

Whether extensions are enabled

auto_compaction: bool

Whether to auto-compact conversations that exceed context window

tool_timeout_seconds: u64

Timeout in seconds for tool execution

extensions: Vec<String>

List of extension paths or npm package sources to load

skills: Vec<String>

List of skill paths or npm package sources to load

prompts: Vec<String>

List of prompt template paths to load

themes: Vec<String>

List of theme paths to load

Implementations

impl Settings

pub fn settings_dir() -> Result<PathBuf>

Get the global settings directory path (~/.oxi).

pub fn settings_toml_path() -> Result<PathBuf>

Get the global settings TOML file path (~/.oxi/settings.toml).

pub fn settings_json_path() -> Result<PathBuf>

Get the global settings JSON file path (~/.oxi/settings.json).

pub fn settings_path() -> Result<PathBuf>

Get the global settings file path (JSON takes priority).

Returns the path to the settings file that should be used. If both JSON and TOML exist, JSON is returned (takes priority). If only one exists, that path is returned. If neither exists, returns the JSON path by default.

pub fn settings_path_with_preference(prefer_json: bool) -> Result<PathBuf>

Get the effective settings file path, preferring the specified format.

If prefer_json is true, checks JSON first; otherwise checks TOML first. Returns the first existing file, or the preferred path if neither exists.

pub fn detect_format(path: &Path) -> SettingsFormat

Detect the settings file format from its path.

pub fn find_project_settings(start_dir: &Path) -> Option<PathBuf>

Get the project-local settings file path.

Searches for .oxi/settings.json first, then .oxi/settings.toml. Returns the first one found, or None if neither exists.

pub fn effective_session_dir(&self) -> Result<PathBuf>

Resolve the effective session directory.

Priority: session_dir field → $OXI_SESSION_DIR → ~/.oxi/sessions.

pub fn load() -> Result<Self>

Load settings, applying all layers:

1. Built-in defaults
2. Global ~/.oxi/settings.toml
3. Project .oxi/settings.toml
4. Environment variable overrides

pub fn load_from(dir: &Path) -> Result<Self>

Load settings with an explicit working directory for project config discovery.

pub fn load_from_cwd() -> Result<Self>

Convenience: load from current working directory.

pub fn apply_env(&mut self)

Apply environment variable overrides in-place.

Supported variables:

Env var	Setting
OXI_MODEL	default_model
OXI_PROVIDER	default_provider
OXI_THINKING	thinking_level
OXI_THEME	theme
OXI_MAX_TOKENS	max_tokens
OXI_TEMPERATURE	default_temperature
OXI_SESSION_DIR	session_dir
OXI_STREAM	stream_responses
OXI_EXTENSIONS_ENABLED	extensions_enabled
OXI_AUTO_COMPACTION	auto_compaction
OXI_TOOL_TIMEOUT	tool_timeout_seconds

pub fn from_env() -> Self

Build a Settings instance from only environment variables (all other fields stay at defaults).

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

Save settings to the global config file.

Uses the format of the existing file if present, otherwise saves as JSON. Preserves backward compatibility with existing TOML files.

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

Save settings to a specific path, using the format determined by the file extension.

pub fn save_project(&self, project_dir: &Path) -> Result<()>

Save settings to the project-local config file.

Uses the format of the existing file if present, otherwise saves as JSON.

pub fn serialize_for_format( settings: &Settings, format: SettingsFormat, ) -> Result<String>

Serialize settings to a string in the specified format.

pub fn parse_from_str(content: &str, format: SettingsFormat) -> Result<Settings>

Parse settings from a string in the specified format.

pub fn merge_cli(&mut self, model: Option<String>, provider: Option<String>)

Merge with CLI arguments (CLI takes precedence).

pub fn effective_model(&self, cli_model: Option<&str>) -> String

Get the effective model ID (provider/model format).

pub fn effective_provider(&self, cli_provider: Option<&str>) -> String

Get the effective provider.

pub fn effective_temperature(&self) -> Option<f64>

Get the effective temperature, preferring default_temperature (f64) over temperature (f32), falling back to None.

pub fn effective_max_tokens(&self) -> Option<usize>

Get the effective max tokens, preferring max_response_tokens (usize) over max_tokens (u32), falling back to None.

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() -> Self

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.