Struct GlobalArgs 

pub struct GlobalArgs {

    pub spec: Option<String>,
    pub mcp: Option<String>,
    pub mcp_stdio: Option<String>,
    pub graphql: Option<String>,
    pub auth_header: Vec<String>,
    pub base_url: Option<String>,
    pub cache_key: Option<String>,
    pub cache_ttl: u64,
    pub refresh: bool,
    pub list_commands: bool,
    pub search_pattern: Option<String>,
    pub detail: Option<String>,
    pub describe: Option<String>,
    pub verbose: bool,
    pub sort: Option<String>,
    pub top: Option<usize>,
    pub compact: bool,
    pub pretty: bool,
    pub raw: bool,
    pub json_output: bool,
    pub envelope: bool,
    pub toon: bool,
    pub head: Option<usize>,
    pub max_bytes: Option<usize>,
    pub inline: bool,
    pub agent: bool,
    pub spool_clean: bool,
    pub fields: Option<String>,
    pub transport: String,
    pub env: Vec<String>,
    pub oauth: bool,
    pub oauth_client_id: Option<String>,
    pub oauth_client_secret: Option<String>,
    pub oauth_client_name: String,
    pub oauth_scope: Option<String>,
    pub oauth_redirect_uri: Option<String>,
    pub oauth_flow: String,
    pub oauth_clear: bool,
    pub session_start: Option<String>,
    pub session: Option<String>,
    pub session_stop: Option<String>,
    pub session_list: bool,
    pub session_idle_secs: Option<u64>,
    pub session_clean_env: bool,
    pub list_resources: bool,
    pub list_resource_templates: bool,
    pub read_resource: Option<String>,
    pub list_prompts: bool,
    pub get_prompt: Option<String>,
    pub prompt_arg: Vec<String>,
}

Fields

spec: Option<String>

OpenAPI spec URL or local file

mcp: Option<String>

MCP server URL (HTTP streamable / SSE)

mcp_stdio: Option<String>

MCP server as a shell command (stdio transport)

graphql: Option<String>

GraphQL endpoint URL

auth_header: Vec<String>

HTTP header as Name:Value (repeatable; value may use env:/file:)

base_url: Option<String>

Override base URL from OpenAPI spec

cache_key: Option<String>

Custom cache key

cache_ttl: u64

Cache TTL in seconds

refresh: bool

Force re-fetch

list_commands: bool

List available subcommands

search_pattern: Option<String>

Search tools by name or description

detail: Option<String>

List / help JSON detail: names|brief|full

describe: Option<String>

Emit one tool’s full schema as JSON (progressive describe)

verbose: bool

Full tool descriptions in –list

sort: Option<String>

Sort –list: usage|recent|alpha|default

top: Option<usize>

Show only top N tools

compact: bool

Space-separated tool names only (alias for –detail names)

pretty: bool

Pretty-print JSON

raw: bool

Print raw response body

json_output: bool

Force valid JSON output (content-only for MCP; see –envelope)

envelope: bool

Return full MCP CallToolResult envelope (instead of content-only)

toon: bool

TOON encoding (native; falls back to JSON on encode failure)

head: Option<usize>

Limit output to first N array records

max_bytes: Option<usize>

Spill stdout to spool when rendered size exceeds N bytes (0 = never)

inline: bool

Never spill; always print full stdout

agent: bool

Agent defaults: JSON, brief discovery, spool oversize (or SKIFF_AGENT=1)

spool_clean: bool

Delete expired spool files and exit

fields: Option<String>

GraphQL selection set override

transport: String

MCP HTTP transport: auto|sse|streamable

env: Vec<String>

Env KEY=VALUE for MCP stdio (repeatable)

oauth: bool

Enable OAuth (also implied by –oauth-client-id / –oauth-client-secret)

oauth_client_id: Option<String>

OAuth client ID (supports env:/file: secrets)

oauth_client_secret: Option<String>

OAuth client secret (supports env:/file: secrets)

oauth_client_name: String

OAuth client name for DCR

oauth_scope: Option<String>

OAuth scope string

oauth_redirect_uri: Option<String>

Loopback redirect URI (http://127.0.0.1:/callback)

oauth_flow: String

OAuth flow: auto|authorization_code|client_credentials

oauth_clear: bool

Clear cached OAuth credentials for the discovery URL and exit

session_start: Option<String>

Start a named MCP session daemon (requires –mcp or –mcp-stdio; Unix)

session: Option<String>

Use an existing session daemon instead of a one-shot MCP connect (Unix)

session_stop: Option<String>

Stop a named session daemon (SIGTERM, then SIGKILL; Unix)

session_list: bool

List session daemons (use –json for machine-readable output)

session_idle_secs: Option<u64>

Session idle exit after N seconds of no IPC (default 1800; 0 = never)

session_clean_env: bool

For stdio sessions: child gets only PATH/HOME/LANG/TMP* plus –env

list_resources: bool

List MCP resources (via –session today)

list_resource_templates: bool

List MCP resource templates

read_resource: Option<String>

Read an MCP resource by URI

list_prompts: bool

List MCP prompts

get_prompt: Option<String>

Get an MCP prompt by name

prompt_arg: Vec<String>

Prompt argument as key=value (repeatable, with –get-prompt)

Implementations

impl GlobalArgs

pub fn apply_agent_defaults(&mut self)

Apply --agent / SKIFF_AGENT=1 defaults (idempotent).

pub fn list_detail(&self) -> ListDetail

pub fn quiet_list(&self) -> bool

Suppress human list banners.

pub fn output_options(&self) -> OutputOptions

pub fn full_envelope(&self) -> bool

MCP call: content-only unless --envelope.

pub fn parse_auth_headers(&self) -> Result<Vec<(String, String)>>

pub fn parse_env_vars(&self) -> Result<BTreeMap<String, String>>

Trait Implementations

impl Args for GlobalArgs

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 GlobalArgs

fn clone(&self) -> GlobalArgs

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl CommandFactory for GlobalArgs

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 GlobalArgs

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

Formats the value using the given formatter.

impl FromArgMatches for GlobalArgs

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 GlobalArgs

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.