Struct Config 

pub struct Config {

    pub theme: Option<String>,
    pub hide_thinking_block: Option<bool>,
    pub show_hardware_cursor: Option<bool>,
    pub default_provider: Option<String>,
    pub default_model: Option<String>,
    pub default_thinking_level: Option<String>,
    pub enabled_models: Option<Vec<String>>,
    pub steering_mode: Option<String>,
    pub follow_up_mode: Option<String>,
    pub check_for_updates: Option<bool>,
    pub quiet_startup: Option<bool>,
    pub collapse_changelog: Option<bool>,
    pub last_changelog_version: Option<String>,
    pub double_escape_action: Option<String>,
    pub editor_padding_x: Option<u32>,
    pub autocomplete_max_visible: Option<u32>,
    pub session_picker_input: Option<u32>,
    pub session_store: Option<String>,
    pub session_durability: Option<String>,
    pub compaction: Option<CompactionSettings>,
    pub branch_summary: Option<BranchSummarySettings>,
    pub retry: Option<RetrySettings>,
    pub shell_path: Option<String>,
    pub shell_command_prefix: Option<String>,
    pub gh_path: Option<String>,
    pub images: Option<ImageSettings>,
    pub markdown: Option<MarkdownSettings>,
    pub terminal: Option<TerminalSettings>,
    pub thinking_budgets: Option<ThinkingBudgets>,
    pub packages: Option<Vec<PackageSource>>,
    pub extensions: Option<Vec<String>>,
    pub skills: Option<Vec<String>>,
    pub prompts: Option<Vec<String>>,
    pub themes: Option<Vec<String>>,
    pub enable_skill_commands: Option<bool>,
    pub extension_policy: Option<ExtensionPolicyConfig>,
    pub repair_policy: Option<RepairPolicyConfig>,
    pub extension_risk: Option<ExtensionRiskConfig>,
}

Main configuration structure.

Fields

theme: Option<String>

hide_thinking_block: Option<bool>

show_hardware_cursor: Option<bool>

default_provider: Option<String>

default_model: Option<String>

default_thinking_level: Option<String>

enabled_models: Option<Vec<String>>

steering_mode: Option<String>

follow_up_mode: Option<String>

check_for_updates: Option<bool>

quiet_startup: Option<bool>

collapse_changelog: Option<bool>

last_changelog_version: Option<String>

double_escape_action: Option<String>

editor_padding_x: Option<u32>

autocomplete_max_visible: Option<u32>

session_picker_input: Option<u32>

Non-interactive session picker selection (1-based index).

session_store: Option<String>

Session persistence backend: jsonl (default) or sqlite (requires sqlite-sessions).

session_durability: Option<String>

Session durability mode: strict, balanced (default), or throughput.

compaction: Option<CompactionSettings>

branch_summary: Option<BranchSummarySettings>

retry: Option<RetrySettings>

shell_path: Option<String>

shell_command_prefix: Option<String>

gh_path: Option<String>

Override path to GitHub CLI (gh) for features like /share.

images: Option<ImageSettings>

markdown: Option<MarkdownSettings>

terminal: Option<TerminalSettings>

thinking_budgets: Option<ThinkingBudgets>

packages: Option<Vec<PackageSource>>

extensions: Option<Vec<String>>

skills: Option<Vec<String>>

prompts: Option<Vec<String>>

themes: Option<Vec<String>>

enable_skill_commands: Option<bool>

extension_policy: Option<ExtensionPolicyConfig>

repair_policy: Option<RepairPolicyConfig>

extension_risk: Option<ExtensionRiskConfig>

Implementations

impl Config

pub fn load() -> Result<Self>

Load configuration from global and project settings.

pub fn global_dir() -> PathBuf

Get the global configuration directory.

pub fn project_dir() -> PathBuf

Get the project configuration directory.

pub fn sessions_dir() -> PathBuf

Get the sessions directory.

pub fn package_dir() -> PathBuf

Get the package directory.

pub fn extension_index_path() -> PathBuf

Get the extension index cache file path.

pub fn auth_path() -> PathBuf

Get the auth file path.

pub fn permissions_path() -> PathBuf

Get the extension permissions file path.

pub fn load_with_roots( config_path: Option<&Path>, global_dir: &Path, cwd: &Path, ) -> Result<Self>

pub fn settings_path_with_roots( scope: SettingsScope, global_dir: &Path, cwd: &Path, ) -> PathBuf

pub fn patch_settings_with_roots( scope: SettingsScope, global_dir: &Path, cwd: &Path, patch: Value, ) -> Result<PathBuf>

pub fn merge(base: Self, other: Self) -> Self

Merge two configurations, with other taking precedence.

pub fn compaction_enabled(&self) -> bool

pub fn steering_queue_mode(&self) -> QueueMode

pub fn follow_up_queue_mode(&self) -> QueueMode

pub fn compaction_reserve_tokens(&self) -> u32

pub fn compaction_keep_recent_tokens(&self) -> u32

pub fn branch_summary_reserve_tokens(&self) -> u32

pub fn retry_enabled(&self) -> bool

pub fn retry_max_retries(&self) -> u32

pub fn retry_base_delay_ms(&self) -> u32

pub fn retry_max_delay_ms(&self) -> u32

pub fn image_auto_resize(&self) -> bool

pub fn should_check_for_updates(&self) -> bool

Whether to check for version updates on startup (default: true).

pub fn image_block_images(&self) -> bool

pub fn terminal_show_images(&self) -> bool

pub fn terminal_clear_on_shrink(&self) -> bool

pub fn thinking_budget(&self, level: &str) -> u32

pub fn enable_skill_commands(&self) -> bool

pub fn resolve_extension_policy_with_metadata( &self, cli_override: Option<&str>, ) -> ResolvedExtensionPolicy

Resolve the extension policy from config, CLI override, and env var.

Resolution order (highest precedence first):

1. cli_override (from --extension-policy flag)
2. PI_EXTENSION_POLICY environment variable
3. extension_policy.profile from settings.json
4. Default: “safe”

If allow_dangerous is true (from config or env), exec/env are removed from the policy’s deny list.

pub fn resolve_extension_policy( &self, cli_override: Option<&str>, ) -> ExtensionPolicy

pub fn resolve_repair_policy_with_metadata( &self, cli_override: Option<&str>, ) -> ResolvedRepairPolicy

Resolve the repair policy from config, CLI override, and env var.

Resolution order (highest precedence first):

1. cli_override (from --repair-policy flag)
2. PI_REPAIR_POLICY environment variable
3. repair_policy.mode from settings.json
4. Default: “suggest”

pub fn resolve_repair_policy( &self, cli_override: Option<&str>, ) -> RepairPolicyMode

pub fn resolve_extension_risk_with_metadata(&self) -> ResolvedExtensionRisk

Resolve runtime risk controller settings from config and environment.

Resolution order (highest precedence first):

1. PI_EXTENSION_RISK_* env vars
2. extensionRisk config
3. deterministic defaults

pub fn resolve_extension_risk(&self) -> RuntimeRiskConfig

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Config

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

Formats the value using the given formatter.

impl Default for Config

fn default() -> Config

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Config

where Config: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Config

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

where __S: Serializer,

Serialize this value into the given Serde serializer.