llmx/codex-rs/repl/src/cli.rs

use clap::ArgAction;
use clap::Parser;
use codex_core::ApprovalModeCliArg;
use codex_core::SandboxModeCliArg;
use std::path::PathBuf;

/// Command‑line arguments.
#[derive(Debug, Parser)]
#[command(
    author,
    version,
    about = "Interactive Codex CLI that streams all agent actions."
)]
pub struct Cli {
    /// User prompt to start the session.
    pub prompt: Option<String>,

    /// Override the default model from ~/.codex/config.toml.
    #[arg(short, long)]
    pub model: Option<String>,

    /// Optional images to attach to the prompt.
    #[arg(long, value_name = "FILE")]
    pub images: Vec<PathBuf>,

    /// Increase verbosity (-v info, -vv debug, -vvv trace).
    ///
    /// The flag may be passed up to three times. Without any -v the CLI only prints warnings and errors.
    #[arg(short, long, action = ArgAction::Count)]
    pub verbose: u8,

    /// Don't use colored ansi output for verbose logging
    #[arg(long)]
    pub no_ansi: bool,

    /// Configure when the model requires human approval before executing a command.
    #[arg(long = "ask-for-approval", short = 'a', value_enum, default_value_t = ApprovalModeCliArg::OnFailure)]
    pub approval_policy: ApprovalModeCliArg,

    /// Configure the process restrictions when a command is executed.
    ///
    /// Uses OS-specific sandboxing tools; Seatbelt on OSX, landlock+seccomp on Linux.
    #[arg(long = "sandbox", short = 's', value_enum, default_value_t = SandboxModeCliArg::NetworkAndFileWriteRestricted)]
    pub sandbox_policy: SandboxModeCliArg,

    /// Allow running Codex outside a Git repository.  By default the CLI
    /// aborts early when the current working directory is **not** inside a
    /// Git repo because most agents rely on `git` for interacting with the
    /// code‑base.  Pass this flag if you really know what you are doing.
    #[arg(long, action = ArgAction::SetTrue, default_value_t = false)]
    pub allow_no_git_exec: bool,

    /// Disable server‑side response storage (sends the full conversation context with every request)
    #[arg(long = "disable-response-storage", default_value_t = false)]
    pub disable_response_storage: bool,

    /// Record submissions into file as JSON
    #[arg(short = 'S', long)]
    pub record_submissions: Option<String>,

    /// Record events into file as JSON
    #[arg(short = 'E', long)]
    pub record_events: Option<String>,
}