Struct Cli 

pub struct Cli {

    pub vendor: Option<Vendor>,
    pub icon: Option<String>,
    pub format: Option<String>,
    pub tooltip_format: Option<String>,
    pub pace_tolerance: u32,
    pub format_pace_color: bool,
    pub tooltip_pace_pts: bool,
    pub color_low: Option<String>,
    pub color_mid: Option<String>,
    pub color_high: Option<String>,
    pub color_critical: Option<String>,
    pub pretty: bool,
    pub json: bool,
    pub watch: Option<u64>,
    pub cycle_next: bool,
    pub cycle_prev: bool,
    pub cache_dir: Option<PathBuf>,
    pub creds_path: Option<PathBuf>,
}

Fields

vendor: Option<Vendor>

Which vendor to query. When omitted, reads [ui] primary from ~/.config/ai-usagebar/config.toml; falls back to anthropic if neither is set.

icon: Option<String>

Optional icon prepended to the bar text (Nerd Font glyph / emoji / Pango span). claudebar --icon.

format: Option<String>

Bar-text format string with {placeholder} substitutions. Defaults to {session_pct}% · {session_reset}.

tooltip_format: Option<String>

Custom tooltip format. Overrides the default bordered tooltip when set; identical placeholder set as --format.

pace_tolerance: u32

Tolerance band (in percentage points) for ratio-based pacing icons.

format_pace_color: bool

Color pace placeholders individually per window (instead of the global usage-based color). Claudebar --format-pace-color.

tooltip_pace_pts: bool

Use point-based pacing in the tooltip’s pace column (vs ratio-based). Also enables an elapsed-position marker on the tooltip progress bars. Claudebar --tooltip-pace-pts.

color_low: Option<String>

Override the low-usage color (#RRGGBB).

color_mid: Option<String>

Override the mid-usage color (#RRGGBB).

color_high: Option<String>

Override the high-usage color (#RRGGBB).

color_critical: Option<String>

Override the critical-usage color (#RRGGBB).

pretty: bool

Render human-readable terminal output (ANSI colors + box drawing) instead of Waybar JSON. Auto-on when stdout is a TTY.

json: bool

Force JSON output even on a TTY (useful when piping into jq from an interactive shell).

watch: Option<u64>

Re-render every N seconds, clearing the screen between ticks. Implies --pretty. Press Ctrl-C to exit.

cycle_next: bool

Cycle the persisted “active vendor” forward and exit. Wire to Waybar’s on-scroll-up to scroll-cycle through enabled vendors. Sends SIGRTMIN+13 to waybar afterwards so the bar refreshes immediately rather than waiting for the next interval tick.

cycle_prev: bool

Cycle backwards. Wire to on-scroll-down.

cache_dir: Option<PathBuf>

Override the cache directory (for tests / debugging).

creds_path: Option<PathBuf>

Override the credentials file path (for tests / debugging).

Implementations

impl Cli

pub fn resolved_vendor(&self, config: &Config) -> Vendor

Resolve the vendor with full precedence:

1. explicit --vendor (highest)
2. persisted scroll-cycle state (~/.cache/ai-usagebar/active_vendor)
3. [ui] primary from config
4. anthropic (lowest)

This reads the persisted scroll-cycle state from disk via crate::active::read. The pure precedence logic lives in Cli::resolve_vendor_with so it can be unit-tested without touching ~/.cache/ai-usagebar/active_vendor.

pub fn resolve_vendor_with( &self, config: &Config, active: Option<VendorId>, ) -> Vendor

Pure precedence resolution given an explicit scroll-cycle active override (i.e. whatever crate::active::read returned). Split out from the disk read so tests exercise the precedence rules hermetically instead of depending on the developer’s real active_vendor file.

impl Cli

pub fn output_json(&self) -> bool

True when we should emit Waybar JSON. Default behavior: JSON when stdout is piped, pretty when on a TTY (unless --json is set).

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