Live Recall

等待另一个会话的下一步

Total Recall(跨会话历史检索)搜索已经发生的事,Live Recall(实时会话跟随)等待接下来发生的事。Contextify 会在几秒内为 Claude Code 和 Codex 对话记录的每一轮建立索引,让一个会话直接等待另一个会话实时写出的内容,无需自己编写轮询循环。

信号会提前出现:PR 创建前几分钟,worktree(工作树)的对话记录里就会写出“我马上要推送了”。Live Recall 会在这句话出现时唤醒等待中的会话。

何时使用

以另一个 worktree 的进度为触发条件

让依赖步骤暂停,直到另一个会话宣布达到里程碑;消息一出现,就开始你的工作。

先唤醒,再确认

在对话记录中发现 PR 即将创建的信号时唤醒,再用 gh 确认,然后据此行动。

流式接收事件

新的匹配条目一写入就实时跟踪,把等待交给 AI 助手的事件循环,而不是阻塞。

三个子命令

Live Recall 由 Contextify CLI 的三个命令组成。每个命令都接受一个 SQLite FTS 查询,并读取本地索引。

子命令 作用
contextify watch <query> 阻塞到有一个新条目匹配为止,输出该条目,然后以退出码 0 退出。超时则以退出码 124 退出。默认超时为 60 秒;可传入 --timeout 90m。
contextify tail 每出现一个新的匹配事件,就流式输出一行 JSON。专为 AI 助手的事件循环设计。按 Ctrl-C 可正常退出。
contextify since <cursor> 返回某个游标标记之后的全部新内容,以及下一个游标。适合在被其他事件唤醒时获取增量。

长时间等待之前,先运行 contextify status --json,并根据 .data.liveness 采取行动。结果为 live 表示可以继续。如果是 stale,就延长超时时间,或者在等待时检查实际产物。如果是 stopped,先按报告的 .data.livenessRemediation 处理,再开始等待。

好的提示词

与其这样问 不如试试
“一直检查 wb3 有没有完成。” “用 Live Recall 等到 wb3 为 HOT-4018 发起 PR,然后用 gh 确认。”
“轮询另一个智能体。” “监视另一个 worktree,等它开始重构 registry,就着手依赖这项重构的配置工作。”
“有什么动静就告诉我。” “跟踪与 HOT-4018 或 HOT-4049 相关的对话记录,第一次匹配就叫醒我。”

工作原理

Live Recall 依赖 Contextify CLI。这些命令每隔几百毫秒轮询一次本地 Contextify 数据库,一有新条目匹配就返回。因此你只需调用一条命令、拿到一个结果,不必自己写循环。

等待的实时程度取决于索引是否及时更新。contextify status --json 总会报告 .data.liveness。如果可以确定最近一次导入距今多久,还会同时报告 .data.livenessAgeSeconds 和 .data.newestIngestTimestamp。这个判定结果告诉智能体应该继续、更谨慎地等待,还是先修复问题。

Live Recall 读取的本地索引与 Total Recall 相同,只是时间方向相反。哪些数据留在本地、哪些可以同步,请参阅隐私与数据和导入与同步。

在终端中试用

这些命令随 Contextify CLI 提供。确认 CLI 已在 PATH 中:

contextify --version

然后开始等待。在一个终端中,监视另一个会话即将写出的一句话:

contextify watch '"HOT-4018" AND push' --timeout 30m --json

它会一直阻塞,直到出现匹配条目,然后输出该条目并以退出码 0 退出。如果超时前没有任何匹配,它会以退出码 124 退出,这样 shell 调用方就能区分超时和匹配。如果要流式输出而不是阻塞:

contextify tail --query '"HOT-4018"' --exclude-this-session --json

对任一命令使用 --exclude-this-session,避免监听器匹配到自己生成的对话记录。等待另一个 worktree 时,在整台机器范围内监听,并用查询锚点限定匹配范围;只有监听自己所在的 worktree 时才使用 --this-worktree。

在 AI 助手中使用

Contextify CLI 会随 Total Recall 一起安装 live-recall 技能(skill),这样 Claude Code 和 Codex 会替你组合使用这些命令。Mac 应用会在你配置 CLI 时安装它。如果使用 App Store 版本或 Linux,请用 CLI 添加:

安装 Contextify 应用时已完成这项配置。如果后来找不到该技能,可通过 Settings → CLI → Enable or Repair 修复。

brew install PeterPym/contextify/contextify-query
contextify install-plugin
curl -fsSL https://contextify.sh/install.sh | sh
contextify install-skill

新开一个 Claude Code 或 Codex 会话,输入 /live。当 AI 助手建议使用 live-recall 时,说明技能已就绪。然后用自然语言提出等待请求:

Use Live Recall to wait until wb3 opens the PR for HOT-4018, then confirm with gh.

AI 助手会把 watch 与它的事件循环结合使用,在匹配时唤醒,并先用实际产物确认,再继续执行。

最后更新:2026 年 7 月 26 日