CC Bar

cc-bar

  macOS 原生 AI 额度监控与用量分析工具
  在菜单栏实时监控 Codex、Claude Code、Cursor、Antigravity 配额与重置时间，本地离线分析 Tokens、费用与对话。

  下载安装 ·
  服务支持 ·
  核心特性 ·
  安全说明 ·
  从源码构建 ·
  问题反馈 ·
  English

  菜单栏、桌面悬浮窗与 Popover · 浅色 / 深色模式

⚡ 服务支持矩阵

cc-bar 展示两类数据：订阅额度直连各服务官方接口获取剩余比例与重置时间；本机用量由本地日志解析或服务端计量汇总，不上传任何代码、项目数据或会话内容。

✨ 核心特性

⚡ 实时配额与状态监控
* 常驻菜单栏与桌面悬浮窗 — 支持主要窗口、周窗口或双窗口模式；桌面悬浮窗边缘吸附、位置记忆，不抢占键盘焦点。
* 低额度系统通知 — 当 5 小时、周或计费周期额度低于设定阈值时发送 macOS 系统通知，同一周期仅提醒一次，点击通知直达用量统计。
* 低开销后台调度 — 额度查询、日志扫描与服务状态合并调度；锁屏与息屏降频，睡眠暂停、唤醒补刷，接口 429 自动退避。
* 多账号无缝并存 — Codex 支持粘贴 auth.json 或 PAT 导入多个账号同屏查看剩余额度与额外重置次数，不影响 CLI 登录状态。

📊 本地离线用量与项目分析
* 多维度统计分析 — 概览、对话、项目与额度四个页面，支持日 / 周 / 月粒度与自定义时间范围：
  * 用量概览：堆叠图展示总 Tokens、费用与同期变化，按服务、Provider、模型或项目分析构成，统计缓存命中率。
  * 对话明细：检索历史会话，查看输入、输出、缓存读写明细、请求数、模型构成与 Standard / Fast 速度档位费用拆分。
  * 项目分析：按项目汇总用量趋势、高消耗对话与分支分布；Git worktree 自动归入主仓库。
  * 额度对比与预估：对比当前周期的本机用量、用满预估与官方已用比例；支持开启「包含其他 Agent 中的 Codex 订阅用量」，将 Pi、OpenCode、DSH 中消耗的 Codex 额度合并计入。
* 规则变更自动重算 — 价格表或统计规则变化后自动重新计费；会话日志已清理的对话自动保留历史用量，不影响统计连续性。

  展开查看对话明细、项目分析与额度监控截图

💻 原生体验与隐私控制
* 一页管理与拖拽排序 — 「设置 → 服务与账号」一页开关所有服务，可整行拖拽自定义服务在菜单栏、Popover、悬浮窗与统计页的全局展示顺序。
* 截图隐私模式 — 一键匿名遮挡账号邮箱、项目路径、Git 分支与会话 ID，保留真实金额与图表，截图分享无负担。
* 应用内平滑升级 — 集成 Sparkle 更新器，直接在应用内查看更新说明、一键下载安装并自动重启。
* 本地诊断与零追踪 — 日志自动轮转且关键字段全脱敏；可手动导出诊断包，应用不含任何用户行为遥测。

📦 快速安装
运行环境：macOS 14 (Sonoma) 或更新版本。
前置条件：相关 AI 编程工具需已在终端或桌面端完成至少一次登录。

1. 进入 Releases 页面 下载最新的 CCBar.dmg（或 CCBar.app.zip）。
2. 打开 DMG，将 CCBar.app 拖入 /Applications 文件夹即可。

首次升级到含应用内更新器的版本，需要按上述步骤手动安装一次。此后可在「设置 → 通用 → 检查更新」查看更新内容，点击「下载并安装」后自动完成安装并重新启动。

首次启动安全提示 (Gatekeeper)
发布的构建为 ad-hoc 签名（未走付费 Apple 公证）。首次启动若被系统拦截：
1. 打开 系统设置 → 隐私与安全性，向下滑动找到 CCBar 的拦截提示，点击 「仍要打开」；
2. 若系统提示「应用程序已损坏」，可在终端执行以下命令清除隔离标记：

3. 若本机不存在明文 credentials 文件，应用会在说明后请求 Keychain 读取权限，请选择 「始终允许」。

🔒 数据与隐私安全

用量日志在本机解析与保存；额度、Cursor…