AgentAcct

在本机终端把编码代理的会话、工作步骤和估算成本连起来。

Star 数
★ 759
最近更新
1 个月前
License
MIT
主语言
Python

30 秒速览

运行形态
命令行工具桌面应用
可在哪里用
兼容但需适配Codex · Claude Code
费用
免费,无需付费服务
上手难度
低 · 几分钟可跑通
开始前需要
Python >= 3.11macOS 或 Linux(Windows 通过 WSL)Shell / 命令行本地文件系统MCP Server
典型场景
使用 Claude Code 或 Codex 的个人开发者,想在终端查看每个本地会话消耗的令牌、估算成本和工作步骤。
不适合
  • 需要 Windows 原生支持的团队(仅支持 WSL)
  • 要求稳定接口、可长期依赖的生产用户(早期 alpha,接口可能变动)
  • 需要精确订阅账单而非估算成本的团队
官网
trytofu.ai ↗ 来自 GitHub 仓库设置
维护状态
近半年有提交最近提交 2026-10-03最新版本 v0.12.11(2026-10-03)近 7 天每天 +0.6 ★

这个 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 管理本地运行时。

  1. 使用 Claude Code 或 Codex 的个人开发者,想在终端查看每个本地会话消耗的令牌、估算成本和工作步骤。
  2. 维护订阅额度的工程师,需要结合限额条和重置倒计时判断近期编码会话的使用情况。
  3. 需要核实某次代理任务是否真正运行过测试的团队成员,可在会话详情中查看机器检查及退出码。
  4. 重视隐私的开发环境,需要从本地日志生成会话可观测数据,而不提交 API 密钥或建立云端账号。
  5. 希望分享某个仪表盘状态的用户,可通过 p 导出可渲染的 SVG 快照。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • brew install pipx
  • uv tool install agentacct
  • pipx 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?

FollowAgents 源码审查 · FARS-2.1
表现良好
75/ 100 五分制 3.8 / 5
信任安全 19/29
可靠稳定 8/14
适用触发 15/18
规范维护 14/18
有效结果 12/13
证据核验 7/8
查看各维度的扣分理由
信任安全19 / 29 · 3.3/5

文档把采集限定为本地元数据,并说明默认不采集提示词、响应、工具内容或密钥;安全策略也限定 localhost、进程所有权及可选代理的边界。安装提示要求先展示修改全局配置的命令,卸载说明列出停止服务和删除状态数据的步骤,因此最小权限、确认和回退均有实际指引。扣分在于这些材料描述了目标和操作边界,但本样本未展示对应实现细节;依赖清单也没有可见的漏洞审计或锁定策略。来源能追溯到客户端日志、MCP 记录和机器检查,但发布者身份未验证,不能据此增强信任。

可靠稳定8 / 14 · 2.9/5

README、使用真值表和安全文档对估算成本、报告与验证、元数据采集等边界大体一致。源码片段展示了跨平台快速退出、隐藏异常局部变量等防护,CI 配置也列出多 Python 版本和 macOS 应用检查。扣分在于依赖可用性仅有版本范围而无锁文件或可见的供应链检查,且材料提到 macOS 与 Python 3.13 的进程身份测试存在已知问题;静态材料不能证明运行结果。

适用触发15 / 18 · 4.2/5

产品明确面向需要检查多个编码代理任务、步骤、成本和证据的开发者,并覆盖多种客户端、CLI、TUI、Dashboard 及不同安装方式。能力矩阵、成本真值表和“报告不等于验证”等说明清晰划定了能力边界。工作流技能有适用条件和禁止猜测成本的约束,但其中一条末尾截断,且触发条件较宽;平台支持 macOS/Linux、Windows 仅 WSL,原生窗口仅 macOS,限制已说明。

规范维护14 / 18 · 3.9/5

README 将安装、产品视图、工作原理、安全边界、卸载、参考资料和贡献入口组织清楚;安装要求、替代安装路径及卸载清理步骤具体。MIT 许可证明确,文档也坦承 alpha 状态与各集成限制。扣分在于样本没有变更日志,版本演进记录不充分;虽然贡献指南和安全报告路径存在,但维护责任只部分明确,且发布者身份未知。示例文档有链接,但给定材料未包含其内容。

有效结果12 / 13 · 4.6/5

工作回执、活动时间线、用量筛选、检查结果及成本估算旨在把跨代理工作整理为可用的审阅材料;失败尝试保留,缺少证据时显示缺口,且把估算标为估算,具备明确的边际价值。扣分在于成本仍是客户端数据或定价表估计,部分能力需集成主动记录或导入才能覆盖;早期 alpha 与多客户端配置也增加了使用成本。静态材料无法确认实际输出质量。

证据核验7 / 8 · 4.4/5

文档将关键主张关联到覆盖矩阵、真值表、隐私威胁模型、集成参考和 CLI 命令,并区分客户端报告、MCP 自报、机器检查及估算成本。CI 和应用测试文件给出了可见的检查方案,但这是源代码中的测试配置,不是本次独立执行结果;各来源之间有较多相互印证。扣分在于提供材料是仓库样本而非完整文件集,且技能内容被截断,不能据此确认全仓一致性。

风险与缓解建议
  • 这是低置信度静态审查;没有执行程序或独立验证测试结果。
  • 产品标注为早期 alpha。成本可能是定价表估算或客户端报告值,不等于账单;集成覆盖也因代理而异。
  • 给定技能文件末尾截断,且材料仅为仓库样本,未见文件不能据此视为缺失或已验证。
证据充分度:低 评估于 2026年11月8日 审查版本 03f1dd803662
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/agentacct.svg?lang=zh)](https://followagents.com/zh/agents/agentacct)
<a href="https://followagents.com/zh/agents/agentacct"><img src="https://followagents.com/badge/agentacct.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. 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 查看 ↗
  2. 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 查看 ↗
  3. 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 密钥吗?
不会。它不请求或保存供应商 API 密钥,也没有 Claude Code 或 Codex 订阅账单的精确访问权限;成本来自本地价格表估算。
数据是否会被上传到云端?
不会。状态是本地文件,没有托管仪表盘、账号、云同步或电话回传。可选浏览器仪表盘仅在 http://127.0.0.1:8765 本机地址运行。
为什么有些会话没有完整的工作归因?
它只在能通过会话或转录 ID 证明关联时建立连接,并显示置信度。无法证明时会显示缺口,而不会猜测归属。
它会监控所有本机进程吗?
不会。它读取检测到的客户端本地会话文件,不监视由 AgentAcct 或其集成之外启动的无关进程。
AgentAcct 官网是什么?
AgentAcct 的 GitHub 仓库填写的官网是 https://trytofu.ai。这个链接由仓库作者设置;源码在 GitHub(mikehasa/agentacct)。
AgentAcct 免费吗?
免费。AgentAcct 可以免费使用,不需要付费服务。
AgentAcct 开源吗?
开源。源码在 GitHub(mikehasa/agentacct),许可证是 MIT。
AgentAcct 安全吗?
FollowAgents 的 FARS 评审(2026年11月8日)给 AgentAcct 的“信任与安全”打了 19/29 分。评审检查的 8 项安全措施没有完全缺失的。
AgentAcct 还在维护吗?
更新变慢了:GitHub 上最近一次提交是 2026-10-03,在最近半年内,但不在最近 30 天内。最新版本是 v0.12.11(2026-10-03)。
AgentAcct 是谁开发的?
AgentAcct 由 GitHub 账号 mikehasa 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

所属宿主生态

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念