use clap::Parser;
use crossterm::event::{
DisableMouseCapture, EnableMouseCapture, Event, KeyCode, KeyEvent, MouseButton, MouseEventKind,
};
use crossterm::execute;
use crossterm::terminal::{
disable_raw_mode, enable_raw_mode, EnterAlternateScreen, LeaveAlternateScreen,
};
use quotas::auth::cursor::CursorAuthResolver;
use quotas::auth::env::EnvResolver;
use quotas::auth::file::{CookieFileResolver, FileResolver};
use quotas::auth::oauth::OAuthFileResolver;
use quotas::auth::opencode::{KimiCliResolver, OpencodeAuthResolver, OpencodeSlot};
use quotas::auth::refresh;
use quotas::auth::{AuthResolver, MultiResolver, StaticResolver};
use quotas::cache;
use quotas::config::Config;
use quotas::output::json::JsonOutput;
use quotas::output::statusline::{self, StatusLineConfig};
use quotas::providers::{Provider, ProviderKind, ProviderResult};
use quotas::tui::Dashboard;
use quotas::tui::DetailMode;
use quotas::tui::Direction;
use quotas::tui::HitResult;
use quotas::tui::ProviderEntry;
use ratatui::backend::CrosstermBackend;
use ratatui::Terminal;
use std::io;
use std::path::PathBuf;
use std::time::{Duration, Instant};
#[derive(Parser, Debug)]
#[command(name = "quotas")]
#[command(about = "Check AI provider usage quotas from your configured credentials", long_about = None)]
struct Args {
#[arg(long)]
json: bool,
#[arg(long)]
pretty: bool,
#[arg(long)]
raw: bool,
#[arg(long)]
statusline: bool,
#[arg(long)]
no_icons: bool,
#[arg(long)]
no_bg_refresh: bool,
#[arg(long)]
cached: bool,
#[arg(long)]
ensure_current: bool,
#[arg(long)]
format: Option<String>,
#[arg(long, hide = true)]
update_cache: bool,
#[arg(long, value_delimiter = ',')]
provider: Vec<String>,
#[arg(long, hide = true)]
snap: bool,
#[arg(long, default_value = "160", hide = true)]
snap_width: u16,
#[arg(long, default_value = "50", hide = true)]
snap_height: u16,
#[arg(long, hide = true)]
snap_output: Option<String>,
}
fn parse_key_file(content: &str) -> Option<String> {
for raw_line in content.lines() {
let line = raw_line.trim();
if line.is_empty() || line.starts_with('#') {
continue;
}
if let Some(rest) = line.strip_prefix("api_key=") {
return Some(rest.trim().trim_matches('"').to_string());
}
if let Some(rest) = line.strip_prefix("token=") {
return Some(rest.trim().trim_matches('"').to_string());
}
if line.contains('=') {
continue;
}
return Some(line.to_string());
}
None
}
fn build_auth_resolver(kind: &ProviderKind, config: &Config) -> Box<dyn AuthResolver> {
match kind {
ProviderKind::Minimax => {
let resolvers: Vec<Box<dyn AuthResolver>> = vec![
Box::new(EnvResolver::new(vec![("MINIMAX_API_KEY", "minimax")])),
Box::new(FileResolver::new(
vec![dirs::home_dir().unwrap_or_default().join(".minimax")],
parse_key_file,
"minimax",
)),
Box::new(OpencodeAuthResolver::new(OpencodeSlot::Minimax)),
];
Box::new(MultiResolver::new(resolvers))
}
ProviderKind::Zai => {
let resolvers: Vec<Box<dyn AuthResolver>> = vec![
Box::new(EnvResolver::new(vec![
("ZHIPU_API_KEY", "zhipu"),
("ZAI_API_KEY", "zai"),
])),
Box::new(FileResolver::new(
vec![dirs::home_dir().unwrap_or_default().join(".api-zai")],
parse_key_file,
"zai",
)),
Box::new(OpencodeAuthResolver::new(OpencodeSlot::Zai)),
];
Box::new(MultiResolver::new(resolvers))
}
ProviderKind::Kimi => {
let resolvers: Vec<Box<dyn AuthResolver>> = vec![
Box::new(EnvResolver::new(vec![
("MOONSHOT_API_KEY", "moonshot"),
("KIMI_API_KEY", "kimi"),
])),
Box::new(FileResolver::new(
vec![
dirs::home_dir().unwrap_or_default().join(".moonshot"),
dirs::home_dir().unwrap_or_default().join(".kimi"),
],
parse_key_file,
"kimi",
)),
Box::new(KimiCliResolver::new()),
Box::new(OpencodeAuthResolver::new(OpencodeSlot::Kimi)),
];
Box::new(MultiResolver::new(resolvers))
}
ProviderKind::Claude => {
let resolvers: Vec<Box<dyn AuthResolver>> = vec![
Box::new(OAuthFileResolver::claude()),
Box::new(OpencodeAuthResolver::new(OpencodeSlot::Anthropic)),
Box::new(EnvResolver::new(vec![("ANTHROPIC_API_KEY", "anthropic")])),
];
Box::new(MultiResolver::new(resolvers))
}
ProviderKind::Codex => {
let resolvers: Vec<Box<dyn AuthResolver>> = vec![
Box::new(OAuthFileResolver::codex()),
Box::new(OpencodeAuthResolver::new(OpencodeSlot::Openai)),
Box::new(EnvResolver::new(vec![("OPENAI_API_KEY", "openai")])),
];
Box::new(MultiResolver::new(resolvers))
}
ProviderKind::Cursor => Box::new(CursorAuthResolver::new()),
ProviderKind::DeepSeek => {
let resolvers: Vec<Box<dyn AuthResolver>> = vec![
Box::new(EnvResolver::new(vec![("DEEPSEEK_API_KEY", "deepseek")])),
Box::new(FileResolver::new(
vec![dirs::home_dir().unwrap_or_default().join(".deepseek")],
parse_key_file,
"deepseek",
)),
];
Box::new(MultiResolver::new(resolvers))
}
ProviderKind::Gemini => {
let resolvers: Vec<Box<dyn AuthResolver>> = vec![
Box::new(OAuthFileResolver::gemini()),
Box::new(EnvResolver::new(vec![("GEMINI_API_KEY", "gemini")])),
Box::new(FileResolver::new(
vec![dirs::home_dir().unwrap_or_default().join(".gemini-api-key")],
parse_key_file,
"gemini",
)),
];
Box::new(MultiResolver::new(resolvers))
}
ProviderKind::SiliconFlow => {
let resolvers: Vec<Box<dyn AuthResolver>> = vec![
Box::new(EnvResolver::new(vec![
("SILICONFLOW_API_KEY", "siliconflow"),
("SILICON_FLOW_API_KEY", "siliconflow"),
])),
Box::new(FileResolver::new(
vec![dirs::home_dir().unwrap_or_default().join(".siliconflow")],
parse_key_file,
"siliconflow",
)),
];
Box::new(MultiResolver::new(resolvers))
}
ProviderKind::OpenRouter => {
let resolvers: Vec<Box<dyn AuthResolver>> = vec![
Box::new(EnvResolver::new(vec![("OPENROUTER_API_KEY", "openrouter")])),
Box::new(FileResolver::new(
vec![dirs::home_dir().unwrap_or_default().join(".openrouter")],
parse_key_file,
"openrouter",
)),
];
Box::new(MultiResolver::new(resolvers))
}
ProviderKind::GitHubCopilot => {
let mut resolvers: Vec<Box<dyn AuthResolver>> = vec![
Box::new(OpencodeAuthResolver::new(OpencodeSlot::GitHubCopilot)),
Box::new(EnvResolver::new(vec![(
"GITHUB_COPILOT_TOKEN",
"github_copilot",
)])),
];
if let Some(token) = config.github_copilot.token.clone() {
resolvers.push(Box::new(StaticResolver {
token,
source: "config:github_copilot.token".into(),
}));
}
Box::new(MultiResolver::new(resolvers))
}
ProviderKind::Mimo => {
let resolvers: Vec<Box<dyn AuthResolver>> = vec![
Box::new(CookieFileResolver::new(
vec![
dirs::home_dir()
.unwrap_or_default()
.join(".config/mimo/cookie"),
dirs::home_dir().unwrap_or_default().join(".mimo-cookie"),
],
"mimo-cookie",
)),
Box::new(EnvResolver::new(vec![
("XIAOMI_MIMO_API_KEY", "xiaomi_mimo"),
("XIAOMI_API_KEY", "xiaomi"),
("MIMO_API_KEY", "mimo"),
])),
Box::new(FileResolver::new(
vec![
dirs::home_dir().unwrap_or_default().join(".mimo-key"),
dirs::home_dir().unwrap_or_default().join(".xiaomimimo"),
dirs::home_dir().unwrap_or_default().join(".mimo"),
],
parse_key_file,
"mimo",
)),
];
Box::new(MultiResolver::new(resolvers))
}
}
}
fn filter_kinds(requested: &[String], config: &Config, cached: bool) -> Vec<ProviderKind> {
if !requested.is_empty() {
let config_enabled = config.providers_enabled_kinds();
let requested_kinds: Vec<_> = requested
.iter()
.filter_map(|s| normalize_provider(s))
.filter(|k| config_enabled.contains(k))
.collect();
if cached {
let cache = cache::read_cache();
return requested_kinds
.into_iter()
.filter(|k| cache.entries.contains_key(k.slug()))
.collect();
}
return requested_kinds;
}
if cached {
let cache = cache::read_cache();
return cache
.entries
.keys()
.filter_map(|s| normalize_provider(s))
.collect();
}
config.providers_enabled_kinds()
}
fn normalize_provider(name: &str) -> Option<ProviderKind> {
match name.to_lowercase().as_str() {
"claude" | "anthropic" => Some(ProviderKind::Claude),
"codex" | "chatgpt" | "openai" => Some(ProviderKind::Codex),
"cursor" => Some(ProviderKind::Cursor),
"deepseek" | "deep-seek" | "deep_seek" => Some(ProviderKind::DeepSeek),
"gemini" => Some(ProviderKind::Gemini),
"kimi" | "moonshot" => Some(ProviderKind::Kimi),
"minimax" => Some(ProviderKind::Minimax),
"zai" | "zhipu" | "z.ai" | "glm" => Some(ProviderKind::Zai),
"siliconflow" | "silicon-flow" | "silicon_flow" => Some(ProviderKind::SiliconFlow),
"openrouter" | "open-router" | "open_router" => Some(ProviderKind::OpenRouter),
"mimo" | "xiaomimimo" | "xiaomi-mimo" | "xiaomi_mimo" => Some(ProviderKind::Mimo),
"copilot" | "github-copilot" | "github_copilot" | "githubcopilot" => {
Some(ProviderKind::GitHubCopilot)
}
_ => None,
}
}
async fn maybe_refresh_creds(kind: ProviderKind, config: &Config) {
if !config.auto_refresh.enabled {
return;
}
match kind {
ProviderKind::Kimi => {
let path = refresh::kimi_creds_path();
let _ = refresh::refresh_kimi_if_expired(&path).await;
if let Some(oc) = refresh::opencode_creds_path() {
let _ = oc;
}
}
ProviderKind::Claude => {
let path = refresh::claude_creds_path();
let _ = refresh::refresh_claude_if_expired(&path).await;
if let Some(oc) = refresh::opencode_creds_path() {
let _ = refresh::refresh_opencode_anthropic_if_expired(&oc).await;
}
}
ProviderKind::Codex => {
let path = refresh::codex_creds_path();
let _ = refresh::refresh_codex_if_expired(&path).await;
if let Some(oc) = refresh::opencode_creds_path() {
let _ = refresh::refresh_opencode_openai_if_expired(&oc).await;
}
}
_ => {}
}
}
async fn fetch_one(kind: ProviderKind, config: &Config) -> ProviderResult {
maybe_refresh_creds(kind, config).await;
let auth = build_auth_resolver(&kind, config);
let provider: Box<dyn Provider> = match kind {
ProviderKind::Claude => Box::new(quotas::providers::claude::ClaudeProvider::new(auth)),
ProviderKind::Codex => Box::new(quotas::providers::codex::CodexProvider::new(auth)),
ProviderKind::Cursor => Box::new(quotas::providers::cursor::CursorProvider::new(auth)),
ProviderKind::Minimax => Box::new(
quotas::providers::minimax::MinimaxProvider::with_multi_resolver(MultiResolver::new(
vec![auth],
)),
),
ProviderKind::Zai => Box::new(quotas::providers::zai::ZaiProvider::new(auth)),
ProviderKind::Kimi => Box::new(quotas::providers::kimi::KimiProvider::new(auth)),
ProviderKind::DeepSeek => {
Box::new(quotas::providers::deepseek::DeepSeekProvider::new(auth))
}
ProviderKind::Gemini => Box::new(quotas::providers::gemini::GeminiProvider::new(auth)),
ProviderKind::SiliconFlow => Box::new(
quotas::providers::siliconflow::SiliconFlowProvider::new(auth),
),
ProviderKind::OpenRouter => {
Box::new(quotas::providers::openrouter::OpenRouterProvider::new(auth))
}
ProviderKind::Mimo => Box::new(quotas::providers::mimo::MimoProvider::new(auth)),
ProviderKind::GitHubCopilot => Box::new(
quotas::providers::github_copilot::GitHubCopilotProvider::new(auth),
),
};
let auth_source = provider
.auth_resolver()
.resolve()
.await
.ok()
.map(|a| a.source);
let mut result = match provider.fetch().await {
Ok(r) => r,
Err(quotas::Error::Auth(msg)) => auth_required_result(kind, msg),
Err(e) => network_error_result(kind, e.to_string()),
};
result.auth_source = auth_source;
result
}
fn fetch_provider_sync(kind: ProviderKind, config: &Config) -> ProviderResult {
let rt = match tokio::runtime::Builder::new_current_thread()
.enable_all()
.build()
{
Ok(rt) => rt,
Err(e) => return network_error_result(kind, e.to_string()),
};
rt.block_on(fetch_one(kind, config))
}
fn auth_required_result(kind: ProviderKind, _reason: String) -> ProviderResult {
ProviderResult {
kind,
status: quotas::providers::ProviderStatus::AuthRequired,
fetched_at: chrono::Utc::now(),
raw_response: None,
auth_source: None,
cached_at: None,
}
}
fn network_error_result(kind: ProviderKind, message: String) -> ProviderResult {
ProviderResult {
kind,
status: quotas::providers::ProviderStatus::NetworkError { message },
fetched_at: chrono::Utc::now(),
raw_response: None,
auth_source: None,
cached_at: None,
}
}
fn auto_refresh_interval(kind: ProviderKind) -> Duration {
match kind {
ProviderKind::Claude => Duration::from_secs(600), _ => Duration::from_secs(300), }
}
fn should_startup_fetch(cached: bool, refresh_on_start: bool, has_creds: bool) -> bool {
!cached && refresh_on_start && has_creds
}
fn should_periodic_refresh(cached: bool, auto_refresh_enabled: bool) -> bool {
!cached && auto_refresh_enabled
}
struct PeriodicRefreshState<'a> {
cached: bool,
auto_refresh_enabled: bool,
show_detail: bool,
selected_entry: Option<usize>,
kinds: &'a [ProviderKind],
auth_ready: &'a [bool],
entry_done: &'a [bool],
elapsed: &'a [Duration],
}
fn periodic_refresh_candidates(state: PeriodicRefreshState<'_>) -> Vec<usize> {
if !should_periodic_refresh(state.cached, state.auto_refresh_enabled) {
return Vec::new();
}
let indices: Vec<usize> = if state.show_detail {
state.selected_entry.into_iter().collect()
} else {
(0..state.kinds.len()).collect()
};
indices
.into_iter()
.filter(|&idx| state.auth_ready.get(idx).copied().unwrap_or(false))
.filter(|&idx| state.entry_done.get(idx).copied().unwrap_or(false))
.filter(|&idx| {
state
.elapsed
.get(idx)
.is_some_and(|elapsed| *elapsed >= auto_refresh_interval(state.kinds[idx]))
})
.collect()
}
fn should_backdate_refresh_timer(refresh_on_start: bool, startup_fetching: bool) -> bool {
refresh_on_start && !startup_fetching
}
fn fetch_all(kinds: Vec<ProviderKind>, config: &Config) -> Vec<ProviderResult> {
let results: Vec<ProviderResult> = kinds
.into_iter()
.map(|k| fetch_provider_sync(k, config))
.collect();
cache::write_cache(&results);
results
}
fn fetch_with_staleness_check(kinds: Vec<ProviderKind>, config: &Config) -> Vec<ProviderResult> {
let cache = cache::read_cache();
let now = chrono::Utc::now();
let mut results = Vec::with_capacity(kinds.len());
let mut fresh_results = Vec::new();
for kind in kinds {
let key = kind.slug().to_string();
let staleness_threshold = config.staleness.staleness_threshold(&key);
if let Some(entry) = cache.entries.get(&key) {
let age_secs = (now - entry.cached_at).num_seconds() as u64;
if age_secs < staleness_threshold {
let mut result = entry.result.clone();
result.cached_at = Some(entry.cached_at);
results.push(result);
continue;
}
}
let result = fetch_provider_sync(kind, config);
fresh_results.push(result);
}
if !fresh_results.is_empty() {
cache::write_cache(&fresh_results);
}
results.extend(fresh_results);
results
}
fn spawn_fetches_for(
rt: &tokio::runtime::Runtime,
kinds: &[ProviderKind],
indices: &[usize],
config: Config,
tx: tokio::sync::mpsc::UnboundedSender<(usize, ProviderResult)>,
) {
for &idx in indices {
let kind = kinds[idx];
let tx = tx.clone();
let config = config.clone();
rt.spawn(async move {
let result = fetch_one(kind, &config).await;
let _ = tx.send((idx, result));
});
}
}
fn render_dashboard_text(dashboard: &Dashboard, width: u16, height: u16) -> String {
use ratatui::backend::TestBackend;
let backend = TestBackend::new(width, height);
let mut terminal = Terminal::new(backend).unwrap();
terminal.draw(|f| dashboard.render(f)).unwrap();
let buffer = terminal.backend().buffer().clone();
let mut lines = Vec::new();
for y in 0..height {
let mut line = String::new();
for x in 0..width {
line.push_str(buffer.cell((x, y)).map(|c| c.symbol()).unwrap_or(" "));
}
lines.push(line.trim_end().to_string());
}
lines.join("\n") + "\n"
}
fn snap_page_output_path(path: &str, page_number: usize) -> PathBuf {
let original = PathBuf::from(path);
let suffix = format!("page{page_number}");
match (original.file_stem(), original.extension()) {
(Some(stem), Some(ext)) => original.with_file_name(format!(
"{}-{}.{}",
stem.to_string_lossy(),
suffix,
ext.to_string_lossy()
)),
(Some(stem), None) => {
original.with_file_name(format!("{}-{}", stem.to_string_lossy(), suffix))
}
_ => PathBuf::from(format!("{path}-{suffix}")),
}
}
fn run_snap(
kinds: Vec<ProviderKind>,
config: Config,
width: u16,
height: u16,
output: Option<&str>,
) {
let disk_cache = cache::read_cache();
let now = chrono::Utc::now();
let entries: Vec<ProviderEntry> = kinds
.iter()
.map(|kind| {
let key = kind.slug().to_string();
if let Some(entry) = disk_cache.entries.get(&key) {
let mut result = entry.result.clone();
result.cached_at = Some(entry.cached_at);
ProviderEntry::Done(result)
} else {
ProviderEntry::Done(ProviderResult {
kind: *kind,
status: quotas::providers::ProviderStatus::AuthRequired,
fetched_at: now,
raw_response: None,
auth_source: None,
cached_at: None,
})
}
})
.collect();
let mut dashboard = Dashboard::new_with_entries(kinds, entries);
dashboard.show_all_windows = config.ui.show_all_windows;
dashboard.vertical_spanning = config.ui.vertical_spanning;
dashboard.auto_refresh_enabled = config.tui.auto_refresh;
for provider in &config.favorites.providers {
dashboard.set_provider_favorite(provider, true);
}
for (provider, preferences) in &config.quota_preferences {
dashboard.set_quota_preferences(provider, preferences.clone());
}
if dashboard.all_loaded() {
dashboard.refresh_visual_order();
}
let out = render_dashboard_text(&dashboard, width, height);
let pages = dashboard.page_count();
if let Some(path) = output {
if let Err(e) = std::fs::write(path, &out) {
eprintln!("Error writing to {path}: {e}");
std::process::exit(1);
}
eprintln!("Wrote {path}");
for page in 1..pages {
dashboard.select_page(page);
let page_out = render_dashboard_text(&dashboard, width, height);
let page_path = snap_page_output_path(path, page + 1);
if let Err(e) = std::fs::write(&page_path, &page_out) {
eprintln!("Error writing {}: {e}", page_path.display());
std::process::exit(1);
}
eprintln!("Wrote {}", page_path.display());
}
} else {
print!("{out}");
for page in 1..pages {
dashboard.select_page(page);
print!("{}", render_dashboard_text(&dashboard, width, height));
}
}
}
fn run_tui(kinds: Vec<ProviderKind>, config: Config, cached: bool) -> io::Result<()> {
let mut config = config;
let rt = tokio::runtime::Builder::new_multi_thread()
.enable_all()
.worker_threads(2)
.build()
.map_err(io::Error::other)?;
let disk_cache = cache::read_cache();
let now = chrono::Utc::now();
let auth_resolvers: Vec<Box<dyn AuthResolver>> =
kinds.iter().map(|k| build_auth_resolver(k, &config)).collect();
let auth_ready: Vec<bool> = auth_resolvers
.iter()
.map(|resolver| resolver.have_credentials())
.collect();
let mut initial_entries = Vec::with_capacity(kinds.len());
let mut fetch_indices: Vec<usize> = Vec::new();
for (idx, kind) in kinds.iter().enumerate() {
let key = kind.slug().to_string();
let has_creds = auth_resolvers[idx].have_credentials();
let fetch_on_start = should_startup_fetch(cached, config.tui.refresh_on_start, has_creds);
if cached {
if let Some(entry) = disk_cache.entries.get(&key) {
let mut result = entry.result.clone();
result.cached_at = Some(entry.cached_at);
initial_entries.push(ProviderEntry::Done(result));
} else if has_creds {
initial_entries.push(ProviderEntry::Done(ProviderResult {
kind: *kind,
status: quotas::providers::ProviderStatus::AuthRequired,
fetched_at: now,
raw_response: None,
auth_source: None,
cached_at: None,
}));
} else {
initial_entries.push(ProviderEntry::Done(auth_required_result(
*kind,
"no credentials".into(),
)));
}
continue;
}
if let Some(entry) = disk_cache.entries.get(&key) {
let mut result = entry.result.clone();
result.cached_at = Some(entry.cached_at);
if fetch_on_start {
initial_entries.push(ProviderEntry::Refreshing(result));
fetch_indices.push(idx);
} else {
initial_entries.push(ProviderEntry::Done(result));
}
} else if has_creds {
if fetch_on_start {
initial_entries.push(ProviderEntry::Loading);
fetch_indices.push(idx);
} else {
initial_entries.push(ProviderEntry::Done(ProviderResult {
kind: *kind,
status: quotas::providers::ProviderStatus::Unavailable {
info: quotas::providers::UnavailableInfo {
reason: "No cached data; startup refresh disabled".into(),
console_url: None,
},
},
fetched_at: now,
raw_response: None,
auth_source: None,
cached_at: None,
}));
}
} else {
initial_entries.push(ProviderEntry::Done(auth_required_result(
*kind,
"no credentials".into(),
)));
}
}
let mut dashboard = Dashboard::new_with_entries(kinds.clone(), initial_entries);
dashboard.show_all_windows = config.ui.show_all_windows;
dashboard.vertical_spanning = config.ui.vertical_spanning;
dashboard.auto_refresh_enabled = config.tui.auto_refresh;
for provider in &config.favorites.providers {
dashboard.set_provider_favorite(provider, true);
}
for (provider, preferences) in &config.quota_preferences {
dashboard.set_quota_preferences(provider, preferences.clone());
}
if dashboard.all_loaded() {
dashboard.refresh_visual_order();
}
enable_raw_mode()?;
let mut stdout = io::stdout();
execute!(stdout, EnterAlternateScreen, EnableMouseCapture)?;
let backend = CrosstermBackend::new(stdout);
let mut terminal = Terminal::new(backend)?;
let (mut cur_tx, mut rx) = tokio::sync::mpsc::unbounded_channel::<(usize, ProviderResult)>();
if !fetch_indices.is_empty() {
spawn_fetches_for(&rt, &kinds, &fetch_indices, config.clone(), cur_tx.clone());
}
let mut last_refresh: Vec<Instant> = kinds
.iter()
.enumerate()
.map(|(idx, _)| {
if fetch_indices.contains(&idx) {
Instant::now()
} else if should_backdate_refresh_timer(
config.tui.refresh_on_start,
fetch_indices.contains(&idx),
) {
if let Some(entry) = disk_cache.entries.get(kinds[idx].slug()) {
let age_secs = (now - entry.cached_at).num_seconds().max(0) as u64;
let elapsed = Duration::from_secs(age_secs);
Instant::now()
.checked_sub(elapsed)
.unwrap_or(Instant::now())
} else {
Instant::now()
}
} else {
Instant::now()
}
})
.collect();
let tick = Duration::from_millis(80);
let result: io::Result<()> = (|| loop {
terminal.draw(|f| dashboard.render(f))?;
while let Ok((idx, result)) = rx.try_recv() {
cache::write_cache(std::slice::from_ref(&result));
dashboard.update(idx, result);
last_refresh[idx] = Instant::now();
}
if should_periodic_refresh(cached, dashboard.auto_refresh_enabled) {
let elapsed: Vec<Duration> = last_refresh.iter().map(|instant| instant.elapsed()).collect();
let entry_done: Vec<bool> = (0..kinds.len()).map(|idx| dashboard.is_entry_done(idx)).collect();
let targets = periodic_refresh_candidates(PeriodicRefreshState {
cached,
auto_refresh_enabled: dashboard.auto_refresh_enabled,
show_detail: dashboard.show_detail,
selected_entry: dashboard.selected_entry_index(),
kinds: &kinds,
auth_ready: &auth_ready,
entry_done: &entry_done,
elapsed: &elapsed,
});
for idx in targets {
let kind = kinds[idx];
dashboard.reset_one(idx);
let tx2 = cur_tx.clone();
let config2 = config.clone();
rt.spawn(async move {
let result = fetch_one(kind, &config2).await;
let _ = tx2.send((idx, result));
});
last_refresh[idx] = Instant::now();
}
}
if crossterm::event::poll(tick)? {
match crossterm::event::read()? {
Event::Mouse(me) => match me.kind {
MouseEventKind::ScrollDown => {
if dashboard.show_detail {
dashboard.scroll_detail(3);
} else {
dashboard.navigate(Direction::Down);
}
}
MouseEventKind::ScrollUp => {
if dashboard.show_detail {
dashboard.scroll_detail(-3);
} else {
dashboard.navigate(Direction::Up);
}
}
MouseEventKind::Down(MouseButton::Left) => {
match dashboard.hit_test(me.column, me.row) {
Some(HitResult::Refresh) => {
let (new_tx, new_rx) = tokio::sync::mpsc::unbounded_channel();
rx = new_rx;
cur_tx = new_tx;
let fetchable: Vec<usize> = (0..kinds.len())
.filter(|&i| auth_ready[i])
.collect();
for &idx in &fetchable {
dashboard.reset_one(idx);
}
spawn_fetches_for(
&rt,
&kinds,
&fetchable,
config.clone(),
cur_tx.clone(),
);
for &idx in &fetchable {
last_refresh[idx] = Instant::now();
}
}
Some(HitResult::AutoRefreshToggle) => {
dashboard.auto_refresh_enabled = !dashboard.auto_refresh_enabled;
}
Some(HitResult::Quit) => return Ok(()),
Some(HitResult::Card(vpos)) => {
if dashboard.selected_index == vpos && !dashboard.show_detail {
dashboard.show_detail = true;
dashboard.detail_mode = DetailMode::Auto;
dashboard.reset_detail_position();
} else {
dashboard.selected_index = vpos;
dashboard.show_detail = false;
}
}
None => {}
}
}
MouseEventKind::Moved => {
dashboard.set_mouse_pos(me.column, me.row);
}
_ => {}
},
Event::Key(KeyEvent { code, .. }) => match code {
KeyCode::Char('q') | KeyCode::Char('Q') => return Ok(()),
KeyCode::Esc | KeyCode::Backspace if dashboard.show_detail => {
dashboard.show_detail = false;
}
KeyCode::Char('r') | KeyCode::Char('R') => {
let (new_tx, new_rx) = tokio::sync::mpsc::unbounded_channel();
rx = new_rx;
cur_tx = new_tx;
let fetchable: Vec<usize> = (0..kinds.len())
.filter(|&i| auth_ready[i])
.collect();
for &idx in &fetchable {
dashboard.reset_one(idx);
}
spawn_fetches_for(&rt, &kinds, &fetchable, config.clone(), cur_tx.clone());
for &idx in &fetchable {
last_refresh[idx] = Instant::now();
}
}
KeyCode::Char('c') | KeyCode::Char('C') => {
if let Some(selected) = dashboard.selected_provider() {
if let Ok(json) = serde_json::to_string_pretty(selected) {
if let Ok(mut ctx) = arboard::Clipboard::new() {
let _ = ctx.set_text(&json);
}
}
}
}
KeyCode::Char('f') | KeyCode::Char('F') if dashboard.show_detail => {
if let Some(provider) = dashboard.selected_provider_slug() {
if let Some(row) = dashboard.selected_detail_row() {
config.toggle_quota_favorite(&provider, &row.quota_key);
let prefs = config.quota_preferences_for(&provider);
dashboard.set_quota_preferences(&provider, prefs);
} else {
config.toggle_provider_favorite(&provider);
dashboard.toggle_selected_provider_favorite();
}
let _ = config.save();
}
}
KeyCode::Char('f') | KeyCode::Char('F') => {
if let Some(provider) = dashboard.toggle_selected_provider_favorite() {
config.toggle_provider_favorite(&provider);
let _ = config.save();
}
}
KeyCode::Char('x') | KeyCode::Char('X') if dashboard.show_detail => {
if let Some(provider) = dashboard.selected_provider_slug() {
if let Some(row) = dashboard.selected_detail_row() {
config.toggle_quota_hidden(&provider, &row.quota_key);
let prefs = config.quota_preferences_for(&provider);
dashboard.set_quota_preferences(&provider, prefs);
dashboard.move_detail_focus(0);
let _ = config.save();
}
}
}
KeyCode::Char('a') | KeyCode::Char('A') => {
dashboard.auto_refresh_enabled = !dashboard.auto_refresh_enabled;
}
KeyCode::Enter => {
if dashboard.show_detail {
dashboard.show_detail = false;
dashboard.reset_detail_position();
} else {
dashboard.show_detail = true;
dashboard.detail_mode = DetailMode::Auto;
dashboard.reset_detail_position();
}
}
KeyCode::Tab if dashboard.show_detail => {
dashboard.cycle_detail_mode();
}
KeyCode::Left | KeyCode::Char('h') => {
if dashboard.show_detail {
dashboard.detail_prev();
} else {
dashboard.navigate(Direction::Left);
}
}
KeyCode::Right | KeyCode::Char('l') => {
if dashboard.show_detail {
dashboard.detail_next();
} else {
dashboard.navigate(Direction::Right);
}
}
KeyCode::Up | KeyCode::Char('k') => {
if dashboard.show_detail {
dashboard.move_detail_focus(-1);
} else {
dashboard.navigate(Direction::Up);
}
}
KeyCode::Down | KeyCode::Char('j') => {
if dashboard.show_detail {
dashboard.move_detail_focus(1);
} else {
dashboard.navigate(Direction::Down);
}
}
KeyCode::PageUp => {
if dashboard.show_detail {
dashboard.scroll_detail(-20);
} else {
dashboard.page_up();
}
}
KeyCode::PageDown => {
if dashboard.show_detail {
dashboard.scroll_detail(20);
} else {
dashboard.page_down();
}
}
_ => {}
},
_ => {}
} } else if !dashboard.all_loaded() {
dashboard.tick_spinner();
}
})();
disable_raw_mode()?;
execute!(
terminal.backend_mut(),
DisableMouseCapture,
LeaveAlternateScreen
)?;
terminal.show_cursor()?;
result
}
fn main() {
let args = Args::parse();
let config = Config::load();
let kinds = filter_kinds(&args.provider, &config, args.cached);
if args.update_cache {
let _ = fetch_all(kinds, &config);
return;
}
if args.raw {
let results = fetch_all(kinds, &config);
let mut map = serde_json::Map::new();
for r in results {
let key = r.kind.slug().to_string();
let value = match r.raw_response {
Some(v) => v,
None => serde_json::json!({
"status": match r.status {
quotas::providers::ProviderStatus::AuthRequired => "auth_required",
quotas::providers::ProviderStatus::NetworkError { .. } => "network_error",
quotas::providers::ProviderStatus::Unavailable { .. } => "unavailable",
quotas::providers::ProviderStatus::Available { .. } => "available_no_raw",
},
"note": "no raw response captured"
}),
};
map.insert(key, value);
}
let wrapped = serde_json::Value::Object(map);
println!(
"{}",
serde_json::to_string_pretty(&wrapped).unwrap_or_default()
);
return;
}
if args.json {
let results = if args.cached {
let cache = cache::read_cache();
cache
.entries
.into_values()
.map(|e| {
let mut result = e.result;
result.cached_at = Some(e.cached_at);
result
})
.collect()
} else if args.ensure_current {
fetch_with_staleness_check(kinds, &config)
} else {
fetch_all(kinds, &config)
};
let cache = cache::read_cache();
println!(
"{}",
JsonOutput::from_results(results, &cache).to_json(args.pretty)
);
return;
}
if args.statusline {
run_statusline(&args, &config);
return;
}
if args.snap {
run_snap(
kinds,
config,
args.snap_width,
args.snap_height,
args.snap_output.as_deref(),
);
return;
}
if let Err(e) = run_tui(kinds.clone(), config, args.cached) {
eprintln!("Error: {:?}", e);
}
}
const BG_REFRESH_THRESHOLD_SECS: u64 = 30 * 60;
fn run_statusline(args: &Args, config: &Config) {
let cache = cache::read_cache();
let sl_config = StatusLineConfig {
icons: if args.no_icons {
false
} else {
config.statusline.icons
},
providers: filter_kinds(&args.provider, config, args.cached),
format: args.format.clone(),
};
let line = statusline::render(&cache, &sl_config);
if !line.is_empty() {
println!("{line}");
}
let bg_enabled = if args.no_bg_refresh {
false
} else {
config.statusline.bg_refresh
};
if bg_enabled && !args.cached {
if let Some(age) = cache::cache_age(&cache) {
if age.as_secs() >= BG_REFRESH_THRESHOLD_SECS {
let _ = spawn_bg_refresh();
}
}
}
}
fn spawn_bg_refresh() -> io::Result<()> {
let self_exe = std::env::current_exe()?;
let mut cmd = std::process::Command::new(self_exe);
cmd.arg("--update-cache");
cmd.stdin(std::process::Stdio::null());
cmd.stdout(std::process::Stdio::null());
cmd.stderr(std::process::Stdio::null());
#[cfg(unix)]
{
cmd.arg("--"); }
cmd.spawn()?;
Ok(())
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn parse_key_file_accepts_raw_token_on_first_line() {
assert_eq!(parse_key_file("sk-cp-abc\n").as_deref(), Some("sk-cp-abc"));
}
#[test]
fn parse_key_file_accepts_api_key_assignment() {
assert_eq!(
parse_key_file("# my key\napi_key=\"sk-cp-xyz\"\n").as_deref(),
Some("sk-cp-xyz")
);
}
#[test]
fn parse_key_file_skips_comments_and_blanks() {
assert_eq!(
parse_key_file("\n# comment\n\nsk-live-0\n").as_deref(),
Some("sk-live-0")
);
}
#[test]
fn parse_key_file_empty_returns_none() {
assert_eq!(parse_key_file(""), None);
}
#[test]
fn startup_fetch_runs_by_default_when_credentials_exist() {
assert!(should_startup_fetch(false, true, true));
}
#[test]
fn startup_fetch_stops_when_disabled() {
assert!(!should_startup_fetch(false, false, true));
}
#[test]
fn startup_fetch_stops_in_cached_mode() {
assert!(!should_startup_fetch(true, true, true));
}
#[test]
fn startup_fetch_requires_credentials() {
assert!(!should_startup_fetch(false, true, false));
}
#[test]
fn periodic_refresh_follows_tui_toggle() {
assert!(should_periodic_refresh(false, true));
assert!(!should_periodic_refresh(false, false));
assert!(!should_periodic_refresh(true, true));
}
#[test]
fn periodic_refresh_targets_only_selected_provider_in_detail_view() {
let kinds = vec![ProviderKind::Claude, ProviderKind::Codex, ProviderKind::Gemini];
let auth_ready = vec![true, true, true];
let entry_done = vec![true, true, true];
let elapsed = vec![
Duration::from_secs(601),
Duration::from_secs(301),
Duration::from_secs(301),
];
let targets = periodic_refresh_candidates(PeriodicRefreshState {
cached: false,
auto_refresh_enabled: true,
show_detail: true,
selected_entry: Some(1),
kinds: &kinds,
auth_ready: &auth_ready,
entry_done: &entry_done,
elapsed: &elapsed,
});
assert_eq!(targets, vec![1]);
}
#[test]
fn periodic_refresh_targets_all_due_providers_on_dashboard() {
let kinds = vec![ProviderKind::Claude, ProviderKind::Codex, ProviderKind::Gemini];
let auth_ready = vec![true, true, false];
let entry_done = vec![true, true, true];
let elapsed = vec![
Duration::from_secs(601),
Duration::from_secs(301),
Duration::from_secs(301),
];
let targets = periodic_refresh_candidates(PeriodicRefreshState {
cached: false,
auto_refresh_enabled: true,
show_detail: false,
selected_entry: Some(1),
kinds: &kinds,
auth_ready: &auth_ready,
entry_done: &entry_done,
elapsed: &elapsed,
});
assert_eq!(targets, vec![0, 1]);
}
#[test]
fn refresh_timer_backdates_only_when_startup_refresh_is_allowed() {
assert!(should_backdate_refresh_timer(true, false));
assert!(!should_backdate_refresh_timer(false, false));
assert!(!should_backdate_refresh_timer(true, true));
}
#[test]
fn snap_page_output_path_inserts_page_before_extension() {
let path = snap_page_output_path("screenshots/snap.txt", 2);
assert_eq!(path.to_string_lossy(), "screenshots/snap-page2.txt");
}
#[test]
fn snap_page_output_path_handles_no_extension() {
let path = snap_page_output_path("screenshots/snap", 3);
assert_eq!(path.to_string_lossy(), "screenshots/snap-page3");
}
}