
Claude Code가 학습 내용을 유지하지 못하고 계속 같은 저장소를 다시 읽는 문제를 해결하기 위해 오픈 소스 수정안을 만들었습니다. 1
요약
코딩 에이전트가 매 세션마다 저장소를 반복 학습하는 문제를 해결하기 위해 오픈 소스 도구인 mex v0.7.0을 출시했습니다. mex는 로컬 코드 그래프를 생성하여 에이전트가 필요한 컨텍스트만 효율적으로 로드하도록 돕습니다.
핵심 포인트
- Tree-sitter와 SQLite를 활용한 결정론적 로컬 코드 그래프 구축
- 전체 파일 대신 관련 심볼과 관계 중심의 컴팩트한 컨텍스트 제공
- 기존 방식 대비 컨텍스트 크기를 약 90.7% 절감
- Markdown 위키와 실제 코드를 연결하여 지식의 최신성 유지
안녕하세요! 몇 달 전 이곳에 mex의 초기 버전을 게시했습니다. 반응이 정말 엄청났습니다. 여러 게시물을 통해 조회수가 약 100만 회에 달했고, 저장소(repo)는 GitHub 스타 1,200개를 돌파했으며, 한 번도 만난 적 없는 분들이 기여하기 시작했습니다. 그 이후로 계속 개발을 이어왔으며, 방금 mex v0.7.0을 출시했습니다. 저장소: https://github.com/mex-memory/mex
원래 문제는 간단했습니다: 코딩 에이전트(coding agents)가 매 세션마다 동일한 저장소를 계속 다시 읽으며 아키텍처(architecture)를 다시 학습하고, 그 지식의 대부분을 다시 버린다는 것이었습니다. mex는 저장소 내부에 살아있는 Markdown 위키(wiki)를 생성합니다. 에이전트는 작업하면서 아키텍처, 컨벤션(conventions), 결정 사항, 패턴을 기록하며, 향후 세션에서는 현재 작업과 관련된 지식만 로드합니다.
v0.7.0의 주요 추가 사항은 Tree-sitter와 SQLite를 사용하여 구축된 결정론적 로컬 코드 그래프(deterministic local code graph)입니다. 현재 TypeScript/TSX, JavaScript/JSX, Python, Rust를 지원합니다. 에이전트는 다음과 같이 실행할 수 있습니다: mex graph scope "trace the authentication flow" (인증 흐름 추적).
전체 파일을 컨텍스트(context)에 쏟아붓는 대신, mex는 관련 함수, 호출자(callers), 피호출자(callees), 임포트(imports) 및 관계의 컴팩트한 이웃(compact neighbourhood)을 반환합니다. 그러면 에이전트는 필요한 정확한 심볼(symbols)만 확장할 수 있습니다.
mex 저장소에 대한 벤치마크(benchmark) 결과:
- grep top-3 대비 반환된 컨텍스트 10.74배 적음
- 대략 90.7% 더 작음
- 6개의 검색 작업 전반에 걸쳐 100% 예상 심볼 재현율(expected-symbol recall) 달성
- 5/5 실제 에이전트 작업 정확히 완료
- 0/5 폴백(fallback) 필요
컴팩트한 그래프 컨텍스트를 사용한 Read/Grep
이것은 하나의 저장소와 작업 세트에 대한 작은 벤치마크이며, mex가 에이전트의 총 토큰 사용량을 보편적으로 90% 절감한다는 주장은 아닙니다. 제가 흥분되는 또 다른 부분은 위키를 실제 코드와 다시 연결하는 것입니다. Markdown 설명은 정확한 심볼을 가리킬 수 있습니다. 함수가 변경되거나, 이동하거나, 사라지면 mex는 어떤 프로젝트 지식이 이제 오래된 것(stale)인지 식별할 수 있습니다.
따라서 기본 개념은 다음과 같습니다: 코드는 진실의 원천(source of truth)입니다. Markdown은 설명입니다. 그래프는 이 둘을 연결된 상태로 유지합니다.
특히 코드 인텔리전스 (code intelligence), 에이전트 툴링 (agent tooling), 파서 (parsers), 또는 대규모 저장소 (large repositories) 분야에서 작업하시는 분들의 피드백을 진심으로 기다립니다. 기여자(Contributors)분들도 언제든 환영합니다. /u/DJIRNMAN 제출 [link] [comments]
AI 자동 생성 콘텐츠
본 콘텐츠는 r/ClaudeAI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기