Repomix

^{Special thanks to:}

Warp, built for coding with multiple AI agents
Available for MacOS, Linux, & Windows

CodeRabbit | AI Code Reviews
Cut code review time & bugs in half, instantly.

Please consider sponsoring me.

🏆 오픈소스 어워드 후보 지명 ​

영광입니다! Repomix가 JSNation Open Source Awards 2025의 Powered by AI 카테고리에 후보로 지명되었습니다.

이는 Repomix를 사용하고 지원해 주신 여러분 모두 덕분입니다. 감사합니다!

Repomix란 무엇인가요? ​

Repomix는 전체 코드베이스를 하나의 AI 친화적 파일로 패키징하는 강력한 도구입니다. 코드 리뷰, 리팩터링 또는 프로젝트에 대한 AI 지원이 필요할 때, 전체 리포지토리 컨텍스트를 AI 도구와 쉽게 공유할 수 있습니다.

빠른 시작 ​

Repomix를 사용하여 패키지 파일(repomix-output.xml)을 생성한 후, 다음과 같은 프롬프트와 함께 AI 어시스턴트(예: ChatGPT, Claude)에게 전송할 수 있습니다:

이 파일은 저장소의 모든 파일을 하나로 통합한 것입니다.
코드를 리팩터링하고 싶으니 먼저 검토해 주세요.

AI는 전체 코드베이스를 분석하고 포괄적인 인사이트를 제공할 것입니다:

구체적인 변경 사항을 논의할 때는 AI가 코드 생성을 도와줍니다. Claude의 Artifacts와 같은 기능을 사용하면 상호 의존적인 여러 파일도 한 번에 받을 수 있습니다:

즐거운 코딩 되세요! 🚀

왜 Repomix인가요? ​

Repomix는 ChatGPT, Claude, Gemini, Grok 등 원하는 구독 서비스와 자유롭게 사용할 수 있어 추가 비용 걱정이 없습니다. 코드베이스 전체를 컨텍스트로 제공하기 때문에 파일을 일일이 탐색할 필요 없이, 더 빠르고 정확한 분석이 가능합니다.

코드베이스 전체를 컨텍스트로 활용하면 구현 계획 수립, 버그 조사, 서드파티 라이브러리 보안 점검, 문서 생성 등 다양한 작업에 Repomix를 활용할 수 있습니다.

CLI 도구 사용하기 ​

Repomix는 다양한 기능과 커스터마이징 옵션을 제공하는 명령줄 도구로 사용할 수 있습니다.

CLI 도구는 로컬에 설치된 Git을 사용하므로 프라이빗 저장소에도 접근할 수 있습니다.

빠른 시작 ​

프로젝트 디렉토리에서 설치 없이 바로 Repomix를 시작할 수 있습니다:

npx repomix@latest

또는 반복 사용을 위해 전역 설치:

# npm으로 설치
npm install -g repomix

# 또는 yarn으로 설치
yarn global add repomix

# 또는 bun으로 설치
bun add -g repomix

# 또는 Homebrew로 설치 (macOS/Linux)
brew install repomix

# 그런 다음 아무 프로젝트 디렉토리에서 실행
repomix

이게 전부입니다! Repomix가 현재 디렉토리에 repomix-output.xml 파일을 생성하며, 이 파일에는 AI 친화적인 형식으로 정리된 전체 코드베이스가 포함됩니다.

사용법 ​

전체 저장소를 패키징:

repomix

특정 디렉토리를 패키징:

repomix path/to/directory

glob 패턴을 사용하여 특정 파일이나 디렉토리를 지정:

repomix --include "src/**/*.ts,**/*.md"

특정 파일이나 디렉토리 제외:

repomix --ignore "**/*.log,tmp/"

원격 저장소 처리:

# 단축형 사용
npx repomix --remote yamadashy/repomix

# 전체 URL 사용 (브랜치 및 특정 경로 지원)
npx repomix --remote https://github.com/yamadashy/repomix
npx repomix --remote https://github.com/yamadashy/repomix/tree/main

# 커밋 URL 사용
npx repomix --remote https://github.com/yamadashy/repomix/commit/836abcd7335137228ad77feb28655d85712680f1

새 설정 파일(repomix.config.json) 초기화:

repomix --init

생성된 파일은 Claude, ChatGPT, Gemini와 같은 생성형 AI 도구와 함께 사용할 수 있습니다.

Docker 사용법 ​

Docker를 사용하여 Repomix를 실행할 수도 있습니다 🐳
격리된 환경에서 Repomix를 실행하거나 컨테이너를 선호하는 경우에 유용합니다.

기본 사용법(현재 디렉토리):

docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix

특정 디렉토리를 처리:

docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix path/to/directory

원격 저장소를 처리하고 output 디렉토리에 출력:

docker run -v ./output:/app -it --rm ghcr.io/yamadashy/repomix --remote https://github.com/yamadashy/repomix

출력 형식 ​

선호하는 출력 형식을 선택하세요:

# XML 형식(기본값)
repomix --style xml

# Markdown 형식
repomix --style markdown

# JSON 형식
repomix --style json

# 일반 텍스트 형식
repomix --style plain

사용자 정의 ​

repomix.config.json을 생성하여 지속적인 설정을 관리할 수 있습니다:

{
  "output": {
    "style": "markdown",
    "filePath": "custom-output.md",
    "removeComments": true,
    "showLineNumbers": true,
    "topFilesLength": 10
  },
  "ignore": {
    "customPatterns": ["*.test.ts", "docs/**"]
  }
}

실제 사용 사례 ​

LLM 코드 생성 워크플로우 ​

한 개발자가 기존 코드베이스에서 코드 컨텍스트를 추출하기 위해 Repomix를 사용하고, 그 컨텍스트를 Claude와 Aider 같은 LLM과 함께 활용하여 점진적 개선, 코드 리뷰, 자동화된 문서 생성을 수행하는 방법을 공유합니다.

LLM을 위한 지식 데이터팩 생성 ​

저자들이 자신의 글—블로그, 문서, 책—을 LLM 호환 형식으로 패키징하기 위해 Repomix를 사용하여, 독자들이 AI 기반 Q&A 시스템을 통해 그들의 전문 지식과 상호작용할 수 있도록 하고 있습니다.

더 많은 사용 사례 확인하기 →

파워 유저 가이드 ​

Repomix는 고급 사용 사례를 위한 강력한 기능들을 제공합니다. 파워 유저를 위한 필수 가이드들을 소개합니다:

• MCP 서버 - AI 어시스턴트를 위한 Model Context Protocol 통합
• GitHub Actions - CI/CD 워크플로우에서 코드베이스 패키징 자동화
• 코드 압축 - Tree-sitter 기반 인텔리전트 압축 (~70% 토큰 감소)
• 라이브러리로 사용하기 - Node.js 애플리케이션에 Repomix 통합
• 커스텀 지시사항 - 출력에 커스텀 프롬프트와 지시사항 추가
• 보안 기능 - 내장된 Secretlint 통합 및 안전성 검사
• 모범 사례 - 검증된 전략으로 AI 워크플로우 최적화

더 많은 예제 ​