AgentAcct
在本机终端把编码代理的会话、工作步骤和估算成本连起来。
- Star 数
- ★ 759
- 最近更新
- 1 个月前
- License
- MIT
- 主语言
- Python
- FA 评分
- 75/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配Codex · Claude Code
- 费用
- 免费,无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 使用 Claude Code 或 Codex 的个人开发者,想在终端查看每个本地会话消耗的令牌、估算成本和工作步骤。
- 不适合
- 需要 Windows 原生支持的团队(仅支持 WSL)
- 要求稳定接口、可长期依赖的生产用户(早期 alpha,接口可能变动)
- 需要精确订阅账单而非估算成本的团队
- 官网
- trytofu.ai ↗ 来自 GitHub 仓库设置
- 维护状态
- 近半年有提交最近提交 2026-10-03最新版本 v0.12.11(2026-10-03)近 7 天每天 +0.6 ★
- 源码审查
- 75/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 快照。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
brew install pipxuv tool install agentacctpipx install agentacct
- 配置文件
~/.local/state/agentacct/state- 运行环境
- Python 3.11
- 安装说明涉及
- Windows · macOS · Linux · WSL
如何安装或部署这个 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 当前 | 75 · 表现良好 | 命令行工具免费 | ★ 759 | 1 个月前 | Python | Codex · Claude Code |
| Frink — 本地 AI 工作流自动化桌面应用 | 65 · 存在缺口 | 桌面应用免费 + 模型费 | ★ 176 | 今天 | TypeScript | Codex · Claude Code |
| cost-xray | 65 · 存在缺口 | 命令行工具免费 | ★ 5.8k | 5 天前 | Python | Codex · Claude Code · OpenAI API · Claude API |
| ClawMetry | 71 · 存在缺口 | 命令行工具免费版 + 付费版 | ★ 439 | 今天 | Python | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
文档把采集限定为本地元数据,并说明默认不采集提示词、响应、工具内容或密钥;安全策略也限定 localhost、进程所有权及可选代理的边界。安装提示要求先展示修改全局配置的命令,卸载说明列出停止服务和删除状态数据的步骤,因此最小权限、确认和回退均有实际指引。扣分在于这些材料描述了目标和操作边界,但本样本未展示对应实现细节;依赖清单也没有可见的漏洞审计或锁定策略。来源能追溯到客户端日志、MCP 记录和机器检查,但发布者身份未验证,不能据此增强信任。
README、使用真值表和安全文档对估算成本、报告与验证、元数据采集等边界大体一致。源码片段展示了跨平台快速退出、隐藏异常局部变量等防护,CI 配置也列出多 Python 版本和 macOS 应用检查。扣分在于依赖可用性仅有版本范围而无锁文件或可见的供应链检查,且材料提到 macOS 与 Python 3.13 的进程身份测试存在已知问题;静态材料不能证明运行结果。
产品明确面向需要检查多个编码代理任务、步骤、成本和证据的开发者,并覆盖多种客户端、CLI、TUI、Dashboard 及不同安装方式。能力矩阵、成本真值表和“报告不等于验证”等说明清晰划定了能力边界。工作流技能有适用条件和禁止猜测成本的约束,但其中一条末尾截断,且触发条件较宽;平台支持 macOS/Linux、Windows 仅 WSL,原生窗口仅 macOS,限制已说明。
README 将安装、产品视图、工作原理、安全边界、卸载、参考资料和贡献入口组织清楚;安装要求、替代安装路径及卸载清理步骤具体。MIT 许可证明确,文档也坦承 alpha 状态与各集成限制。扣分在于样本没有变更日志,版本演进记录不充分;虽然贡献指南和安全报告路径存在,但维护责任只部分明确,且发布者身份未知。示例文档有链接,但给定材料未包含其内容。
工作回执、活动时间线、用量筛选、检查结果及成本估算旨在把跨代理工作整理为可用的审阅材料;失败尝试保留,缺少证据时显示缺口,且把估算标为估算,具备明确的边际价值。扣分在于成本仍是客户端数据或定价表估计,部分能力需集成主动记录或导入才能覆盖;早期 alpha 与多客户端配置也增加了使用成本。静态材料无法确认实际输出质量。
文档将关键主张关联到覆盖矩阵、真值表、隐私威胁模型、集成参考和 CLI 命令,并区分客户端报告、MCP 自报、机器检查及估算成本。CI 和应用测试文件给出了可见的检查方案,但这是源代码中的测试配置,不是本次独立执行结果;各来源之间有较多相互印证。扣分在于提供材料是仓库样本而非完整文件集,且技能内容被截断,不能据此确认全仓一致性。
- 这是低置信度静态审查;没有执行程序或独立验证测试结果。
- 产品标注为早期 alpha。成本可能是定价表估算或客户端报告值,不等于账单;集成覆盖也因代理而异。
- 给定技能文件末尾截断,且材料仅为仓库样本,未见文件不能据此视为缺失或已验证。
最近版本
来自该项目 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 本机地址运行。为什么有些会话没有完整的工作归因?
它会监控所有本机进程吗?
AgentAcct 官网是什么?
AgentAcct 免费吗?
AgentAcct 开源吗?
AgentAcct 安全吗?
AgentAcct 还在维护吗?
AgentAcct 是谁开发的?
谢谢反馈,我们会据此改进页面。