mex-memory/mex

Team memory for engineers and their AI agents. Lives in your repo. Shared through Git.

解决的问题

MEX 为工程团队及其 AI 编码代理提供了一个共享项目记忆系统。它通过在 Git 仓库中创建持久且版本控制的上下文存储位置,解决了关键架构决策、调试历史和边缘情况被锁在个人工程师头脑中或短暂的代理会话中的知识碎片化问题。

工作原理

MEX 将规范知识与本地检索机制分离:

  • 规范记忆: 知识以结构化 Markdown 文件(Wiki、规格书、Relays、收件箱提案)的形式直接存储在仓库中,可通过标准 Git 提交和推送进行共享。
  • 本地索引: 每个用户维护自己的本地 SQLite 索引(代码图和 Wiki 搜索),这些索引可从规范文件和源代码中重建。
  • 代码图: 使用 Tree-sitter 语法解析器将代码中的符号和关系(支持 TypeScript、JavaScript、Python 和 Rust)映射,为 AI 代理提供精确的证据。
  • 根植性: Wiki 声明与特定代码符号相关联。如果代码发生变化,MEX 会标记“漂移”,提示文档需要审查。
  • 代理集成: 提供指令和技能,使代理(如 Claude Code 或 Codex)能够检索上下文并起草知识提案或交接内容,这些内容必须由人类审查并批准后才能成为规范内容。

适用对象

专为使用 AI 编码代理并希望确保某人或代理学到的上下文能被团队其他成员保存和访问的软件工程团队设计。

主要亮点

  • 基于 Git 的共享: 无需托管服务或中央数据库;记忆随代码一起迁移。
  • 项目中心: 本地浏览器界面,用于探索知识图谱、审查提案和管理交接。
  • Relays: 一种结构化的工作交接方式,记录进展、障碍和下一步行动。
  • 代码关联说明: 说明与实现之间直接关联,防止文档退化。
  • 多代理支持: 通过指令锚点和针对 Claude Code 与 Codex 的特定技能,兼容多种 AI 工具。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目