用途：搜索、浏览并恢复 Claude Code 的对话历史，覆盖所有项目。采用两阶段方式：先建索引以便快速查找，再用 grep 作为深度内容搜索的兜底。
主要能力：可按主题、PR、分支、worktree、所用技能、修改文件、仓库、标题、agent 等条件检索；支持关键词精确匹配与语义（自然语言）相似匹配；可筛选最近时间（--today）；结果以 JSON 输出并标注由哪种引擎命中。索引器会提取 startedAt、lastActiveAt、title、agentSetting、tags、首尾用户消息、branches、worktrees、prs、repos、skills、filesModified、toolCounts、compactionCount、continuationSummaries 等字段。
使用方式：先检查索引是否存在：test -f ~/.claude/session-index/index.json && echo "INDEX EXISTS" || echo "NO INDEX"。首次无索引时运行 bash ~/.claude/skills/find-claude/scripts/setup.sh（首次设置需数分钟，可选安装语义搜索 episodic-memory）；已有索引则运行 bun ~/.claude/skills/find-claude/scripts/index-sessions.ts 做增量更新。搜索示例：bun ~/.claude/skills/find-claude/scripts/search.ts "figma hook"；带过滤如 --skill eng:spec、--pr 2212、--branch feat/auth、--today、--file manage-schema.ts、--worktree agents-pr2212、--repo doltgresql、--title "auth refactor"、--agent code-reviewer、--limit 30；语义搜索加 --semantic。关键词与语义均无结果时用 grep -rl "KEYWORD" ~/.claude/projects//.jsonl 兜底。
适用场景：找回某主题的会话、继续未完成的工作、按 PR/分支/文件/技能定位会话、查看今天或昨天的工作、恢复压缩过的长会话上下文。
限制：语义搜索依赖 episodic-memory 安装于 ~/.claude/oss-repos/episodic-memory/ 并 npm link，需运行 episodic-memory sync 索引新会话；结构化过滤标志仅适用于关键词模式；关键词为整串子串匹配，过长会缩小范围；默认返回 20 条结果，展示最多 10 条；恢复会话需先 cd 到 launchDir，因为 Claude Code 按项目作用域。压缩不会删除 JSONL 中的消息，仅影响实时上下文窗口。