在 Linux 命令行中运行 Contextify

安装

安装程序会检测你的架构，下载对应的二进制文件，并一步完成索引配置。

curl -fsSL https://contextify.sh/install.sh | sh

安装程序会：

• 下载适用于 x86_64 或 ARM64 的 contextify 二进制文件，并安装到 ~/.local/bin/
• 为 Claude Code 和 Codex CLI 安装 Total Recall 技能
• 为 ~/.claude/ 和 ~/.codex/ 中已有的对话记录建立索引
• 配置 systemd 用户定时器，持续为新的对话记录建立索引

安装以当前用户身份运行，不需要 root 权限。如果 ~/.local/bin 不在 PATH 中，请先添加，然后打开一个新的 shell。

如果想自己选择架构，可以直接下载发布版二进制文件。大多数服务器和台式机使用 x86_64，Raspberry Pi 和 AWS Graviton 使用 ARM64。解压后，把 contextify 放到 PATH 所含的目录中。

验证安装

contextify --version
contextify status
contextify doctor

status 会报告数据库路径，以及已建立索引的对话记录数和条目数。doctor 会检查二进制文件、技能的安装情况和后台服务。如果 doctor 报告缺少技能，请重新安装：

contextify install-skill
contextify doctor

在 Linux 上，数据库位于 ~/.local/share/contextify/contextify.db，遵循 XDG 基础目录规范。设置 CONTEXTIFY_DB_PATH 或传入 --db，可以改用其他文件。

持续为历史记录建立索引

搜索只能看到已建立索引的对话记录。安装程序会为磁盘上已有的记录建立索引，并为新会话配置定时器，所以大多数时候无需你操心。如需手动建立索引：

contextify ingest

安装程序会配置 systemd 用户定时器，每 15 分钟在后台建立一次索引。你可以直接查看或管理它：

systemctl --user status contextify.timer
journalctl --user -u contextify

如果缺少定时器，用 contextify install-service 安装，用 contextify uninstall-service 移除。在没有 systemd 的系统上，安装程序会改用 cron 任务。

搜索历史记录

先用过往会话中一个有辨识度的短语、任务 ID、分支名、文件路径或错误信息来搜索。

contextify search "sign-in handoff" --limit 5
contextify search "token refresh race" --days 30
contextify search "cloud sync" --project . --limit 10

搜索使用支持词干提取的 FTS5，因此 deploy 也能匹配“deployed”和“deploying”。带连字符的标识符会拆分成多个词元，所以请搜索 "ct 1703"，而不是 ct-1703。需要可供脚本处理的输出时，使用 --json。

用搜索输出中的条目 ID 查看某个结果的详情：

contextify context <entry-id> --before 5 --after 15
contextify projects
contextify activity --days 7

在 AI 助手中搜索

安装程序会为 Claude Code 和 Codex CLI 添加 Total Recall 技能。安装完成后，请 AI 助手检索以往的工作记录，它就会替你执行搜索：

/total-recall how did we fix the auth bug?

需要多步调研时，把任务交给研究型子智能体。在 Claude Code 中，它是随技能一起提供的 query:contextify-researcher。Codex 中对应的是 contextify_researcher，安装在 ~/.codex/agents/。两者都会在只读沙盒中运行多次查询，并返回附带引用的摘要。

要让任意 MCP 客户端使用搜索，请通过 stdio 运行服务器：

contextify serve-mcp

它提供三个只读工具：search_conversations 用于全文搜索，list_recent 用于列出最近的会话，get_conversation_entries 用于获取单个对话记录中的消息。

跨机器同步

Contextify Cloud 会在你的多台机器之间同步已索引的历史记录，让 Linux 服务器和 Mac 笔记本共享同一份可搜索的历史记录。在终端中连接：

contextify cloud setup
contextify cloud status
contextify cloud sync

如果使用自托管 Cloud，配置时请指向你自己的服务器。尽量使用交互式提示输入，这样 API 密钥不会留在 shell 历史记录中：

contextify cloud setup --url https://your-server.example.com
contextify cloud projects
contextify cloud sync

cloud projects 管理这台机器同步哪些项目。cloud search 会查询所有已同步设备上的条目，而不只是这台机器。

Linux 上可用的功能

相关文档