Struct HeadlessArgs 

pub struct HeadlessArgs {
    pub prompt: Vec<String>,
    pub agent: Option<String>,
    pub model: Option<String>,
    pub cwd: PathBuf,
    pub mcp_configs: Vec<PathBuf>,
    pub system_prompt: Option<String>,
    pub output: CliOutputFormat,
    pub verbose: bool,
    pub events: Vec<CliEventKind>,
}

Fields

prompt: Vec<String>

Prompt to send (reads stdin if omitted and stdin is not a TTY)

agent: Option<String>

Named agent from settings.json (defaults to first user-invocable agent)

model: Option<String>

Model for ad-hoc runs (e.g. “anthropic:claude-sonnet-4-5”). Mutually exclusive with –agent.

cwd: PathBuf

Working directory

mcp_configs: Vec<PathBuf>

Path(s) to mcp.json. Pass multiple times to layer configs (last wins on collisions). If omitted, paths from settings.json mcpServers are used (or cwd/mcp.json is auto-detected).

system_prompt: Option<String>

Additional system prompt

output: CliOutputFormat

Output format

verbose: bool

Verbose diagnostic logging to stderr.

events: Vec<CliEventKind>

Comma-separated list of events to emit (e.g. tool_call,tool_result). Omit to emit everything. When set, error is only shown if explicitly listed.

Trait Implementations

impl Args for HeadlessArgs

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 FromArgMatches for HeadlessArgs

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.