Struct Cli 

pub struct Cli {

    pub cwd: PathBuf,
    pub model: String,
    pub websearch: WebSearchMode,
    pub websearch_url: Option<String>,
    pub reasoning_effort: ReasoningEffort,
    pub reasoning_summary: ReasoningSummary,
    pub tick_rate_ms: u64,
    pub no_mouse: bool,
    pub mouse: bool,
    pub verbose: bool,
    pub theme: Theme,
    pub print_prompt: bool,
    pub skill_dirs: Vec<PathBuf>,
    pub session_dir: Option<PathBuf>,
    pub config_diagnostics: Vec<String>,
    pub config_layers: Vec<LoadedConfigLayer>,
    pub config_origins: BTreeMap<String, ConfigOrigin>,
    pub acp_agents: AcpAgentsConfig,
    pub command: Option<Command>,
}

Runtime configuration after defaults, TOML, env, and flags are merged.

Fields

cwd: PathBuf

Working directory used for context loading and display.

model: String

Model to use for completions.

If omitted, first-run setup asks for a provider and model before the coding workspace becomes usable.

websearch: WebSearchMode

Application-owned web search backend.

websearch_url: Option<String>

Base URL for the SearXNG web search backend.

reasoning_effort: ReasoningEffort

Configured reasoning effort for supporting provider models.

TODO: Route this through every provider/model family that supports reasoning-effort controls.

reasoning_summary: ReasoningSummary

Configured reasoning-summary policy for supporting provider models.

TODO: Route this through every provider/model family that supports reasoning-summary controls.

tick_rate_ms: u64

Event poll interval in milliseconds (minimum MIN_TICK_RATE_MS).

no_mouse: bool

Disable mouse capture in the alternate-screen interface.

mouse: bool

Enable terminal mouse capture for overlay mouse events.

Enables transcript wheel scrolling and overlay mouse navigation. Most terminals retain a modifier-assisted text selection gesture while mouse capture is active.

verbose: bool

Show diagnostic transcript rows such as provider events and log paths.

theme: Theme

UI color theme.

print_prompt: bool

Print the assembled prompt bundle/lowered messages with secrets redacted.

skill_dirs: Vec<PathBuf>

Additional skill directories to scan.

session_dir: Option<PathBuf>

Directory for append-only session JSONL files.

config_diagnostics: Vec<String>

Config diagnostics from effective config loading.

config_layers: Vec<LoadedConfigLayer>

Effective config layers for session metadata.

config_origins: BTreeMap<String, ConfigOrigin>

Effective config key origins for session metadata.

acp_agents: AcpAgentsConfig

Effective external ACP agent configs.

command: Option<Command>

Optional non-interactive command.

Implementations

impl Cli

pub fn parse_configured() -> Result<Self, ConfigError>

Parse command-line arguments, load TOML config, and merge them.

pub fn try_parse_from<I, T>(itr: I) -> Result<Self, Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Test-friendly parser that applies CLI defaults but skips config loading.

Trait Implementations

impl Args for Cli

fn group_id() -> Option<Id>

Report the ArgGroup::id for this set of arguments

fn augment_args<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

impl Clone for Cli

fn clone(&self) -> Cli

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl CommandFactory for Cli

fn command<'b>() -> Command

Build a Command that can instantiate Self.

fn command_for_update<'b>() -> Command

Build a Command that can update self.

impl Debug for Cli

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

Formats the value using the given formatter.

impl Default for Cli

fn default() -> Self

Used by tests and as the implicit baseline before flag overrides.

impl From<&Cli> for App

fn from(value: &Cli) -> Self

Converts to this type from the input type.

impl FromArgMatches for Cli

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Parser for Cli

fn parse() -> Self

Parse from std::env::args_os(), exit on error.

fn try_parse() -> Result<Self, Error>

Parse from std::env::args_os(), return Err on error.

fn parse_from<I, T>(itr: I) -> Self

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, exit on error.

fn try_parse_from<I, T>(itr: I) -> Result<Self, Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, return Err on error.

fn update_from<I, T>(&mut self, itr: I)

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, exit on error.

fn try_update_from<I, T>(&mut self, itr: I) -> Result<(), Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, return Err on error.