Gitingest로 GitHub 저장소를 AI가 읽는 텍스트 한 파일로 만들기

KAITABASE가 공식 문서와 원문을 직접 읽고 새로 쓴 가이드입니다.

이 가이드로 할 수 있는 것

Gitingest는 Git 저장소나 내 컴퓨터의 폴더를 "AI 프롬프트에 넣기 좋은 텍스트"로 바꾸는 도구입니다. 결과 파일 맨 앞에는 폴더 구조 그림이, 뒤에는 파일마다 구분선과 내용이 붙고, 실행하면 대략의 토큰 수도 알려 줍니다. 저장소를 하나하나 열어 복사하지 않아도 AI에게 "이 프로젝트가 뭘 하는지"를 물을 수 있습니다.

2026-10-22에 Windows 11에서 직접 설치해 공개 저장소의 하위 폴더 하나를 변환해 봤고, 그 출력을 그대로 옮겼습니다.

빠른 시작

설치 없이 쓰려면 GitHub 주소에서 hub 를 ingest 로 바꿉니다(README 안내).

https://github.com/microsoft/markitdown
→ https://gitingest.com/microsoft/markitdown

터미널에서 쓰려면 다음과 같습니다(Windows PowerShell 기준).

python -m venv .venv
.\.venv\Scripts\python -m pip install gitingest
.\.venv\Scripts\gitingest https://github.com/microsoft/markitdown/tree/main/packages/markitdown-mcp -o digest.txt

성공하면 마지막에 이런 요약이 나옵니다(실제 출력).

123456789Analysis complete! Output written to: digest.txt

Summary:
Repository: microsoft/markitdown
Commit: 21d9c1d01ecc12538dab19811fd247ef2f96ef60
Subpath: /packages/markitdown-mcp
Files analyzed: 11

Estimated tokens: 8.4k

STEP 1. 웹에서 먼저 써 보기

목표: 설치 없이 결과물이 어떻게 생겼는지 봅니다. · 예상 시간: 2분

1. 보고 싶은 저장소 주소를 엽니다. 예: https://github.com/microsoft/markitdown
2. 주소창에서 github.com 의 hub 를 ingest 로 바꿔 gitingest.com/microsoft/markitdown 으로 이동합니다.
3. 화면에 나온 요약 · 폴더 구조 · 파일 내용을 복사하거나 내려받습니다.

확인 2026-10-22에 https://gitingest.com/microsoft/markitdown 은 정상(HTTP 200)으로 열렸습니다.

막히면 비공개 저장소는 웹 주소 바꾸기로 열리지 않습니다. STEP 5의 토큰 방식을 씁니다. 회사 코드라면 외부 웹 서비스에 넣어도 되는지 먼저 확인합니다.

STEP 2. CLI 설치하기

목표: 내 컴퓨터에서 직접 변환할 수 있게 합니다. · 예상 시간: 3분

README의 요구 사항은 Python 3.8 이상입니다. 저장소를 내려받을 때 내부적으로 git clone 을 쓰므로 git도 있어야 합니다.

12345python --version
git --version
python -m venv .venv
.\.venv\Scripts\python -m pip install gitingest
.\.venv\Scripts\gitingest --help

README는 여러 프로젝트에서 쓸 거라면 pipx install gitingest 도 권합니다.

확인 --help 를 치면 -s/--max-size, -e/--exclude-pattern, -i/--include-pattern, -b/--branch, --include-gitignored, --include-submodules, -t/--token, -o/--output 옵션 목록이 나옵니다.

되돌리기 가상환경 폴더 .venv 를 지우면 끝입니다.

STEP 3. 저장소 · 하위 폴더 변환하기

목표: 필요한 부분만 텍스트로 묶습니다. · 예상 시간: 2분

저장소 전체 대신 하위 폴더 주소(/tree/<브랜치>/<경로>)를 넣으면 그 폴더만 변환합니다. 큰 저장소일수록 토큰을 아끼는 가장 쉬운 방법입니다.

.\.venv\Scripts\gitingest https://github.com/microsoft/markitdown/tree/main/packages/markitdown-mcp -o mcp_digest.txt

결과 파일 앞부분(실제 출력):

123456789101112131415161718Directory structure:
└── markitdown-mcp/
    ├── README.md
    ├── Dockerfile
    ├── pyproject.toml
    ├── src/
    │   └── markitdown_mcp/
    │       ├── __about__.py
    │       ├── __init__.py
    │       ├── __main__.py
    │       └── py.typed
    └── tests/
        ├── __init__.py
        ...

================================================
FILE: packages/markitdown-mcp/README.md
================================================

이번 실행은 약 16초 걸렸고, 파일 11개 · 약 8.4k 토큰이었습니다. -o 를 빼면 현재 폴더에 digest.txt 로 저장되고, -o - 를 주면 화면(표준 출력)으로 내보냅니다.

확인 요약의 Estimated tokens 가 쓰려는 AI의 입력 한도보다 충분히 작은지 봅니다.

막히면 실행 중 회색 로그가 많이 찍히는 것은 정상입니다. 마지막 Analysis complete! 가 나오면 성공입니다. 내려받은 저장소는 운영체제 임시 폴더 아래 gitingest 폴더에 잠시 만들어집니다.

STEP 4. 필요한 파일만 고르기 (필터)

