ctxrs/ctx

Instant recall for coding agents. Search the history already on your machine. Git blame, but for agent sessions.

解决的问题

编码代理经常留下包含决策、假设和失败尝试的冗长日志文件，这些文件对人类和代理来说都难以搜索和检索。ctx 提供了一种快速、本地化的方式，对这些转录内容进行索引和搜索，以防止重复工作、减少 token 消耗，并恢复最终代码中不存在的历史上下文。

工作原理

ctx 扫描来自 Claude Code、Cursor、OpenHands 等不同提供商的本地代理历史文件（如 JSONL 或 SQLite 数据库）。它将这些文件转换为一致的本地记录，并使用 Tantivy 进行高性能词汇搜索索引。它还支持通过嵌入向量进行本地语义搜索。"ctx pro" 插件允许用户将特定代码行、提交或 PR 与生成它们的原始代理会话关联起来，类似于代理会话的 git blame。

适用人群

希望在不同会话和工具之间长期、无损地保留代理工作记忆的 AI 编码代理使用者。

主要亮点

  • 广泛支持代理：支持多种代理框架，包括 Claude Code、Cursor、Codex 等。
  • 本地优先的隐私保护：所有索引和搜索都在本地运行；提示和转录内容不会发送到云服务。
  • 高效性能：使用 Tantivy 进行索引，比传统数据库导入快得多，且比原始转录搜索更节省 token。
  • 溯源追踪：Pro 版本支持通过 ctx blame 将代码变更追溯到特定代理会话。
  • 混合搜索：结合 BM25 词汇匹配与本地语义搜索，实现更灵活的检索。

相关

  • Dispatch
    ctx：本地搜索编码代理历史记录

    ctx 是一个开源 CLI 工具，能够将本地编码代理会话索引到 SQLite，以实现对过去讨论、决策和失败尝试的快速、令牌高效搜索。

  • 项目
    Dicklesworthstone/coding_agent_session_search

    一个基于 Rust 的终端 UI 和 CLI，将数十个 AI 编码助手的对话日志聚合、归一化并索引到本地 SQLite 归档中。提供 60 毫秒以下的词法搜索和可选的设备内 MiniLM 语义搜索，配备稳定的 JSON 机器人模式 API，用于自动化和诊断。

  • 项目
    MoizIbnYousaf/ai-agent-skills

    AI Agent Skills 是一个基于 npm 的 CLI/TUI 工具，提供约 115 个 AI 代理“技能”（提示-代码组合）的精选库，按书架（前端、后端、移动、工作流、代理工程、营销）组织。它允许你浏览、搜索、安装和管理本地“本地副本”技能以及仅存储元数据的上游技能。你还可以使用 `init-library` 启动个人库，添加或归档新技能，打包副本，同步更新，并生成文档。支持任何 Agent-Skills 兼容代理（Claude、Cursor、Gemini 等），并支持多种安装目标。非常适合希望拥有整洁、可搜索的可重用代理能力工具箱的开发者或团队。

  • 项目
    mcncarl/agent-memory-vault

    一个以本地优先、基于 Git 的长期记忆系统，允许 Claude Code 和 Codex 等 AI 编码代理共享一个基于 Markdown 的、可验证的记忆库。

  • Dispatch
    Recall：Claude Code 的本地项目记忆

    Recall 是一个完全本地化的 Claude Code 插件，通过自动记录会话并使用本地 Python 摘要器生成紧凑、节省 token 的上下文摘要，从而提供持久的项目记忆。