mex

让AI代理记住项目上下文，跨会话不迷路

mex 是一个为 AI 编程代理提供持久化项目记忆的开源工具。它通过结构化的脚手架（scaffold）和漂移检测命令行界面，帮助 AI 代理在多次会话中保持对项目上下文、决策和约定的持续理解。它解决了 AI 代理在跨会话工作时丢失项目背景、重复询问或产生不一致代码的问题。核心能力包括：定义项目记忆的结构化格式，自动检测项目状态与记忆内容之间的漂移，并通过 CLI 提供简单的读写和更新操作。它使用 TypeScript 编写，易于集成到现有的 AI 编码工作流中，提升代理的长期任务执行效率和准确性。

开源 free 开源模型

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1694

维护状态活跃

是否开源是

定价模式 free

项目数据

分类开源模型

开发团队mex-memory

所属国家

官网地址https://mexmemory.com

GitHubhttps://github.com/mex-memory/mex

定价模式free

价格说明开源项目，MIT 许可证，完全免费，可自行部署使用。

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型claude-code,claude-code-skills,cli-tool,code-graph,codex,context-management,cursor,developer-tools,documentation,knowledge-graph,llm,mcp-server,memory-management,tree-sitter,typescript

GitHub 星标★ 1694

30天Star增速

HF 下载量

上线时间2026-03-21 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数6

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

Node.js 22.5 或更高版本
该 Node 构建需支持 SQLite FTS5（见 COMPATIBILITY.md#sqlite-fts5）
一个 Git 仓库（mex 以 Git 作为共享层）
npm（README 说明常规 npm 流程在 macOS、Linux、Windows CMD/PowerShell/WSL 均可用）

安装与启动步骤

1确认 Node 版本

mex 要求 Node.js 22.5 或更新版本。先确认本机 Node 版本达标，否则后续步骤无法进行。
2检查 FTS5 支持

你使用的 Node 构建必须带 SQLite FTS5 支持。若不确定，请查阅仓库的 COMPATIBILITY.md#sqlite-fts5 说明。
3准备 Git 仓库

进入你要赋予项目记忆的代码仓库目录。mex 依赖 Git 在工作流和团队之间共享记忆。
```
cd /your/project
```
4按 npm 流程安装

README 的 Quick start 只给出环境要求，未列出具体 npm 命令。请以仓库最新 README 的 Quick start 为准执行安装。
5初始化项目记忆

安装后通过 mex 的 CLI 写入项目记忆（架构、决策、需求、交接信息），内容以可读的 Markdown 形式保存在仓库中。
6在本地 Hub 查看

用本地 Hub 浏览和评审项目记忆，包括 README 0.8.1 提到的可视化上下文图与 Inbox 知识贡献。

如何确认成功

CLI 能正常执行并在仓库中生成可读 Markdown 记忆文件，本地 Hub 可打开浏览这些内容。

常见问题

Q：Node 版本低于 22.5 可以安装吗？

A：不行。README 明确要求 Node.js 22.5 或更新版本，并需要该 Node 构建支持 SQLite FTS5。

Q：Windows 系统支持吗？

A：支持。README 说明常规 npm 流程可在 macOS、Linux、Windows 命令提示符、PowerShell 和 WSL 上使用。

Q：为什么要求必须是 Git 仓库？

A：mex 把项目记忆和代码放在一起，并以 Git 作为工程师与代理之间的共享层，因此需要 Git 仓库。

Q：具体安装命令是什么？

A：本次 README 节选的 Quick start 只列出环境要求，未给出具体命令。请查看仓库最新 README 的 Quick start 章节获取准确命令。

注意事项

README 节选中未给出具体安装命令，本教程未编造任何命令，执行前请核对仓库最新 Quick start。
务必确认 Node 构建包含 SQLite FTS5 支持，否则可能无法正常使用。
记忆以可读 Markdown 存储在仓库内，可随代码一起被评审和共享。
具体 CLI 子命令请参考 README 的 Command map 章节。

核心亮点

结构化脚手架让项目记忆有清晰模板，避免AI代理自由发挥
漂移检测能自动发现代码与记忆不一致，及时提醒更新
CLI设计简洁，可无缝嵌入现有AI编码工具链

不足之处

依赖开发者主动维护记忆内容，自动化程度有限
文档/社区待观察

适用场景

大型项目多会话AI辅助开发，保持上下文连续
团队协作时统一AI代理对项目约定的理解
长期维护中自动检测文档与代码的漂移

替代项目

mem0、MemGPT、Cognee

项目介绍

mex 是编程开发领域的开源项目，由 mex-memory 开发，是 2026 年新上线的项目。

在全站 13,014 个收录项目中，它的 GitHub 星标数（1,694）位列前 30%，在编程开发分类中处于中上游。

近 42 天，它的 GitHub 星标从 1,429 增加到 1,694，净增 265。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。MIT 许可证，完全免费，可自行部署使用。

它主要面向的使用场景是：大型项目多会话AI辅助开发，保持上下文连续。同类可对比的替代方案包括 mem0、MemGPT、Cognee。

上一篇：llama.vscode

下一篇：OpenRCA

mex