Struct Cli 

pub struct Cli {

    pub color: Color,
    pub workspace_path: Option<PathBuf>,
    pub model: Option<String>,
    pub provider: Option<String>,
    pub api_key_env: String,
    pub workspace: Option<PathBuf>,
    pub research_preview: bool,
    pub security_level: String,
    pub show_file_diffs: bool,
    pub max_concurrent_ops: usize,
    pub api_rate_limit: usize,
    pub max_tool_calls: usize,
    pub debug: bool,
    pub verbose: bool,
    pub quiet: bool,
    pub config: Vec<String>,
    pub log_level: String,
    pub no_color: bool,
    pub theme: Option<String>,
    pub tick_rate: u64,
    pub frame_rate: u64,
    pub enable_skills: bool,
    pub chrome: bool,
    pub no_chrome: bool,
    pub skip_confirmations: bool,
    pub codex_experimental: bool,
    pub no_codex_experimental: bool,
    pub print: Option<String>,
    pub full_auto: Option<String>,
    pub resume_session: Option<String>,
    pub continue_latest: bool,
    pub fork_session: Option<String>,
    pub all: bool,
    pub session_id: Option<String>,
    pub summarize: bool,
    pub agent: Option<String>,
    pub allowed_tools: Vec<String>,
    pub disallowed_tools: Vec<String>,
    pub dangerously_skip_permissions: bool,
    pub ide: bool,
    pub permission_mode: Option<String>,
    pub command: Option<Commands>,
}

Main CLI structure for vtcode with advanced features

Fields

color: Color

Color output selection (auto, always, never)

workspace_path: Option<PathBuf>

Optional positional path to run vtcode against a different workspace

model: Option<String>

LLM Model ID (e.g., gpt-5, claude-sonnet-4-6, gemini-3-flash-preview)

provider: Option<String>

LLM Provider (gemini, openai, anthropic, deepseek, openrouter, codex, zai, moonshot, minimax, ollama, lmstudio)

api_key_env: String

API key environment variable (auto-detects GEMINI_API_KEY, OPENAI_API_KEY, etc.)

workspace: Option<PathBuf>

Workspace root directory (default: current directory)

research_preview: bool

Enable research-preview features

security_level: String

Security level for tool execution (strict, moderate, permissive)

show_file_diffs: bool

Show diffs for file changes in chat interface

max_concurrent_ops: usize

Maximum concurrent async operations

api_rate_limit: usize

Maximum API requests per minute

max_tool_calls: usize

Maximum tool calls per session

debug: bool

Enable debug output for troubleshooting

verbose: bool

Enable verbose logging

quiet: bool

Suppress all non-essential output (for scripting, CI/CD)

config: Vec<String>

Configuration overrides or file path (KEY=VALUE or PATH)

log_level: String

Log level (error, warn, info, debug, trace)

no_color: bool

Disable color output (equivalent to --color never)

theme: Option<String>

Select UI theme (e.g., ciapre-dark, ciapre-blue)

tick_rate: u64

App tick rate in milliseconds (default: 250)

frame_rate: u64

Frame rate in FPS (default: 60)

enable_skills: bool

Enable skills system

chrome: bool

Enable Chrome browser integration for web automation

no_chrome: bool

Disable Chrome browser integration

skip_confirmations: bool

Skip safety confirmations (use with caution)

codex_experimental: bool

Enable experimental Codex app-server features for this run

no_codex_experimental: bool

Disable experimental Codex app-server features for this run

print: Option<String>

Print response without launching the interactive TUI

full_auto: Option<String>

Enable full-auto mode (no interaction) or run a headless task

resume_session: Option<String>

Resume a previous conversation (use without ID for interactive picker)

continue_latest: bool

Continue the most recent conversation automatically

fork_session: Option<String>

Fork an existing session with a new session ID

all: bool

Show archived sessions from every workspace when resuming or forking

session_id: Option<String>

Custom suffix for session identifier (alphanumeric, dash, underscore only, max 64 chars)

summarize: bool

Use summarized history when forking a session

agent: Option<String>

Override the default agent model for this session

allowed_tools: Vec<String>

Tools that execute without prompting (comma-separated, supports patterns like “Bash(git:*)”)

disallowed_tools: Vec<String>

Tools that cannot be used by the agent

dangerously_skip_permissions: bool

Skip all permission prompts (reduces security - use with caution)

ide: bool

Explicitly connect to IDE on startup (auto-detects available IDEs)

permission_mode: Option<String>

Begin in a specified permission mode (default, accept_edits, auto, dont_ask, bypass_permissions, plus legacy ask/suggest/auto-approved/full-auto/trusted_auto/plan)

command: Option<Commands>

Implementations

impl Cli

pub fn get_model(&self) -> String

Get the model to use, with fallback to default

pub async fn load_config(&self) -> Result<ConfigFile, Box<dyn Error>>

Load configuration from a simple TOML-like file without external deps

Supported keys (top-level): model, api_key_env, verbose, log_level, workspace Example: model = “gemini-3-flash-preview” api_key_env = “GEMINI_API_KEY” verbose = true log_level = “info” workspace = “/path/to/workspace”

pub fn get_workspace(&self) -> PathBuf

Get the effective workspace path

pub fn get_api_key_env(&self) -> String

Get the effective API key environment variable

Automatically infers the API key environment variable based on the provider when the current value matches the default or is not explicitly set.

pub fn is_verbose(&self) -> bool

Check if verbose mode is enabled

pub fn is_research_preview_enabled(&self) -> bool

Check if performance monitoring is enabled Check if research-preview features are enabled

pub fn get_security_level(&self) -> &str

Get the security level

pub fn is_debug_mode(&self) -> bool

Check if debug mode is enabled (includes verbose)

pub fn codex_experimental_override(&self) -> Option<bool>

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 Clone for Cli

fn clone(&self) -> Cli

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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 Debug for Cli

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

Formats the value using the given formatter.

impl Default for Cli

fn default() -> Self

Returns the “default value” for a type.

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.