Struct CliArgs 

pub struct CliArgs {

    pub provider: Option<String>,
    pub model: Option<String>,
    pub sandbox: Option<SandboxModeArg>,
    pub yolo: bool,
    pub profile: Option<String>,
    pub log_format: Option<LogFormatArg>,
    pub config_override: Vec<String>,
    pub resume: Option<Option<String>>,
    pub local: bool,
    pub repl: bool,
    pub message: Option<String>,
    pub format: OutputFormat,
    pub goal: Option<String>,
    pub max_turns: Option<u32>,
    pub command: Option<Command>,
}

Headless agent over ACP/stdio.

Fields

provider: Option<String>

LLM provider to use. CLI flag takes precedence over the DEFECT_PROVIDER environment variable and config file.

model: Option<String>

Override the default model ID. CLI flag takes precedence over the DEFECT_MODEL environment variable.

sandbox: Option<SandboxModeArg>

Override the sandbox permission mode. CLI flag takes precedence over config [sandbox].mode. Useful for CI: --sandbox open runs every tool without prompting. Note that --repl always forces open regardless.

yolo: bool

Shortcut for --sandbox open: grants maximum permissions and runs every tool without prompting. Mutually exclusive with --sandbox.

profile: Option<String>

Run the entire session under a named subagent profile, located in .defect/agents/<name>/ or ~/.config/defect/agents/<name>/. The profile’s model, system prompt, and tool allowlist become the session root. The CLI flag takes precedence over the DEFECT_PROFILE environment variable.

log_format: Option<LogFormatArg>

Format for the tracing/log output (stderr). text (default) is human-readable; jsonl emits one JSON object per log line. Takes precedence over config [tracing].format. This controls diagnostic logs, not the --format stdout event stream.

config_override: Vec<String>

Additional dotted-path config overrides; may be repeated.

resume: Option<Option<String>>

Resume a previous session. With a SESSION_ID, resume that specific session; bare --resume resumes the most recently active session for the current working directory. In ACP mode, the resumed session is returned on the first session/new; in --repl mode, it is loaded directly.

local: bool

Sandbox mode: ignore global/user config and store all state (config, sessions) under <repo-root>/.defect/. The user-level ~/.config/defect config, agents, and skills are skipped entirely.

repl: bool

Run a minimal in-process REPL on stdin/stdout instead of the ACP server. Requires the repl build feature (enabled by default); a binary built with --no-default-features rejects this flag at runtime.

message: Option<String>

Run a single prompt turn headlessly and exit (CI / scripting). The assistant output goes to stdout; the process exit code reflects the turn outcome. A value of -, or no value while stdin is piped, reads the prompt from stdin. Combine with --resume to continue a previous session. Mutually exclusive with --repl. Requires the oneshot build feature (on by default).

format: OutputFormat

Output format for --message / --goal mode.

goal: Option<String>

Run a goal-driven autonomous loop and exit (for CI / scripting). The agent works across multiple turns until it calls the goal_done tool (goal achieved) or reaches --max-turns. Like --message, but continues until the goal is reached instead of stopping after one turn. Reads from stdin if the value is - or omitted while piped. Mutually exclusive with --message and --repl. Requires the oneshot build feature.

max_turns: Option<u32>

Maximum number of times the goal-gate may keep the agent going before giving up (maps to [turn].max_hook_continues). Only meaningful with --goal. When exceeded, the run exits with a non-zero (exhausted) code.

command: Option<Command>

Optional subcommand. When omitted, defect runs as an agent (ACP server by default, or one of the --repl / --message / --goal modes). Subcommands are for one-off management tasks that exit without starting an agent.

Implementations

impl CliArgs

pub fn to_overrides(&self) -> Result<CliOverrides>

Translates CLI flags into CliOverrides and feeds them to defect_config::load_config.

Trait Implementations

impl Args for CliArgs

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 CommandFactory for CliArgs

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 CliArgs

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

Formats the value using the given formatter.

impl FromArgMatches for CliArgs

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 CliArgs

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.