agent-usage-stats 是一款专为多AI助手用户设计的本地Token消耗监控工具，核心价值在于"一次安装，统一管理"。
核心用法
运行token-stats启动交互式菜单，选择要监控的Agent即可查看历史消耗；支持-a参数直接指定Agent跳过菜单，--watch实现实时监控。工具自动识别6种主流Agent的本地数据存储位置，包括Hermes的SQLite数据库、Claude Code的JSONL日志、CodeX的多源数据等，无需手动配置路径。
显著优点
1. 零依赖设计：仅使用Python标准库，无第三方包安装风险，兼容性强
2. 完全离线：所有数据读取本地文件，Token消耗信息不上传任何服务器，隐私安全极高
3. 跨Agent整合：打破各AI助手数据孤岛，统一查看对比不同平台的消耗情况
4. 轻量易用：单文件脚本，支持git/ClawHub双渠道更新维护
潜在局限
- 依赖各Agent的本地存储格式，若官方更新路径结构可能需等待工具适配
- 仅支持已列出的6种Agent，新兴Agent覆盖滞后
- Python 3.11+门槛排除了部分旧系统用户
- 无历史趋势图表化展示，纯文本输出
适合人群
多平台AI助手重度用户、企业成本管控团队、隐私敏感型开发者、需量化AI使用成本的独立开发者。
常规风险
工具本身无网络行为，风险极低；但需注意读取本地Agent数据库时文件锁冲突问题（建议不在Agent运行高峰期查询），以及定期备份以防误操作。