用途：cc-history 是分析 Claude Code 对话历史文件的参考文档，帮助用户用 shell 命令和 jq 查询、统计 JSONL 会话记录。
数据位置与结构：历史文件位于 ~/.claude/projects/{encoded-path}/，包含 {session-uuid}.jsonl 主对话，以及 {session-uuid}/subagents/ 下的 agent-{hash}.jsonl 子智能体对话和 tool-results/ 大工具输出。项目路径编码规则为：开头 / 变为 -，普通 / 变为 -，/.（隐藏目录）变为 --；文档给出将当前目录转换为项目目录的命令：PROJECT_DIR="~/.claude/projects/$(echo "$PWD" | sed 's|^/|-|; s|/.|--|g; s|/|-|g')"。
消息与能力：JSONL 每行是一个消息对象，含 type、uuid、parentUuid、timestamp、sessionId、message 等字段；type 包括 user、assistant、system、queue-operation。assistant 内容块分 thinking、tool_use、text 三类。文档提供查找会话、按行号或 uuid 取消息、筛选用户/助手消息、列出与统计工具调用、检测技能调用（模式 python3 -m skills.）、统计 Token 用量与时间变化、按类型聚合、统计字符数、查看子智能体任务及与父对话 Task 调用关联等示例命令。
使用方式：在终端中组合 ls、grep、sed、jq、sort、uniq 等命令对相关 JSONL 文件执行查询。
限制：子智能体文件不直接链接到父对话的 Task 调用，需人工按首个用户消息描述匹配。文档未说明适用版本或其他限制。