Struct RunAgentArgs 

pub struct RunAgentArgs {

    pub profile: Option<String>,
    pub runner: Option<String>,
    pub model: Option<String>,
    pub effort: Option<String>,
    pub runner_cli: RunnerCliArgs,
    pub phases: Option<u8>,
    pub quick: bool,
    pub repo_prompt: Option<RepoPromptMode>,
    pub git_revert_mode: Option<String>,
    pub git_commit_push_on: bool,
    pub git_commit_push_off: bool,
    pub include_draft: bool,
    pub notify: bool,
    pub no_notify: bool,
    pub notify_fail: bool,
    pub no_notify_fail: bool,
    pub notify_sound: bool,
    pub lfs_check: bool,
    pub no_progress: bool,
    pub runner_phase1: Option<String>,
    pub model_phase1: Option<String>,
    pub effort_phase1: Option<String>,
    pub runner_phase2: Option<String>,
    pub model_phase2: Option<String>,
    pub effort_phase2: Option<String>,
    pub runner_phase3: Option<String>,
    pub model_phase3: Option<String>,
    pub effort_phase3: Option<String>,
}

Extended agent arguments for run commands (includes phases).

Fields

profile: Option<String>

Named configuration profile to apply before resolving task/CLI overrides. Examples: quick, thorough, quick-fix

runner: Option<String>

Runner override for this invocation (codex, opencode, gemini, claude, cursor). Overrides task.agent and config.

model: Option<String>

Model override for this invocation. Overrides task.agent and config. Allowed: gpt-5.4, gpt-5.3-codex, gpt-5.3-codex-spark, gpt-5.3, gpt-5.2-codex, gpt-5.2, zai-coding-plan/glm-4.7, gemini-3-pro-preview, gemini-3-flash-preview, sonnet, opus, kimi-for-coding (codex supports only gpt-5.4/gpt-5.3-codex/gpt-5.3-codex-spark/gpt-5.3/gpt-5.2-codex/gpt-5.2; opencode/gemini/claude/cursor/kimi/pi accept arbitrary model ids).

effort: Option<String>

Codex reasoning effort override (low, medium, high, xhigh). Ignored for other runners.

runner_cli: RunnerCliArgs

phases: Option<u8>

Execution shape:

• 1 => single-pass execution (no mandated planning step)
• 2 => two-pass execution (plan then implement)
• 3 => three-pass execution (plan, implement+CI, review+complete)

If omitted, defaults to config agent.phases.

quick: bool

Quick mode: skip planning phase and run single-pass execution.

Equivalent to –phases=1. Cannot be used with –phases.

repo_prompt: Option<RepoPromptMode>

RepoPrompt mode (tools, plan, off). Alias: -rp.

git_revert_mode: Option<String>

Git revert mode for automatic error handling (ask, enabled, disabled).

git_commit_push_on: bool

Enable automatic git commit and push after successful runs.

git_commit_push_off: bool

Disable automatic git commit and push after successful runs.

include_draft: bool

Include draft tasks when selecting what to run.

notify: bool

Enable desktop notification on task completion (overrides config).

no_notify: bool

Disable desktop notification on task completion (overrides config).

notify_fail: bool

Enable desktop notification on task failure (overrides config).

no_notify_fail: bool

Disable desktop notification on task failure (overrides config).

notify_sound: bool

Enable sound alert with notification (requires –notify or config enabled).

lfs_check: bool

Enable strict LFS validation before commit (fail if filters misconfigured).

no_progress: bool

Disable progress indicators and celebrations.

runner_phase1: Option<String>

Runner override for Phase 1 (planning).

model_phase1: Option<String>

Model override for Phase 1 (planning).

effort_phase1: Option<String>

Reasoning effort override for Phase 1 (planning).

runner_phase2: Option<String>

Runner override for Phase 2 (implementation).

model_phase2: Option<String>

Model override for Phase 2 (implementation).

effort_phase2: Option<String>

Reasoning effort override for Phase 2 (implementation).

runner_phase3: Option<String>

Runner override for Phase 3 (review).

model_phase3: Option<String>

Model override for Phase 3 (review).

effort_phase3: Option<String>

Reasoning effort override for Phase 3 (review).

Trait Implementations

impl Args for RunAgentArgs

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 RunAgentArgs

fn clone(&self) -> RunAgentArgs

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RunAgentArgs

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

Formats the value using the given formatter.

impl Default for RunAgentArgs

fn default() -> RunAgentArgs

Returns the “default value” for a type.

impl FromArgMatches for RunAgentArgs

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.