Cortex：为 AI 编程智能体提供本地代码上下文检索

Hacker News 上出现了一款面向 AI 编程智能体（coding agent）的开源工具 Cortex。它的定位是：让 Cursor、Claude Code、Continue 等代理在编写或重构代码前，能够通过本地命令快速定位相关文件、符号和影响范围，而不是把整个仓库塞进上下文窗口。所有索引都留在本地，代码不会离开用户机器。

工具原理

Cortex 会在项目内构建一张"代码地图"，覆盖符号定义、调用关系与项目级规则。AI 智能体通过 CLI 与这张地图交互，按需查询，避免猜测或全量读取仓库。其默认工作流不依赖 MCP（Model Context Protocol），仅在客户端显式要求时才通过 cortex connect 启用 MCP 兼容模式。

安装与初始化

环境要求 Node.js 20.9 及以上版本，并需安装 Git。安装与初始化步骤大致如下：

• 全局安装：npm install --global @danielblomma/cortex-mcp
• 进入项目目录后执行 cortex init --bootstrap，会自动建立索引、向 AGENTS.md 写入提示指令、安装 Git 钩子，并启动后台监听进程
• 可通过 cortex doctor 检查整体配置是否就绪

初始化写入的指令会引导 AI 智能体在回答前先调用 cortex search，在重构前先调用 cortex impact。

常用命令

Cortex 暴露了一组面向智能体的 JSON 输出命令，方便解析：

• cortex search "<query>" --json：在仓库中检索相关代码
• cortex related <entity-id> --json：从某个结果出发，跟踪符号关联
• cortex impact "<topic>" --json：评估一处改动可能波及的范围
• cortex rules --json：读取项目自定义规则
• cortex pattern-evidence <file> --json：把改动文件与附近代码模式进行对比

Git 钩子与后台监听进程一般会自动维护索引，用户可通过 cortex status、cortex watch status、cortex update 查看或在批量改动后手动刷新。

大型仓库与平台支持

对于体量较大的代码库，Cortex 提供"先词法+图检索、后语义索引"的渐进式启动方式：

• cortex bootstrap --background --profile interactive
• cortex indexing status --json 查看后台语义索引进度

该模式目前支持 macOS、Linux 与 WSL，原生 Windows 仍需使用前台完整索引。

升级与许可

升级到最新版本只需重新安装包并执行 cortex init --force、cortex bootstrap、cortex update，项目配置与规则会被保留，版本变更细节见项目 CHANGELOG.md。Cortex 以 MIT 协议开源，源码托管在相关仓库，开发者可通过 Issues 区反馈问题。整体来看，它属于轻量级、可自托管的 AI 编码辅助中间件，更适合对代码隐私敏感、或不愿依赖云端索引的团队与个人开发者。