VibePulse：macOS 菜单栏 AI 用量监控

项目简介

VibePulse 是一款 macOS 菜单栏应用，用于跟踪本机 AI 编程代理的 token 花费。它的数据来自 agentsview：VibePulse 调用 agentsview 的用量报告，把结果汇总后直接显示在菜单栏和下拉面板里。适合日常使用 Claude Code、Codex 等本地代理、想随时掌握用量与花费的开发者。

所有用量数据都保存在本机，应用不含任何分析或遥测。

主要功能

• 菜单栏显示当日合计花费（按 token 单价计算、不含订阅费用）
• Today 视图展示当天累计花费；7 天、30 天视图展示每日合计
• 1 年视图展示最近 12 个自然月（含当月）的每月合计
• 图表可按代理、模型或机器分组
• 可配置的后台刷新频率（5 分钟、15 分钟、1 小时、4 小时、1 天）
• 内置数据维护，用于规范化历史数据、重跑导入修复
• 设置里可控制开机自启、依赖路径与数据源开关

安装与使用

环境要求：macOS 13（Ventura）及以上；已安装支持 usage daily --timezone 的 agentsview；过去一年内至少有一个被 agentsview 解析、且产生计费活动的代理。

1. 从 GitHub Releases 下载最新的 .dmg 文件。
2. 把 VibePulse.app 拖到「应用程序」文件夹。
3. 启动应用。若被 macOS 拦截，到「系统设置 → 隐私与安全性」中放行。

安装 agentsview：

curl -fsSL https://agentsview.io/install.sh | bash

该脚本会把 agentsview 安装到 ~/.local/bin/agentsview 或 /usr/local/bin/agentsview。VibePulse 不在 shell 环境中运行，因此如果 agentsview 装在非标准位置，需要在 Settings → Dependencies 中填写路径；也可以通过该处填写 agentsview pg serve 实例的 URL（例如 http://127.0.0.1:18080）来读取服务端数据。使用 mise 安装时，应用会优先检查 ~/.local/share/mise/shims/agentsview。

首次启动会出现欢迎窗口，说明 agentsview 依赖、默认 15 分钟刷新周期，并可开关开机自启。

本地开发可直接运行：

swift run

注意事项

• 数据存放：用量数据库位于 ~/Library/Application Support/VibePulse/，vibepulse.sqlite 保存合并用量，vibepulse-non-automated.sqlite 保存排除自动化会话后的用量。
• 1 年视图：首次加载比普通刷新慢，应用会在本地缓存该历史数据；当天运行期间复用这次年度导入。
• 自动化会话：Data Sources 中的「Include automated sessions」默认开启，可关闭以从服务器报告中排除自动评审；使用本地 CLI 时该设置不可用，始终包含自动化会话。
• 代理未显示：可在终端运行 agentsview usage daily --format json --breakdown --since 30d --timezone America/Los_Angeles（时区换成自己的 IANA 标识），确认该代理在时间窗口内出现在 agentBreakdowns 中且总花费为正。
• 开机自启：macOS 可能要求在「系统设置 → 登录项」中批准。

许可证：MIT。

---

本作品整理自 GitHub 开源项目 kenn-io/vibepulse，原作者 @kenn-io，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。