ctx 是一款 Apache-2.0 开源命令行工具,读取本机已有的编码代理会话记录,把消息、工具调用、会话关系和仓库活动整理成可检索索引。它还提供 ctx blame,把文件行、提交或 PR 追溯到原始代理会话,并给出可回看的记录引用。
来源:github.com/ctxrs/ctx 查看 GitHub 仓库 → 📘 使用教程 →编码代理用得越多,本机就越容易积累分散在 JSONL 或 SQLite 中的历史记录。ctx 把这些记录转成统一索引,并在 v1.6.1 加入 Devin CLI 本地历史发现与导入,覆盖的代理来源继续扩大。
来源:github.com/ctxrs/ctx (1) · github.com/ctxrs/ctx/releases/tag/v1.6.1 (2)默认用 BM25 搜索历史消息和工具调用;语义检索需显式启用,嵌入在本地计算,词法索引在模型准备期间仍可使用。
来源:github.com/ctxrs/ctxsearch 返回会话与事件 ID,show 可读取命中片段或完整会话,locate 用来确认原始来源。
来源:github.com/ctxrs/ctxctx blame 可从文件、行号、提交或 PR 追溯产生变更的代理会话;本机没有相应会话时会明确说明无法证明归属。
来源:github.com/ctxrs/ctx/blob/main/docs/blame.md官方列表覆盖 Codex、Claude Code、Cursor、OpenCode、Gemini CLI、Devin 等多种本地历史格式,并理解父会话、子代理和分叉关系。
来源:github.com/ctxrs/ctxctx setup 先发现本机代理历史源,再把不同格式转换成会话、消息、工具调用、关系和仓库活动等统一记录。并行扫描器把记录直接写入 Tantivy 索引,避免先导入关系型数据库;自动索引默认开启,并以完成后的新索引原子可见。语义搜索在本机下载模型并建立投影,不要求模型 API key。
来源:github.com/ctxrs/ctx (1) · ctx.rs/concepts/how-it-works (2)Tantivyrusqlite(读取基于 SQLite 的代理历史)本地嵌入模型(仅在启用 semantic 后获取)适合找回旧会话里的报错、决策和失败方案,审计某段代码由哪次代理会话产生,或让新会话引用过去的原始记录。它不能替代 Git 的代码差异、团队知识库或长期规则管理;队友生成但未同步到本机的代理历史也无法被证明。
来源:github.com/ctxrs/ctx最新正式版 v1.6.1 于 2026-09-22 发布。它新增 Devin CLI 标准本地历史发现与导入,覆盖主会话、压缩历史、关联子代理和工具活动;托管 Devin 历史与未关联后台线程不在范围内。该版本还改进磁盘空间不足时的恢复、守护进程诊断,并从网站和文档移除已退役商业产品页面。
来源:github.com/ctxrs/ctx/releases/tag/v1.6.1status: official_docs_checked_not_installed | checked_at: 2026-09-23 | environment: 核对官方 README、v1.6.1 Release、安装与 CLI 文档;没有运行远程安装脚本,也没有读取本机代理历史 | limitations: 未验证安装脚本内容、二进制签名、自动升级、索引速度、语义模型下载、磁盘占用、任何具体代理格式或 ctx blame 的真实命中率 | observed_output: 最新正式 Release 为 v1.6.1,发布于 2026-09-22;README 给出 macOS/Linux 与 Windows 安装入口;v1.6.1 新增 Devin CLI 标准本地历史导入,并移除已退役商业产品页面
来源:github.com/ctxrs/ctx/releases/tag/v1.6.1 (1) · github.com/ctxrs/ctx (2)相比 Mem0,ctx 面向编码代理的原始本地历史和 Git 变更归因,搜索结果可以回到完整会话与工具调用;Mem0 是面向 AI 应用的记忆层,会从对话中提取、保存并检索可用记忆。需要保留原始证据和追溯代码来源时选 ctx;需要让应用跨会话维护用户偏好或事实时,Mem0 的抽取式记忆模型更直接。两者可以并用。
来源:github.com/ctxrs/ctx (1) · github.com/mem0ai/mem0 (2)如果你已经积累了大量本地编码代理会话,ctx 值得先用词法检索做小范围试跑。先检查来源目录和本地索引权限,再决定是否开启自动索引、语义模型与自动升级。把它当作原始历史检索和审计工具,而不是自动脱敏的团队知识库。
来源:github.com/ctxrs/ctx (1) · ctx.rs/first-search (2)官方 README 称索引、搜索和语义嵌入在本地完成,不调用模型 API,也不需要 API key。不过转录文本会原样保存在本地索引中,导出或粘贴结果前仍要检查敏感信息。
官方说明 setup 会发现并读取已有来源,不修改原文件;它把标准化记录写入自己的本地存储和索引。首次使用前仍应确认扫描到的来源目录符合预期。
blame 只能基于本机已索引的 Git 与代理历史建立证据。若提交来自队友、原会话被清理、仓库路径不匹配或历史尚未导入,ctx 会无法证明归属;这不是代码没有经过代理的证明。
不必须。默认 BM25 词法搜索可直接使用。只有同一概念经常用不同措辞、且能接受模型下载与额外索引成本时,才需要执行 ctx semantic enable。