CodexBar - Usage of AI
Developer Tools
Free · Designed for iPad. Not verified for macOS.
CodexBar for iOS lets you monitor your AI coding tool usage on the go. View rate limits, spending, token usage, and budget tracking for providers like Claude, Cursor, ChatGPT, and OpenRouter — all synced from your Mac in real time via iCloud.
Requires the CodexBar Mac app — this iOS app is a companion that reads usage data pushed by CodexBar on your Mac. Install the Mac app first, enable iCloud Sync in its settings, and your data will appear on your iPhone automatically.
Features:
• Share your AI spending as a beautiful image card with Classic or Vibe style options
• Export share cards for Today, 7 Days, or 30 Days, with dark mode support
• Real-time rate limit tracking with reset countdowns, budget progress, and daily cost breakdowns
• Cost dashboard with provider share, model and service mix, and 30-day spend analysis
• Interactive charts with Bar and Line styles, press-and-hold inspection, and horizontal scrolling for history
• Daily spend and token usage views with clearer summaries and sharper breakdown amounts
• Sharper percentage and cost labels across provider cards and tighter layouts for easier reading
• Toggle between used and remaining quota display in Settings
• Smarter chart axis scaling with clean integer tick marks for easier reading
• Improved iCloud sync reliability, better error reporting, pull-to-refresh, and built-in onboarding guidance
Open Source
CodexBar is built on the open-source CodexBar project, licensed under MIT. This fork (github.com/o1xhack/CodexBar) adds iCloud sync and the iOS companion app. Contributions and feedback are welcome on GitHub.
more Mac client errors from App Store but downloaded from GitHub and works
Developer Response Yes. the mac has to be downloaded from website/github. It using credentials that hard to go on the mac app store
Mac client errors from App Store but downloaded from GitHub and works
Yes. the mac has to be downloaded from website/github. It using credentials that hard to go on the mac app store
Always updated on time, I'm so grateful.
Always updated on time, I'm so grateful.
Alibaba Token Plan now shows 5-hour and weekly limits, and Subscription Utilization uses the latest quota history. Update CodexBar on Mac to 0.45.2.2 for the full fix.
1.19.1 5d ago
iPhone 1.19 adds eight providers, richer quota details, clearer limits, and more reliable iCloud sync.
What's New
* Eight more providers — ClinePass, DeepInfra, Neuralwatt, LongCat, sub2api, Wayfinder, ZenMux, and ai& now appear with their own colors and detail pages, plus quota alerts when available.
* Kimi at a glance — see Weekly, five-hour, Monthly, and Code 7-day limits in one consistent order.
* Clearer Claude plans — Max 5x and Max 20x stay distinct, even while your Macs update at different times.
* More complete details — sub2api shows account balance and request totals, while Wayfinder shows routing activity and savings.
* More reliable quota history — monthly and additional limits stay visible alongside daily and weekly windows, and Subscription Utilization automatically uses the freshest quota history when session history stops updating.
* Small percentages — every positive usage value below 1% now stays visible instead of rounding to 0% or 1%.
* Reliable iCloud sync — stalled Mac uploads now time out with a clear failure instead of spinning forever, and Developer Tools includes a read-only iCloud diagnostic report.
* A smoother Mac companion — CodexBar for Mac now recovers sign-ins more safely, reports usage more accurately, and improves performance, menus, and settings.
* A more capable Mac companion — customize menu bar layouts, see usage forecasts, use safer refresh controls, and benefit from the latest provider, performance, and security fixes.
Required Mac version
For all new details, update CodexBar on Mac to version 0.45.2.1 or later. iPhone 1.19 still works with data from older Mac versions.
1.19.0 Jul 27
CodexBar 1.17 adds richer Mac sync, more trustworthy Cost totals, and clearer diagnostics.
What's new
• New providers — iPhone now recognizes Sakana AI, Qoder, CrossModel, and ClawRouter from Mac sync. CrossModel also shows balance, uncollected spend, and daily, weekly, and monthly usage.
• More reliable Cost data — Today, 7-day, 30-day, and 90-day views now use consistent date ranges and device/account merge rules across Overview, Provider Share, Daily Spend, Model Mix, service breakdowns, and share cards.
• Local Cost History — enabled by default with a 90-day window, so iPhone can retain synced daily cost history locally.
• Cost Diagnostics — Developer Tools can now show where totals came from and whether every Cost view reconciles.
• Sync and widget fixes — removed or stale providers no longer linger in local history, cleared history stays cleared, and the widget update footer is centered in every supported size.
Update Mac CodexBar to 0.39.0.1 (fork build 97.1 or later) for the full 1.17 experience.
1.17.0 Jul 10
1.16.0 adds CodexBar Home Screen widgets.
What's new
* Home Screen widgets — add CodexBar widgets in small, medium, large, or iPad extra-large sizes to see provider usage, today's cost, and sync health at a glance.
* Light, Dark, and tinted Home Screen appearances — widgets follow your system appearance instead of using a fixed dark or colorful dashboard style.
* Widget color style — choose Mono for the native single-color look, or Colorful for a restrained accent palette that keeps the same clean layout.
* Today Cost polish — widgets now use the same merged cost totals as the Cost page, small widgets include token usage, medium widgets use a cleaner spend-vs-token layout, and provider rows avoid account-plan labels.
* Configurable views — choose Overview, Provider Focus, Today Cost, or Sync Health for each widget; edited Home Screen widgets now keep and render the selected view.
* Real synced data — widgets read the shared CodexBar CloudKit sync merge, including multi-device local CLI spend, and fall back to older iCloud snapshots when needed.
* Cost totals — the Cost page now cross-checks synced provider summaries so incomplete daily history does not undercount spend.
No App Group setup or CloudKit schema change is required for this update.
1.16.0 Jul 4
1.15.0 pairs the iPhone app with Mac CodexBar 0.37.2.1.
What's new
• Codex reset credits — when your Mac syncs available manual reset credits, iPhone shows the count and next expiration on the Codex detail page.
• Clearer usage confidence — estimated or percentage-only Mac data is now labeled instead of shown as exact.
• Provider updates from Mac — Cursor personal on-demand usage, Mistral Vibe monthly limits, Bedrock CloudWatch activity, MiniMax model names, and CommandCode quota transitions are ready to display where available.
• Diagnostics and security — Mac 0.37 adds stronger endpoint validation, safer Codex OAuth credential permissions, improved CLI diagnostics, and more reliable Claude/Codex web reads.
For the full 1.15 experience, update Mac CodexBar to 0.37.2.1 (fork build 92.1) or later. Older Mac data still opens; new details appear after Mac updates.
1.15.0 Jun 25
1.14.0 adds Sync Device Management for duplicate or retired Mac devices.
What's new
• Merge duplicate Macs — if reinstalling a Mac creates a second sync device, combine the old and new identities without deleting history.
• Archive retired Macs — keep old device history while removing retired Macs from the active device count and stale sync warnings.
• Undo when needed — restore archived devices or unmerge device identities from Settings > About & Sync.
• Safer local cost totals — merged identities from the same physical Mac no longer count local CLI history as two separate computers.
• Cleaner charts — Provider detail Daily Spend charts now use compact weekly labels instead of overcrowded daily labels.
No Mac update is required for this iPhone feature. Existing Mac sync data is preserved.
1.14.0 Jun 24
1.13.0 is one combined iPhone update: it includes the previously unreleased 1.12 sync work plus the latest Mac CodexBar 0.36.1 companion improvements.
What's new
• More providers on iPhone — Devin, LiteLLM, Poe, Chutes, and Zed can now appear when your Mac syncs their usage, with quota notifications prepared for the new providers.
• Richer provider details — MiniMax renewal and expiration dates, Copilot budget windows, MiMo balances and token plans, Kimi Code API usage, and Poe point history now flow through where available.
• Smoother upgrades — iPhone keeps rich provider details when one Mac has updated and another is still on an older build, reducing empty-card flicker during rolling upgrades.
• Mac companion refinements — provider accuracy, security, localization, and menu reliability fixes from recent Mac CodexBar releases are reflected in the companion experience.
For the full 1.13 experience, update Mac CodexBar to 0.36.1.1 (build 88.1) or later. Older Mac data still opens; new provider details appear after your Mac updates.
1.13.0 Jun 20
• The Daily Spend chart now scrolls — swipe left to browse your full cost history (30 / 90 / 365-day windows) instead of cramming every day into one screen. The latest day stays pinned to the right.
• Search the Usage list by provider name — handy when you have many providers synced.
• Cleaner, more accurate data synced from your Mac: tidier Antigravity quota rows, correct Copilot usage on zero-entitlement plans, fixed Augment parsing, steadier Claude readings through brief sign-in hiccups, and refreshed Codex / Claude cost numbers.
1.11.1 Jun 19
Quieter, more accurate provider data synced from your Mac — Antigravity quota rows without the noise, correct Copilot usage on zero-entitlement plans, fixed Augment parsing, and steadier Claude readings — from the CodexBar 0.32.4 sync.
What's New
Search — filter the Usage list by provider name; handy when many providers are synced.
Antigravity — quota rows are cleaner: image / lite / autocomplete / internal noise rows no longer skew the summary bar.
Copilot — zero-entitlement business tokens no longer show a misleading usage percentage.
Augment — usage parses correctly again after the upstream status-format change.
Claude — a brief sign-in hiccup no longer blanks your usage; the last good reading is kept.
Codex / Claude cost — refreshed by the v0.32 cost-scanner update; your cost cards re-scan to the corrected numbers.
Required Mac version
Update Mac CodexBar to 0.32.4 (fork build 79.1 or later). iPhone 1.11.0 stays forward-compatible with older Mac builds — these refinements simply arrive once Mac is updated.
1.11.0 Jun 7
What's New in 1.10.0
• DeepSeek usage card — see your DeepSeek web-session usage and cost right on your iPhone: today and this-month tokens, spend, and request counts alongside your balance.
• Codex Spark & Antigravity — Codex Spark (5-hour + weekly) and Antigravity per-model quota lanes now sync through to your iPhone.
• Smarter cost cards — cost cards now show request counts and format amounts in the correct currency (e.g. EUR / CNY), not just USD.
• Upstream fixes flow through automatically — corrected Claude Enterprise extra-usage amount (no longer 100× too high), Grok / Ollama window labels and pace projection, and the Claude "Design" lane folded into the main Claude limit.
Requires CodexBar for Mac 0.31.0 or later to surface the new DeepSeek card and the Codex Spark / Antigravity lanes. Older Mac builds stay compatible — the new cards simply remain hidden until Mac is updated.
1.10.0 Jun 4
Three new providers (Azure OpenAI, Alibaba Token Plan, T3 Chat) from the CodexBar 0.29.0 sync — plus richer detail across many providers: the iPhone now surfaces more of what your Mac already tracks.
• Azure OpenAI — usage card validating deployment status from your API key, endpoint, and deployment name.
• Alibaba Token Plan (Bailian) — monthly token-plan quota card showing used and total credits with the reset date, imported from browser or manual cookies.
• T3 Chat — web-session usage card with a 4-hour base window plus a monthly overage window.
• Richer detail elsewhere too — Codex standard/fast spend split per model, an OpenRouter balance & credits card, Mistral daily cost in the Cost dashboard, the Antigravity multi-account switcher, and cost summaries that show the real history window (not always 30 days).
Update Mac CodexBar to 0.29.0 (fork build 68.1 or later) to see the three new providers. iPhone 1.9.0 stays forward-compatible with older Mac builds — the new cards simply stay hidden until Mac is on 0.29.0.
1.9.0 May 30
CodexBar 1.8.0 adds five new providers and upgrades six existing ones.
New providers:
• Grok (xAI) — monthly spend, plan, percent used, renewal date
• ElevenLabs — character credits plus voice slots
• Deepgram — speech/agent hours, requests, TTS characters
• GroqCloud — live request / token / cache-hit rates
• LLM Proxy — aggregate usage across all upstream providers
Provider upgrades:
• Claude — Anthropic Admin API dashboard (today / 7-day / 30-day spend, top models) and an Enterprise spend-limit gauge
• OpenAI API — pick any 1–365 day cost-history window
• OpenCode Go — Zen workspace balance
• MiniMax — 30-day billing chart with top methods and models
• Kiro — overage credits when your monthly plan is exhausted
Also:
• Quota alerts now name the account that triggered them
• Codex shows your active workspace and weekly usage pace
Requires CodexBar for Mac 0.27.0 or later.
1.8.0 May 26
- Six new dedicated provider cards (Kiro credits, AWS Bedrock cost, Moonshot / Kimi API balance, z.ai hourly chart, OpenAI API Dashboard, Antigravity multi-account) plus two new settings toggles.
What's New?
OpenAI Admin API Dashboard on the OpenAI provider page — Today / 7 days / 30 days summary cards, a 30-day spend chart, and top models / top line items lists. Requires Mac 0.26.2 with Admin API access.
Kiro: dedicated credits card with plan tag, primary credit usage progress, and an optional bonus pool with expiry countdown.
AWS Bedrock (NEW): monthly spend + budget card with the active AWS region. Color-coded as approach 75% / 90% of budget.
Moonshot / Kimi API (NEW): clean balance + currency + region card so you can see your top-up at a glance.
z.ai hourly chart: stacked per-model token usage for the last 24 hours, with model legend.
Antigravity multi-account switcher: when more than one Google account is wired on Mac, the iPhone shows the linked list with active-account marker.
Two new Settings toggles — Hide quota-warning markers (only the tick-marks; notifications still fire) and Show provider changelog links (companion section in Settings → About).
Required Mac version
Update Mac CodexBar to 0.26.1 (fork build 63.2 or later). iPhone 1.7.0 is also forward-compatible with Mac 0.25.2 — new cards just stay hidden until Mac is on the new build.
1.7.0 May 20
1.6.0 — Catch-up for 11 new providers from Mac CodexBar v0.24/v0.25, plus a Claude peak-hours indicator and quota warning markers on every usage bar.
What's new
• 11 new providers render natively — Windsurf, Codebuff, DeepSeek, Manus, Xiaomi MiMo, Doubao, Command Code, StepFun, Crof, Venice, OpenAI API. Each has its own brand color across the Usage, Cost, and Subscription tabs.
• Push notifications expanded to cover the 11 new providers — your iPhone now pings on their quota events the same way it does for the existing 27.
• Quota warning markers — usage bars show tick marks at thresholds you set on Mac (default 50% / 20% remaining); a warning icon appears when you cross the most critical one.
• Warning push — when a configured threshold (e.g. 50% remaining) is crossed on Mac, the iPhone gets a localized push at that moment instead of only at full depletion.
• Claude peak-hours indicator on the Claude detail page — see at a glance whether you're inside Anthropic's published 8am-2pm ET peak window or how long until the next one starts.
Requires CodexBar for Mac 0.25.1+ for the new providers and depleted/restored push, or 0.25.2+ for the warning push.
1.6.0 May 18
1.5.3
Multi-account display fix on Cost and Subscription Utilization, plus a new cross-version account-link prompt with the related crash fix.
Recent updates
• Abacus AI and Mistral support — monthly usage and renewal countdown sync to your iPhone, with quota push notifications.
• Claude Designs / Daily Routines / Web Sonnet usage bars on the Claude detail page; Cursor Extra budget gauge on the Cursor page.
• Synthetic 5h / weekly tokens / search hourly labels render correctly instead of generic fallbacks.
• Codex Pro $100 plan badge; estimated cost for newly-released models marked with *.
• Two Macs on different CodexBar versions during a rolling upgrade now show a single card per account.
Requires CodexBar for Mac 0.23.4 or later for the new providers.
1.5.3 May 13
Primarily resolves multiple Codex accounts failing to display fully on iPhone. After configuring multiple Codex accounts on Mac, iPhone now shows each account as a separate card; Cost, Usage, and Provider Share all attribute correctly per account.
A real-data regression test suite covering all 27 providers was added to ensure sync stability across multi-account and multi-device scenarios. Several related issues fixed along the way:
Some accounts (Claude / Ollama / Copilot etc.) being incorrectly hidden in specific scenarios
Stale sync records left behind by previous Mac sessions persisting on iPhone
Cards being merged or lost in multi-account scenarios
Requires Mac CodexBar 0.23.6.
1.5.2 May 8
Our GitHub repo was renamed from o1xhack/CodexBar to o1xhack/CodexBar-Mobile to differentiate from the upstream Mac repo.
1.5.0 All Date Re-structure
* For the new providers and accurate Cost numbers, update CodexBar on Mac to 0.23.4 (Build 58.4.1.3.1) or later. Download: github.com/o1xhack/CodexBar/releases.
Two new providers and several quality-of-life improvements, all paired with the latest Mac CodexBar 0.23.4.
• Abacus AI — monthly compute-credit usage with billing-cycle countdown and quota push notifications.
• Mistral — monthly spend and renewal date sync, with quota event notifications.
• Claude — Designs, Daily Routines, and Web Sonnet usage bars now appear on the Claude detail page.
• Cursor — on-demand budget gauge from the Mac menu bar metric is now visible on the Cursor detail page.
• Synthetic — three usage lanes (5-hour, weekly, search) are now properly labeled instead of generic Session / Weekly fallbacks.
• Codex Pro $100 plan badge displays in the account-info capsule on each Codex card.
• Cost estimate for newly-released models — when Mac sees a model name that isn't in its pricing table yet, it uses the closest known rate as a temporary estimate (marked with *) instead of letting Daily Spend drop to $0.
• Two Macs, one card — when your Macs run different CodexBar versions during a rolling upgrade, your iPhone now correctly merges the same account into a single card. Works for non-ASCII emails too.
1.5.1 May 2
1.5.0 All Date Re-structure
* For the new providers and accurate Cost numbers, update CodexBar on Mac to 0.23.4 (Build 58.4.1.3.1) or later. Download: github.com/o1xhack/CodexBar/releases.
Two new providers and several quality-of-life improvements, all paired with the latest Mac CodexBar 0.23.4.
• Abacus AI — monthly compute-credit usage with billing-cycle countdown and quota push notifications.
• Mistral — monthly spend and renewal date sync, with quota event notifications.
• Claude — Designs, Daily Routines, and Web Sonnet usage bars now appear on the Claude detail page.
• Cursor — on-demand budget gauge from the Mac menu bar metric is now visible on the Cursor detail page.
• Synthetic — three usage lanes (5-hour, weekly, search) are now properly labeled instead of generic Session / Weekly fallbacks.
• Codex Pro $100 plan badge displays in the account-info capsule on each Codex card.
• Cost estimate for newly-released models — when Mac sees a model name that isn't in its pricing table yet, it uses the closest known rate as a temporary estimate (marked with *) instead of letting Daily Spend drop to $0.
• Two Macs, one card — when your Macs run different CodexBar versions during a rolling upgrade, your iPhone now correctly merges the same account into a single card. Works for non-ASCII emails too.
1.5.0 Apr 29
1.3.1 fix the bug of multi-mac syncing issue in 1.3.0
Important 1.3.0
Update CodexBar on Mac to 0.20.3 (Build 55.3.1.3.0) or later to see Perplexity's structured credit breakdown (recurring / promo / purchased pools + Pro/Max plan + renewal countdown). Older Mac versions fall back to the legacy 3-bar rendering on the Perplexity detail page. Download from github.com/o1xhack/CodexBar/releases.
What's New 1.3.0
Perplexity credit breakdown — when Mac 0.20.3+ is installed, the Perplexity detail page shows a stacked 3-segment bar for monthly / bonus / purchased credits, a Pro/Max plan badge, and a renewal-date countdown.
OpenCode Go support — separate provider from OpenCode Zen with its own tint (mint) and push subscriptions; cards are visually distinguishable at a glance even with both products enabled.
Codex multi-account cards — if you have 2+ Codex accounts (e.g. a personal Pro and a work Business account), each now renders as its own card with the email as the subtitle. Accounts without an email get a localized ordinal fallback ("Codex 2", etc.).
Full push-notification coverage — quota depleted / restored pushes now work for Perplexity and OpenCode Go in addition to the 23 existing providers.
Provider color palette consolidated — every tab and card uses the same color for a given provider, so the Subscription Utilization chart, the provider list, the share card, and the detail page all agree.
Under the hood
SwiftData-backed local cache — cold start time for Usage / Cost tabs reduced from 2-5 seconds to under 200 ms. Data persists across app relaunches instead of re-fetching from CloudKit every time.
Per-provider CloudKit records with zlib compression — removes the 1 MB-per-record hard cap that long-term users were approaching as their utilization history grew.
Push-driven incremental sync — Mac changes now land on iPhone within ~500 ms via CloudKit silent pushes instead of waiting for the next manual refresh.
1.3.1 Apr 27
Important 1.3.0
Update CodexBar on Mac to 0.20.3 (Build 55.3.1.3.0) or later to see Perplexity's structured credit breakdown (recurring / promo / purchased pools + Pro/Max plan + renewal countdown). Older Mac versions fall back to the legacy 3-bar rendering on the Perplexity detail page. Download from github.com/o1xhack/CodexBar/releases.
What's New 1.3.0
Perplexity credit breakdown — when Mac 0.20.3+ is installed, the Perplexity detail page shows a stacked 3-segment bar for monthly / bonus / purchased credits, a Pro/Max plan badge, and a renewal-date countdown.
OpenCode Go support — separate provider from OpenCode Zen with its own tint (mint) and push subscriptions; cards are visually distinguishable at a glance even with both products enabled.
Codex multi-account cards — if you have 2+ Codex accounts (e.g. a personal Pro and a work Business account), each now renders as its own card with the email as the subtitle. Accounts without an email get a localized ordinal fallback ("Codex 2", etc.).
Full push-notification coverage — quota depleted / restored pushes now work for Perplexity and OpenCode Go in addition to the 23 existing providers.
Provider color palette consolidated — every tab and card uses the same color for a given provider, so the Subscription Utilization chart, the provider list, the share card, and the detail page all agree.
Under the hood
SwiftData-backed local cache — cold start time for Usage / Cost tabs reduced from 2-5 seconds to under 200 ms. Data persists across app relaunches instead of re-fetching from CloudKit every time.
Per-provider CloudKit records with zlib compression — removes the 1 MB-per-record hard cap that long-term users were approaching as their utilization history grew.
Push-driven incremental sync — Mac changes now land on iPhone within ~500 ms via CloudKit silent pushes instead of waiting for the next manual refresh.
1.3.0 Apr 26
Subscription Utilization, multi-Mac sync, and push notifications from Mac.
Important
You must update CodexBar on Mac to 0.19.0 (Build 54.1.2.0) or later to use this release. Subscription Utilization data collection and Mac→iOS push notifications both depend on Mac-side changes in that version. Download from github.com/o1xhack/CodexBar/releases.
What's New
Subscription Utilization visualization — see how much of each session / weekly / opus quota you're using, per provider and across all providers. 30-day daily bar chart in the Cost tab with Today / This Week / 14 Days / 30 Days summary cards, plus a utilization history chart on every provider detail page.
Multi-Mac data merge — if you run CodexBar on more than one Mac, data from all of them is deduped by hour and combined on iPhone, so your iPhone charts stay consistent regardless of which Mac was last active.
Push notifications from Mac — when a session quota hits 0% or becomes available again on any of your Macs, your iPhone receives a localized notification that includes the provider name (e.g. "Codex session quota depleted" / "Codex 的会话额度已耗尽"). Background App Refresh does not need to be enabled.
Improvements
Settings and Developer Tools streamlined — Setup Guide promoted to the top of Settings; Push Diagnostic tool added under Developer Tools to inspect the Mac→iOS push chain; redundant How It Works sections removed.
1.2.0 Apr 18
!! Important Notice !!
v1.1.0+ requires the Mac app (0.18.0-mobile-1.1.0 or later) to unlock Multi-device CloudKit sync. More Info inside the app
What’s New
∙ CloudKit multi-device sync — data from multiple Macs is now merged on iPhone instead of last-write-wins.
∙ New Sync Detail page in Settings — view sync status, connected devices, and detailed error info.
∙ Raw Sync Data inspector — per-device unmerged data with daily cost breakdowns for debugging.
∙ Specific CloudKit error messages — network, auth, quota issues now show exact cause instead of generic errors.
Improvements
∙ Tab bar no longer hides when scrolling.
∙ Simplified sync status bar at the bottom of Usage and Cost tabs.
∙ Legacy KVS sync maintained as fallback for older Mac app versions.
1.1.0 Apr 5
Alibaba Token Plan now shows 5-hour and weekly limits, and Subscription Utilization uses the latest quota history. Update CodexBar on Mac to 0.45.2.2 for the full fix.
more Version 1.19.1 5d ago
Data Not Collected The developer does not collect any data from this app.