프로젝트 소개

CodeGraph는 Claude Code, Cursor, Codex CLI, opencode, Hermes Agent, Gemini CLI, Antigravity IDE, Kiro, GitHub Copilot 등을 포함한 AI 코딩 에이전트를 가속화하기 위해 설계된 오픈소스 100% 로컬 코드 지식 그래프입니다. 전체 코드베이스의 심층 그래프 — 모든 심볼, 호출 간선, 의존성 — 를 사전 인덱싱하여 빌드하고, 파일 변경 때마다 자동 동기화되어 인덱스가 절대 낡지 않습니다. 에이전트가 grep과 Read 도구 호출로 파일을 수색하는 대신, CodeGraph는 필요한 코드를 한 번의 호출로 정확하게 제공합니다. 주요 기능: - **네이티브 Rust 커널**: 20개 이상 언어(TypeScript, JavaScript, Python, Go, Rust, Java, C/C++, Swift, Kotlin 등)를 지원하는 Rust 기반 파싱 엔진. 생성된 그래프는 참조 엔진과 바이트 단위로 검증됨. - **기계 환경 적응형**: 실제 시스템 리소스 기반으로 워커 풀과 캐시 크기 조정 — 컨테이너 인식 코어 수와 정확한 RAM 측정 사용. 워크스테이션과 저사양 VPS 모두 지원. - **정밀 컨텍스트**: 단일 도구 호출로 진입점, 관련 심볼, 코드 스니펫 반환, 파일별 탐색 불필요. - **자동 동기화**: 프로젝트를 감시하여 파일 변경 시 그래프 갱신 (~0.3초 증분 동기화). - **프레임워크 인식 라우팅**: 웹 프레임워크의 라우팅 이해. - **혼합 플랫폼 지원**: iOS/React Native/Expo 브리징 처리. - **브라우저 UI**: http://127.0.0.1:4747에서 콜러, 심볼, 콜리에 그래프 시각화. - **MCP 서버**: 지원되는 에이전트와의 Model Context Protocol 통합. 벤치마크 결과 (2026년 8월 Claude Opus 4.8로 7개 오픈소스 저장소에서 측정): CodeGraph는 파일 읽기 방식 에이전트 대비 도구 호출 88%, 토큰 62%, 비용 44% 감소. 모든 테스트 저장소에서 파일 읽기 영제. 설치: Node.js 불필요 standalone 바이너리 (설치 스크립트), 또는 npm 글로벌 패키지. `codegraph init`으로 프로젝트별 연결, `codegraph install`로 에이전트 연결.