Struct CliArgs 

pub struct CliArgs {
    pub wavedata: Option<PathBuf>,
    pub instance: String,
    pub headless: bool,
    pub auth_key_file: Option<PathBuf>,
    pub web_port: Option<u16>,
    pub ws_port: Option<u16>,
    pub frontend_dir: Option<PathBuf>,
    pub allowed_origins: Vec<String>,
    pub secret_store: Option<SecretStoreKind>,
    pub command: Option<SrvCommand>,
}

Fields

wavedata: Option<PathBuf>

Path to wave data directory (overrides AGENTMUX_DATA_HOME)

instance: String

Instance identifier (used for multi-version coexistence)

headless: bool

Run without a launcher or desktop host (container, server, CI). Read early by headless::prepare_env; see docs/specs/SPEC_SRV_HEADLESS_MODE_2026_09_26.md.

auth_key_file: Option<PathBuf>

Headless: read the auth key from this file instead of generating one.

web_port: Option<u16>

Headless: fixed loopback port for the web listener (default: OS-chosen).

ws_port: Option<u16>

Headless: fixed loopback port for the websocket listener (default: OS-chosen).

frontend_dir: Option<PathBuf>

Headless: serve the built frontend (a directory holding index.html) at /; health stays at /health.

allowed_origins: Vec<String>

Headless: also accept this browser origin (e.g. https://app.example.com) for CORS and the /ws check, beside loopback. Repeatable.

secret_store: Option<SecretStoreKind>

Headless: where srv keeps secrets (API keys, OAuth accounts, cloud credentials). Default file: owner-only files under the shared dir, for machines with no OS keychain.

command: Option<SrvCommand>

Trait Implementations

impl Args for CliArgs

fn group_id() -> Option<Id>

Report the [ArgGroup::id][crate::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 Default for CliArgs

fn default() -> CliArgs

Returns the “default value” for a type.

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][Error::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][Error::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][Error::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.