用途：ccbox 是一个 CLI 工具，用于检查本地 Codex/Claude 智能体会话日志，并生成快速、基于证据的洞察。适用于列出已发现的项目、查找会话、查看历史记录等场景。
主要能力：可列出已发现的项目（ccbox projects）；列出当前文件夹的会话并自动识别项目（ccbox sessions，支持 --limit、--offset、--size）；查看当前文件夹最新会话历史（ccbox history，支持 --full、--limit、--offset、--size）；也可针对指定项目路径或具体日志文件（.jsonl）查看会话与历史。
使用方式：先确认工具可用并更新，运行 ccbox --help 与 ccbox update（macOS/Linux 支持自更新，输出 up-to-date: 或 updated:）。随后用 ccbox sessions 选择当前文件夹最新会话，或 ccbox sessions "/abs/project/path" 指定项目，复制首行 log_path，再运行 ccbox history "/abs/log.jsonl" --full 获取证据（工具调用、输出、错误）。推荐产出洞察报告，包含用户意图（首个 USER 提示）、智能体动作（工具调用序列与关键输出）、变更内容（工具输出中可见的文件/命令）、失败或风险（警告、截断时间线、panic/错误）以及后续步骤（具体验证命令与跟进项）。
适用场景：需要复盘本地 Codex/Claude 会话、定位项目与会话、提取工具调用与错误证据时。
限制：资料未提供平台支持范围、安装方式、收费与价格等信息；自更新仅说明支持 macOS/Linux。参考文档包括 references/cli.md（CLI 命令与输出格式）和 references/insights.md（洞察清单与报告模板）。