我用做了一个 macOS 菜单栏小工具：把你的 AI 编程用量放进状态栏
如果你和我一样，已经习惯了让 Codex、Claude Code 这类 AI 编程助手参与日常开发，那么大概率也遇到过一个小小的焦虑：
今天到底用了多少？
这周消耗怎么样？
Codex 配额还剩多少？
这些 token 大概花了多少钱？
于是我做了 AgentBar：一个本地优先的 macOS 菜单栏应用，用来追踪 AI 编程助手的使用量、token、费用估算和 Codex 配额状态。
GitHub 地址：github.com/varenyzc1/a…
如果你觉得这个项目有用，欢迎顺手点个 Star。它会给我很多继续打磨的动力。
为什么需要 AgentBar？
AI 编程助手越来越像开发环境的一部分，但使用数据却常常散落在不同地方：
- 有些记录在本地日志里；
- 有些配额要去网页里看；
- 有些费用只能靠自己心算；
- 真想回顾一周使用趋势时，又没有一个轻量入口。
AgentBar 想解决的就是这件事：把 AI 编程使用情况变成一个随手可看的菜单栏状态。
不需要打开复杂后台，不需要上传自己的使用记录。点一下菜单栏，就能看到今日、近 7 天、全部使用量，以及 Codex 5 小时 / 7 天滚动配额窗口。
它能做什么？
AgentBar 目前主要支持这些能力：
- 统计今日、近 7 天、全部 AI 编程使用量；
- 展示 Codex 5 小时和 7 天滚动配额；
- 根据本地 token 记录估算费用；
- 支持 token / 费用预算配置；
- 按来源拆分使用量，例如 Codex、Claude Code；
- 展示 365 天活动热力图；
- 手动扫描、费用重算、价格重置；
- 支持开机启动；
- 支持 GitHub Releases 更新检查；
- 支持 Homebrew 安装和升级。
菜单栏可以切换不同显示模式，比如优先显示配额、提醒或本地用量。它的定位不是一个庞大的 SaaS 面板，而是一个安静的小工具：常驻、轻量、够用。
本地优先：你的使用记录留在自己电脑上
AgentBar 的一个核心设计是 local-first。
它会扫描本机 AI 编程助手产生的使用记录，解析 provider、model、token、时间等信息，然后把归一化后的数据写入本地 SQLite 数据库。
也就是说，本地使用量的计算不依赖远程服务器。
网络请求只会出现在少数明确场景：
- 配置后刷新 Codex 配额；
- 检查 GitHub Releases 是否有新版本；
- 你主动选择用 Homebrew 更新应用。
对开发者工具来说，我觉得这点很重要。使用记录、账号、配额信息和本地路径都可能是敏感信息，能留在本地就尽量留在本地。
设置也尽量克制
AgentBar 是 Swift + SwiftUI 写的原生 macOS 应用。设置页里可以配置菜单栏显示、刷新行为、开机启动、预算、维护操作和更新检查。
它不会在界面里堆很多说明文字，更多是做成一个紧凑、可扫读的工具面板。
安装方式
如果你使用 Homebrew，可以直接安装：
brew tap varenyzc1/agentbar
brew install --cask agentbar
升级到最新版本：
brew update && brew upgrade --cask agentbar
也可以从源码构建：
git clone https://github.com/varenyzc1/agentbar.git
cd agentbar
./build.sh
open .build/AgentBar.app
项目要求：
- macOS 14 或更新版本；
- Xcode Command Line Tools；
- Swift 5.9 或更新版本。
技术栈
AgentBar 的实现比较朴素：
- Swift / SwiftUI 构建 macOS 菜单栏应用；
- Swift Package 管理 targets；
- SQLite 存储归一化后的本地使用记录；
- GitHub Actions 负责 release 打包；
- Homebrew cask 支持安装和升级。
项目结构也尽量保持清晰：
AgentBar：菜单栏 UI、设置页、更新检查和 macOS 集成；AgentBarCore：扫描、解析、存储、价格、聚合、Codex 配额逻辑；AgentBarCoreTests：核心逻辑测试。
最后
AgentBar 还在持续迭代中。如果你也是 AI 编程工具的重度用户，欢迎试试看。
GitHub：github.com/varenyzc1/a…
如果这个小工具刚好解决了你的痛点，欢迎 Star、提 issue，或者一起贡献代码。
