mex는 AI 코딩 에이전트가 매 세션마다 프로젝트를 처음부터 읽는 문제를 줄이기 위한 영속 메모리 도구다. 프로젝트 루트에 작은 자동 로드 파일과 ROUTER.md를 두고, 작업에 필요한 메모리만 라우팅하며, 의미 있는 작업 뒤에는 상태·결정·패턴을 갱신한다.
핵심 아이디어
에이전트 메모리는 “긴 프롬프트 하나”가 아니라 탐색 가능한 파일 구조여야 한다. mex는 세션 시작 시 전체 문서를 밀어 넣지 않고, 라우터가 현재 작업과 관련된 문서만 로드하게 한다. 이후 GROW 단계가 프로젝트 지식을 누적해 다음 세션의 콜드 스타트 비용을 낮춘다.
주요 기능
| 기능 | 설명 |
|---|---|
mex init | 프로젝트를 스캔해 메모리 스캐폴드 생성 |
ROUTER.md | 작업 유형에 따라 읽을 문서를 안내 |
mex check | 깨진 링크, 누락된 라우트, drift를 점수화 |
| watch hook | 작업 후 메모리 갱신을 유도 |
| MCP 서버 | shell 호출 없이 구조화된 도구 호출로 mex 기능 사용 |
| JSON 출력 | mex check --json, mex init --json으로 자동화에 통합 |
설치
npm install -g mex-agent
mex init
mex check전역 설치가 어렵다면 npx mex-agent로 실행할 수 있다.
잘 맞는 사용 사례
- 장기 코드베이스 작업: 아키텍처 결정, 테스트 관례, 배포 주의사항을 세션 간 유지한다.
- 여러 에이전트 운용: Codex, Claude Code, Cursor가 같은 프로젝트 메모리를 공유한다.
- 리팩터링·마이그레이션: 이전 시도와 실패 이유를 파일로 남겨 반복 삽질을 줄인다.
관련 문서
- agent-harness — 에이전트 성능을 결정하는 스캐폴딩 설계
- codebase-memory-mcp — 코드베이스를 Tree-Sitter 지식 그래프로 인덱싱하는 MCP 서버
- recall — Claude Code 세션을 로컬에서 기록·요약하는 오프라인 메모리
- cognee — 에이전트를 위한 오픈소스 장기 메모리 플랫폼
참고 자료
- mex-memory/mex — GitHub 공식 저장소