ctx
一个用于本地快速搜索过往编码代理会话的CLI工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：ctx。 它的用途是：一个用于本地快速搜索过往编码代理会话的CLI工具。 完整的 Skill 内容见：https://321skill.com/skills/ctx/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘请用 ctx 搜索我们之前关于“优化数据库查询”的讨论，特别是失败的那些尝试。’ 它会调用 `ctx search "优化数据库查询"` 命令，快速找到相关的历史会话和代码片段，避免你们重复之前的错误路径。或者，当你遇到一个似曾相识的错误时，可以让 AI 执行 `ctx search --file src/api/user.rs` 来查看所有修改过该文件的过往会话，快速定位问题根源。
介绍
ctx 是一个开源命令行工具，旨在解决编码智能体（如 Claude、Cursor 等）在开发过程中因缺乏历史会话记忆而导致的重复劳动问题。这些智能体通常只能访问当前代码库，而无法回顾之前讨论、决策、失败尝试、命令和测试结果等宝贵上下文。
ctx 通过扫描并索引您本地存储的智能体历史日志文件，将其结构化地存入 SQLite 数据库。之后，您或您当前正在使用的智能体可以通过简单的自然语言命令，快速搜索到相关的过往会话片段，例如查找某个失败的迁移尝试或特定文件的修改历史。
它非常适合依赖编码代理进行日常开发工作的工程师、需要追溯项目决策过程的项目经理，以及任何希望从过往的 AI 协作历史中提取结构化知识的开发者。
使用前建议先运行 ctx setup 索引所有现有会话。请注意，所有数据均在本地处理，默认情况下不会上传到云端，但在分享搜索结果时仍需留意其中可能包含的本地路径或敏感信息。
核心特点
与直接搜索原始冗长的会话日志相比，ctx 通过结构化索引和高效检索，能将搜索结果的 Token 消耗降低数十倍，使智能体能够经济地利用历史信息。同时，它完全本地化运行，无需 API 密钥或网络连接，保护了隐私和数据安全。
注意事项
目前仅支持索引特定编码代理（如 Cursor、Claude Desktop 等）的本地历史文件，对于云端或非标准格式的会话日志支持有限。
常见问题
ctx 会泄露我的代码或会话数据吗？
不会，ctx 默认在本地运行，所有索引和搜索操作均在您的机器上完成，不会将数据发送到云端服务。
如何让我的 AI 编码助手使用 ctx？
在对话中直接提示 AI 安装并使用 ctx CLI，例如：“请安装并设置 ctx CLI，然后搜索关于‘用户登录失败’的历史讨论。”
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/ctx/raw/index.md 读取 ctx 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/ctx/raw/index.md（查看排版版本）