Repomix

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

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

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

Repomix가 AI 도구를 위한 코드베이스 분석이나 패키징에 도움이 되었다면, Powered by AI 카테고리에서 저희에게 투표해 주시면 감사하겠습니다.

여기서 투표하실 수 있습니다: https://forms.gle/5QaYBM6pNoyWLfL2A

여러분의 지원에 감사드립니다!

빠른 시작 ​

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

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

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

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

즐거운 코딩 되세요! 🚀

CLI 도구 사용하기 ​

Repomix는 강력한 기능과 사용자 정의 옵션을 제공하는 명령줄 도구로 사용할 수 있습니다.

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

빠른 시작 ​

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

npx repomix

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

# 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

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

사용자 정의 ​

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

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

더 많은 예제 ​