mex
mex 给 AI 编码智能体提供可导航的项目记忆,而不是一个巨大的指令文件。`mex setup` 会创建一套 markdown 脚手架:很小的入口文件(`AGENTS.md` 或 `CLAUDE.md`)、把任务路由到合适上下文的 `ROUTER.md`、存放架构/技术栈/部署/决策/约定的 `context/` 目录、可复用任务指南的 `patterns/` 目录,以及用 `mex log` 追加写入的决策日志。之后由命令行负责保持内容准确:11 个检查器(路径、命令、依赖、过期、工具配置同步、失效链接等)不消耗任何 AI token,并给出漂移分数,`mex sync` 会生成针对性的提示词,让智能体只修复过期的部分。
需要 Node.js 20 或更高版本,运行 `npx mex-agent setup`(npm 包名是 `mex-agent`,因为 `mex` 已被占用,命令仍然是 `mex`)。设置过程会询问你用哪个工具并写入对应配置文件:Claude Code 用 `CLAUDE.md`,Cursor 用 `.cursorrules`,另有 `.windsurfrules`、Copilot 指令、OpenCode,以及 Codex 用的 `AGENTS.md`。还有一个 MCP 服务包,把 mex 暴露成工具调用。README 说基于语法树的代码图是尚未发布的 v0.7.0 预览,稳定版是 v0.6.3;并报告了一位社区成员在家庭实验室场景下的测试,平均节省约 60% token,这只是一次独立测试。许可证为 MIT。
功能特性
为什么选择它
权衡点
维护状况检查
- 最近提交
- 2026-10-26
- 近 90 天提交数
- 100+
- 近 90 天发布数
- 8
- 最新发布
- v0.8.4 (2026-10-14)
- 未关闭 issue
- 35
- 近期 issue 至少有一条评论的比例
- 1/21
最早的一周在左边,最近 4 周为橙色。数据来源:GitHub 提交统计。
状态规则:GitHub 上已归档 = 已归档;最近提交在 90 天内 = 活跃;91 到 365 天 = 放缓;更久 = 停滞。所有数字来自所示日期的 GitHub API。
讨论最多的未关闭 issue
- #202 MISSING_PATH: six notations and exemptions that are not drift12 条评论 · 2026-09-19
- #140 Field report: 40x rebuild wall-clock variance across OS users on one machine; check RSS ballooning (~12 GB); no repair path short of full re9 条评论 · 2026-08-25
- #231 check false positives on clean scaffolds not covered by #201-#2033 条评论 · 2026-09-22
- #118 Decide: do we support a second parser architecture (Prism for Ruby)?3 条评论 · 2026-08-04
- #93 [Go] Add code-graph extractor3 条评论 · 2026-07-14
issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。
适合谁
- 你的 AGENTS.md 或 CLAUDE.md 已经太大,想改成小的入口文件加按任务路由的上下文文件。
- 想把记忆存成仓库里的普通 markdown,能在 pull request 里审阅和对比。
- 想要不消耗 AI token 的漂移检查,能发现缺失路径、过期文件和失效脚本。
- 你想跨无关项目或对话回忆信息:mex 只存在于单个仓库里。
- 你的项目很小:多一套要维护的文件可能得不偿失。
- 你现在就想用 AST 代码图谱功能:README 标为尚未发布的预览。
与同类的区别
mex 是人工整理、人能读懂的项目知识,比如决策和约定。Codebase Memory 则从源码自动构建代码图谱。它们回答的是不同的问题,可以组合使用。
兼容性
快速开始
使用场景
同类工具
收录于以下清单
评论
暂无评论,来发表第一条吧