유용한 도구:
GitReverse: https://t.co/186qNlvvEu
GitDiagram: https://t.co/Q2viLlksjP
Gitingest: https://t.co/U9sDV86OXr
ExplainGitHub: https://t.co/smKGoUYr1T
저는 2,976개 파일로 구성된 저장소에서 이 네 가지 도구를 모두 테스트했습니다.
목표는 간단했습니다. 수백 개의 파일을 수동으로 열거나 전체 저장소를 AI 도구에 덤프하지 않고 대규모 코드베이스를 이해하는 것이었습니다.
제가 발견한 내용은 다음과 같습니다.
GitReverse: 프로젝트 이해하기
→ GitHub URL에서 hub를 reverse로 변경합니다.
→ 로그인할 필요 없이 134단어 분량의 프롬프트를 생성합니다.
→ 프로젝트에 대한 높은 수준의 설명을 제공합니다.
→ 하지만 FastAPI의 핵심 의존성 중 하나인 Starlette을 놓쳤습니다.
최적의 용도: 코드를 탐색하기 전에 빠른 개요를 얻는 것.
GitDiagram: 아키텍처 시각화
→ GitHub URL에서 hub를 diagram으로 변경합니다.
→ 저장소 구조를 인터랙티브 다이어그램으로 변환합니다.
→ 저는 세 개의 클릭 가능한 섹션을 테스트했고, 모두 올바른 파일을 열었습니다.
→ 로그인이나 API 키가 필요하지 않습니다.
최적의 용도: 프로젝트의 여러 부분이 어떻게 연결되는지 이해하는 것.
Gitingest: AI와 함께 코드 탐색하기
→ GitHub URL에서 hub를 ingest로 변경합니다.
→ 저장소 내용을 AI 친화적인 텍스트 형식으로 변환합니다.
→ /tree/[branch]/[folder]를 사용하여 특정 폴더를 지정할 수 있습니다.
한 가지 중요한 점: 저장소가 크다면 전체 저장소를 인제스트하지 마세요.
제 FastAPI 테스트에서:
❌ 전체 저장소: 3.0M 토큰
✓ 선택된 단일 폴더: 62.4K 토큰
이는 약 48배 적은 토큰 수입니다.
또 다른 제한 사항이 있습니다.
Gitingest는 기본 파일 크기 제한이 50 KB입니다.
FastAPI의 https://t.co/Pu9Z0pXr9d는 약 260 KB이므로, 생성된 출력에서 누락되었습니다.
웹사이트 슬라이더를 변경해도 해결되지 않았습니다.
CLI(Command Line Interface) 우회 방법:
uvx gitingest [폴더 URL] -s 500000
최적의 용도: 관련 코드를 Claude나 다른 AI 어시스턴트에게 공급하는 것.
ExplainGitHub: 코드에 대해 질문하기
→ URL에 github 앞에 explain을 추가하세요.
→ 저장소 코드를 이해하고 상호작용하도록 설계되었습니다.
→ 제 테스트에서는 로그인 요구 사항이 발생했습니다.
→ 유료 패스는 일회성 구매로 각각 9달러와 29달러가 책정되어 있었습니다.
최적 용도: 코드베이스에 대한 대화형 탐색(Conversational exploration).
제가 추천하는 워크플로우 (MY RECOMMENDED WORKFLOW)
전체 저장소를 AI 모델에 한 번에 입력하며 시작하지 마세요.
다음 순서를 사용하세요:
GitReverse → 프로젝트가 무엇을 하는지 이해합니다.
GitDiagram → 아키텍처가 어떻게 연결되어 있는지 시각화합니다.
Gitingest → 관련 폴더만 추출합니다.
ExplainGitHub → 질문을 통해 코드를 탐색합니다.
이 실험에서 얻은 가장 큰 교훈:
3백만 토큰짜리 저장소라고 해서 반드시 3백만 토큰짜리 프롬프트가 될 필요는 없습니다.
아키텍처부터 시작하여 관련 모듈을 식별하고, 그 후에 코드를 검사하세요.
참고: 이 결과는 범용 벤치마크가 아닌, 제가 하나의 저장소에서 테스트한 결과입니다.
다음에 생소한 코드베이스를 탐색할 때 이 도구들을 아껴두세요.