| summary | Provider data sources and parsing overview for every registered CodexBar provider. | |||
|---|---|---|---|---|
| read_when |
|
CodexBar currently registers 54 provider IDs. Some companies expose multiple surfaces, such as Codex vs OpenAI API or OpenCode vs OpenCode Go, because the auth source and quota shape differ.
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). |
| OpenAI | Admin API key (api) for organization spend/usage; legacy API-key balance fallback. |
| Azure OpenAI | API key + endpoint + deployment probe (api) for deployment status validation. |
| Claude | Admin API key (api) when configured; otherwise 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) -> local SQLite usage (local) in auto mode; optional workspace ID. |
| Alibaba Coding Plan | Console RPC via web cookies (auto/manual) with API key fallback (web, api). |
| Alibaba Token Plan | Bailian subscription summary API via browser or manual cookies (web). |
| Droid/Factory | Web cookies → stored tokens → local storage → WorkOS cookies (web). |
| Devin | Chrome localStorage session or manual Bearer token → daily and weekly quota API (web). |
| z.ai | API token from config/env → quota API (api). |
| Manus | Browser session_id cookie (auto/manual/env) → credits API (web). |
| MiniMax | Manual/browser session via Coding Plan web path (web), or Coding Plan API token (api). |
| Kimi | Kimi Code API key (api), then kimi-auth cookie/manual token/env fallback (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 (unofficial) | API key from config/env → legacy 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 | Local amp usage CLI, access-token API, then browser-cookie legacy fallback (cli, api, web). |
| T3 Chat | Web tRPC customer-data endpoint via browser cookies (web). |
| Warp | API token (config/env) → GraphQL request limits (api). |
| ElevenLabs | API key from config/env → subscription usage API (api). |
| Windsurf | Web session bundle from browser localStorage (web) → local SQLite cache (local). |
| Ollama | API key verifies Cloud API access (api); browser cookies expose Cloud quota windows (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). |
| Xiaomi MiMo | Browser cookies → balance/token plan endpoints (web). |
| Doubao | API key from config/env → Volcengine Ark chat-completions probe (api). |
| Sakana AI | Manual Cookie header → billing page parser for 5-hour and weekly quota windows (web). |
| Abacus AI | Browser cookies → compute points + billing API (web). |
| Mistral | Console billing and Vibe subscription usage via browser cookies (web). |
| DeepSeek | API key from env or token accounts → balance endpoint (api). |
| Moonshot | API key from config/env → balance endpoint (api). |
| Codebuff | API token from config/env or codebuff login credentials → usage API (api). |
| Crof | API key from config/env → credit balance + requests quota API (api). |
| Venice | API key from config/env → DIEM/USD balance API (api). |
| Command Code | Web billing API via Command Code session cookies (web). |
| StepFun | Username/password login or manual Oasis token (web). |
| AWS Bedrock | AWS credentials → Cost Explorer spend/budgets and optional CloudWatch Claude activity (api). |
| Grok | grok agent stdio JSON-RPC x.ai/billing (cli) → grok.com billing gRPC-web via Chrome session cookies (web); local ~/.grok/sessions signals as fallback. |
| GroqCloud | API key → Prometheus metrics API for request/token/cache-hit rates (api). |
| LLM Proxy | API key + base URL → /v1/quota-stats aggregate proxy usage (api). |
| LiteLLM | API key + base URL → /key/info, then /user/info or /team/info budget usage (api). |
| Deepgram | API key → project discovery and usage breakdown API (api). |
| Chutes | API key from config/env → subscription usage and quota API (api). |
| Zed | Zed editor Keychain session → cloud.zed.dev/client/users/me for plan and quota data (local). |
- App Auto: OAuth API first; falls back to CLI only when OAuth credentials are missing or auth/refresh is invalid.
- Web dashboard (optional, off by default):
https://chatgpt.com/codex/settings/usagevia 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-serverJSON-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)sessionsand siblingarchived_sessionsJSONL files for the configured history window. - Status: Statuspage.io (OpenAI).
- Details:
docs/codex.md.
- API key from
~/.codexbar/config.json,OPENAI_ADMIN_KEY, orOPENAI_API_KEY. - Admin API keys are preferred and fetch organization costs plus completion usage for inline Today/7d/configured-window dashboards.
- Normal API keys fall back to the legacy credit-grants balance endpoint when organization usage is unavailable.
- Details:
docs/openai.md.
- API key, endpoint, and deployment from
~/.codexbar/config.jsonorAZURE_OPENAI_API_KEY,AZURE_OPENAI_ENDPOINT, andAZURE_OPENAI_DEPLOYMENT_NAME. AZURE_OPENAI_ENDPOINTand configured endpoint overrides must be HTTPS URLs or bare hosts normalized to HTTPS; explicithttp://URLs, user info, and encoded host-delimiter tricks fail closed beforeapi-keyheaders are attached.- Validates the configured deployment with a minimal chat-completions request; it does not expose Azure spend or quota history.
- Use
AZURE_OPENAI_API_VERSIONto override the API version. Set it tov1for Azure's OpenAI-compatible v1 API path. - Status: Azure status page link.
- Admin API:
sk-ant-admin...key in Settings/config, token accounts, orANTHROPIC_ADMIN_KEY. - Admin API shows organization spend/messages summaries with the same inline dashboard pattern as OpenAI API.
- 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_DIRwhen set, otherwise~/.config/claude/projectsand~/.claude/projectsJSONL files for the configured history window. - Status: Statuspage.io (Anthropic).
- Details:
docs/claude.md.
- API token from
~/.codexbar/config.json(providers[].apiKey) orZ_AI_API_KEYenv var. - Supports global and BigModel CN quota hosts; override with
Z_AI_API_HOSTorZ_AI_QUOTA_URL. - z.ai endpoint overrides must be HTTPS or bare hosts normalized to HTTPS.
Z_AI_QUOTA_URLtakes precedence for quota resolution; combined usage validates both configured endpoints before sending bearer auth. - Status: none yet.
- Details:
docs/zai.md.
- Automatic auth reads the current
auth1_sessiontoken and organization metadata from Chrome localStorage. - Manual auth accepts the
Authorization: Bearer ...value from an app.devin.ai request. - Usage endpoint:
GET /api/<internal-org-id>/billing/quota/usage. - Shows daily and weekly quota percentages with their reset timestamps.
- Details:
docs/devin.md.
- Session token via browser
session_idcookie, manual Settings entry,MANUS_SESSION_TOKEN, orMANUS_COOKIE. - Credits endpoint:
POST https://api.manus.im/user.v1.UserService/GetAvailableCredits. - Auto mode prefers cached/browser cookies before env fallback; manual mode accepts either a bare
session_idvalue or a full Cookie header. - Status: none yet.
- 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.
- Web-session billing history can render 30-day token charts plus top model/method breakdowns when MiniMax exposes it.
- Status: none yet.
- Details:
docs/minimax.md.
- Kimi Code API key via
~/.codexbar/config.jsonorKIMI_CODE_API_KEY. - Web fallback uses the JWT from
kimi-authcookie via manual entry orKIMI_AUTH_TOKENenv var. - Shows weekly quota and 5-hour rate limit (300 minutes).
- Status: none yet.
- Details:
docs/kimi.md.
- API token from
~/.codexbar/config.json(providers[].apiKey) orKILO_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 bykilo login. - Status: none yet.
- Details:
docs/kilo.md.
- API key via
~/.codexbar/config.jsonorKIMI_K2_API_KEY/KIMI_API_KEYenv var. - Shows credit usage from the legacy
kimi-k2.aiconsumed/remaining totals. - Use Moonshot / Kimi API for the official Kimi API account and billing surface.
- Status: none yet.
- Details:
docs/kimi-k2.md.
- 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.
- Local Antigravity language server (internal protocol, HTTPS on localhost).
GetUserStatusprimary;GetCommandModelConfigsfallback.- Status: Google Workspace incidents (Gemini product).
- Details:
docs/antigravity.md.
- Web API via browser cookies (
cursor.com+cursor.sh). - Fallback: stored WebKit session.
- Status: Statuspage.io (Cursor).
- Details:
docs/cursor.md.
- Web dashboard via browser cookies (
opencode.ai). - Status: none yet.
- Details:
docs/opencode.md.
- Web dashboard via browser or manual cookies (
opencode.ai). - Auto mode falls back to local usage from
~/.local/share/opencode/opencode.dbon macOS and Linux. - 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) orCODEXBAR_OPENCODEGO_WORKSPACE_ID. - Status: none yet.
- Details:
docs/opencode.md.
- 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) orALIBABA_CODING_PLAN_API_KEYenv var. - Region hosts: international (
ap-southeast-1) and China mainland (cn-beijing). - Host overrides:
ALIBABA_CODING_PLAN_HOSTorALIBABA_CODING_PLAN_QUOTA_URL. - Status:
https://status.aliyun.com(link only, no auto-polling). - Details:
docs/alibaba-coding-plan.md.
- Web mode posts to the Bailian
GetSubscriptionSummaryendpoint with form-encoded params and optionalsec_token. - Cookie sources: browser import (
auto), manual Cookie header, orALIBABA_TOKEN_PLAN_COOKIE. - Default quota URL:
https://bailian.console.aliyun.com/data/api.json?action=GetSubscriptionSummary&product=BssOpenAPI-V3. - Host overrides:
ALIBABA_TOKEN_PLAN_HOSTorALIBABA_TOKEN_PLAN_QUOTA_URL. - Status:
https://status.aliyun.com(link only, no auto-polling). - Details:
docs/alibaba-token-plan.md.
- 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.
- 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.
- 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-cliinstalled and logged in via AWS Builder ID. - Status: AWS Health Dashboard (manual link, no auto-polling).
- Details:
docs/kiro.md.
- API token from Settings or
WARP_API_KEY/WARP_TOKENenv var. - Shows monthly credits usage and next refresh time.
- Status: none yet.
- Details:
docs/warp.md.
- API key from Settings, token accounts,
ELEVENLABS_API_KEY, orXI_API_KEY. - Reads
GET /v1/user/subscriptionfromapi.elevenlabs.io. - Shows character credit usage, reset timing, and voice slot usage when available.
- Override the API base URL with
ELEVENLABS_API_URL. - Status:
https://status.elevenlabs.io(link only, no auto-polling). - Details:
docs/elevenlabs.md.
- OAuth credentials from
gcloud auth application-default login(ADC). - Quota usage via Cloud Monitoring
consumer_quotametrics foraiplatform.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.
- Local XML quota file from IDE configuration directory.
- Auto-detects installed JetBrains IDEs; uses most recently used.
- Reads
AIAssistantQuotaManager2.xmlfor monthly credits and refill date. - Status: none (no status page).
- Details:
docs/jetbrains.md.
- Reads the signed-in Zed editor session from the macOS Keychain (
credentials_url/https://zed.dev). - Calls
GET https://cloud.zed.dev/client/users/mefor plan, billing cycle, Edit Predictions quota, and overdue invoice flag. - Sign in to the Zed editor first.
- Details:
docs/zed.md.
- Auto mode tries the
auggieCLI 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.
- Auto mode tries the local
amp usagecommand first. - API mode calls Amp's balance endpoint with an access token.
- Web fallback reads the legacy settings page with browser cookies.
- Tracks Amp Free usage, account identity, and individual and workspace credit balances.
- Status: none yet.
- Details:
docs/amp.md.
- Web tRPC endpoint (
https://t3.chat/api/trpc/getCustomerData) via browser cookies. - Parses JSONL response lines and extracts customer data from the embedded tRPC payload.
- Shows the 4-hour Base bucket and monthly Overage bucket documented in the T3 Chat FAQ.
- Status: none yet.
- Details:
docs/t3chat.md.
- 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.
- API key from
~/.codexbar/config.json(providers[].apiKey) orSYNTHETIC_API_KEY. - Shows rolling five-hour, weekly token, search-hourly, and cost/credit quota lanes when present.
- Status: none yet.
- API token from
~/.codexbar/config.json(providers[].apiKey) orOPENROUTER_API_KEYenv var. - Reads credits and key rate-limit info from OpenRouter APIs.
- Shows daily, weekly, and monthly API-key spend when
/api/v1/keyreturns those fields. - Override base URL with
OPENROUTER_API_URLenv var. - Status:
https://status.openrouter.ai(link only, no auto-polling yet). - Details:
docs/openrouter.md.
- 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).
- Browser cookies from automatic import or manual
Cookie:header forplatform.xiaomimimo.combalance and token-plan endpoints. - Optional testing override via
MIMO_API_URL; overrides must be HTTPS or bare hosts normalized to HTTPS, and invalid overrides fail closed instead of falling back to local MiMo usage accounting. - Local MiMo token accounting is available only when the opt-in cache file exists.
- Status: none yet.
- Details:
docs/mimo.md.
- API key via
ARK_API_KEY,VOLCENGINE_API_KEY,DOUBAO_API_KEY, or provider config. - Probes Volcengine Ark chat completions and reads request rate-limit headers when present.
- Status: none yet.
- Details:
docs/doubao.md.
- Manual
Cookie:header fromconsole.sakana.ai; no automatic browser import. - Reads the billing page and surfaces 5-hour and weekly quota windows when present.
- Status: none yet.
- Details:
docs/sakana.md.
- 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.
- Session cookie (
ory_session_*) from browser auto-import or manualCookie:header. - CSRF token (
csrftokencookie) sent asX-CSRFTOKENfor billing and Vibe usage requests. - Domains:
admin.mistral.aifor API billing andconsole.mistral.aifor optional Vibe subscription usage. Console requests forward onlycsrftokenandory_session_*; all other admin cookies stay origin-bound. - Reads monthly usage and pricing from the Mistral billing API.
- Cost is computed client-side from token counts and response pricing.
- Reads Vibe monthly-plan usage percentage and reset time when the console endpoint is available.
- The menu bar metric can show either pay-as-you-go API spend or monthly-plan usage.
- Resets at end of calendar month.
- Status:
https://status.mistral.ai(link only, no auto-polling).
- API key via
DEEPSEEK_API_KEY/DEEPSEEK_KEYenv 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.
- API key via
MOONSHOT_API_KEY/MOONSHOT_KEYenv var or provider config. - Reads
GET /v1/users/me/balancefrom the selected Moonshot region. - Region: international (
api.moonshot.ai) or China mainland (api.moonshot.cn), configurable in Settings orMOONSHOT_REGION. - Shows available balance; negative cash balance is surfaced as a deficit.
- Status: none yet.
- Details:
docs/moonshot.md.
- API key via
VENICE_API_KEY/VENICE_KEYenv var or Venice token accounts. - Shows current DIEM or USD balance; DIEM epoch allocation progress when available.
- Status: none yet.
- Details:
docs/venice.md.
- API token from
~/.codexbar/config.json,CODEBUFF_API_KEY, or~/.config/manicode/credentials.jsoncreated bycodebuff 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.
- API key from
~/.codexbar/config.json,CROF_API_KEY, orCROFAI_API_KEY. - Reads
credits,requests_plan, andusable_requestsfromGET https://crof.ai/usage_api/. - Shows request quota as the primary usage window and dollar credits as the secondary row.
- Infers the daily request reset from midnight America/Chicago until the usage API exposes reset metadata.
- Status: none yet.
- Details:
docs/crof.md.
- Browser session cookies from automatic import or manual
Cookie:header. - Linux CLI supports configured manual cookies; automatic browser import remains macOS-only.
- Reads monthly USD credits and billing-cycle usage from
api.commandcode.ai. - Automatic import looks for better-auth session cookies from
commandcode.ai/www.commandcode.ai. - Status: none yet.
- Details:
docs/command-code.md.
grok agent stdio(ACP) JSON-RPCx.ai/billingmethod; requiresgrok login(SuperGrok OAuth/OIDC).- Reads cached credentials from
~/.grok/auth.jsonfor identity (email, team). - Falls back to grok.com's billing gRPC-web endpoint via Chrome session cookies when the CLI does not expose billing.
- CLI/test runs do not import browser cookies unless
CODEXBAR_ALLOW_BROWSER_COOKIE_IMPORT=1is set. - Local fallback aggregates
~/.grok/sessions/**/signals.jsontoken counts when the RPC is unavailable. - Status: link only to
https://status.x.ai(no auto-polling yet). - Details:
docs/grok.md.
- AWS credentials from
AWS_ACCESS_KEY_ID,AWS_SECRET_ACCESS_KEY, and optionalAWS_SESSION_TOKEN. - Region from
AWS_REGION/AWS_DEFAULT_REGION, defaulting tous-east-1. - Reads AWS Cost Explorer for Bedrock spend and can compare usage against
CODEXBAR_BEDROCK_BUDGET. - Optionally reads rolling 14-day Claude token and request totals from CloudWatch with
cloudwatch:GetMetricData. - Override Cost Explorer base URL with
CODEXBAR_BEDROCK_API_URLfor tests. - Details:
docs/bedrock.md.
- API key from config or
DEEPGRAM_API_KEY. - Optional project ID from provider settings or
DEEPGRAM_PROJECT_ID; otherwise aggregates all visible projects. - Optional API base URL override via
DEEPGRAM_API_URL; overrides must be HTTPS or bare hosts normalized to HTTPS. - Reads Deepgram usage breakdowns for audio hours, agent hours, token totals, TTS characters, and requests.
- Details:
docs/deepgram.md.
- API key from config or
LITELLM_API_KEY; base URL from configenterpriseHostorLITELLM_BASE_URL. - Reads
/key/infofirst, then/user/info?user_id=...for user-bound keys or/team/info?team_id=...for team-only keys. - User-bound keys show personal budget usage as the primary window and the key's exact matching team as the secondary window.
- Team-only keys show the team budget as their sole usage window. Automatic menu-bar selection prefers the enforced team budget.
- Spend remains visible in the API-spend row when LiteLLM has no budget limit configured.
- Accepts base URLs with or without a
/v1suffix; management requests are sent to the proxy root. - Details:
docs/litellm.md.
- API key from config or
POE_API_KEY. - Reads the current point balance and recent points history from Poe's official usage API.
- History failures are non-fatal; the current balance remains available.
- Details:
docs/poe.md.
- API key from config or
CHUTES_API_KEY. - Reads subscription usage first, then fills missing rolling, monthly, or pay-as-you-go quota data from the quota APIs.
- Uses Chutes' management API at
https://api.chutes.ai;CHUTES_API_URLcan override it with an HTTPS endpoint. - Details:
docs/chutes.md.
- Username/password login or manual Oasis-Token.
- Reads Step Plan 5-hour and weekly rate-limit windows from
platform.stepfun.com. - Shows subscription plan name when the Step Plan status API returns one.
- Status: none yet.
- Details:
docs/stepfun.md.
See also: docs/provider.md for architecture notes.