프로젝트 소개
GitNexus(Akon Labs 제작)는 저장소를 쿼리 가능한 지식 그래프로 변환하는 코드 인텔리전스 엔진입니다. AI 에이전트에게 원시 그래프 엣지를 넘겨주고 충분히 탐색하길 기대하는 대신, 인덱스 시점에 클러스터링, 호출 체인 추적, 신뢰도 점수 계산 등 구조를 미리 계산하여 단일 도구 호출만으로 심볼, 해당 심볼의 의존 항목, 그리고 참여하는 실행 흐름에 대한 완전한 컨텍스트를 반환할 수 있습니다.
작동 방식
저장소 루트에서 `npx gitnexus analyze`를 실행하면 코드베이스를 인덱싱하고, 에이전트 스킬을 설치하며, 지원되는 편집기용 후크를 등록하고 AGENTS.md / CLAUDE.md 컨텍스트 파일을 생성합니다. `npx gitnexus setup`은 MCP 구성을 작성하여 Claude Code, Cursor, Codex, Antigravity, Windsurf, OpenCode, CodeBuddy, Qoder 같은 편집기가 그래프를 쿼리할 수 있게 합니다. 파싱은 Tree-sitter를 사용하며(CLI는 네이티브 바인딩, 브라우저는 WASM), 인덱스는 LadybugDB에 저장됩니다(CLI는 네이티브 영구 저장, 웹 UI는 인메모리 WASM).
두 가지 사용 모드
CLI + MCP 경로는 일상적인 개발을 위한 것입니다. 로컬에서 인덱싱한 다음 에이전트가 그래프를 쿼리하게 합니다. 웹 UI(gitnexus.vercel.app에서 호스팅되거나 자체 호스팅)는 비주얼 그래프 탐색기와 AI 채팅을 제공하며, 백엔드를 사용하지 않으면 브라우저 메모리로 제한됩니다. 브리지 모드인 `gitnexus serve`는 웹 UI가 로컬 서버를 감지하여 재업로드나 재인덱싱 없이 CLI로 인덱싱된 저장소를 탐색할 수 있게 합니다.
MCP 도구
17개의 MCP 도구가 노출됩니다(저장소별 15개 + 그룹 수준 2개). 여기에는 `query`(하이브리드 BM25 + 시맨틱 + RRF 검색), `context`(360도 심볼 뷰), `impact`(블래스트 반경 분석), `trace`(심볼 간 최단 방향 경로), `detect_changes`(git-diff 영향 매핑), `rename`, 원시 그래프 쿼리용 `cypher`, 그리고 라우트/도구/형태/API 영향 헬퍼와 PDG 기반 `explain` 및 `pdg_query`(오염 및 문(statement) 수준 의존성 분석)가 포함됩니다. 함께 제공되는 MCP 리소스는 저장소 목록, 클러스터, 프로세스, 스키마, 그룹 계약을 제공하며, 두 개의 프롬프트(`detect_impact`, `generate_map`)는 커밋 전 분석과 아키텍처 문서화를 안내합니다.
에이전트 스킬 및 워크플로
스킬은 `.claude/skills/`에 설치되며, `.agents/skills/`가 있으면 해당 위치에도 미러링됩니다. 탐색, 디버깅, 영향 분석, 리팩토링, CLI 사용법, PDG 쿼리, 오염 분석을 다룹니다. 슬래시 커맨드 스타일 워크플로에는 plan, work, review와 전체 plan→work→review 파이프라인이 포함됩니다. `--skills`를 사용하면 Leiden 커뮤니티 탐지가 기능 영역을 식별하고, 각 영역의 프로젝트 스킬을 생성하여 주요 파일, 진입점, 영역 간 연결을 설명합니다.
배포 및 운영
Render(토큰 기반 인증을 사용하는 프라이빗 서버 서비스와 퍼블릭 웹 서비스) 및 RepoCloud용 원클릭 배포 청사진이 있습니다. README에는 npm 11 관련 설치 주의사항, 선택적 Tree-sitter 문법, 프록시 제한 환경, 임베딩 런타임 다운로드, 그리고 읽기 전용 MCP 모드와 에이전트가 접근할 수 있는 저장소를 제한하는 허용 저장소 정책이 문서화되어 있습니다. 라이선스는 PolyForm Noncommercial이며, 벤더가 상용 SaaS/자체 호스팅을 제공합니다.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.