memex 用于搜索历史 Claude Code 和 Codex 会话，基于全文搜索并按 BM25 排名。它索引 ~/.claude/projects/ 与 ~/.codex/sessions/，索引存放在 ~/.memex.db（SQLite FTS5），首次运行会索引全部会话，之后增量更新，并在源文件被删除时清理孤立记录。
用法为运行脚本：python3 <MEMEX_SKILL_DIR>/scripts/recall.py [QUERY] 及各类参数。安装目录常见为 ~/.claude/skills/memex 或 ~/.agents/skills/memex，具体随安装方式变化。
查询语法支持词（bufferStore，含词干变体）、短语（"ACP protocol"）、布尔（rust AND async、tauri OR electron、NOT deprecated）、前缀（buffer*）及组合。
常用参数：--list 列出最近会话（可带文本过滤）、--project PATH 按精确项目路径或子路径过滤、--days N 限定天数、--source claude|codex 限定来源、--limit/--offset 分页、--include-subagents 显示默认隐藏的子代理会话、--no-summary 隐藏摘要、--summary-len 控制摘要长度、--json 输出机器可读结果、--reindex 强制重建索引、--version 显示版本、--doctor 做本地健康检查、--fix 配合 --doctor 应用安全自动修复。
每条结果包含 File: 路径，可用 read_session.py 读取原始记录。若缺 File: 路径，运行 --reindex 补齐。找到后可 cd 到项目目录，用 claude --resume SESSION_ID 或 codex resume SESSION_ID 恢复会话。
仅索引用户与助手消息，会过滤系统噪音；结果带 [claude] 或 [codex] 标签。特殊字符查询会自动加引号，FTS 报错时回退到 LIKE 搜索；简单 CJK 查询增加子串回退以提高召回。