CodexBar 0.20.0 — Mobile 1.2.0

Mac-side alignment with upstream CodexBar 0.20. Mobile companion stays at 1.2.0. New upstream providers (Perplexity, OpenCode Go) appear in the Mac app; iPhone 1.2.0 displays them as fallback cards, full iOS-side adaptation ships in Mobile 1.3.0.

Highlights — upstream 0.20 (Mac)

• Codex system account switching — switch between system accounts/profiles without manually logging out and back in (contribution by @ratulsarna).
• Perplexity provider (PR #606) — recurring, bonus, and purchased-credit tracking; Pro/Max plan detection; browser-cookie auto-import with manual-cookie fallback.
• OpenCode Go — separate provider from OpenCode Zen, with 5-hour / weekly / monthly web usage tracking, widget integration, and browser-cookie support.
• Claude token/cost accuracy — fixes cross-file double counting of subagent JSONL logs and streaming chunk deduplication; adds claude-sonnet-4-6 pricing.

Mac — providers & usage

• Codex: workspace attribution for account labels and same-email multi-workspace accounts.
• Codex: reconcile live-system and managed accounts by canonical identity, preserve per-account usage/history/dashboard state, OAuth CLI fallback, tighter OpenAI web ownership gating.
• Codex: normalize weekly-only rate limits across OAuth and CLI/RPC; free-plan accounts render as Weekly instead of a fake Session.
• Codex: end-to-end refactor into clearer components (CodexDashboardAuthority / CodexAccountReconciliation / CodexIdentity / CodexConsumerProjection / ManagedCodexAccountCoordinator).
• OpenCode: preserve product separation between Zen and Go; harden cookie/domain behavior for authenticated web fetches.
• Cost history: merge supported pi session usage into Codex/Claude provider history (#653).

Mac — menu & settings

• Codex: UI for switching the system-level Codex account and promoting a managed account into the live system slot.
• Claude: "Avoid Keychain prompts" enabled by default (experimental label removed).
• Fix alignment of menu chart hover coordinates on macOS.

Mac — fixes (selected)

• Cursor fetch crash path (#663).
• z.ai 5-hour lane selection.
• Ollama __Secure-session cookie recognition (#707).
• Edge browser cookie import for Codex (#694).
• Antigravity localhost TLS challenges (#693).
• Battery-drain mitigations: menu bar updates and OpenAI web extras (#708, #684).
• Menu bar icon regression on macOS 26 RenderBox Metal shader (#677).
• Claude CLI well-known path fallback precedence (#675).

---

2026-04-16 Mac 端对齐上游 CodexBar 0.20。Mobile 版本保持 1.2.0。上游新增 Provider（Perplexity、OpenCode Go）会出现在 Mac 端；iPhone 1.2.0 以兜底卡片形式显示，完整的 iOS 端适配在 Mobile 1.3.0 推出。

亮点 — 上游 0.20（Mac）

• Codex 系统账号切换 —— 不用手动登出再登入即可切换系统账号/profile（@ratulsarna 贡献）。
• Perplexity 服务商（PR #606）—— recurring / 赠送 / 购买三段式 credit 追踪，Pro/Max 套餐识别，浏览器 cookie 自动导入加手动 cookie 兜底。
• OpenCode Go —— 从 OpenCode Zen 分离出独立 provider，支持 5 小时 / 周 / 月 web 用量追踪、widget、浏览器 cookie。
• Claude token/费用修正 —— 修复子 agent JSONL 跨文件重复计数和流式分片去重；新增 claude-sonnet-4-6 定价。

Mac — 服务商 & 用量

• Codex：账号 label 的 workspace 归属，支持同 email 多 workspace。
• Codex：用 canonical 身份协调实时与 managed 账号，保留每账号独立用量/历史/dashboard；OAuth CLI 兜底；OpenAI web 所有权收紧。
• Codex：周限额在 OAuth/CLI/RPC 间归一化，免费账号显示为 Weekly 而非虚假 Session。
• Codex：端到端重构（CodexDashboardAuthority / CodexAccountReconciliation / CodexIdentity / CodexConsumerProjection / ManagedCodexAccountCoordinator 等）。
• OpenCode：Zen 与 Go 的产品边界保留；web 认证抓取的 cookie/domain 行为强化。
• 费用历史：支持将 pi session 用量合并到 Codex/Claude 历史（#653）。

Mac — 菜单 & 设置

• Codex：切换系统级 Codex 账号、将 managed 账号晋升为 live system 的 UI。
• Claude："避免 Keychain 弹窗" 改为默认开启（不再是 experimental）。
• 修复 macOS 上菜单栏图表 hover 坐标对齐。

Mac — 修复（节选）

• Cursor 抓取崩溃路径（#663）。
• z.ai 5 小时额度通道选择。
• Ollama __Secure-session cookie 识别（#707）。
• Edge 浏览器 cookie 导入 for Codex（#694）。
• Antigravity localhost TLS 握手。
• 电量回归修复（#708、#684）。
• macOS 26 RenderBox Metal 着色器导致的菜单栏图标不显示（#677）。
• Claude CLI well-known 路径 fallback 优先级（#675）。

0.19.0-1.2.0: CodexBar 0.19.0 — Mobile 1.2.0

This release ships the Mac-side changes that support Mobile 1.2.0: a CloudKit push notification writer (with multi-Mac dedup and 5-minute debounce per provider/state), 4 DEV test buttons in Preferences → Mobile, and an About-page locale fix. Upstream CodexBar 0.19.0 features are unchanged since the original release.

Highlights — Mobile 1.2.0

• Subscription Utilization visualization on iPhone — see each session / weekly / opus quota per provider and across all providers, with a 30-day daily bar chart in the Cost tab and a utilization history chart on every provider detail page.
• Multi-Mac data merge on iPhone — if you run CodexBar on more than one Mac, iPhone now dedupes data by hour and combines across Macs, so iPhone charts stay consistent regardless of which Mac was last active.
• Mac→iPhone push notifications — 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 is not required.

Mac — Mobile 1.2.0 push infrastructure

• QuotaTransition CloudKit record writer — every session quota transition writes one record into the matching Quota-{providerID}-{state}Zone (~46 zones for 23 providers × 2 states). iPhone has a pre-baked CKRecordZoneSubscription per zone, with the provider name baked into the localized alertBody at subscription setup.
• 5-minute debounce per (provider, state) to prevent oscillation near 0% from spamming.
• Multi-Mac dedup — recordName = (providerID, hourBucket) collapses concurrent transitions from 2+ Macs in the same hour to one record, so iPhone receives at most one push per (provider, state) per hour.
• DEV test buttons in Preferences → Mobile (debug builds only) — Codex / Claude × Depleted / Restored, for end-to-end push validation without waiting for a real quota change.

Mac — fixes

• About page build date is now formatted with en_US_POSIX locale, avoiding mixed Chinese + English format on Chinese-system Macs.

Highlights — Mobile 1.1.0

• iCloud sync upgraded from KVS to CloudKit for multi-device sync.
• Session quota push notifications for iOS.
• Composite Sparkle build number for upstream-safe version detection.

CodexBar 0.19.0 (Upstream)

• Alibaba Coding Plan provider with region-aware quota fetching.
• Subscription utilization history chart in menu bar.
• Claude provider end-to-end refactor with expanded tests.
• Cursor dashboard alignment (Total/Auto/API lanes).
• Codex code review reset time display.
• Per-model token counts in cost history.
• GPT-5.4 mini and nano pricing.
• Antigravity model selection fix.

---

本版本带来 Mobile 1.2.0 配套的 Mac 端改动：CloudKit 推送通知写入（支持多 Mac 去重和按 provider/state 的 5 分钟 debounce）、Preferences → Mobile 下的 4 个 DEV 测试按钮，以及 About 页 locale 修复。上游 CodexBar 0.19.0 自原始发布以来无变化。

亮点 — Mobile 1.2.0

• iPhone 订阅利用率可视化 —— 直观看到每个 session / weekly / opus 额度的使用情况，可按 Provider 分开看也可以跨 Provider 看总体。Cost tab 有 30 天日级柱状图，每个 Provider 详情页还有独立的利用率历史图。
• iPhone 多 Mac 数据合并 —— 如果你在多台 Mac 上使用 CodexBar，iPhone 上会按小时去重后把所有 Mac 的数据合并，不管最后活跃的是哪台 Mac，iPhone 图表都一致。
• Mac→iPhone 推送通知 —— 当你任何一台 Mac 上会话额度耗尽或恢复可用时，iPhone 收到一条本地化的通知，内容包含 Provider 名称（如"Codex 的会话额度已耗尽"）。不需要启用 Background App Refresh。

Mac — Mobile 1.2.0 推送基础设施

• QuotaTransition CloudKit record 写入 —— 每次会话额度状态变化，Mac 向对应的 Quota-{providerID}-{state}Zone（23 providers × 2 states ≈ 46 个 zone）写一条 record。iPhone 端为每个 zone 预创建 CKRecordZoneSubscription，subscription 创建时就把 Provider 名烤进 alertBody。
• 5 分钟 (provider, state) 级 debounce，防止额度在 0% 附近抖动导致重复推送。
• 多 Mac 去重 —— recordName 用 (providerID, hourBucket)，多台 Mac 同一小时内检测到同一状态变化合并为单条 record，iPhone 每小时每种 (provider, state) 最多收到 1 条推送。
• Preferences → Mobile 新增 4 个 DEV 测试按钮（仅 debug 构建），Codex / Claude × 耗尽 / 恢复，端到端验证推送链路无需等真实额度变化。

Mac — 修复

• About 页 Build 日期强制 en_US_POSIX locale，避免中文系统 Mac 显示中英文混合格式。

亮点 — Mobile 1.1.0

• iCloud 同步从 KVS 升级至 CloudKit，支持多设备同步。
• 会话配额推送通知：iOS 后台接收耗尽/恢复提醒。
• Sparkle 复合版本号方案，避免与上游版本号冲突。

CodexBar 0.19.0（上游更新）

• 新增阿里巴巴 Coding Plan 服务商，支持区域化配额查询。
• 菜单栏新增订阅利用率历史图表。
• Claude 服务商端到端重构，测试覆盖更完整。
• Cursor 用量与仪表盘 Total/Auto/API 对齐。
• Codex 代码审查限制显示重置时间。
• 费用历史新增每模型 Token 统计。
• GPT-5.4 mini 和 nano 定价支持。
• Antigravity 模型选择修复。

CodexBar 0.19.0 — Mobile 1.1.0

CodexBar 0.19.0-Mobile 1.1.0

This release merges upstream CodexBar 0.19.0 into our fork, ensuring full compatibility and laying the groundwork for upcoming mobile features. Mobile-side support for the new upstream capabilities is in development.

Mobile 1.1.0 (No Change)

• iCloud sync upgraded from KVS to CloudKit for multi-device sync.
• Session quota push notifications for iOS.
• Composite Sparkle build number for upstream-safe version detection.

CodexBar 0.19.0 (Upstream)

• Alibaba Coding Plan provider with region-aware quota fetching.
• Subscription utilization history chart in menu bar.
• Claude provider end-to-end refactor with expanded tests.
• Cursor dashboard alignment (Total/Auto/API lanes).
• Codex code review reset time display.
• Per-model token counts in cost history.
• GPT-5.4 mini and nano pricing.
• Antigravity model selection fix.

---

本版本将上游 CodexBar 0.19.0 完整合并至我们的分支，确保全面兼容并为后续移动端功能开发奠定基础。上游新功能的移动端适配正在开发中。

Mobile 1.1.0（无变更）

• iCloud 同步从 KVS 升级至 CloudKit，支持多设备同步
• 会话配额推送通知：iOS 后台接收耗尽/恢复提醒
• Sparkle 复合版本号方案，避免与上游版本号冲突

CodexBar 0.19.0（上游更新）

• 新增阿里巴巴 Coding Plan 服务商，支持区域化配额查询
• 菜单栏新增订阅利用率历史图表
• Claude 服务商端到端重构，测试覆盖更完整
• Cursor 用量与仪表盘 Total/Auto/API 对齐
• Codex 代码审查限制显示重置时间
• 费用历史新增每模型 Token 统计
• GPT-5.4 mini 和 nano 定价支持
• Antigravity 模型选择修复

Build: 54.1.1.0 | Developer ID: Yuxiao Wang

CodexBar 0.18.0 — Mobile 1.1.0 (CloudKit Multi-Device Sync)

What's New

• CloudKit Multi-Device Sync: Upgraded from iCloud KVS to CloudKit for reliable multi-device sync
• Sparkle build number scheme: Uses composite BUILD_NUMBER.MOBILE_VERSION (53.1.1.0) to avoid upstream conflicts
• Signed with Developer ID, notarized by Apple

Full changelog: See CHANGELOG.md

CodexBar 0.18.0 Mobile 1.0.0

CodexBar Mobile 1.0.0

This release packages the first public iPhone companion app alongside CodexBar 0.18.0.

Added

• iPhone companion app that reads the latest CodexBar snapshot from iCloud Key-Value Store.
• Provider list and detail screens with dynamic rate-limit windows, budget progress, sync metadata, and interactive daily spend charts.
• Dedicated Cost tab with provider share, model mix, service mix, and 30-day spend analysis.
• In-app onboarding, setup guidance, demo mode, release notes, and About & Sync information.
• Native localization for English, Simplified Chinese, Traditional Chinese, and Japanese.
• Privacy manifest, privacy policy, and dark-mode app icon for App Store distribution.

Improved

• Usage and Cost charts now support both bar and line presentation styles.
• Press-and-hold chart inspection now reveals exact daily values directly on the graph.
• Settings are reorganized into About & Sync, Release Notes, Usage Setting, and Cost Setting.
• Mobile versioning is now aligned consistently across the Mac companion display and the iPhone app as 1.0.0.

Fixed

• Pull to refresh now asks iCloud Key-Value Store to synchronize before reading the latest snapshot.
• Mac sync status now reports missing iCloud entitlements or unavailable iCloud accounts instead of showing a false success state.

Assets

• CodexBar-0.18.0-mobile.1.0.0.zip: notarized macOS app bundle with Mobile 1.0.0 companion support.
• CodexBar-0.18.0-mobile.1.0.0.dSYM.zip: debug symbols for crash analysis.

CodexBar 0.18.0 (Mobile 0.1.1)

CodexBar 0.18.0 (Mobile 0.1.1)

Base version from upstream steipete/CodexBar v0.18.0, with the mobile-dev iCloud sync additions by @o1xhack.

What's new in this release

Mac

• Upstream 0.18.0 features and fixes, including the GPT-5.4 / GPT-5.3 Codex cost updates.
• Mobile companion sync metadata is preserved in the Mac app (Mobile 0.1.1 shown in About).
• Sync cost and usage data to iOS through iCloud KVS.
• Sync dynamic rate windows with labels such as Session, Weekly, and Sonnet.

Mobile companion compatibility

• Keeps the Mobile 0.1.1 payload/version tracking used by the iOS companion app now in App Review.
• Pushes both Mac app version and mobile version in iCloud payloads for traceability.

Install

Download CodexBar-0.18.0-mobile.0.1.1.zip, unzip it, and move CodexBar.app to /Applications.

Signed and notarized by Apple (Developer ID Application: Yuxiao Wang).

v0.18.0-beta.3 · Sync 0.1.0

CodexBar v0.18.0-beta.3 · Sync 0.1.0

Base version from upstream steipete/CodexBar v0.18.0-beta.3, with iCloud sync additions by @o1xhack.

What's new (Sync 0.1.0)

Mac

• Sync cost/usage data (session cost, 30-day cost, daily spend chart) to iOS via iCloud KVS
• Sync dynamic rate windows with labels (Session, Weekly, Sonnet, etc.)
• Parallel Sync Version tracking independent from upstream version
• Display "Sync 0.1.0" in About panel

iOS Companion App

• Provider detail view with interactive daily spend bar chart
• Budget progress bar with color-coded thresholds
• Tappable provider cards with cost teaser
• iCloud sync error display
• iOS 26 Liquid Glass UI
• Developer info and open source credits in About tab
• Mac Version and Sync Version visible in About tab

Install

Download CodexBar-0.18.0-beta.3-sync.0.1.0.zip, unzip, and move to /Applications.
Signed and notarized by Apple (Developer ID: Yuxiao Wang).

iOS companion app: build from source via Xcode (CodexBarMobile/).