코딩 에이전트가 코드 구조를 이해하게 만드는 로컬 인덱싱 도구
함수 호출 관계나 의존성을 직접 추적하지 않아도, 코딩 에이전트가 '이 함수를 누가 호출하는가' 같은 질문에 답할 수 있게 됩니다. GitNexus는 코드베이스를 심볼, 호출, 의존성, 실행 흐름으로 이루어진 지식 그래프로 인덱싱하는 도구입니다. 로컬에서 실행되며 서버 없이도 코드의 구조적 맥락을 파악할 수 있습니다.
로컬 인덱싱과 에이전트 연동
GitNexus는 Node.js 22.18 이상 또는 24.11 이상 환경에서 실행됩니다. npx gitnexus analyze 명령을 실행하면 현재 저장소의 인덱스를 생성하고, 에이전트 스킬을 설치하며, Claude Code 훅을 등록합니다. 이 과정에서 AGENTS.md와 CLAUDE.md 같은 컨텍스트 파일도 함께 작성됩니다. npx gitnexus setup을 실행하면 사용 중인 편집기에 MCP 설정을 자동으로 적용합니다. 인덱싱만 수행하고 저장소 통합 파일은 생성하지 않으려면 --index-only 옵션을 사용할 수 있습니다.
그래프 기반 코드 탐색 도구
인덱싱된 그래프를 통해 코드의 구조적 관계를 다양한 방식으로 조회할 수 있습니다.
- 구조적 조회 심볼의 호출 관계와 의존성을 그래프 기반으로 확인합니다.
- 영향 분석 코드 변경이 미치는 범위를 사전에 파악합니다.
- 경로 추적 두 코드 요소 사이의 실행 흐름을 추적합니다.
지원 언어와 편집기 통합
언어별 지원 범위는 구문 구조에 따라 다르며, 구체적인 측정 결과와 제외 항목은 언어 목록 문서를 참고해야 합니다. 편집기로는 Claude Code, Cursor, Codex, Antigravity, Factory Droid, OpenCode, CodeBuddy, Qoder를 자동 감지합니다. Windsurf는 수동 MCP 설정이 필요합니다.
웹 UI와 배포 옵션
gitnexus.vercel.app에서 백엔드에 연결해 저장소를 탐색하고 AI 채팅을 사용할 수 있습니다. 기존 인덱스를 재사용하므로 재업로드나 재인덱싱이 필요 없습니다. Docker나 호스팅 배포, 이미지 검증, 로컬 프론트엔드 설정은 배포 문서를 참고합니다. 여러 에이전트가 동시에 사용하려면 gitnexus mcp --http --port 3111로 단일 서버를 실행하고 클라이언트를 해당 주소에 연결하면 됩니다.
라이선스와 사용 전 확인 사항
GitNexus는 PolyForm Noncommercial 1.0.0 라이선스를 적용받습니다. 상업적 사용은 akonlabs.com을 통한 라이선스 구매가 필요합니다. 엔터프라이즈 버전은 SaaS 또는 셀프호스팅 형태로 제공되며, PR 리뷰 자동화, 코드 위키 자동 업데이트, 멀티 리포 지원, OCaml 지원 등이 포함됩니다. CLI는 로컬에서 코드를 인덱싱할 때 LLM을 사용하지 않지만, 원격 임베딩, 위키 생성, AI 채팅은 사용자가 설정한 프로바이더를 사용합니다. 인덱스를 다른 사용자에게 노출하기 전에 보안 가이드와 배포 인증을 검토해야 합니다.
