cc-insights

面向 Claude Code / Codex 的使用诊断工具：把历史数据变成可解释的证据、判断和改进方向

cc-insights 是一个 code agent 使用诊断 CLI：默认读取 Claude Code 本地数据，也可通过 provider 读取 Codex session 与 runtime 日志。它把历史数据、项目会话、工具调用、失败样例、Token 消耗和 Session 生命周期整理成**可解释的证据、诊断结论和改进方向**。默认输出可读摘要，也提供本地 Web Dashboard，并支持时间范围筛选、缓存预聚合和并发解析。

目录

• 为什么用 cc-insights
• 快速开始
• 命令速查
• 与 AI 协作
• 配置与规则
• Dashboard
• 开发
• 故障排查
• 文档

为什么用 cc-insights

cc-insights 的目标不是展示「用了多少 token、跑了多少命令」，而是回答**为什么 code agent 变慢、变贵或频繁失败**，以及**下一步该优化哪里**。

传统方式（翻 JSONL / 看终端日志）	用 cc-insights
手动 grep ~/.claude 找失败	cc-insights rec -p 7d → 给根因候选、证据摘要和下钻命令
数不清 Token 花在哪	cc-insights tok -p 30d -j → 按项目 / 模型 / 会话拆解
Bash 命令频繁失败，不知是哪段	cc-insights cmd -p 30d → 按命令族 + 链式逐段 + 高风险命令
长会话失控难发现	cc-insights ses → 找长会话 / 高失败会话 / Plan·Task 信号
想看可视化要自己搭	cc-insights web → 单二进制本地起 Dashboard
让 AI 帮分析但数据是乱的	所有命令 -j 输出结构化 JSON → AI 直接消费

**核心设计原则：**

• 诊断优先 — rec 先给判断，再给证据和可执行下钻命令；不为每种解释继续堆命令
• AI 友好 — JSON / Markdown / Table 三种输出，AI 直接解析