AgentAcct
在本机终端把编码代理的会话、工作步骤和估算成本连起来。
按维度查看评分与理由
证据显示：项目强调本地优先、无遥测、不存储API密钥，并采用最小权限原则（如仅读取本地会话文件、不扫描无关进程）。用户确认方面，安装和配置过程需要用户明确操作，且修改全局配置前会显示确切命令。数据流透明性：文档详细说明了数据流和隐私模型。敏感数据处理：有明确的秘密处理指南和重定向。依赖安全：依赖列表常见，但未提供漏洞扫描或锁定文件。外部影响：明确限制为仅控制自身启动的进程，并有安全边界文档。回滚：提供卸载和清理说明。来源归属：明确区分客户端报告和估计值。扣分原因：依赖安全缺乏具体证据，如依赖锁定或漏洞扫描。
自一致性：文档和代码注释一致，测试覆盖全面。依赖可用性：依赖均为常见库，但未提供版本锁定或镜像。失败消息：测试和文档显示有清晰的错误提示和恢复建议。扣分原因：依赖可用性缺乏具体保障措施。
受众和场景：明确面向开发者，支持多种编码代理。能力边界：文档明确列出各客户端的支持程度。触发精度：通过MCP工具和钩子精确记录工作步骤。环境适配：支持macOS和Linux，Windows需WSL。扣分原因：无重大缺陷。
信息架构：文档结构清晰，有参考手册和安装指南。安装说明：提供多种安装方式。命名稳定性：项目名称和命令稳定，但存在旧名称兼容。示例和FAQ：提供演示和常见问题。已知限制：明确说明是早期alpha。许可证：MIT。版本和变更日志：有版本号但无详细变更日志。维护责任：有贡献指南和反馈渠道。扣分原因：命名稳定性因旧名称兼容而略有扣分，版本变更日志不详细。
输出可用性：提供终端仪表盘和SVG快照。边际价值：提供成本估算和工作步骤记录，具有独特价值。成本效益：本地运行，无额外成本。扣分原因：无重大缺陷。
声明可追溯：文档和测试对应。跨来源佐证：测试覆盖多个场景，但未提供外部验证。事实与推断分离：明确区分客户端报告和估计值。扣分原因：跨来源佐证不足。
- 依赖安全：未提供依赖锁定或漏洞扫描，建议使用锁文件并定期检查。
- 版本变更日志不详细，建议补充。
- 跨来源佐证不足，建议增加外部验证或独立测试。
这个 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 在临时存储中查看演示，不读取真实数据。
常见问题
它会访问我的供应商账单或 API 密钥吗？
数据是否会被上传到云端？
http://127.0.0.1:8765 本机地址运行。