用途：在回答涉及本地编码智能体会话的问题前，先在本地查找、列出、检索、读取、检查、导出或还原会话记录，覆盖 Codex、Claude Code/Desktop、OpenCode、oh-my-pi、gajae-code、Senpi、OpenClaw、Droid、Amp 等平台。
主要能力：提供统一的会话查找脚本，可跨平台并行搜索。先按平台路由到对应参考文档（如 references/codex.md、references/claude.md、references/opencode.md、references/senpi.md、references/all-platforms.md）。支持模糊回忆场景，允许用多个 --query 并联检索，通过 match_reasons 显示命中的字段与片段。结果包含 platform、id、path、cwd、时间戳、provider/model、首末用户消息、usage、parent_id、agent、subagent_count、detail_hint 等字段，并输出 JSON 便于 jq 处理。
使用方式：常用命令包括 python3 scripts/find-agent-sessions.py list --limit 20 python3 scripts/find-agent-sessions.py find "commit" --from 7d --platform senpi --platform opencode python3 scripts/find-agent-sessions.py read <session-id> 在只有 python 的系统上用 python 替代 python3。支持 --platform、--root、--from/--to、--cwd、--model、--limit、--query、--workers、--include-subagents 等过滤器。默认只返回主会话并标注 subagent_count；read 主会话会同时返回其子会话数组，查看委派树。必要时用 --include-subagents 搜索仅存在于子会话中的工作。
适用场景：模糊记忆检索（“几天前做了什么”“X 是否已迁移”）、按错误文本/仓库名/会话 ID 定位历史、还原跨平台会话证据。对模糊请求应先用 3-6 条查询线索扩展再搜索。
限制：仅读取本地已有存储，不接入远程服务；部分平台的 usage 信息可能缺失。搜索结果为归一化格式，原始 transcript 文件仍是唯一事实来源，需打开原始文件核实。缺失会话可通过设置环境变量（如 CODEX_HOME）或 --root 指定路径解决；日期过滤无法解析时回退到文件 mtime。可用子代理/委派工具时用其跑并行搜索，否则并行执行查找命令。未提供收费、价格与效果信息。