Struct AgentConfig 

pub struct AgentConfig {

    pub provider: String,
    pub api_key_env: String,
    pub default_model: String,
    pub theme: String,
    pub todo_planning_mode: bool,
    pub ui_surface: UiSurfacePreference,
    pub max_conversation_turns: usize,
    pub reasoning_effort: ReasoningEffortLevel,
    pub enable_self_review: bool,
    pub max_review_passes: usize,
    pub refine_prompts_enabled: bool,
    pub refine_prompts_max_passes: usize,
    pub refine_prompts_model: String,
    pub onboarding: AgentOnboardingConfig,
    pub project_doc_max_bytes: usize,
    pub instruction_max_bytes: usize,
    pub instruction_files: Vec<String>,
    pub custom_prompts: AgentCustomPromptsConfig,
    pub custom_api_keys: BTreeMap<String, String>,
    pub checkpointing: AgentCheckpointingConfig,
}

Agent-wide configuration

Fields

provider: String

AI provider for single agent mode (gemini, openai, anthropic, openrouter, xai, zai)

api_key_env: String

Environment variable that stores the API key for the active provider

default_model: String

Default model to use

theme: String

UI theme identifier controlling ANSI styling

todo_planning_mode: bool

Enable TODO planning workflow integrations (update_plan tool, onboarding hints)

ui_surface: UiSurfacePreference

Preferred rendering surface for the interactive chat UI (auto, alternate, inline)

max_conversation_turns: usize

Maximum number of conversation turns before auto-termination

reasoning_effort: ReasoningEffortLevel

Reasoning effort level for models that support it (low, medium, high) Applies to: Claude, GPT-5, Gemini, Qwen3, DeepSeek with reasoning capability

enable_self_review: bool

Enable an extra self-review pass to refine final responses

max_review_passes: usize

Maximum number of self-review passes

refine_prompts_enabled: bool

Enable prompt refinement pass before sending to LLM

refine_prompts_max_passes: usize

Max refinement passes for prompt writing

refine_prompts_model: String

Optional model override for the refiner (empty = auto pick efficient sibling)

onboarding: AgentOnboardingConfig

Session onboarding and welcome message configuration

project_doc_max_bytes: usize

Maximum bytes of AGENTS.md content to load from project hierarchy

instruction_max_bytes: usize

Maximum bytes of instruction content to load from AGENTS.md hierarchy

instruction_files: Vec<String>

Additional instruction files or globs to merge into the hierarchy

custom_prompts: AgentCustomPromptsConfig

Custom prompt configuration for slash command shortcuts

custom_api_keys: BTreeMap<String, String>

Provider-specific API keys captured from interactive configuration flows

checkpointing: AgentCheckpointingConfig

Checkpointing configuration for automatic turn snapshots

Trait Implementations

impl Clone for AgentConfig

fn clone(&self) -> AgentConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentConfig

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

Formats the value using the given formatter.

impl Default for AgentConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AgentConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for AgentConfig

fn schema_name() -> String

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

impl Serialize for AgentConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.