用途：在全部 Claude Code 会话与项目中搜索过往讨论、解决方案和上下文。
主要能力：按关键词或短语搜索；用 --project 限定到具体项目目录（路径中的 / 以 - 表示，如 -Users-aviz-sb）；用 --user-only 只搜用户消息，跳过助手、进度和系统消息；用 --limit N 限制显示的会话数（默认 10）。
使用方式： /search-history "aviz-museum" /search-history "supabase migration" --project Users-aviz-dreemz-backend /search-history "Riley Brown" --user-only --limit 5 参数：<search-term> 为必填关键词；其余为可选过滤项。
数据来源与结构：会话存于 ~/.claude/projects/，每个项目一个目录，目录名由路径中的 / 替换为 - 得到；会话文件为 UUID 命名的 .jsonl，会话产物存放在同名目录下的 subagents/ 和 tool-results/。每行 JSON 含 type 字段，类型包括 user、assistant、progress、system、file-history-snapshot、queue-operation、last-prompt，各自带 message.content、timestamp、cwd、data.toolName 等字段。
实现要点：可用 grep 快速跨项目检索并列出文件， grep -rl "SEARCH_TERM" ~/.claude/projects//.jsonl
如需带上下文的结构化输出，可用 Python 解析 JSONL，提取匹配消息并附上项目、时间戳和消息类型等元数据。
提示：先宽泛检索；--user-only 便于只看自己提过的问题；--project 可缩小到特定工作区；会话 UUID 可配合 claude --resume SESSION_ID 使用；工具结果在会话目录的 tool-results/ 下的 .txt 文件，子代理对话在 subagents/agent-*.jsonl。
限制：资料未提供安装命令、权限要求、跨平台兼容性、性能或隐私说明，也暂未提供价格信息。