CodeGraph
코드 변경과 함께 갱신되는 20개 언어 로컬 지식 그래프 CLI·MCP
curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh소스 코드를 심볼·호출·의존 관계 그래프로 색인하고 Claude Code·Codex·Cursor 같은 에이전트에 MCP로 연결하는 로컬 도구입니다. 20개 언어를 Rust 파싱 커널로 처리하고 파일 변경을 증분 반영하며, 검색·호출자·영향 범위를 CLI와 Node API에서도 질의합니다. 외부 코드 분석 API가 필요 없고 인덱스는 프로젝트의 .codegraph 디렉터리에 남습니다.
판단
이럴 때 씁니다
- 큰 저장소에서 에이전트가 심볼·호출자·영향 범위를 반복해서 찾아야 할 때
- 코드를 외부 분석 서비스로 보내지 않고 로컬 그래프와 MCP를 운영해야 할 때
- MCP가 없는 서브에이전트나 스크립트에서도 같은 그래프를 CLI·Node API로 조회하고 싶을 때
이럴 땐 쓰지 마세요
- 파일 몇 개뿐인 작은 저장소에서 단순 텍스트 검색만으로 충분할 때
- 문서·설계 이미지·영상까지 같은 지식 그래프에 넣어야 할 때
- 생성되는 프로젝트 인덱스와 에이전트 설정 변경을 팀 정책상 허용할 수 없을 때
차별점
- TypeScript·JavaScript·Python·Java·Go·C/C++·Rust 등 20개 언어를 네이티브 Rust 파싱 커널로 색인합니다.
- 파일 감시기가 그래프를 증분 갱신해 에이전트가 오래된 전체 색인을 매번 다시 만들지 않게 합니다.
- Claude Code·Cursor·Codex CLI·OpenCode·Hermes Agent·Gemini CLI 등의 MCP 설정을 자동으로 연결하고 되돌리는 설치기를 제공합니다.
- MCP뿐 아니라 query·callers·impact CLI와 Node API를 제공해 셸 스크립트나 자체 도구에서도 같은 그래프를 씁니다.
워크플로
- 01공식 설치 스크립트를 실행하고 새 셸에서 codegraph version으로 v1.5.0을 확인합니다.
- 02codegraph install을 실행해 사용할 에이전트와 전역·프로젝트 설정 범위를 고릅니다.
- 03각 프로젝트 루트에서 codegraph init으로 첫 그래프를 만들고 codegraph status로 색인 상태를 확인합니다.
- 04에이전트에서는 MCP 도구를 쓰고, 자동화에서는 query·callers·impact --json을 호출합니다. 감시가 꺼진 환경은 codegraph sync를 별도로 실행합니다.
주요 명령
| 명령 | 설명 |
|---|---|
codegraph install | 설치된 에이전트를 찾아 MCP 서버와 사용 지침을 연결합니다. |
codegraph init | 현재 프로젝트에 .codegraph 디렉터리를 만들고 전체 그래프를 처음 구축합니다. |
codegraph status --json | 인덱스 통계와 백엔드 상태를 JSON으로 확인합니다. |
codegraph impact AuthMiddleware --depth 3 | 선택한 심볼의 전이 영향 범위를 조회합니다. |
codegraph uninstall | 설치기가 추가한 MCP 설정과 지침만 에이전트에서 제거합니다. |
함정
설치 전에 확인하세요
- codegraph install은 여러 에이전트의 전역 또는 프로젝트 설정을 고칩니다. 제거할 때 패키지만 삭제하지 말고 codegraph uninstall을 먼저 실행해야 고아 MCP 설정이 남지 않습니다.
- CLI와 MCP는 자체 런타임을 포함하지만 Node API를 애플리케이션에 임베드할 때는 node:sqlite 때문에 Node.js 22.5 이상이 필요합니다.
- 파일 감시기를 쓸 수 없는 환경에서는 그래프가 자동으로 최신 상태가 되지 않습니다. 이 경우 codegraph sync나 제공되는 Git 훅 경로를 운영 절차에 넣어야 합니다.
- 문서·이미지까지 한 그래프에서 찾아야 한다면 CodeGraph의 코드 중심 색인만으로는 범위가 부족합니다.
비교
Code Review Graph가 리뷰의 변경 영향과 테스트 범위를 좁히는 데 집중한다면, CodeGraph는 일반 심볼 검색·호출 관계·영향 분석을 CLI·MCP·Node API로 넓게 제공합니다. Graphify처럼 문서·이미지를 함께 다루지는 않으므로 코드 구조만 로컬에서 빠르게 갱신하려는 저장소에 더 맞습니다.
최근 변경
v1.6.0에서는 GitHub Copilot을 지원 대상 에이전트로 추가하고, codegraph install --yes --init 한 번으로 설치와 색인을 마칠 수 있게 했습니다. 강제 종료 시 write-ahead log가 무한히 쌓이던 디스크 누수를 고치고, codegraph.json 설정을 바꿔도 재시작 없이 즉시 반영되도록 했습니다.