목표: 테스트 · 빌드 산출물 같은 군더더기를 빼서 토큰을 줄입니다. · 예상 시간: 3분

1234## 파이썬 파일만
.\.venv\Scripts\gitingest . -i "*.py" -o -
## 특정 폴더 빼기
.\.venv\Scripts\gitingest . -e "node_modules" -e "dist" -o digest.txt

기본값으로 .gitignore 에 적힌 파일은 빠지고, 파일 하나가 10MB(10485760 바이트)를 넘으면 건너뜁니다. 이미지 · 엑셀 같은 이진 파일은 내용 대신 [Binary file] 로만 표시됩니다(실제 확인).

막히면 Windows에서 -e ".venv/*" 처럼 와일드카드를 넣었더니 Error: Got unexpected extra arguments (.venv\Lib .venv\pyvenv.cfg .venv\Scripts) 가 나왔습니다. 패턴이 실제 파일 이름으로 먼저 펼쳐진 것입니다. 이때는 -e ".venv" 처럼 폴더 이름만 쓰면 정상 동작했습니다(직접 확인).

STEP 5. 비공개 저장소 변환하기

목표: 내 비공개 저장소를 토큰으로 읽습니다. · 예상 시간: 5분 · 공식 문서 기준(직접 실행 안 함)

1. GitHub의 Personal access tokens 설정(https://github.com/settings/personal-access-tokens)에서 토큰을 만듭니다. 읽기 권한만, 필요한 저장소만 고릅니다.
2. 명령에 직접 쓰지 말고 환경 변수로 넘깁니다.

$env:GITHUB_TOKEN = "github_pat_..."
.\.venv\Scripts\gitingest https://github.com/내계정/비공개저장소 -o digest.txt
Remove-Item Env:GITHUB_TOKEN

README는 --token 옵션도 안내하지만, 명령 기록(히스토리)에 토큰이 남으므로 환경 변수 쪽이 낫습니다.

되돌리기 다 쓴 토큰은 GitHub 설정에서 바로 폐기(Revoke)합니다.

STEP 6. 구조도가 필요하면 GitDiagram

목표: 텍스트 대신 구조 그림으로 먼저 훑어봅니다. · 예상 시간: 2분

GitDiagram README는 주소의 hub 를 diagram 으로 바꾸면 구조도를 볼 수 있고, gitdiagram.com/<owner>/<repo>.md 로 AI가 읽기 좋은 마크다운판을 준다고 안내합니다.

https://gitdiagram.com/microsoft/markitdown
https://gitdiagram.com/microsoft/markitdown.md

.md 주소를 직접 열어 보니 # microsoft/markitdown architecture 제목, 개요, Mermaid 구조도 코드가 들어 있었고, "AI가 만든 개요이니 세부는 소스와 대조하라"는 안내가 붙어 있었습니다.

확인 구조도는 AI가 파일 트리 · README · 일부 소스로 만든 것입니다. 중요한 판단 전에는 Gitingest 결과나 실제 코드로 다시 확인합니다.

잘못 쓰는 예 · 바르게 쓰는 예

바로 쓰는 프롬프트 · 템플릿

12345678아래는 Gitingest로 만든 저장소 텍스트입니다. 맨 앞에 폴더 구조, 뒤에 파일 내용이 있습니다.
1) 이 프로젝트가 하는 일을 세 문장으로 설명해 주세요.
2) 실행 진입점 파일과 핵심 모듈을 경로와 함께 표로 정리해 주세요.
3) 처음 기여하려는 사람이 먼저 읽을 파일 3개를 순서대로 추천해 주세요.
근거로 쓴 파일 경로를 답마다 붙여 주세요. 텍스트에 없는 내용은 추측하지 말고 "확인 필요"로 적어 주세요.

---
(digest.txt 내용 붙여 넣기)

주의할 점

• 토큰 · 요금: Gitingest의 토큰 수는 추정치입니다. AI 서비스마다 세는 방식이 달라 실제 사용량은 다를 수 있습니다.
• 보안: 비공개 저장소 토큰은 읽기 전용 · 필요한 저장소만으로 만들고, 다 쓰면 폐기합니다. 결과 파일 안에 .env 같은 비밀 파일이 섞이지 않았는지 확인합니다(.gitignore 에 없으면 포함될 수 있습니다).
• 외부 서비스: gitingest.com · gitdiagram.com 은 외부 웹 서비스입니다. 회사 코드를 넣기 전에 사내 규정을 확인합니다.
• 라이선스: 두 저장소 모두 MIT입니다. 변환한 남의 저장소 코드는 원래 저장소의 라이선스를 따릅니다.

공식 자료

• Gitingest 저장소 README — https://github.com/coderamp-labs/gitingest
• PyPI gitingest — https://pypi.org/project/gitingest/
• GitDiagram 저장소 README — https://github.com/ahmedkhaleel2004/gitdiagram
• GitHub 개인 액세스 토큰 설정 — https://github.com/settings/personal-access-tokens

더 보기

이 가이드는 KAITABASE가 공식 문서와 원문을 직접 읽고 실행해 본 뒤 새로 쓴 자료입니다. 같은 주제의 다른 글은 KAITABASE에서 이어서 볼 수 있습니다.

• 지식 · 검색 자료 모음 — https://kaitabase.vercel.app/?area=knowledge
• KAITABASE 전체 자료 — https://kaitabase.vercel.app