mex

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署开源模型 🍴 复刻 151 🐛 待处理 33 👀 关注 4

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1794

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，MIT 许可证，完全免费，可自行部署使用。

项目预览

项目数据

分类开源模型

开发团队mex-memory

官网地址https://mexmemory.com

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

定价模式🏷️完全免费

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

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言TypeScript

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

GitHub 星标★ 1794

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

代码更新2026-11-04

仓库体积25.4 MB

本站数据更新2026-11-08

维护状态活跃

收录时间2026-08-09

浏览次数7

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1794

技术标签

agent-skill agent-skills claude-code claude-code-skills cli-tool

使用教程

⚠ 本教程由 AI 依据该项目 README 整理；原始文档不完整，部分步骤为通用流程推断，实际安装请以项目官方文档为准。

难度：入门约 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 知识贡献。