AI Pulse v1.2.6 — Spend Alert Accuracy & watchOS Polish

What's New

• More accurate spend-surge and balance-drop alerts driven by the balance API
• watchOS now shows the app/CloudKit version and aligns the corner labels

Fixes & Engineering

• Correct cache-token pricing in cost calculations
• Use Int64 session timestamps in the iCloud dashboard snapshot
• Normalize percentage formatting and localization
• Extract the cross-platform shared core into AIPulseShared

Deployment Notes

• No CloudKit record type, field, index, or subscription changes
• CKSchema.payloadVersion remains 1.2.4
• App Store submission should use MARKETING_VERSION = 1.2.6 and
  CURRENT_PROJECT_VERSION = 29

Verification

• Tests: swift test — 137 passed
• Builds:
  • macOS AIPulse_macOS
  • iOS AIPulse_iOS
  • watchOS AIPulse_watchOS
  • Widget AIPulseWidgetExtension

Store Copy Handoff

• version: 1.2.6
• tag: v1.2.6
• platforms: macOS, iOS, watchOS
• app_store_ids: {macOS: 6786290416, iOS: TBD}
• headline_en: More accurate spend alerts and clearer watchOS version info
• headline_zh: 更准确的支出告警与更清晰的 watchOS 版本信息
• features_en:
  • Spend-surge and balance-drop alerts now use the balance API for more accurate thresholds
  • watchOS displays the app and CloudKit version and aligns corner labels
• features_zh:
  • 花费激增与余额骤降告警现在基于余额 API，阈值更准确
  • watchOS 显示应用与 CloudKit 版本，并对齐角落标签
• fixes_en:
  • Correct cache-token pricing
  • Use Int64 session timestamps in the iCloud snapshot
  • Normalize percentage formatting and localization
  • Extract cross-platform shared core into AIPulseShared
• fixes_zh:
  • 修正缓存 token 计价
  • 在 iCloud 快照中使用 Int64 会话时间戳
  • 统一百分比格式与本地化
  • 抽取跨平台共享核心 AIPulseShared
• deployment_notes:
  • No CloudKit schema changes
  • Payload version remains 1.2.4
• verification:
  • tests: 137 passed
  • builds: macOS, iOS, watchOS, widget passed
• links:
  • GitHub: https://github.com/wxy/ai-pulse-macos
  • App Store: https://apps.apple.com/app/id6786290416

AI Pulse v1.2.5 — Spend Surge Alerts & Cross-Device Sync

AI Pulse v1.2.5 — Spend Surge Alerts & Cross-Device Sync

What's New

• Spend-surge & balance-drop alerts delivered on Mac, iPhone, and Apple Watch via CloudKit
• Notification controls: system-notification master switch, spend-alert toggle, sound toggle, and permission status
• Grouped General settings: Notifications / Startup & Reset / General
• Session-level tool details with profile metrics
• Companion-app reminder on the About page
• App & CloudKit version display

Fixes & Engineering

• Migrated GRDB 6 → 7, removing the async continuation data race
• Removed the debug spend-alert simulation before release

Deployment Notes

• Deploy the CloudKit schema changes (SpendAlert_v1 and its queryable recordName) to the Production environment before distributing this build.

Verification

• Tests: make test — 137 passed
• macOS app build (arm64): succeeded

Links

• Pull request: Spend surge and balance drop alerts
• macOS App Store: AI Pulse
• iOS companion: AI Pulse — Coding Cost Tracker

---

AI Pulse v1.2.5 — 花费激增告警与跨设备同步

新功能

• 花费激增与余额骤降告警，通过 CloudKit 在 Mac、iPhone、Apple Watch 上同步提醒
• 通知设置：系统通知总开关、花费告警开关、音效开关与权限状态
• 通用设置分组：通知 / 启动与重置 / 常规
• 会话级工具详情与档案指标
• 关于页伴侣应用提醒
• 应用与 CloudKit 版本显示

修复与工程

• GRDB 6 升级到 7，移除异步 continuation 数据竞争
• 发布前移除调试用花费告警模拟

部署注意事项

• 发布前将 CloudKit schema 变更（SpendAlert_v1 及可查询的 recordName）部署到 Production 环境。

验证

• 测试：make test — 137 通过
• macOS App（arm64）构建：通过

链接

• Pull request: Spend surge and balance drop alerts
• macOS App Store: AI Pulse
• iOS 伴侣应用: AI Pulse — Coding Cost Tracker

AI Pulse v1.2.4 — iCloud 同步兼容与稳定性修复

新功能（What's New）

• iCloud 同步版本兼容（macOS） — 当数据由旧版 macOS 写入时，现在会清晰提示升级 macOS 或 iOS，而不是静默显示无数据
• 更智能的 iCloud 同步（iOS） — 旧版 macOS 写入的数据不再误显示为「无数据」或 iCloud 错误，并提供明确的升级指引与 App Store 直达链接
• 退出稳定性 — 修复退出时的卡死/崩溃问题，退出保存不再阻塞
• 后台安全 — 应用健康监控的线程安全修复
• 区域性优化 — 中国大陆地区的工具检测与文案优化

修复与工程

• iCloud payload 版本化：payloadVersion + writerAppVersion 写入每个快照，iOS 端检测旧版数据并展示升级提示（VersionMismatchView）
• 退出挂起/崩溃修复：退出时不再于主线程等待持久化
• CN 合规：中国大陆区域隐藏 Codex CLI / OpenAI 相关工具与文案

---

What's New (English)

• iCloud sync version compatibility — if data was written by an older macOS build, AI Pulse now shows a clear prompt to update macOS or iOS instead of silently showing no data
• Smarter iCloud sync on iOS — clear upgrade guidance with an App Store link instead of "no data" or an iCloud error
• Quit reliability — fixed a hang/crash on quit; shutdown no longer blocks while saving
• Background safety — thread-safety fixes for app health monitoring
• Regional refinements — optimized tool detection and copy for mainland China

