Struct Cli 

pub struct Cli {
    pub ai_backend: Option<AiBackend>,
    pub claude_cli_allow_tools: bool,
    pub claude_cli_allow_mcp: bool,
    pub claude_cli_max_budget_usd: Option<f64>,
    pub models_yaml: Option<PathBuf>,
    pub command: Commands,
}

Top-level clap-derived CLI struct; the library entry point for embedding omni-dev programmatically.

Global flags (--ai-backend, --claude-cli-allow-tools, --claude-cli-allow-mcp, --claude-cli-max-budget-usd, --models-yaml) are propagated to environment variables read by downstream factories before dispatching to a Commands variant.

Fields

ai_backend: Option<AiBackend>

Selects the AI backend used by commands that invoke an AI model.

Overrides the OMNI_DEV_AI_BACKEND environment variable.

claude_cli_allow_tools: bool

Weakens the claude-cli sandbox by allowing the nested claude -p session to use its default built-in tools (Read, Edit, Write, Bash, Glob, Grep).

Only use for deliberately tool-capable use cases. By default the nested session runs with --tools "" and cannot touch the file system. This flag removes that guard. Equivalent to setting OMNI_DEV_CLAUDE_CLI_ALLOW_TOOLS=true. Independent of --claude-cli-allow-mcp.

Ignored when --ai-backend is not claude-cli.

claude_cli_allow_mcp: bool

Weakens the claude-cli sandbox by allowing the nested claude -p session to load MCP servers from ~/.claude/settings.json.

Only use deliberately. MCP servers commonly hold OAuth tokens (Gmail, Drive, Slack) and may be arbitrary network-attached services; enabling this exposes them to the nested session. By default the session runs with --strict-mcp-config and no MCP servers load. Equivalent to setting OMNI_DEV_CLAUDE_CLI_ALLOW_MCP=true. Independent of --claude-cli-allow-tools.

Ignored when --ai-backend is not claude-cli.

claude_cli_max_budget_usd: Option<f64>

Per-invocation spending cap in USD for the claude-cli backend.

Forwarded to claude -p --max-budget-usd. When the nested session exceeds this budget it aborts rather than running away with cost. Equivalent to setting OMNI_DEV_CLAUDE_CLI_MAX_BUDGET_USD.

Ignored when --ai-backend is not claude-cli.

models_yaml: Option<PathBuf>

Path to a single user-side models.yaml that short-circuits the standard ./.omni-dev/models.yaml and ~/.omni-dev/models.yaml lookup. The file is still merged over the embedded catalog. Equivalent to setting OMNI_DEV_MODELS_YAML.

command: Commands

The main command to execute.

Implementations

impl Cli

pub async fn execute(self) -> Result<()>

Executes the CLI command.

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 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 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.