'abhigyanpatwari/GitNexus' 깃허브 트렌딩… 코드베이스를 지식 그래프로 인덱싱하는 MCP, Claude Code·Cursor·Codex 등에 깊은 아키텍처 컨텍스트 제공
코드베이스를 지식 그래프로 인덱싱하는 'GitNexus'가 깃허브 트렌딩에 올랐다. 누적 2만 9,652스타에 일일 667스타가 추가됐다. 모든 의존성·콜체인·클러스터·실행 흐름을 그래프로 저장한 뒤 스마트 도구를 통해 노출해, AI 에이전트가 코드를 놓치지 않도록 만드는 것이 목적이다. 프로젝트 측은 "DeepWiki가 코드를 이해시키는 도구라면 GitNexus는 코드를 분석시키는 도구"라고 설명한다.
두 가지 사용 형태가 있다. CLI + MCP는 Cursor·Claude Code·Codex·Windsurf·OpenCode를 일상 개발에 연결해 에이전트가 의존성을 놓치거나 콜체인을 깨거나 맹목적인 편집을 출하하지 않도록 만든다. 웹 UI(gitnexus.vercel.app)는 시각적 그래프 탐색과 브라우저 내 AI 채팅을 제공하며, 빠른 탐색·데모·일회성 분석 용도다.
스토리지·파싱 스택은 양쪽이 다르다. CLI는 LadybugDB 네이티브와 Tree-sitter 네이티브 바인딩을 사용해 빠르고 영속적이며, 모든 처리가 로컬에서 이뤄지고 네트워크 통신이 없다. 웹 UI는 LadybugDB WASM과 Tree-sitter WASM으로 세션당 인메모리 처리를 하고 모든 처리가 브라우저 안에서 이뤄지지만, 브라우저 메모리 한계로 약 5,000 파일까지 다룰 수 있다(백엔드 모드는 무제한). 'gitnexus serve'를 실행하면 웹 UI가 로컬 서버를 자동 감지해 CLI에 인덱싱된 모든 리포를 재업로드 없이 탐색할 수 있다(브리지 모드).
설치와 사용은 단순하다. 리포 루트에서 'npx gitnexus analyze' 한 줄을 실행하면 인덱싱과 함께 에이전트 스킬 설치, Claude Code 훅 등록, AGENTS.md/CLAUDE.md 컨텍스트 파일 생성이 모두 한 번에 이뤄진다. 에디터 MCP 설정은 'npx gitnexus setup'을 한 번 실행하면 자동 감지로 글로벌 MCP 설정이 작성된다.
에디터별 통합 깊이는 차등 적용된다. Claude Code는 MCP·스킬·PreToolUse 훅(검색을 그래프 컨텍스트로 강화)·PostToolUse 훅(커밋 후 인덱스 노후화 감지·재인덱싱 유도)까지 풀 지원이다. Cursor·Codex·OpenCode는 MCP + 스킬, Windsurf는 MCP만 지원한다. 수동 설정도 가능해, Claude Code는 'claude mcp add gitnexus -- npx -y gitnexus@latest mcp', Codex는 'codex mcp add gitnexus -- npx -y gitnexus@latest mcp' 형태로 추가한다.
주요 CLI 명령은 'gitnexus analyze'(인덱싱·업데이트), '--force'(강제 전체 재인덱싱), '--skills'(감지된 커뮤니티 기반 리포별 스킬 파일 생성), '--skip-embeddings'(임베딩 생략으로 빠른 인덱싱), '--embeddings'(임베딩 활성화로 더 나은 검색), '--skip-git'(Git이 아닌 폴더도 인덱싱), 'gitnexus mcp'(stdio MCP 서버 시작), 'gitnexus serve'(웹 UI 연결용 로컬 HTTP 서버), 'gitnexus list'(인덱싱된 리포 목록), 'gitnexus status', 'gitnexus clean' 등이다.
엔터프라이즈는 풀 매니지드 SaaS 또는 셀프호스트 형태로 제공되며, OSS 상용 사용 라이선스도 가능하다. 엔터프라이즈 기능에는 PR 리뷰(자동 블래스트 반경 분석), 자동 업데이트 코드 위키, 자동 재인덱싱, 멀티 리포 통합 그래프, OCaml 지원, 우선 기능·언어 지원이 포함된다. 향후 자동 회귀 포렌식과 엔드투엔드 테스트 생성을 추가할 예정이며, 문의는 akonlabs.com과 founders@akonlabs.com이다.
커뮤니티 확장으로는 @tintinweb의 'pi-gitnexus'(pi 패키지 매니저용 플러그인, 'pi install npm:pi-gitnexus'로 설치), @ShunsukeHayashi의 'gitnexus-stable-ops'(Miyabi 생태계의 안정 운영·배포 워크플로우)가 소개돼 있으며, 새 프로젝트는 PR로 추가받는다.