abhigyanpatwari/GitNexus

여기에 속하나요? 네

이것은 진짜이고 실질적인 소프트웨어 프로젝트입니다. 목록, 튜토리얼, 데모가 아닙니다. AI 코딩 에이전트가 코드를 이해하는 방식을 개선하도록 설계된 네이티브 코드 인덱싱 파이프라인(Tree-sitter 파싱, 그래프 저장소, MCP 서버, CLI, Web UI)을 구축합니다.

무엇을 하나요 (쉽게 설명)

Cursor, Claude Code, Codex 같은 AI 코딩 어시스턴트는 코드 작성에 능숙하지만 대규모 코드베이스의 구조에 대해 종종 눈이 멀어 있습니다. 한 함수를 편집하면서 다른 47개의 함수가 그것에 의존한다는 것을 모를 수 있으므로 "무해한" 변경이 일상적으로 빌드를 깨뜨립니다.

GitNexus는 코드베이스 전체의 지식 그래프를 사전 구축하여 이 문제를 해결합니다. AI가 원시 파일을 단계별로 파헤치게 하는 대신 모든 것을 사전에 인덱싱합니다: 모든 파일, 함수, 의존성, 호출 체인, 실행 흐름. 그런 다음 이 그래프를 MCP(Model Context Protocol) 를 통해 AI 에이전트에 노출합니다. 이는 AI 에이전트에 추가 도구를 제공하는 표준 방법입니다.

사용 방법

CLI + MCP(권장): 리포지토리에서 npx gitnexus analyze를 실행하여 인덱싱합니다. npx gitnexus setup을 실행하여 편집기(Claude Code, Cursor, Codex 등)를 자동 연결합니다. 이 명령을 실행하면 구성이 작성되고 에이전트용 "스킬"이 설치되며 그래프 컨텍스트를 자동으로 주입하는 후크가 등록됩니다.
Web UI: 브라우저 기반 그래프 탐색기 및 채팅. 완전히 브라우저 내에서(WASM을 통해) 또는 로컬 CLI 인덱스에 재업로드 없이 연결되는 "브리지 모드"로 작동합니다.

핵심 아이디어: 사전 계산된 관계형 지능

전통적인 "그래프 RAG"는 AI에게 원시 그래프 엣지를 제공하고 하나씩 쿼리하게 합니다(예: 쿼리 1: 호출자 찾기 -> 쿼리 2: 어떤 파일? -> ... 4번의 쿼리 후). GitNexus는 답을 사전 계산합니다. AI에게 "UserService에 의존하는 것은 무엇인가?"라고 묻으면 도구는 단일 호출로 8명의 호출자, 3개의 클러스터, 신뢰 점수를 반환합니다. 이렇게 하면 답이 신뢰할 수 있고(토큰 비용이 많이 드는 다중 쿼리 체인 건너뛰기) 인덱서가 무거운 작업을 수행하므로 더 작고/저렴한 LLM도 더 잘 작동합니다.

주요 기능(19개의 MCP 도구 + 리소스)

impact: 폭발 반경 분석 — 심볼을 변경하면 깨질 모든 것을 나열합니다.
trace: 두 함수 사이의 최단 경로.
detect_changes: Git diff 영향 — 변경된 줄을 영향받는 프로세스에 매핑합니다.
rename: 의미론적 이름 변경(안전한 리팩토링), 드라이런 미리보기 포함.
explain / pdg_query: 프로그램 의존성 그래프(PDG) 분석으로 문 수준 흐름 및 오염/소스-싱크 경로 디버깅.
또한 query(하이브리드 의미+키워드 검색), route_map(API 엔드포인트), read_file / grep 같은 도구.

또한 에이전트 스킬(영향 분석, 디버깅, 리팩토링 등)을 생성하고 Claude Code, Codex 등용 후크를 설치하여 에이전트가 행동하기 전에 검색이 그래프 컨텍스트로 자동 강화되도록 합니다.

내부 구조

파싱: Tree-sitter(CLI는 네이티브, Web은 WASM). 많은 언어를 지원합니다. 일부(Kotlin, Dart, Proto, Swift)는 사전 빌드된 바이너리가 있는 벤더 그래머를 사용합니다.
저장소: LadybugDB(CLI용 빠른 네이티브 그래프 DB, 브라우저용 WASM).
임베딩: HuggingFace Transformers/ONNX를 통한 선택적 로컬 의미 검색(옵트인 설치).

대상 사용자

중대형 코드베이스에서 AI 코딩 어시스턴트를 사용하고 "AI가 환각으로 잘못된 편집을 했다"에 지쳤으며 도구에 더 깊은 구조적 컨텍스트를 원하는 엔지니어링 팀과 개인 개발자.

주의 사항 및 실용적인 메모

라이선스: PolyForm 비상업적(비상업적 사용은 무료이지만 상업적 사용에는 라이선스가 필요합니다).
설정 특이사항: 임베딩 기능에는 Node >= 22.15가 필요합니다. npm 11 사용자는 충돌이 발생할 수 있습니다. pnpm 또는 전역 설치를 권장합니다.
배포: Render에 원클릭 배포는 월 약 $35(서버 + 웹 인스턴스 + 디스크)입니다.
규모: CLI는 모든 크기의 전체 리포지토리를 처리합니다. 순수 브라우저 내 Web UI는 약 5k 파일로 제한됩니다(백엔드 브리지를 사용하지 않는 한).