docs/GitNexus-Code-Intelligence-Server.md에서 배포한 서버의 웹 UI를 실제로 눌러보면서 뭘 할 수 있는지 정리한 기록. MCP 도구 레퍼런스는 docs/GitNexus-MCP-Tools-Reference.md 참고 — 이 문서는 사람이 브라우저로 직접 쓰는 법.

접속

http://k3s-master.taildcdcee.ts.net:30747

처음 한 번은 브라우저 콘솔에서 이걸 실행해야 한다(이유는 아래 "왜 이게 필요한가" 참고):

localStorage.setItem('gitnexus-backend-url', 'http://k3s-master.taildcdcee.ts.net:30747');

또는 이 URL로 한 번 들어가면 자동으로 저장된다:

http://k3s-master.taildcdcee.ts.net:30747/?server=http://k3s-master.taildcdcee.ts.net:30747

한 번만 하면 된다 — 그 브라우저에 영구 저장되니 다음부턴 그냥 기본 주소로 들어가면 된다(브라우저/프로필이 다르면 다시 해야 함).

왜 이게 필요한가

GitNexus 번들 UI는 페이지를 로드하면 **접속한 주소와 무관하게 항상 자기 자신의 localhost:4747**을 찾으려고 한다(원래는 npx gitnexus serve로 로컬에서 띄워서 같은 컴퓨터 브라우저로 보는 걸 전제로 설계된 UI라서 그렇다). 우리처럼 서버에 올려두고 다른 기기에서 접속하면 "Waiting for server to start"에서 멈춘다. localStorage에 실제 서버 주소를 넣어주면 이 자동 감지를 건너뛰고 바로 연결된다.

화면 구성

1. 레포 선택 화면

처음 들어가면 인덱싱된 레포 목록이 뜬다 — 지금은 4개(k3s-msa-infrastructure, target-tracking-service, threat-intel-ai-service, c4i-dashboard-frontend). 각 카드에 파일 수/심볼 수/flow 수와 마지막 인덱싱 시각이 보인다. 클릭하면 그 레포의 그래프 화면으로 들어간다.

2. 좌측 — Explorer / Filters

• Explorer: 파일 트리. 클릭하면 우측(또는 하단) Code Inspector에 실제 소스 코드가 뜬다.
  • ⚠️ 깊게 중첩된 파일(5단계 이상)은 가끔 안 열릴 수 있다 — 업스트림 버그, docs/GitNexus-Code-Intelligence-Server.md 15번 항목 참고. 안 열리면 새로고침 후 재시도.
• Filters: 그래프에 보일 노드 타입(Folder/File/Class/Function/Method/Variable 등)과 엣지 타입(Contains 등)을 체크박스로 켜고 끌 수 있다. 노드가 너무 많아서 복잡할 때 특정 종류만 남기고 싶을 때 유용.

3. 중앙 — 그래프

세 가지 레이아웃을 전환할 수 있다:

• Force Graph (기본) — 물리 시뮬레이션 기반 자유 배치, 전체 구조를 한눈에 보기 좋음
• Sequential Layout — 순서가 있는 흐름을 선형으로