核心功能
agent-usage-stats（token-stats）是一款专注于 AI 助手 token 消耗监控的轻量级命令行工具。其核心设计哲学是"选择即查看"——每次运行均弹出交互式菜单，让用户自主选定目标 Agent，而非预设默认值。
显著优点
1. 零依赖部署：纯 Python 标准库实现，无额外包管理负担，Python 3.11+ 环境即装即用
2. 纯本地数据源：所有数据读取自 Agent 本地数据文件（SQLite、JSONL 等），完全离线运行，无隐私外泄风险
3. 跨 Agent 兼容：统一接口支持 Hermes、Claude Code、CodeX、OpenClaw、Reasonix、DeepSeek TUI 六款主流工具
4. 灵活交互模式：既支持交互式菜单选择，也支持 -a 参数直接指定 Agent；--watch 模式实现实时监控
5. 工程友好集成：Hermes 用户可通过 SKILL.md 配置任务结束后自动输出消耗统计，无缝嵌入工作流
潜在局限
- 数据源绑定特定 Agent 版本：若目标 Agent 更新数据存储格式，需等待工具同步适配
- 历史数据完整性依赖 Agent 本身：部分 Agent 可能清理或归档旧会话数据
- 无聚合分析能力：仅提供单 Agent 消耗查看，不支持跨工具汇总或趋势图表生成
- Python 3.11+ 门槛：旧系统环境需升级
适合人群
- 多 Agent 并行使用的开发者，需要快速切换查看各工具消耗
- 关注本地隐私、拒绝云端同步的敏感场景用户
- 追求极简工具链、厌恶重型监控方案的技术人员
- Hermes 重度用户，希望自动化任务后统计输出
常规风险
- 数据路径变动风险：Agent 升级可能改变本地数据文件位置或格式，导致读取失败
- 权限问题：需确保对 Agent 数据目录（如
~/.claude/、~/.hermes/）有读取权限 - 监控盲区：仅覆盖列出的 6 款 Agent，新兴工具需等待社区适配
- MIT 开源风险：无商业支持承诺，关键业务场景建议 fork 自维护
版本与维护
当前 v2.7.4，活跃维护中。GitHub 与 ClawHub 双源分发，支持 git pull 或 token-stats update 热更新。