AgentAcct
在本机终端把编码代理的会话、工作步骤和估算成本连起来。
- Star 数
- ★ 755
- 最近更新
- 1 个月前
- License
- MIT
- 主语言
- Python
- FA 评分
- 61/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配Codex · Claude Code
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 使用 Claude Code 或 Codex 的个人开发者，想在终端查看每个本地会话消耗的令牌、估算成本和工作步骤。
- 不适合
- 需要 Windows 原生支持的团队（仅支持 WSL）
- 要求稳定接口、可长期依赖的生产用户（早期 alpha，接口可能变动）
- 需要精确订阅账单而非估算成本的团队
- 源码审查
- 61/100 · 存在缺口
这个 Agent 能做什么，适合哪些场景？
AgentAcct 是面向编码代理的本地优先工作可观测工具，主要读取 Claude Code 和 Codex 已写入本机的会话日志。它通过 agentacct tui 提供实时终端仪表盘，显示用量窗口、限额重置倒计时、近期会话、令牌和估算成本。它还接收代理经 MCP 记录的工作区段与机器检查结果，并将这些证据与会话用量按真实会话或转录 ID 关联。关联结果带有 exact、high、medium 或 low 置信度标签；无法证明关联时会展示缺口而非猜测。默认不需要账号、云同步、遥测或供应商 API 密钥，状态保存在本机文件中。
执行 agentacct onboard 后，AgentAcct 检测本机编码代理日志、建立全局存储并进行首次用量同步。它导入客户端会话文件中的令牌数据并标记为 client_reported，再根据本地价格表生成明确标注的成本估算，而非供应商账单。工作侧由代理调用 MCP 工具 agentacct_record_section 和 agentacct_record_machine_check 写入；机器检查可附带测试等命令的退出码。agentacct tui 将用量、成本、限额信息和工作台账汇总为终端界面；按 s 查看会话，按 u 查看用量，按 p 将当前视图保存为 SVG 快照。它还可用 agentacct start、status、stop 和 repair 管理本地运行时。
- 使用 Claude Code 或 Codex 的个人开发者，想在终端查看每个本地会话消耗的令牌、估算成本和工作步骤。
- 维护订阅额度的工程师，需要结合限额条和重置倒计时判断近期编码会话的使用情况。
- 需要核实某次代理任务是否真正运行过测试的团队成员，可在会话详情中查看机器检查及退出码。
- 重视隐私的开发环境，需要从本地日志生成会话可观测数据，而不提交 API 密钥或建立云端账号。
- 希望分享某个仪表盘状态的用户，可通过
p导出可渲染的 SVG 快照。
如何安装或部署这个 Agent？
运行环境：Python 3.11 或更高版本，macOS 或 Linux；Windows 仅通过 WSL 支持。无需账号或供应商 API 密钥。
pipx install agentacct
agentacct onboard
agentacct tui若未安装 pipx，可先运行 brew install pipx（macOS）或 python3 -m pip install --user pipx，也可使用 uv tool install agentacct。默认的 onboard 为全局安装；如需按仓库安装，使用 agentacct onboard --scope project。
如何使用这个 Agent？
完成 agentacct onboard 后，在新的代理会话中工作，再运行 agentacct tui 查看本机数据。终端界面中按 s 打开会话列表和详情，按 u 打开用量页面，按 p 保存当前视图为 SVG，按 q 退出。全局状态默认位于 ~/.local/state/agentacct/state；项目范围安装则使用仓库中的 .agent-sentinel/。首次运行也可使用 agentacct demo 在临时存储中查看演示，不读取真实数据。
这个 Agent 有哪些优点和局限？
- 把客户端报告的用量、代理记录的工作步骤和机器检查证据分开保存，再以带置信度的关联结果呈现，避免把推测当作事实。
- 成本明确是本地价格表估算，令牌数据标记为
client_reported，不会伪装成供应商发票。 - 本地优先：无账号、无云同步、无电话回传，且不请求或存储供应商 API 密钥。
- 终端仪表盘支持会话下钻、用量视图、限额倒计时和 SVG 快照导出。
- 项目仍处于 early alpha，接口可能变化。
- 完整的实时用量路径目前明确面向 Claude Code 和 Codex；Hermes、OpenCode、OpenClaw、Cursor 的支持范围更窄且按能力区分。
- 成本不是实际订阅账单；Claude 周计划占用比例需要从个人限额历史校准，校准前不会给出数值。
- 需要读取本机代理会话文件并执行一次安装与集成配置；Windows 仅支持 WSL。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| AgentAcct 当前 | 61 · 存在缺口 | 命令行工具免费 | ★ 755 | 1 个月前 | Python | Codex · Claude Code |
| Frink — 本地 AI 工作流自动化桌面应用 | 50 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 181 | 11 天前 | TypeScript | Codex · Claude Code |
| cost-xray | 65 · 存在缺口 | 命令行工具免费 | ★ 5.8k | 今天 | Python | Codex · Claude Code · OpenAI API · Claude API |
| ClawMetry | 81 · 表现良好 | 命令行工具免费版 + 付费版 | ★ 436 | 4 天前 | Python | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：项目强调本地优先、无遥测、不存储API密钥，并采用最小权限原则（如仅读取本地会话文件、不扫描无关进程）。用户确认方面，安装和配置过程需要用户明确操作，且修改全局配置前会显示确切命令。数据流透明性：文档详细说明了数据流和隐私模型。敏感数据处理：有明确的秘密处理指南和重定向。依赖安全：依赖列表常见，但未提供漏洞扫描或锁定文件。外部影响：明确限制为仅控制自身启动的进程，并有安全边界文档。回滚：提供卸载和清理说明。来源归属：明确区分客户端报告和估计值。扣分原因：依赖安全缺乏具体证据，如依赖锁定或漏洞扫描。
自一致性：文档和代码注释一致，测试覆盖全面。依赖可用性：依赖均为常见库，但未提供版本锁定或镜像。失败消息：测试和文档显示有清晰的错误提示和恢复建议。扣分原因：依赖可用性缺乏具体保障措施。
受众和场景：明确面向开发者，支持多种编码代理。能力边界：文档明确列出各客户端的支持程度。触发精度：通过MCP工具和钩子精确记录工作步骤。环境适配：支持macOS和Linux，Windows需WSL。扣分原因：无重大缺陷。
信息架构：文档结构清晰，有参考手册和安装指南。安装说明：提供多种安装方式。命名稳定性：项目名称和命令稳定，但存在旧名称兼容。示例和FAQ：提供演示和常见问题。已知限制：明确说明是早期alpha。许可证：MIT。版本和变更日志：有版本号但无详细变更日志。维护责任：有贡献指南和反馈渠道。扣分原因：命名稳定性因旧名称兼容而略有扣分，版本变更日志不详细。
输出可用性：提供终端仪表盘和SVG快照。边际价值：提供成本估算和工作步骤记录，具有独特价值。成本效益：本地运行，无额外成本。扣分原因：无重大缺陷。
声明可追溯：文档和测试对应。跨来源佐证：测试覆盖多个场景，但未提供外部验证。事实与推断分离：明确区分客户端报告和估计值。扣分原因：跨来源佐证不足。
- 依赖安全：未提供依赖锁定或漏洞扫描，建议使用锁文件并定期检查。
- 版本变更日志不详细，建议补充。
- 跨来源佐证不足，建议增加外部验证或独立测试。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v0.12.11 agentacct 0.12.11
发布说明摘录
Download [Download agentacct 0.12.11 for macOS (Apple Silicon, macOS 14+)](https://github.com/mikehasa/agentacct/releases/download/v0.12.11/agentacct-0.12.11.dmg) What's changed Two Claude accounts on one machine no longer read as one client's contradictory meters: every provider-limit reading is labeled with the account and source it belongs to. (#355) - The macOS Usage page, the TUI, and agentacct limits label each reading — CLI · [email protected], desktop app · org 07c55a50 — so a second account's Weekly meter can no longer be mistaken for the first account's. …在 GitHub 查看 ↗ -
v0.12.10 agentacct 0.12.10
发布说明摘录
macOS app [Download agentacct 0.12.10 for macOS](https://github.com/mikehasa/agentacct/releases/download/v0.12.10/agentacct-0.12.10.dmg) Fixed - Recovery notifications no longer accumulate behind identical banners. A recurring source issue replaces its previous recovery banner, and recovered notices disappear after ten seconds. - Recovery titles identify the affected client and issue. Recent updates keeps the recovery history, while active faults remain visible until dismissed or confirmed recovered. …在 GitHub 查看 ↗ -
v0.12.9 agentacct 0.12.9
发布说明摘录
Codex's gpt-6.1-sol usage rows are priced instead of importing cost-unknown. Nothing else changed. macOS app (no Python, pipx, or terminal needed): [agentacct-0.12.9.dmg](https://github.com/mikehasa/agentacct/releases/download/v0.12.9/agentacct-0.12.9.dmg) — signed, notarized, and stapled, built from this release's own commit. The app embeds the frozen agentacct CLI, so the DMG is rebuilt here even though no Swift file changed: the fix lives in the CLI, and reusing the 0.12.8 DMG would have shipped the old price table and silently dropped it. …在 GitHub 查看 ↗
常见问题
它会访问我的供应商账单或 API 密钥吗？
数据是否会被上传到云端？
http://127.0.0.1:8765 本机地址运行。