Introspect 用于分析 Claude Code 会话日志，从日志中提取可操作的信息：工具使用情况、推理模式、错误与对话流程，从而改进工作流和排查问题。
用途：分析本地 Claude Code 会话记录，了解工具调用频率、推理过程、错误模式和会话流程。
主要能力：解析 ~/.claude 目录结构，包括 history.jsonl（全局用户输入）、projects/{project-path}/ 下的 sessions-index.json、{session-uuid}.jsonl 和 agent-{short-id}.jsonl。项目路径使用双横线编码，如 X:\Dev\claude-mods → X--Dev-claude-mods。可识别的条目类型包括 user、assistant、thinking、tool_use、tool_result、summary、file-history-snapshot、system。支持列出当前项目会话、会话概览、工具使用统计、提取 thinking 块、错误分析、跨会话搜索、对话流程重建、子代理分析、token/成本估算、文件修改追踪、会话对比等。
使用方式：通过 shell 和 jq 组合命令读取日志，例如统计条目类型分布：jq -r '.type' $SESSION.jsonl | sort | uniq -c；统计工具频率：jq -r '... | select(.type == "tool_use") | .name' | sort | uniq -c；提取思考块：jq -r '... | select(.type == "thinking") | .thinking'；查找错误：grep -i "error|failed" $SESSION.jsonl。示例场景包括查询昨日会话最常用工具、查看调试某问题时的推理、统计本周高频错误。
适用场景：Claude Code 使用者复盘会话、优化工作流、调试问题、分析子代理行为。
限制：需要本地存在 Claude Code 会话日志并具备 jq 等命令行工具；日志包含完整对话、文件内容、思考/推理、工具输入输出，分享导出前需检查凭证、API 密钥和隐私数据。其余未在资料中说明的功能暂未提供。