Struct Settings 

pub struct Settings {

    pub default_provider: Option<String>,
    pub default_model: Option<String>,
    pub default_thinking_level: Option<String>,
    pub theme: Option<String>,
    pub scoped_models: Option<Vec<String>>,
    pub packages: Option<Vec<PackageSetting>>,
    pub npm_command: Option<Vec<String>>,
    pub skill_dirs: Option<Vec<String>>,
    pub prompt_dirs: Option<Vec<String>>,
    pub extension_dirs: Option<Vec<String>>,
    pub keybindings: Option<HashMap<String, Value>>,
    pub double_escape_action: Option<String>,
    pub default_tools: Option<Vec<String>>,
    pub hide_thinking_block: Option<bool>,
    pub quiet_startup: Option<bool>,
    pub show_terminal_progress: Option<bool>,
    pub editor_padding_x: Option<usize>,
    pub autocomplete_max_visible: Option<usize>,
    pub fullscreen_copy_on_select: Option<bool>,
    pub http_idle_timeout: Option<Value>,
}

The honored subset of pi’s Settings. Unknown fields are ignored.

Fields

default_provider: Option<String>

Saved default provider id (v1 honors only "anthropic"; an absent or anthropic value allows the saved default-model lookup).

default_model: Option<String>

Saved default model id. When present and the model is authed, provider::resolve selects it (pi findInitialModel step 3).

default_thinking_level: Option<String>

Saved default thinking level (a level-name string: off/minimal/low/medium/ high/xhigh/max). Parsed by the caller via args::parse_thinking_level.

theme: Option<String>

Saved theme name. Surfaced for best-effort TUI theme application.

scoped_models: Option<Vec<String>>

/scoped-models: the model ids allowed in the Ctrl+M cycle. Absent / empty ⇒ every catalog model cycles (the default).

packages: Option<Vec<PackageSetting>>

Pi-compatible static package specs. Entries may be local package directories, package.json files, installed package names, or filtered package objects.

npm_command: Option<Vec<String>>

Command used by native Pi for npm package lookup/install operations. Stored argv-style so launchers such as mise exec -- npm need no shell.

skill_dirs: Option<Vec<String>>

Additional skill directories. Relative paths are resolved against the settings file’s owner (project root for project settings, agent dir for global settings). skills is accepted as a compatibility shorthand.

prompt_dirs: Option<Vec<String>>

Additional prompt-template directories/files. prompts is accepted as a compatibility shorthand.

extension_dirs: Option<Vec<String>>

Additional Rust cdylib extension directories. extensions is accepted as a compatibility shorthand.

keybindings: Option<HashMap<String, Value>>

Native Pi keybinding overrides. Values may be a key string, an array of key strings, or an empty array to unbind an action.

double_escape_action: Option<String>

Action performed by two quick Escape presses while the editor is empty. Native Pi defaults this to tree; none disables the gesture.

default_tools: Option<Vec<String>>

Default tools to enable at startup. When absent, all built-in tools are enabled. When present, only the named tools are enabled.

hide_thinking_block: Option<bool>

Hide the body of thinking blocks while retaining a compact label.

quiet_startup: Option<bool>

Suppress the interactive startup header and resource summary. Update checks remain enabled, matching native Pi.

show_terminal_progress: Option<bool>

Show the global terminal progress indicator while a run is active.

editor_padding_x: Option<usize>

Horizontal editor padding in terminal columns.

autocomplete_max_visible: Option<usize>

Maximum number of autocomplete rows shown above the editor.

fullscreen_copy_on_select: Option<bool>

Automatically copy text to clipboard when selected in fullscreen mode. When false, text selection requires explicit copy action.

http_idle_timeout: Option<Value>

How long idle pooled HTTP connections are kept before being closed. Accepts a millisecond number or the string "disabled". Native pi httpIdleTimeout.

Implementations

impl Settings

pub fn http_idle_timeout_ms(&self) -> Option<i64>

Resolved HTTP idle timeout in milliseconds (None ⇒ library default, Some(0) ⇒ disabled). See rpi_ai::http::parse_http_idle_timeout_ms.

Trait Implementations

impl Clone for Settings

fn clone(&self) -> Self

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.