colbymchenry/codegraph
TypeScript120 / 0
CodeGraph는 tree-sitter로 다중 언어를 파싱해 SQLite(FTS5) 기반의 로컬 코드 지식 그래프를 만들고 MCP 도구로 에이전트에 '정확한' 코드 문맥을 한 번에 제공해 도구 호출·파일 읽기를 크게 줄인다.
TL;DR
CodeGraph는 tree-sitter로 다중 언어를 파싱해 심볼·호출선·파일 관계를 SQLite(FTS5) 기반의 로컬 지식 그래프로 저장하고, MCP 서버로 에이전트에게 codegraph_explore라는 단일 도구를 노출한다. 에이전트는 한 번의 쿼리로 관련 소스, 호출 경로, 영향 반경을 받아서 파일 단위 탐색과 grep/Read 루프를 대체한다. 벤치마크에서 도구 호출이 평균 58% 감소하고 응답 시간이 22% 빨라지는 등 검색·탐색 비용이 줄었으며, 토큰·달러 절감은 리포지토리 규모에 따라 미미할 수도 있고 대형 모노레포에서 큰 효과가 나타났다. 로컬 완전 실행과 자동 파일 감시로 실시간 인덱싱이 유지되며, 임베딩 방식 대신 구조적 그래프로 문맥을 구성하므로 외부 서비스·API 키 없이 에이전트 문맥 품질을 높일 수 있다. 단점은 인덱스 유지와 초기 색인 비용이 존재하고, 토큰·비용 절감은 작은 코드베이스에서 제한적이라는 점이다.
핵심 포인트
- 100% 로컬 실행(번들형 Node 런타임 제공)으로 코드가 외부로 유출되지 않음
- 단일 강력 MCP 도구(codegraph_explore)를 통해 에이전트의 잘못된 서브에이전트 호출을 억제함
- 언어 경계를 잇는 브리징(예: Swift↔ObjC, React Native 브리지)으로 교차언어 호출을 해결함
- SQLite + FTS5 기반 저장소로 별도 벡터 DB 없이 전체문자열 검색을 제공함
벤치마크
| 벤치마크 | 지표 | 값 | 비교 |
|---|---|---|---|
| Aggregate (7 repos) - Tool calls | Tool calls | 58% fewer | median of 4 runs per arm |
| Aggregate (7 repos) - Time | Time | 22% faster | median of 4 runs per arm |
| VS Code | Tool calls | 81% fewer | WITH vs WITHOUT CodeGraph (median of 4) |
| VS Code | Tokens | 64% fewer | WITH vs WITHOUT CodeGraph (median of 4) |
| OkHttp | Time | 31% faster | WITH vs WITHOUT CodeGraph (median of 4) |
| Alamofire | Time | 33% faster | WITH vs WITHOUT CodeGraph (median of 4) |
이미지 분석
55k
STARS
3.4k
FORKS
+233
TRENDING
120
조회수
관련 토론
아직 관련 토론이 없습니다.
댓글
댓글을 작성하려면 로그인이 필요합니다.
