Providers

Fetch strategies (current)

Legend: web (browser cookies/WebView), cli (RPC/PTy or provider CLI), oauth (provider OAuth), api token, local probe, web dashboard. Source labels (CLI/header): openai-web, web, oauth, api, local, cli, plus provider-specific CLI labels (e.g. codex-cli, claude).

Cookie-based providers expose a Cookie source picker (Automatic or Manual) in Settings → Providers. Some browser cookie imports are cached in Keychain and reused until the session is invalid. API keys, manual cookie headers, source selection, provider ordering, and token accounts are stored in ~/.codexbar/config.json.

Provider	Strategies (ordered for auto)
Codex	App Auto: OAuth API (oauth) → CLI RPC/PTy (codex-cli). CLI Auto: Web dashboard (openai-web) → CLI RPC/PTy (codex-cli).
Claude	App Auto: OAuth API (oauth) → CLI PTY (claude) → Web API (web). CLI Auto: Web API (web) → CLI PTY (claude).
Gemini	OAuth-backed API via Gemini CLI credentials (api).
Antigravity	Local LSP/HTTP probe (local).
Cursor	Web API via cookies → stored WebKit session (web).
OpenCode	Web dashboard via cookies (web).
OpenCode Go	Web dashboard via cookies (web); optional workspace ID.
Alibaba Coding Plan	Console RPC via web cookies (auto/manual) with API key fallback (web, api).
Droid/Factory	Web cookies → stored tokens → local storage → WorkOS cookies (web).
z.ai	API token from config/env → quota API (api).
MiniMax	Manual/browser session via Coding Plan web path (web), or Coding Plan API token (api).
Kimi	Auth token from kimi-auth cookie/manual token/env → usage API (web).
Kilo	API token from config/env → usage API (api); auto falls back to CLI session auth (cli).
Copilot	Device-flow/env/config token → copilot_internal API (api).
Kimi K2	API key from config/env → credit endpoint (api).
Kiro	CLI command via kiro-cli chat --no-interactive "/usage" (cli).
Vertex AI	Google ADC OAuth (gcloud) → Cloud Monitoring quota usage (oauth).
Augment	auggie CLI first, then browser-cookie web fallback (cli, web).
JetBrains AI	Local XML quota file (local).
Amp	Web settings page via browser cookies (web).
Warp	API token (config/env) → GraphQL request limits (api).
Ollama	Web settings page via browser cookies (web).
Synthetic	API key from config/env → quota API (api).
OpenRouter	API token (config, overrides env) → credits API (api).
Perplexity	Browser cookies/manual cookie/env session token → credits API (web).
Abacus AI	Browser cookies → compute points + billing API (web).
Mistral	Console billing API via Ory Kratos session cookies (web).
DeepSeek	API key from env or token accounts → balance endpoint (api).
Codebuff	API token from config/env or codebuff login credentials → usage API (api).

Codex

• Web dashboard (optional, off by default): https://chatgpt.com/codex/settings/usage via WebView + browser cookies.
• Battery saver toggle (currently off by default): reduces routine OpenAI web refreshes but still allows explicit manual refreshes.
• CLI RPC default: codex ... app-server JSON-RPC (account/read, account/rateLimits/read).
• CLI PTY: manual diagnostics/parser coverage only; automatic refresh does not launch bare Codex TUI.
• Local cost usage: scans CODEX_HOME (or ~/.codex) sessions and sibling archived_sessions JSONL files (last 30 days).
• Status: Statuspage.io (OpenAI).
• Details: docs/codex.md.

Claude

• App Auto: OAuth API (oauth) → CLI PTY (claude) → Web API (web).
• CLI Auto: Web API (web) → CLI PTY (claude).
• Local cost usage: scans CLAUDE_CONFIG_DIR when set, otherwise ~/.config/claude/projects and ~/.claude/projects JSONL files (last 30 days).
• Status: Statuspage.io (Anthropic).
• Details: docs/claude.md.

z.ai

