Struct Cli 

pub struct Cli {

    pub version: bool,
    pub provider: Option<String>,
    pub model: Option<String>,
    pub api_key: Option<String>,
    pub models: Option<String>,
    pub thinking: Option<String>,
    pub system_prompt: Option<String>,
    pub append_system_prompt: Option<String>,
    pub continue: bool,
    pub resume: bool,
    pub session: Option<String>,
    pub session_dir: Option<String>,
    pub no_session: bool,
    pub session_durability: Option<String>,
    pub no_migrations: bool,
    pub mode: Option<String>,
    pub print: bool,
    pub verbose: bool,
    pub no_tools: bool,
    pub tools: String,
    pub extension: Vec<String>,
    pub no_extensions: bool,
    pub extension_policy: Option<String>,
    pub explain_extension_policy: bool,
    pub repair_policy: Option<String>,
    pub explain_repair_policy: bool,
    pub skill: Vec<String>,
    pub no_skills: bool,
    pub prompt_template: Vec<String>,
    pub no_prompt_templates: bool,
    pub theme: Option<String>,
    pub theme_path: Vec<String>,
    pub no_themes: bool,
    pub export: Option<String>,
    pub list_models: Option<Option<String>>,
    pub list_providers: bool,
    pub command: Option<Commands>,
    pub args: Vec<String>,
}

Pi - AI coding agent CLI

Fields

version: bool

Print version information

provider: Option<String>

LLM provider (e.g., anthropic, openai, google)

model: Option<String>

Model ID (e.g., claude-opus-4, gpt-4o)

api_key: Option<String>

API key (overrides environment variable)

models: Option<String>

Model patterns for Ctrl+P cycling (comma-separated, supports globs)

thinking: Option<String>

Extended thinking level

system_prompt: Option<String>

Override system prompt

append_system_prompt: Option<String>

Append to system prompt (text or file path)

continue: bool

Continue previous session

resume: bool

Select session from picker UI

session: Option<String>

Use specific session file path

session_dir: Option<String>

Directory for session storage/lookup

no_session: bool

Don’t save session (ephemeral)

session_durability: Option<String>

Session durability mode: strict, balanced, or throughput

no_migrations: bool

Skip startup migrations for legacy config/session/layout paths

mode: Option<String>

Output mode for print mode (text, json, rpc)

print: bool

Non-interactive mode (process & exit)

verbose: bool

Force verbose startup

no_tools: bool

Disable all built-in tools

tools: String

Specific tools to enable (comma-separated: read,bash,edit,write,grep,find,ls)

extension: Vec<String>

Load extension file (can use multiple times)

no_extensions: bool

Disable extension discovery

extension_policy: Option<String>

Extension capability policy: safe, balanced, or permissive (legacy alias: standard)

explain_extension_policy: bool

Print the resolved extension policy with per-capability decisions and exit

repair_policy: Option<String>

Repair policy mode: off, suggest, auto-safe, or auto-strict

explain_repair_policy: bool

Print the resolved repair policy and exit

skill: Vec<String>

Load skill file/directory (can use multiple times)

no_skills: bool

Disable skill discovery

prompt_template: Vec<String>

Load prompt template file/directory (can use multiple times)

no_prompt_templates: bool

Disable prompt template discovery

theme: Option<String>

Select active theme (built-in name, discovered theme name, or theme JSON path)

theme_path: Vec<String>

Add theme file/directory to discovery (can use multiple times)

no_themes: bool

Disable theme discovery

export: Option<String>

Export session file to HTML

list_models: Option<Option<String>>

List available models (optional fuzzy search pattern)

list_providers: bool

List all supported providers with aliases and auth env keys

command: Option<Commands>

args: Vec<String>

Messages and @file references

Implementations

impl Cli

pub fn file_args(&self) -> Vec<&str>

Get file arguments (prefixed with @)

pub fn message_args(&self) -> Vec<&str>

Get message arguments (not prefixed with @)

pub fn enabled_tools(&self) -> Vec<&str>

Get enabled tools as a list

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

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

Formats the value using the given formatter.

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.