AI Pulse v1.2.3 稳定性修复

新功能（What's New）

• 订阅配额追踪 — 在仪表盘实时查看 Claude 与 Copilot 订阅用量及重置倒计时，并同步到 iOS
• Codex 支持 — 解析器、集成、沙盒授权与定价
• OpenCode 支持 — 解析器、集成、扫描与测试

仪表盘

• 占位圈修复：无数据时左右两侧显示与真实圈图一致的灰色占位
• 切换选项卡不再冻结（移除 isLoading 互斥，数据与当前 tab 始终一致）
• 余额相对进度条
• Claude 详情面板：缓存/非缓存颜色区分 + 悬停显示缓存与非缓存费用
• 数据源失败补全错误日志

主菜单

• Window 菜单与 Dock 右键菜单共用同一份实时统计（单一来源，数据变更同步刷新）
• File 菜单重组：重新运行欢迎设置、进入/退出演示模式移到 File，关闭窗口移到末尾
• 「关于」打开设置里的 About 页（不再弹系统面板）

仓库扫描

• 快速仓库扫描器（跳过高频目录、限制深度、超时截断）
• 共享持久化扫描缓存（Onboarding、工具检测、设置统一读取）

修复与工程

• 后台线程安全（RepoScanCache 通知、Logger 移出 MainActor）
• 审计修复：libgit2 泄漏、数据竞争、i18n 覆盖、余额/配额展示
• xcstrings 清理、Swift 6 并发适配、dead code 移除
• 新增 Codex/OpenCode 解析器与测试

AI Pulse v1.2.1 — Settings Integration Fixes, Balance Widget & Claude Code Detail Card

What's New

Settings → Integrations — Major UX Overhaul

• Paste works — replaced NSSecureTextField with custom MaskedTextField (plain NSTextField + partial masking: first 8 chars + bullets). Cmd+V/Ctrl+V now work reliably.
• Ctrl+A/C/V support — Windows-style shortcuts handled via event monitor for users switching from Windows.
• Key validation — saving a key triggers an API balance check; status icon shows orange ? (no key), blue spinner (checking), green ✓ (valid), or red ✗ (invalid).
• Per-provider error detection — Zhipu (code≠200, msg), Kimi (code≠0), plus generic error/success JSON patterns.
• Two-row layout — provider name + balance on row 1, key input + save + status icon on row 2.
• Clear to delete — empty the field and save to remove a key; cached balance is cleared on delete.

Claude Code Detail Card

• Expandable detail card from the menu bar tool row, showing session-level Claude Code usage.

Balance Widget (iOS)

• iOS Widget Extension showing remaining balance + daily trend.
• watchOS three-ring layout mirrored in widget for consistency.
• Auto-refresh on data change.

Other Fixes

• Remaining balance normalized to USD across all platforms.
• CloudKit write skipped when snapshot content is unchanged (prevents unnecessary wake-ups).
• Serialized + deduplicated CloudKit network ops to prevent Wi-Fi drop on iPhone SE 2nd gen.
• Launch-at-login toggle in General settings.
• Debug builds show [DEV] in app name.
• About page: open source license, audio credits, feedback link.

---

Full Changelog: v1.2...v1.2.1

AI Pulse v1.2 — iPhone & Apple Watch

What's New

iOS Companion

• Full iPhone app — check your AI spending anytime, anywhere
• Activity-style dashboard matching macOS: donut charts, trend graphs, tool/repo breakdown
• CloudKit-powered iCloud sync — zero configuration
• Push notifications with coin sound effects
• App icon + splash screen with iCloud error handling

Apple Watch

• Three-ring Activity-style glance: Today, This Week, 30 Days
• Center shows today's spend; corner labels for all time ranges
• Tap to refresh; auto-refresh on wrist raise

macOS

• Collapsible tool and repo sections in Dashboard
• Settings window uses native NavigationSplitView
• Removed "fuel gauge" metaphor from copy

Under the Hood

• CloudKit schema centralized in CKSchema constants
• Lazy CKContainer init for faster launch
• Int64 token counts (arm64_32 compatibility)
• Multi-range CloudKit snapshot merging
• Static NumberFormatter caching

Supported Languages

English, 简体中文, 繁體中文（台灣）, 繁體中文（香港）, 日本語, 한국어, Deutsch, Français, Español, Português (Brasil)

AI Pulse v1.0 — Now on the Mac App Store

AI Pulse is your AI coding fuel gauge — track exactly who's charging you, how much, and whether your code output is worth it. 100% local, zero data leaves your machine.

Download

Available on the Mac App Store — requires macOS 14 Sonoma or later.

What's Inside

Dashboard — 3-section home window with spending donut chart, 30-day trend, and repo/tool breakdown.

Menu Bar — Quick-glance today/total spend with drill-down by provider, tool, repo, and week.

Dock Fuel Gauge — Spending ring with log-scale progress, daily badge, and gold pulse animation.

Multi-Layer Tracking

• Log Parsing — Token-level accuracy from Claude Code & aider logs
• Balance API — Exact dollar deltas from DeepSeek, OpenAI, Kimi, Zhipu, Anthropic
• Subscription Detection — Amortized monthly fees for Cursor, Copilot, Windsurf, Claude Code Pro

CostSource Attribution — 2-layer model attributes every dollar to the right tool, provider, and repo, with confidence levels from exact to incomplete.

Also includes — Anomaly detection, coin sound effects, libgit2-powered commit tracking, 中文/English, and full sandbox compliance.

---

Source code and developer docs: see README.