【免费下载链接】ctxInstant recall for coding agents. Search the history already on your machine. Git blame, but for agent sessions.项目地址https://gitcode.com/gh_mirrors/ctx3/ctx点击查看免费下载ctx 是运行在本地的编程 Agent 历史搜索引擎它把 Claude Code、Codex、Cursor 等 Agent 留在你机器上的会话日志变成可检索的索引。本文通过MCP 服务器与Skill 安装两条路径教你让 Agent 自主搜索历史用更少的 token 复用过去的决策、方案与失败教训。一、为什么 Agent 需要历史记忆大多数编程 Agent 都有一个通病每次新会话都从零开始。上一次调试中发现的根因这次又要重新排查一遍之前失败过的技术方案Agent 毫无察觉原样再试一次分散在几十份 JSONL / SQLite 日志里的决策记录格式冗长Agent 根本读不动。如果让 Agent 去裸搜原始日志代价非常高一次历史检索可能产生数万 token 的上下文。而 ctx 把历史结构化为会话、事件与索引字段后同样的检索只需极少的输出量数据来自 README.mdctx 结构化检索比原始 transcript 检索节省约 50 倍 token。ctx 的定位可以一句话概括Git blame但对象是 Agent 会话Instant recall for coding agents。它本地读取各 Agent 的历史文件不修改原始数据建立索引后提供ctx search、ctx show、ctx blame等能力。二、快速安装与初始化 ⚡一切的前提是装好 ctx CLImacOS / Linuxcurl -fsSL https://ctx.rs/install | sh然后初始化本地历史索引ctx setup # 发现本机各Agent的历史源并建立索引 ctx status # 查看索引与健康状态 ctx sources # 查看发现了哪些Agent历史源首次索引会扫描本机全部历史耗时取决于数据量。得益于并行构建的 Tantivy 索引冷启动速度很快日常使用无需操心默认开启自动后台索引历史文件变化后索引自动跟进且每次更新整体原子可见命令永远不会读到半成品索引。三、MCP 服务器安装一条命令接入 Agent3.1 它是什么ctx mcp serve会启动一个本地 stdio MCP 服务器基于 newline-delimited JSON-RPC专门服务于偏好工具发现机制的 Agent 宿主ctx mcp serve # 手动启动一般由Agent宿主自动拉起 ctx integrations install mcp # 自动写入各Agent的MCP配置 ctx integrations status mcp # 查看安装状态 ctx integrations remove mcp # 移除ctx的MCP注册3.2 安装器的安全设计ctx integrations install mcp的行为非常克制这也是它值得推荐的理由特性说明自动探测不带参数时只写入本机检测到的支持型 Agent 配置结构化解析支持 JSON / JSONC / TOML / YAML 配置逐字段 upsert幂等且保守只添加ctx这一个 server 条目保留无关配置冲突保护已存在不同配置的ctx条目时拒绝覆盖需显式--force项目级安装--project写入当前仓库的 MCP 配置如.cursor/mcp.json常用安装命令ctx integrations install mcp --agent codex # 只装给 Codex ctx integrations install mcp --provider cursor --project # Cursor 项目级 ctx integrations install mcp --all-agents --format json # 全部目标3.3 支持矩阵节选ctx 已实现写入配置的 Agent 包括完整矩阵见 docs/mcp-integrations.mdAgent配置文件格式Codex~/.codex/config.tomlTOML[mcp_servers.ctx]Claude Code~/.claude.json或.mcp.jsonJSONmcpServers.ctxCursor~/.cursor/mcp.json/.cursor/mcp.jsonJSONmcpServers.ctxOpenCode~/.config/opencode/opencode.jsonJSONmcp.ctxGemini CLI~/.gemini/settings.jsonJSONmcpServers.ctxZed~/.config/zed/settings.jsonJSONcontext_servers.ctxCopilot CLI~/.copilot/mcp-config.jsonJSONmcpServers.ctx如果你的 Agent 不在自动写入范围内手动在配置里加入以下条目即可{ mcpServers: { ctx: { command: ctx, args: [mcp, serve] } } }3.4 MCP 工具集Agent 到底能做什么服务器通过 MCP 发现机制动态暴露工具主要包括工具用途status查看索引、升级、本地用量等状态等价ctx status --format jsonsources列出本机发现的 Agent 历史源search搜索历史会话支持content_scopeall/transcript/calls/outputs等过滤show_session按 ctx 会话 ID 读取完整 transcript支持分页游标show_event按事件 ID 读取单条事件及前后窗口query_events带条件的确定性分页事件查询blame从文件行 / commit / PR 反查产生它的 Agent 会话附原始 transcript 证据两个值得注意的细节只读安全MCP 进程不导入历史、不写 provider 数据只做有界的健康唤醒与查询结果带证据blame与search都返回可引用的 ctx 会话/事件 IDAgent 会基于证据下结论而不是猜测。更多契约细节见 docs/mcp.md。四、Skill 安装给 Agent 一套历史检索工作流 4.1 Skill 解决什么问题MCP 给 Agent 提供了工具而Skill 教会 Agent什么时候用、怎么组合用。ctx 的 Skill 本质上是一份 SKILL.md 工作流说明书指导 Agent进入陌生代码区域前先ctx search查相关历史决策需要溯源时用ctx blame file path追到产生该代码的会话引用结论前用ctx show event / session打开原文核对回答中给出 ctx 会话 ID 与事件 ID 作为引用。4.2 一键安装ctx integrations install skill # 交互式选择器默认装到 ~/.agents/skills/ctx ctx integrations install skill --agent codex # 指定Agent ctx integrations install skill --agent claude-code --agent cursor ctx integrations install skill --all-agents # 全部支持的Agent ctx integrations install skill --project # 装入项目级技能目录状态检查与卸载同样是幂等的ctx integrations status skill ctx integrations remove skill --agent codex安装器会在SKILL.md旁写入.ctx-skill.json元数据以区分ctx 管理的副本和你本地改过的文件——本地修改过的副本不会被静默覆盖或删除。完整说明见 docs/agent-skill-install.md。4.3 三种接入形态按需选择形态命令适用场景Skill 直装ctx integrations install skill绝大多数支持 Agent Skills 的客户端Codex、Claude Code、Cursor、Zed 等可移植插件ctx integrations install plugin支持 Agent Plugins 标准的客户端附带/ctx命令入口Slash 命令ctx integrations install slash-command --agent opencodeOpenCode、Gemini CLI、Qwen Code 等有独立命令文件约定的客户端装出/ctx query可移植插件位于 plugins/ctx/遵循 Agent Plugins 1.0.0 规范见 plugins/ctx/plugin.json其中捆绑的/ctx命令只是一个薄入口最终仍委托给 ctx Skill。各客户端的命令文件写入规则见 docs/slash-command-integrations.md。Skill 和 MCP 不冲突建议都装MCP 提供结构化工具调用Skill 提供检索工作流与引用规范二者互补。五、验证安装是否生效 ✅三步走1. 检查安装状态ctx integrations status mcp --format json ctx integrations status skill --agent codex --format json状态值包括current最新、stale待刷新、modified本地改过、missing缺失。2. 确认历史索引可用ctx status ctx search migration failed如果搜不到东西通常是历史还没初始化执行ctx setup或等待后台索引完成。3. 让 Agent 自证在 Agent 对话里丢一段验证提示来自 docs-content/skill.mdxSearch ctx for prior work on this area. Inspect the best event or session, tell me which ctx ID you used, and explain whether that history changes your plan.如果 Agent 能给出带 ctx ID 的引用说明整条链路索引 → 检索 → 引用已经打通。六、常见问题 FAQQMCP 安装会破坏我现有的 Agent 配置吗不会。安装器结构化解析配置文件只 upsertctx一个条目无效配置、无关配置一律原样保留冲突条目不--force不碰。Q数据会上传到远端吗不会。MCP 服务器走本地 stdio检索完全在本机完成历史文件只读不改。但注意 MCP 输出属于本地私有内容可能含路径、代码片段Agent 宿主可能会记录工具输出分享前请自行审查。QAgent 装了 Skill 却不主动用 ctx依次排查ctx integrations status skill是否为currentCLI 是否在 PATH 中用ctx status确认索引可读。也可以直接对它说请先用 ctx 搜索本区域的历史再动手。QMCP 和 Slash 命令要都装吗不必。有 Skill 的客户端装 Skill 即可OpenCode、Gemini CLI、Qwen Code 这类命令文件客户端用 slash-command 安装偏好工具发现的宿主如 Cursor、Zed则用 MCP。七、小结给编程 Agent 装上一副记忆只需要三条命令ctx setup # 索引本机历史 ctx integrations install mcp # 接入MCP ctx integrations install skill # 装上检索工作流从此 Agent 在动手前会先翻旧账过去的决策、失败尝试、约束条件都能被检索并引用重复劳动更少token 花得更值。延伸阅读docs/mcp.mdMCP 服务器完整契约docs/mcp-integrations.md全量 Agent 支持与手动配置片段docs/agent-skill-install.mdSkill / 插件安装全解docs/blame.md代码溯源到 Agent 会话skills/ctx/SKILL.mdSkill 工作流原文赞分享【免费下载链接】ctxInstant recall for coding agents. Search the history already on your machine. Git blame, but for agent sessions.项目地址https://gitcode.com/gh_mirrors/ctx3/ctx点击查看免费下载相关推荐Flet LaunchMode 完全指南用 Python 精确控制 URL 的打开方式Flet LaunchMode 完全指南用 Python 精确控制 URL 的打开方式 导读 flet.LaunchMode 是 Flet 中用于声明U前端跨平台桌面应用移动开发在 Claude Code 中安装 Firebase Agent Skills 与 MCP 服务器firebase-basics 实战指南在 Claude Code 中安装 Firebase Agent Skills 与 MCP 服务器firebase basics 实战指南 本篇指南基于 sAI 技能人工智能大模型如何通过MCP让AI Agent检索agent-beacon历史记忆serve与connect双模式配置指南如何通过MCP让AI Agent检索agent beacon历史记忆serve与connect双模式配置指南 agent beaconBeacon 是一款创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考