ctxrs/ctx
Search the coding agent history already on your machine
它解决了什么
编码代理通常缺乏对之前会话的记忆,无法找回之前工作中的具体决策、失败尝试和使用的命令。这会导致代理重复错误或失去先前讨论中建立的意图和约束。
工作原理
ctx 是一个基于 Rust 的 CLI 工具,能够发现并导入来自各种编码代理套件(如 Cursor、Claude Code、Windsurf)的本地历史文件。它将这些数据规范化为本地 SQLite 数据库,并针对检索进行优化。这使得当前代理可以通过自然语言、特定文件或关键词搜索过去的会话,并检索出确切的事件或会话记录作为上下文。
适用人群
使用 AI 编码代理的开发者,希望为其代理提供一种持久、令牌高效的方式来访问历史项目上下文。
亮点
- 广泛的代理支持:支持包括 Claude Code、Cursor、Windsurf 以及 GitHub Copilot CLI 在内的多种代理套件。
- 令牌效率:相比原始文字稿搜索,通过返回排序后的、带引用的匹配项显著降低令牌使用量。
- 本地且私密:所有索引和搜索均在本机通过 SQLite 完成,数据不发送至云服务或模型 API。
- 代理就绪:提供一个 CLI,代理本身即可使用,以搜索并恢复先前会话的上下文。