{"id":50989122,"url":"https://github.com/nanvon/cc-bar","last_synced_at":"2026-07-07T22:00:45.840Z","repository":{"id":359953623,"uuid":"1246243218","full_name":"nanvon/cc-bar","owner":"nanvon","description":"Native macOS menu bar app: track quota, usage and cost for Codex (multi-account) and Claude Code, from your menu bar or a desktop floating HUD.  原生 macOS 菜单栏 App：支持 Codex 多账号与 Claude Code，在菜单栏或桌面悬浮窗实时查看额度、本地用量与消费。","archived":false,"fork":false,"pushed_at":"2026-07-01T02:21:34.000Z","size":2008,"stargazers_count":86,"open_issues_count":2,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-01T04:16:04.474Z","etag":null,"topics":["anthropic","claude","claude-code","codex","macos","menu-bar","multi-account","openai","quota","usage-tracking"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nanvon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-22T02:30:40.000Z","updated_at":"2026-07-01T02:20:41.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/nanvon/cc-bar","commit_stats":null,"previous_names":["nanvon/cc-bar"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/nanvon/cc-bar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nanvon%2Fcc-bar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nanvon%2Fcc-bar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nanvon%2Fcc-bar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nanvon%2Fcc-bar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nanvon","download_url":"https://codeload.github.com/nanvon/cc-bar/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nanvon%2Fcc-bar/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35243953,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-07T02:00:07.222Z","response_time":90,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anthropic","claude","claude-code","codex","macos","menu-bar","multi-account","openai","quota","usage-tracking"],"created_at":"2026-06-20T00:00:28.870Z","updated_at":"2026-07-07T22:00:45.822Z","avatar_url":"https://github.com/nanvon.png","language":"Swift","funding_links":[],"categories":["AI Usage/Status"],"sub_categories":[],"readme":"# cc-bar\n\n\u003e macOS 菜单栏小工具 —— 一眼看清 Codex、Claude Code 与 Antigravity 的剩余额度。\n\n\u003cp\u003e\n  \u003cimg alt=\"platform\" src=\"https://img.shields.io/badge/macOS-14+-blue.svg\"\u003e\n  \u003cimg alt=\"swift\" src=\"https://img.shields.io/badge/Swift-5.9-orange.svg\"\u003e\n  \u003cimg alt=\"version\" src=\"https://img.shields.io/badge/version-0.13.0-brightgreen.svg\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/Screenshots/overview.png\" width=\"380\" alt=\"Popover 总览\"\u003e\n\u003c/p\u003e\n\n## 功能\n\n- **额度显示** —— Codex、Claude Code 与 Antigravity 的 5 小时 / 周窗口剩余额度,实时同步\n- **菜单栏 + 悬浮窗** —— 状态栏图标显示剩余百分比;可选桌面悬浮 HUD,可拖动、边缘吸附、置顶不抢焦\n- **多 Codex 账号** —— 支持导入多个 Codex 账号,主副账号在 Popover 同屏展示;设置页可查看每个账号的额外重置次数与到期时间\n- **Token 与费用统计** —— 按今天 / 昨天 / 本周 / 本月 / 本年 / 7 天 / 30 天 / 全部 / 自定义切换;KPI、堆叠柱状图、按服务占比、按模型明细\n- **丰富的设置** —— 账号开关、菜单栏显示项、悬浮窗、刷新间隔、重置时间显示、中英双语、开机自动启动\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/Screenshots/statistics.png\" width=\"720\" alt=\"用量统计\"\u003e\n\u003c/p\u003e\n\n## 安装\n\n要求 macOS 14 Sonoma 或更新版本。Codex / Claude Code 需已通过终端登录；Antigravity 需安装官方 App 或 IDE，并在运行时提供本地额度服务。\n\n1. 到 [Releases](https://github.com/nanvon/cc-bar/releases) 下载最新 `CCBar.app.zip`,解压后把 `CCBar.app` 拖入 `/Applications`。\n\n2. CCBar 未做 Apple 付费公证,首次启动会被 Gatekeeper 拦下,需手动放行一次。打开「终端」,粘贴回车:\n\n   ```bash\n   xattr -dr com.apple.quarantine /Applications/CCBar.app\n   ```\n\n   然后双击打开。若仍被拦,到 **系统设置 → 隐私与安全性**,下滑找到 CCBar 的提示,点**「仍要打开」**。\n   (macOS Sequoia 起,旧的「右键 → 打开」已失效,只能用上面这种方式。)\n\n3. 若本机无 `~/.claude/.credentials.json`,会弹出说明后请求 Keychain 授权,请选「**始终允许**」。\n\n## 关于本项目与安全性\n\ncc-bar 是 vibe coding 出来满足个人需求的小工具,并非商业化产品。为了显示额度,它需要读取本地的登录凭据:Codex 的 `~/.codex/auth.json`、Claude Code 的 `~/.claude/.credentials.json` 以及 macOS Keychain。Antigravity 只连接官方进程在 `127.0.0.1` 暴露的本地 Language Server,不保存 Google OAuth 凭据,也不会启动 CLI 或发送模型请求。\n\n发布的 `CCBar.app` 未做 Apple 付费公证(详见上方「安装」)。如果你介意安全性,完全可以**自己用 AI 审阅本仓库代码**,确认无误后**按下方教程自行构建**,不依赖我发布的二进制包。\n\n## 从源码构建\n\n需要安装完整 Xcode(非仅 Command Line Tools)。\n\n**日常开发**:双击 `ccbar.xcodeproj`,选 scheme `ccbar` 与「My Mac」,按 **⌘R** 运行调试。\n\n**打包分发**:用命令行不签名构建,产物为 ad-hoc 签名,可在任意 Mac 上运行,无需付费证书或公证。\n\n1. 首次需把命令行工具指向完整 Xcode(一次性):\n\n   ```bash\n   sudo xcode-select -s /Applications/Xcode.app/Contents/Developer\n   ```\n\n2. 在项目根目录执行构建脚本:\n\n   ```bash\n   ./scripts/build.sh\n   ```\n\n   脚本会以 `CODE_SIGNING_ALLOWED=NO` 做 Release 构建(工具链自动 ad-hoc 签名),\n   清理扩展属性并打包,产物输出到 `dist/CCBar.app.zip`。\n\n3. 把 `dist/CCBar.app.zip` 上传到 GitHub Release 即可。用户首次安装按上方「安装」一节手动放行一次。\n\n\u003e 不要用 Xcode 的 Archive 导出分发:那会引入 \"Apple Development\" 开发证书,只能在本机运行,拷给别人会打不开。\n\n## 反馈\n\n请到 [Issues](https://github.com/nanvon/cc-bar/issues) 留言。\n\n## 致谢\n\ncc-bar 在设计与实现上参考了以下优秀的开源项目,在此特别感谢:\n\n- [cc-switch](https://github.com/farion1231/cc-switch) —— 多 Provider 账号切换器,启发了本项目的多账号管理与导入流程\n- [cockpit-tools](https://github.com/jlcodes99/cockpit-tools) —— 多平台 AI 编码助手仪表盘,在额度与刷新策略上提供了参考\n- [CodexBar](https://github.com/steipete/CodexBar) —— macOS 菜单栏 AI 用量监控,在菜单栏交互与本地解析思路上多有借鉴\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnanvon%2Fcc-bar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnanvon%2Fcc-bar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnanvon%2Fcc-bar/lists"}