Struct Settings 

pub struct Settings {

    pub active_provider: Option<String>,
    pub providers: HashMap<String, ProviderConfig>,
    pub agent_models: HashMap<String, ModelSettings>,
    pub default_agent: String,
    pub model_quality: Option<ModelCost>,
    pub review_level: ReviewLevel,
    pub mcp_servers: HashMap<String, McpServerConfig>,
    pub run_build_test_output_mode: RunBuildTestOutputMode,
    pub enable_type_analyzer: bool,
    pub spawn_context_mode: SpawnContextMode,
    pub xml_tool_mode: bool,
    pub disable_custom_steering: bool,
    pub communication_tone: CommunicationTone,
    pub autonomy_level: AutonomyLevel,
    pub voice: VoiceSettings,
    pub skills: SkillsConfig,
    pub reasoning_effort: Option<ReasoningBudget>,
    pub disable_streaming: bool,
    pub modules: HashMap<String, Value>,
}

Core application settings.

Maintainer Note

When adding new settings fields, you must also update the VSCode extension settings UI in:

• tycode-vscode/src/settingsProvider.ts - HTML form elements
• tycode-vscode/src/webview/settings.js - JavaScript state and handlers

Fields

active_provider: Option<String>

The name of the currently active provider

providers: HashMap<String, ProviderConfig>

Map of provider name to configuration

agent_models: HashMap<String, ModelSettings>

Agent-specific model overrides

default_agent: String

Default agent to use for new conversations

model_quality: Option<ModelCost>

Global maximum quality tier applied across agents

review_level: ReviewLevel

Review level for messages

mcp_servers: HashMap<String, McpServerConfig>

MCP server configurations

run_build_test_output_mode: RunBuildTestOutputMode

Output mode for run_build_test tool

enable_type_analyzer: bool

Enable type analyzer tools (search_types, get_type_docs)

spawn_context_mode: SpawnContextMode

Controls how sub-agent context is initialized when spawning

xml_tool_mode: bool

Enable XML-based tool calling instead of native tool use

disable_custom_steering: bool

Disable custom steering documents (from .tycode and external agent configs)

communication_tone: CommunicationTone

Communication tone for agent responses

autonomy_level: AutonomyLevel

Controls whether agent must get plan approval before implementing

voice: VoiceSettings

Voice/speech-to-text configuration

skills: SkillsConfig

Skills system configuration

reasoning_effort: Option<ReasoningBudget>

Global default reasoning effort applied to all agents unless overridden

disable_streaming: bool

When true, AI responses arrive as a single complete message instead of streaming incrementally

modules: HashMap<String, Value>

Enables modules to own their configuration without modifying tycode-core, supporting external/plugin modules that aren’t known at compile time.

Implementations

impl Settings

pub fn active_provider(&self) -> Option<&ProviderConfig>

Get the active provider configuration

pub fn set_active_provider(&mut self, name: &str) -> Result<(), String>

Set the active provider (returns error if provider doesn’t exist)

pub fn add_provider(&mut self, name: String, config: ProviderConfig)

Add or update a provider configuration

pub fn remove_provider(&mut self, name: &str) -> Result<(), String>

Remove a provider configuration

pub fn list_providers(&self) -> Vec<String>

List all provider names

pub fn get_module_config<T: Default + DeserializeOwned>( &self, namespace: &str, ) -> T

Get module-specific configuration, deserializing from the modules map

pub fn set_module_config<T: Serialize>(&mut self, namespace: &str, config: T)

Set module-specific configuration, serializing to the modules map

pub fn get_agent_model(&self, agent_name: &str) -> Option<&ModelSettings>

Get the model settings for a specific agent

pub fn set_agent_model(&mut self, agent_name: String, model: ModelSettings)

Set the model settings for a specific agent

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.