agwatch：AI编程工作流的终端分析利器，让成本与效率一目了然

agwatch是一款终端分析CLI工具，专为AI编程工作流设计。它能读取本地AI助手的使用数据，将其标准化为统一的事件模型，并以交互式仪表板或结构化摘要的形式呈现，帮助开发者精准掌控AI编程的成本与效率。

随着OpenCode、Claude Code等AI编程助手的普及，开发者们越来越依赖这些工具来提升编码效率。然而，这种依赖也带来了一个现实问题：如何清晰地了解自己在AI编程上的投入与产出？

每次调用花费了多少？哪个项目消耗了最多的token？哪些工具被频繁使用？这些问题的答案往往散落在各个AI助手的本地数据文件中，难以汇总分析。agwatch应运而生，它将这些分散的数据整合起来，提供一个统一的视图来洞察AI编程工作流的全貌。

agwatch的设计目标是回答开发者最关心的实际问题：

• 成本追踪：每个AI助手、每个模型、每个项目或每种活动类型花费了多少钱？
• 使用分析：调用了多少次？使用了哪些工具和shell命令？
• Token统计：输入、输出、缓存和写入的token分别有多少？
• 限额监控：各提供商的使用窗口是否接近限额？

通过这些数据，开发者可以做出更明智的决策，比如优化提示词以减少token消耗，或者识别哪些项目从AI辅助中受益最多。

agwatch的核心创新在于它定义了一个统一的使用事件模型。不同AI助手（如OpenCode和Claude Code）使用不同的本地存储格式（SQLite、JSON、JSONL），agwatch通过适配器层读取这些数据，并将其转换为标准化的内部表示。

这种设计带来了几个好处：

1. 多代理聚合：可以同时监控多个AI助手的使用情况
2. 数据一致性：不同来源的数据以相同的格式呈现
3. 可扩展性：添加对新AI助手的支持只需编写新的适配器

目前agwatch支持：

• OpenCode：通过SQLite或JSON本地数据读取
• Claude Code：通过本地JSONL项目日志读取

agwatch的主打功能是交互式终端仪表板。启动后，用户会看到一个多面板界面，实时展示AI编程活动的各项指标：

• 总成本
• 总调用次数
• 会话数量
• 缓存命中率
• 各类token总计

按项目分组展示成本、token和会话数，帮助识别哪些代码库最活跃。

按模型分组展示成本、token和调用次数，揭示哪些LLM是你的主力。