Skip to content

providers.md

Latest commit

 

History

History
243 lines (209 loc) · 11.6 KB

providers.md

File metadata and controls

243 lines (209 loc) · 11.6 KB
summary Provider data sources and parsing overview for every registered CodexBar provider.
read_when
Adding or modifying provider fetch/parsing
Adjusting provider labels, toggles, or metadata
Reviewing data sources for providers

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.