• API token from ~/.codexbar/config.json (providers[].apiKey) or Z_AI_API_KEY env var.
• Supports global and BigModel CN quota hosts; override with Z_AI_API_HOST or Z_AI_QUOTA_URL.
• Status: none yet.
• Details: docs/zai.md.

MiniMax

• Coding Plan API token or web session from configured/manual/browser sources.
• Supports global and China mainland hosts via provider region settings and environment overrides.
• Status: none yet.
• Details: docs/minimax.md.

Kimi

• Auth token (JWT from kimi-auth cookie) via manual entry or KIMI_AUTH_TOKEN env var.
• Shows weekly quota and 5-hour rate limit (300 minutes).
• Status: none yet.
• Details: docs/kimi.md.

Kilo

• API token from ~/.codexbar/config.json (providers[].apiKey) or KILO_API_KEY.
• Auto mode tries API first and falls back to CLI auth when API credentials are missing or unauthorized.
• CLI auth source: ~/.local/share/kilo/auth.json (kilo.access), typically created by kilo login.
• Status: none yet.
• Details: docs/kilo.md.

Kimi K2

• API key via ~/.codexbar/config.json or KIMI_K2_API_KEY/KIMI_API_KEY env var.
• Shows credit usage based on consumed/remaining totals.
• Status: none yet.
• Details: docs/kimi-k2.md.

Gemini

• OAuth-backed quota API (retrieveUserQuota) using Gemini CLI credentials.
• Token refresh via Google OAuth if expired.
• Tier detection via loadCodeAssist.
• Status: Google Workspace incidents (Gemini product).
• Details: docs/gemini.md.

Antigravity

• Local Antigravity language server (internal protocol, HTTPS on localhost).
• GetUserStatus primary; GetCommandModelConfigs fallback.
• Status: Google Workspace incidents (Gemini product).
• Details: docs/antigravity.md.

Cursor

• Web API via browser cookies (cursor.com + cursor.sh).
• Fallback: stored WebKit session.
• Status: Statuspage.io (Cursor).
• Details: docs/cursor.md.

OpenCode

• Web dashboard via browser cookies (opencode.ai).
• Status: none yet.
• Details: docs/opencode.md.

OpenCode Go

• Web dashboard via browser cookies (opencode.ai).
• Uses the workspace Go page/server data for rolling 5-hour, weekly, and optional monthly usage windows.
• Optional workspace ID comes from ~/.codexbar/config.json (providers[].workspaceID) or CODEXBAR_OPENCODEGO_WORKSPACE_ID.
• Status: none yet.
• Details: docs/opencode.md.

Alibaba Coding Plan

• Web mode uses Alibaba console RPC with form payload + sec_token.
• Cookie sources: browser import (auto) or manual header (cookieSource: manual).
• API key fallback from Settings (providers[].apiKey) or ALIBABA_CODING_PLAN_API_KEY env var.
• Region hosts: international (ap-southeast-1) and China mainland (cn-beijing).
• Host overrides: ALIBABA_CODING_PLAN_HOST or ALIBABA_CODING_PLAN_QUOTA_URL.
• Status: https://status.aliyun.com (link only, no auto-polling).
• Details: docs/alibaba-coding-plan.md.

Droid (Factory)

• Web API via Factory cookies, bearer tokens, and WorkOS refresh tokens.
• Multiple fallback strategies (cookies → stored tokens → local storage → WorkOS cookies).
• Status: https://status.factory.ai.
• Details: docs/factory.md.

Copilot

• GitHub device flow OAuth token + api.github.com/copilot_internal/user.
• Supports multiple token accounts and account switching from provider settings/menu surfaces.
• Status: Statuspage.io (GitHub).
• Details: docs/copilot.md.

Kiro

• CLI-based: runs kiro-cli chat --no-interactive "/usage" with 10s timeout.
• Parses ANSI output for plan name, monthly credits percentage, and bonus credits.
• Requires kiro-cli installed and logged in via AWS Builder ID.
• Status: AWS Health Dashboard (manual link, no auto-polling).
• Details: docs/kiro.md.

