GitDiagram의 개요
GitDiagram은 Ahmed Khaleel이 만든 웹 앱이자 오픈소스 Next.js 프로젝트로, GitHub 저장소를 인터랙티브 아키텍처 다이어그램으로 바꿉니다. AI 모델이 저장소의 파일 트리, README, 최대 12개의 소스 파일을 읽고 짧은 개요를 쓴 뒤, 라벨이 붙은 연결로 묶인 최대 34개 구성 요소의 그래프를 돌려줍니다. 그래프를 Mermaid로 컴파일하기 전에 연결된 모든 경로를 실제 트리와 대조하며, 각 구성 요소를 누르면 GitHub의 해당 파일이나 폴더가 열립니다.
다이어그램은 저장되고 공유되므로, 누군가 이미 다이어그램을 만든 저장소는 즉시 열립니다. 사이트는 1분 안팎의 내레이션 설명 영상도 만들고, PNG나 Mermaid 소스로 내보내며, 저장된 모든 다이어그램의 Markdown 버전을 gitdiagram.com/owner/repo.md에서 제공하고, 무료 읽기 전용 원격 MCP 서버를 gitdiagram.com/mcp에서 운영합니다. 비공개 저장소는 읽기 전용 GitHub 토큰으로 쓸 수 있습니다.
저장소는 2024년 12월에 만들어졌고 MIT 라이선스이며, GitHub 스타 약 18,700개와 포크 1,430개를 기록하고 있습니다. 태그가 붙은 릴리스는 없고, 마지막 커밋은 2026년 10월 30일입니다.
GitDiagram, 쓸 만한 가치가 있습니까?
GitDiagram의 가치는 준비 단계가 전혀 없는 작업 흐름입니다. 클론도, 설치도, 대부분의 용도에서는 키도 필요 없고, 끝에는 공유 가능한 링크가 남습니다. 그 뒤의 파이프라인은 URL 트릭이 주는 인상보다 신중합니다. 아키텍처 문서에 따르면 낮은 추론 수준의 GPT-6 Luna 요청 하나가 개요와 엄격한 형식의 그래프 를 스트리밍합니다. 서버는 식별자, 연결성, 연결된 모든 경로를 실제 저장소와 대조하고, 잘못된 출력은 피드백과 함께 다시 시도하며, Mermaid는 모델이 아니라 결정론적 컴파일러가 씁니다. 브라우저는 SVG를 정제하고 GitHub로 가는 링크만 허용합니다. 그래서 그림이 정확하지 않을 때도 링크는 믿을 수 있습니다.
한계는 구조에 내장되어 있습니다. 모델은 트리의 일부 발췌, README, 최대 12개의 소스 파일만 보고, 구성 요소를 34개 넘게 그리지 않습니다. 작은 라이브러리에는 충분하지만, 서비스가 수십 개인 모노레포에서는 패키지 전체가 상자 하나로 합쳐지는 거친 그림이 나옵니다. 프로젝트의 자체 가이드도 이를 완전한 의존성 그래프가 아니라 중요한 부분의 지도라고 부릅니다. GitHub가 잘린 트리로 돌려주는 아주 큰 저장소도 부분 목록으로 다이어그램을 얻지만, 지나치게 큰 README는 바로 거부됩니다. 저장된 다이어그램은 당시의 저장소를 고정해 두므로, 새로 만들려면 Regenerate를 눌러야 합니다.
호스팅 사이트의 데이터 처리는 개인정보 처리방침에 분명하게 적혀 있습니다. 요청한 결과를 만들기 위해 저장소 내용이 OpenAI, Anthropic, OpenRouter로 전송됩니다. 비공개 저장소에는 Contents 읽기 전용 권한의 fine-grained 토큰이나, 선택한 저장소로 제한된 Continue with GitHub 로그인이 필요합니다. 토큰은 HttpOnly 쿠키에 최대 30일 동안 보관되고 서버에는 저장되지 않으며, 비공개 다이어그램은 별도의 네임스페이스에 있습니다. 사이트에서는 PostHog 세션 리플레이가 실행되며, 입력한 내용은 가려집니다. README와 Markdown 버전에는 유료 스폰서 자리가 있으며, 이 글을 쓰는 시점에는 CodeRabbit입니다.
영상은 비용이 많이 드는 부분이라 그에 맞게 배급됩니다. Claude Opus가 대본을 쓰고, Claude Haiku 5.5가 장면을 설계하고, OpenRouter를 거친 Gemini 3.8 Flash TTS가 읽고, whisper-1이 단어 타이밍을 맞춥니다. 기본 상한은 UTC 기준 하루에 브라우저당 새 영상 1편, 사이트 전체 25편이며, 그 이상은 한 편에 $3입니다. 채팅이 딸린 여러 페이지 위키를 쓰는 DeepWiki와 비교하면 GitDiagram은 더 좁은 질문에 더 빨리 답합니다. 비공개 코드나 커밋하지 않은 코드라면 자신의 체크아웃에서 돌리는 코딩 에이전트가 더 정확한 다이어그램을 그립니다.
제 역할을 하는 곳
오픈소스 작업 큐 라이브러리 세 개를 평가하는 백엔드 엔지니어
코드를 읽기 전에 각 라이브러리가 어떻게 짜여 있는지 보기
각 GitHub URL의 'hub'를 'diagram'으로 바꿉니다. 저장된 다이어그램은 바로 열리고 새 다이어그램은 1분 정도 걸립니다. 구성 요소를 누르면 해당 폴더로 이동합니다. 일일 한도 안에서는 무료이고, 그 이후에는 자신의 OpenAI 키로 비용을 냅니다.
낯선 의존성이 얽힌 작업에 Claude Code나 Codex를 쓰는 개발자
소스를 붙여 넣지 않고 에이전트에 의존성의 구조를 알려 주기
명령 하나로 원격 MCP 서버를 추가하고 에이전트에게 프로젝트 구조를 묻습니다. 에이전트는 저장된 개요, 구성 요소, 연결, Mermaid 소스를 읽습니다. 무료이며, 기본값으로 네트워크당 시간당 도구 호출 120회로 제한되고 공개 저장소만 됩니다.
직원 20명 규모 오픈소스 기업의 개발자 관계 책임자
프로젝트 README에 아키텍처 그림과 짧은 설명 영상 넣기
다이어그램을 PNG로 내보내거나 Mermaid 소스를 초안으로 복사해 다듬고, 설명 영상은 자막이 입혀진 가로형 또는 9:16 MP4로 내려받습니다. 무료 일일 할당량을 넘는 영상은 $3입니다.
도입 전 확인할 점
- 설정
- 호스팅: URL을 고치거나 홈페이지에 owner/repo를 붙여 넣습니다. 새 다이어그램은 1분 정도 걸립니다. 자체 호스팅: Bun 1.3.14와 Node 22에서 bun install을 실행하고, bun run dev 전에 .env에 Cloudflare R2 버킷, Upstash Redis, CACHE_KEY_SECRET, OpenAI 또는 OpenRouter 키를 채웁니다.
- 연동
- Claude, Claude Code, Codex, Cursor, VS Code, Gemini CLI, GitHub Copilot CLI, ChatGPT용 원격 MCP 서버(get_repository_diagram, find_repository_diagrams, get_explainer_video), /gitdiagram 스킬이 든 Claude Code 플러그인, /owner/repo.md의 Markdown, PNG와 Mermaid 내보내기.
- 데이터와 개인정보
- 공개 다이어그램과 영상은 그 저장소를 여는 누구에게나 공개됩니다. 저장소 내용은 OpenAI, Anthropic, OpenRouter로 전송됩니다. GitHub 토큰과 OpenAI 키는 브라우저의 HttpOnly 쿠키에 최대 30일 동안 남고 서버에는 저장되지 않습니다. 권장 토큰은 Contents 읽기 전용 권한의 fine-grained 토큰입니다. 사이트에서 PostHog 분석과 세션 리플레이가 실행됩니다. MIT 라이선스.
- 대규모 사용 시 비용
- 호스팅 사이트에는 구독이 없습니다. 자체 호스팅은 R2, Upstash, 다이어그램별 모델 토큰 비용을 냅니다. 프로젝트는 다이어그램당 비용을 공개하지 않지만, 앱이 실행 전마다 예상치를 보여 주며 선택 사항인 Fast 레인은 모델 가격을 두 배로 만듭니다. 영상에는 Anthropic, OpenAI, OpenRouter 호출과 헤드리스 Chromium 렌더링이 더해집니다.
- 제한
- 코드 기본값은 IP당 시간당 서버 부담 생성 8회(자체 키 사용자는 예외)와 모든 사용자의 생성 엔드포인트 호출 시간당 60회를 허용합니다. 생성 시간 예산은 300초입니다. 새 영상 만들기는 일일 상한이 있는 얼리 액세스 단계입니다. 열린 이슈와 풀 리퀘스트 약 55개, 태그가 붙은 릴리스 없음.
좋은 점
- URL만 고치면 되고 클론이나 설치가 필요 없음
- 연결된 모든 경로를 실제 저장소와 대조해 검증
- 결정론적 Mermaid 컴파일러와 GitHub 전용 링크 허용 목록
- 에이전트용 무료 읽기 전용 MCP 서버와 Markdown 버전
아쉬운 점
- 소스 파일 최대 12개, 구성 요소 최대 34개라 모노레포에서는 거침
- 저장된 다이어그램은 누군가 다시 만들 때까지 낡은 상태로 남음
- 자체 호스팅에는 Cloudflare R2, Upstash Redis, 모델 키가 필요
- README와 Markdown 출력에 스폰서 노출
추천 대상
누군가 코드를 열기 전에 낯선 GitHub 저장소를 가늠하려는 엔지니어, 그리고 공개 저장소의 구조를 빠르게 요약해야 하는 에이전트.
GitDiagram 대안
GitDiagram: 자주 묻는 질문
- GitDiagram, 쓸 만한 가치가 있습니까?
- GitDiagram은 URL을 고치는 시간 안에 낯선 저장소의 쓸 만한 첫 지도를 줍니다. 설계도가 아니라 스케치로 받아들인다면 말입니다. 평점은 5점 만점에 4.0점입니다.
- GitDiagram의 가격은 얼마입니까?
- 무료로 쓸 수 있는 오픈소스(MIT)입니다. 새 다이어그램은 일일 한도 안에서 무료이고, 그 이후에는 자신의 OpenAI API 키가 필요합니다. 무료 일일 할당량을 넘는 설명 영상은 한 편에 $3입니다.
- GitDiagram의 단점은 무엇입니까?
- 소스 파일 최대 12개, 구성 요소 최대 34개라 모노레포에서는 거침; 저장된 다이어그램은 누군가 다시 만들 때까지 낡은 상태로 남음; 자체 호스팅에는 Cloudflare R2, Upstash Redis, 모델 키가 필요; README와 Markdown 출력에 스폰서 노출.
- GitDiagram에 적합한 사람은 누구입니까?
- 누군가 코드를 열기 전에 낯선 GitHub 저장소를 가늠하려는 엔지니어, 그리고 공개 저장소의 구조를 빠르게 요약해야 하는 에이전트.
- 팀이나 프로덕션 환경에서 GitDiagram의 비용은 얼마입니까?
- 호스팅 사이트에는 구독이 없습니다. 자체 호스팅은 R2, Upstash, 다이어그램별 모델 토큰 비용을 냅니다. 프로젝트는 다이어그램당 비용을 공개하지 않지만, 앱이 실행 전마다 예상치를 보여 주며 선택 사항인 Fast 레인은 모델 가격을 두 배로 만듭니다. 영상에는 Anthropic, OpenAI, OpenRouter 호출과 헤드리스 Chromium 렌더링이 더해집니다.
- GitDiagram에 회사 데이터를 맡겨도 안전합니까?
- 공개 다이어그램과 영상은 그 저장소를 여는 누구에게나 공개됩니다. 저장소 내용은 OpenAI, Anthropic, OpenRouter로 전송됩니다. GitHub 토큰과 OpenAI 키는 브라우저의 HttpOnly 쿠키에 최대 30일 동안 남고 서버에는 저장되지 않습니다. 권장 토큰은 Contents 읽기 전용 권한의 fine-grained 토큰입니다. 사이트에서 PostHog 분석과 세션 리플레이가 실행됩니다. MIT 라이선스.
- GitDiagram의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 OpenWiki, Archify 및 Repomix입니다.
답변 확인일: 2026년 10월 31일.
GitDiagram 개발사입니까? 이 평점을 사이트에 표시하십시오
