AgentAcct
在本机终端把编码代理的会话、工作步骤和估算成本连起来。
这个 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 有哪些优点和局限？
- 把客户端报告的用量、代理记录的工作步骤和机器检查证据分开保存，再以带置信度的关联结果呈现，避免把推测当作事实。
- 成本明确是本地价格表估算，令牌数据标记为 `client_reported`，不会伪装成供应商发票。
- 本地优先：无账号、无云同步、无电话回传，且不请求或存储供应商 API 密钥。
- 终端仪表盘支持会话下钻、用量视图、限额倒计时和 SVG 快照导出。
- 项目仍处于 early alpha，接口可能变化。
- 完整的实时用量路径目前明确面向 Claude Code 和 Codex；Hermes、OpenCode、OpenClaw、Cursor 的支持范围更窄且按能力区分。
- 成本不是实际订阅账单；Claude 周计划占用比例需要从个人限额历史校准，校准前不会给出数值。
- 需要读取本机代理会话文件并执行一次安装与集成配置；Windows 仅支持 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 在临时存储中查看演示，不读取真实数据。