Warp

• API token from Settings or WARP_API_KEY / WARP_TOKEN env var.
• Shows monthly credits usage and next refresh time.
• Status: none yet.
• Details: docs/warp.md.

Vertex AI

• OAuth credentials from gcloud auth application-default login (ADC).
• Quota usage via Cloud Monitoring consumer_quota metrics for aiplatform.googleapis.com.
• Token cost: uses the Claude local-log scanner filtered to Vertex AI-tagged entries.
• Requires Cloud Monitoring API access in the current project.
• Details: docs/vertexai.md.

JetBrains AI

• Local XML quota file from IDE configuration directory.
• Auto-detects installed JetBrains IDEs; uses most recently used.
• Reads AIAssistantQuotaManager2.xml for monthly credits and refill date.
• Status: none (no status page).
• Details: docs/jetbrains.md.

Augment

• Auto mode tries the auggie CLI first.
• Web fallback uses browser cookies, with manual cookie header support.
• Tracks credit usage and account/subscription data where available.
• Status: none yet.
• Details: docs/augment.md.

Amp

• Web settings page (https://ampcode.com/settings) via browser cookies.
• Parses Amp Free usage from the settings HTML.
• Status: none yet.
• Details: docs/amp.md.

Ollama

• Web settings page (https://ollama.com/settings) via browser cookies.
• Parses Cloud Usage plan badge, session/weekly usage, and reset timestamps.
• Status: none yet.
• Details: docs/ollama.md.

Synthetic

• API key from ~/.codexbar/config.json (providers[].apiKey) or SYNTHETIC_API_KEY.
• Shows rolling five-hour, weekly token, search-hourly, and cost/credit quota lanes when present.
• Status: none yet.

OpenRouter

• API token from ~/.codexbar/config.json (providers[].apiKey) or OPENROUTER_API_KEY env var.
• Reads credits and key rate-limit info from OpenRouter APIs.
• Override base URL with OPENROUTER_API_URL env var.
• Status: https://status.openrouter.ai (link only, no auto-polling yet).
• Details: docs/openrouter.md.

Perplexity

• Browser session cookie from automatic import, manual header/token, or PERPLEXITY_SESSION_TOKEN / PERPLEXITY_COOKIE.
• Tracks recurring credits, bonus/promotional credits, purchased credits, and renewal date when present.
• Status: https://status.perplexity.com/ (link only, no auto-polling).

Abacus AI

• Browser cookies (abacus.ai, apps.abacus.ai) via automatic import or manual header.
• Reads organization compute points and billing data.
• Shows monthly credit gauge with pace tick and reserve/deficit estimate.
• Status: none yet.
• Details: docs/abacus.md.

Mistral

• Session cookie (ory_session_*) from browser auto-import or manual Cookie: header.
• CSRF token (csrftoken cookie) sent as X-CSRFTOKEN header.
• Domain: admin.mistral.ai.
• Reads monthly usage and pricing from the Mistral billing API.
• Cost is computed client-side from token counts and response pricing.
• Resets at end of calendar month.
• Status: https://status.mistral.ai (link only, no auto-polling).

DeepSeek

• API key via DEEPSEEK_API_KEY / DEEPSEEK_KEY env var or DeepSeek token accounts.
• Shows total balance with paid vs. granted breakdown; USD preferred when multiple currencies present.
• Status: https://status.deepseek.com (link only, no auto-polling).
• Details: docs/deepseek.md.

Codebuff

• API token from ~/.codexbar/config.json, CODEBUFF_API_KEY, or ~/.config/manicode/credentials.json created by codebuff login.
• Reads usage and subscription data from Codebuff APIs.
• Shows credit balance, weekly rate limit, reset timing, subscription status, and auto-top-up flag when present.
• Override base URL with CODEBUFF_API_URL.
• Status: none yet.
• Details: docs/codebuff.md.

See also: docs/provider.md for architecture notes.