quotas 0.8.1

CLI that auto-detects AI provider credentials (Claude, Codex, MiniMax, Kimi, Z.ai) and shows your usage quotas in a TUI or JSON.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

#[derive(Clone, Copy)]
pub enum Staleness {
    Fresh,
    Warning,
    Stale,
    Cached,
}

pub struct FreshnessLabel {
    pub label: String,
    pub staleness: Staleness,
    /// How far through the refresh period [0.0, 1.0].
    /// Used to draw the bg-fill progress bar on the freshness text.
    pub fraction: f64,
    /// Whether this label represents cached (static) data without a countdown.
    pub is_cached: bool,
}

impl FreshnessLabel {
    /// Construct with an explicit refresh interval (seconds).
    /// Staleness turns Warning 15s before the next refresh, Stale at/after.
    pub fn with_interval(seconds_ago: i64, interval_secs: u64) -> Self {
        let label = if seconds_ago < 60 {
            format!("Updated {}s ago", seconds_ago)
        } else {
            format!("Updated {}m ago", seconds_ago / 60)
        };
        let iv = interval_secs as i64;
        let fraction = (seconds_ago as f64 / iv as f64).clamp(0.0, 1.0);
        let staleness = if seconds_ago >= iv {
            Staleness::Stale
        } else if seconds_ago >= iv - 15 {
            Staleness::Warning
        } else {
            Staleness::Fresh
        };
        Self {
            label,
            staleness,
            fraction,
            is_cached: false,
        }
    }

    /// Construct for cached data: shows age since cached_at with no countdown bar.
    pub fn cached(seconds_ago: i64) -> Self {
        let label = if seconds_ago < 60 {
            format!("Cached {}s ago", seconds_ago)
        } else {
            format!("Cached {}m ago", seconds_ago / 60)
        };
        Self {
            label,
            staleness: Staleness::Cached,
            fraction: 1.0,
            is_cached: true,
        }
    }
}