Cortex-memory 是一个面向 AI 编程助手的持久化记忆工具。它的核心用途是解决 AI 助手在会话之间遗忘项目上下文的问题：每次开始新的 AI 编程会话时，用户往往需要花费 15-30 分钟重新解释项目架构、过去的决策、已知缺陷和约定。Cortex 会自动捕获这些信息，并在下一次会话开始前注入，让 AI 助手在用户输入第一个字符之前就掌握背景。
主要能力
- 实时记忆捕获：Cortex 在会话进行中实时监控，每 1 秒检查新消息，每 15 秒做一次本地快速提取（不调用 API），每 20 条消息进行一次后台深度 LLM 提取，检测到决策或 bug 时立即捕获。状态栏在活跃会话中显示“Cortex: Live”。
- 三层记忆架构：第一层为工作记忆（热），始终注入约 800 token，包括上次会话摘要、近期决策和未解决问题，会在每次会话前自动注入 CLAUDE.md，AI 可自动读取；第二层为情景记忆（温），每个会话一个文件，包含完整上下文，并自动生成架构决策记录（ADR），可通过 CLI 和 MCP 搜索；第三层为语义记忆（冷），提供跨所有层的全文搜索，向量嵌入计划在 v0.2 推出。
- 自动生成决策日志：每次架构决策都会记录决定内容、原因、考虑过的替代方案以及完整会话上下文。
- 记忆层树视图：可查看工作记忆、情景和决策；提供记忆健康评分（0-100）、token 预算跟踪，并在会话中实时更新。
- CLAUDE.md 自动注入：Claude Code、Cursor 和 Cline 原生读取 CLAUDE.md，Cortex 利用这一点把记忆自动带入会话。
使用方式
- 在 VS Code 扩展中搜索“Cortex Memory”安装，或在命令行使用 CLI，或通过 MCP 服务器接入。
- 可选：添加免费 API 密钥以启用更智能的提取。可在 aistudio.google.com/apikey 获取免费 Gemini 密钥，运行 Ctrl+Shift+P → Cortex: Set API Key → 粘贴密钥。
- 无需 API 密钥也可使用，基础的模式匹配提取在本地运行。
- MCP 服务器支持 Cursor、Cline、Zed，提供工具：cortex_get_context、cortex_search、cortex_save_memory、cortex_get_decisions、cortex_status。
适用场景
- 使用 Claude Code、Cursor、Cline、Copilot 或任何 MCP 客户端的开发者，希望 AI 记住项目架构、决策和约定。
- 团队中希望通过提交 .cortex/ 目录共享记忆（官方计划在 v0.2 提供基于 git 的团队同步）。
限制与隐私
- 数据 100% 本地，全部保存在用户机器上的 .cortex/ 目录。
- 无遥测、无数据收集、无跟踪，无云存储；唯一的外部调用是用户选择的 LLM。
- 删除 .cortex/ 即可清除所有数据，该目录会自动加入 .gitignore。
- 编辑性能影响：包体小于 200KB，所有处理在后台进行，不会拖慢编辑器。
- Gemini 免费层每天 500 次请求，成本为 $0。
- 团队同步、向量嵌入等功能计划在 v0.2 推出，当前版本暂未提供。
其他信息 项目为开源，欢迎通过 CONTRIBUTING.md 参与贡献，接受 PR。
