用途：在全局会话记忆数据库中搜索过去的对话，找回已不在当前上下文窗口中的决策、操作、错误与背景信息。适用于用户询问此前会话或长会话早期内容、引用已丢失的决策或错误，以及“我们当时怎么处理 X”“什么时候修好 Y”“遇到什么错误”等问题。
主要能力：采用 FTS5 关键词与向量混合检索，检索管线包含 RRF 融合、窗口扩展、祖先回溯和跨会话语义链接。数据库位于 ~/.claude/session_memory.db，覆盖所有项目。默认输出 --format context，生成可直接阅读的 XML 标记对话片段。
使用方式： TR=~/.config/dotfiles/submodules/total-recall $TR/.venv/bin/python $TR/retrieve.py "QUERY" --db ~/.claude/session_memory.db
常用参数：--project NAME 限定项目；--top-k N 种子匹配数（默认 5）；--window N 匹配前后上下文窗口（默认 2）；--budget N 最终输出最大块数（默认 20）；--tokens N 最大 token 数（默认 6000）；--session ID 限定会话；--no-tools 排除 tool_use/tool_result 块；--no-vectors 仅用 FTS5 关键词检索；--format json 输出 JSON 数组；--roles user,assistant 按角色过滤。
检索流程：用查询运行 retrieve.py，阅读返回的上下文块；结果过宽时用 --project 或 --session 收窄；结果过少时增大 --top-k 或 --budget；需要精确关键词时用 --no-vectors。搜索决策或讨论时可用 --no-tools 跳过嘈杂的工具输出；需要程序化处理时用 --format json。
限制：资料未提供安装步骤、依赖要求、性能指标、收费方式及支持平台等信息。