ctx 是一个开源命令行工具，用于快速本地搜索您过去的编码代理会话。编码代理通常从零开始。它们可以检查当前的代码库，但通常无法恢复先前工作的讨论、决策、失败尝试、命令和测试结果。这些会话中充满了有用的背景信息：从您对错误调查、重构、文件路径、命令、补丁和先前代理的笔记所做的决策、约束、意图和拒绝的方法。ctx 将这些日志索引到您计算机上的 SQLite 中，然后为当前和未来的代理提供 CLI，以在重复之前的讨论、命令或失败尝试之前找到这些信息。安装和设置 ctx：curl -fsSL https://ctx.rs/install | sh。可选但推荐用于代理会话：npx skills add ctxrs/ctx。有关 Codex、Claude Code、Cursor 和原始代理技能中的市场/插件安装，请参阅代理技能安装。比原始记录搜索高效 50 倍。通过将代理历史结构化为会话、事件、元数据和索引字段，然后返回排名引用的匹配项，代理可以以远低于原始搜索所需的标记访问有意义的历史记录。结果因查询和语料库而异，但原始搜索通常标记繁重，实际上可能等同于没有可用的历史记录。工作原理：您过去的代理会话存储在本地提供程序历史文件中。ctx 发现受支持的来源，导入真实的持久记录，并将标准化的会话、事件和接触文件元数据存储在优化用于检索的本地 SQLite 数据库中。ctx 是用 Rust 编写的，并存储一个本地 SQLite 索引，因此搜索速度快、可编写脚本，无需后台服务。该索引默认是本地和私密的。记录文本得以保留，而不是隐藏本地路径或秘密字符串，因此在与机器外部共享之前，请检查复制的输出。# 索引您所有现有的本地代理会话ctx setup# 您的代理可以用自然语言搜索先前的工作ctx search " failed migration "# 搜索接触过文件的会话/事件ctx search --file crates/foo/src/lib.rs# 或搜索多个术语ctx search --term " failed migration " --term rollback --term " cursor rename "# 高级：使用只读 SQL 检查确切的本地索引数据ctx sql " SELECT provider, COUNT(*) AS sessions FROM ctx_sessions GROUP BY provider "# 结果包括匹配的会话、片段和 ctx ID# evt_01h... ses_01h... codex "迁移预计旧的光标名称"...# 打印旧记录匹配部分ctx show event < ctx-event-id > --window 3# 或打印原始会话的压缩记录ctx show session < ctx-session-id >这些 ID 使您的当前代理能够根据需要从之前的会话中恢复尽可能多的上下文。ctx 不会将您的提示、记录或索引历史发送到云服务，也不会调用模型 API、需要 API 密钥或写入您的源代码库。已安装的二进制文件还包括本地文档和手册页生成：ctx docs search " upgrade " ctx docs show cli-reference ctx docs man --print ctx。官方安装程序管理的二进制文件支持签名的自我升级：ctx upgrade status ctx upgrade check。源构建和包管理器安装仍然不受管理，不会自我升级。有关完整流程，请参阅 ctx 的工作原理。有关快速首次运行，请参阅快速入门。受支持的代理历史记录支持意味着 ctx 可以发现或读取该工具持久的本地历史记录并将其导入本地搜索索引。在您的计算机上使用 ctx sources --json 查看当前可导入的来源。代理工具支持 Claude Code 支持 Codex 支持 Cursor 支持 Pi 支持 OpenCode 支持 Antigravity / Gemini CLI 支持 Factory AI Droid 支持 Copilot CLI 支持。ctx 的比较代理记忆工具通常保存紧凑的事实、摘要、向量或图节点。这些可以帮助保持稳定的偏好，但在下一个代理需要知道决策来源、哪些命令失败或原始对话中拒绝了什么时，它们是薄弱的证据。Graphify样式的工具回答不同的问题。它们映射当前的代码库：文件、符号、导入、文件夹和关系。ctx 搜索解释发生了什么的先前代理会话，同时人员和代理改变了该代码库。ctx 将检索与会话和事件关联，因此另一个代理可以在使用之前检查源。了解更多有关代理记忆、Graphify样式的代码库图和 grep 或日志搜索的信息。探索文档页面涵盖的内容安装安装 ctx，初始化本地存储并索引发现的本地历史记录。快速入门搜索本地历史记录，检查事件，打开会话并使用 JSON 输出。安装 ctx 技能通过打开的技能安装程序安装代理历史搜索技能。代理插件安装通过 Codex、Claude Code、Cursor 或原始技能文件夹安装 ctx 技能。SDKs 从 TypeScript、Python 中使用 ctx 代理历史搜索。