CodeGraph

요약

CodeGraph는 프로젝트의 호출 관계와 파일 의존성을 로컬 그래프로 인덱싱해 코딩 에이전트가 필요한 맥락을 좁혀 읽도록 돕는 CLI·MCP 도구입니다.

도구 소개

공식 README는 Claude Code, Codex, Gemini CLI, Cursor, OpenCode, Hermes Agent 등 여러 에이전트 연결을 지원하고, Rust 기반 커널로 코드 그래프를 만든다고 설명합니다. codegraph_explore MCP 도구는 심볼의 소스, 호출 경로, 영향 범위를 한 번에 보여주는 방식입니다.

사용 포인트

• 프로젝트마다 .codegraph/ 그래프를 만들어 로컬에서 관리
• 코드 질문에 필요한 심볼과 호출 경로를 함께 탐색
• 변경된 파일에서 영향받는 테스트를 codegraph affected로 추적
• MCP 연결 뒤 에이전트가 전체 저장소 대신 관련 코드부터 읽도록 구성

설치와 시작

공식 설치 스크립트 또는 npm 패키지를 사용할 수 있습니다.

npm i -g @colbymchenry/codegraph
cd your-project
codegraph install
codegraph init

처음에는 작은 저장소에서 그래프 생성 시간과 affected 결과를 기존 테스트 명령과 비교하는 편이 안전합니다. 외부 서비스에 코드를 보내지 않는 로컬 구조가 필요한지도 함께 확인합니다.

선정 사유

코딩 에이전트의 문제는 모델이 코드를 못 읽는 것보다 너무 많은 파일과 도구 출력을 한꺼번에 읽는 데서 생기기 쉽습니다. CodeGraph는 호출 관계와 영향 범위를 구조화해 에이전트가 읽을 범위를 먼저 줄이는 접근을 취합니다. 공식 README에는 심볼 뷰어와 영향 분석 화면도 공개되어 있어 기능을 실제 흐름으로 확인할 수 있습니다.

참고

• GitHub 저장소
• 공식 README
• 공식 문서