Repomix

--- layout: home title: Repomix titleTemplate: 코드베이스를 AI 친화적인 형식으로 패키징 aside: false editLink: false features: - icon: 🤖 title: AI 최적화 details: 코드베이스를 AI가 이해하고 처리하기 쉬운 형식으로 변환합니다. - icon: ⚙️ title: Git 인식 details: .gitignore 파일을 자동으로 인식하고 처리합니다. - icon: 🛡️ title: 보안 중심 details: Secretlint를 통합하여 민감한 정보를 감지하고 보호합니다. - icon: 📊 title: 토큰 카운팅 details: LLM 컨텍스트 제한을 위한 파일별 및 전체 토큰 수를 제공합니다. --- <script setup> import YouTubeVideo from '../../components/YouTubeVideo.vue' import { VIDEO_IDS } from '../../utils/videos' </script> <div class="cli-section"> <br> <!--@include: ../shared/sponsors-section.md--> ## 🏆 오픈소스 어워드 후보 지명 영광입니다! Repomix가 [JSNation Open Source Awards 2025](https://osawards.com/javascript/)의 **Powered by AI** 카테고리에 후보로 지명되었습니다. 이는 Repomix를 사용하고 지원해 주신 여러분 모두 덕분입니다. 감사합니다! ## Repomix란 무엇인가요? Repomix는 전체 코드베이스를 하나의 AI 친화적 파일로 패키징하는 강력한 도구입니다. 코드 리뷰, 리팩터링 또는 프로젝트에 대한 AI 지원이 필요할 때, 전체 리포지토리 컨텍스트를 AI 도구와 쉽게 공유할 수 있습니다. <YouTubeVideo :videoId="VIDEO_IDS.REPOMIX_DEMO" /> ## 빠른 시작 Repomix를 사용하여 패키지 파일(`repomix-output.xml`)을 생성한 후, 다음과 같은 프롬프트와 함께 AI 어시스턴트(예: ChatGPT, Claude)에게 전송할 수 있습니다: ``` 이 파일은 저장소의 모든 파일을 하나로 통합한 것입니다. 코드를 리팩터링하고 싶으니 먼저 검토해 주세요. ``` AI는 전체 코드베이스를 분석하고 포괄적인 인사이트를 제공할 것입니다:  구체적인 변경 사항을 논의할 때는 AI가 코드 생성을 도와줍니다. Claude의 Artifacts와 같은 기능을 사용하면 상호 의존적인 여러 파일도 한 번에 받을 수 있습니다:  즐거운 코딩 되세요! 🚀 ## 왜 Repomix인가요? Repomix의 강점은 비용 걱정 없이 ChatGPT, Claude, Gemini, Grok 등의 구독 서비스와 함께 작동할 수 있는 능력에 있으며, 파일 탐색의 필요성을 제거하는 완전한 코드베이스 컨텍스트를 제공하여 분석을 더 빠르고 종종 더 정확하게 만듭니다. 전체 코드베이스가 컨텍스트로 사용 가능하므로, Repomix는 구현 계획, 버그 조사, 서드파티 라이브러리 보안 검사, 문서 생성 등을 포함한 광범위한 애플리케이션을 가능하게 합니다. ## CLI 도구 사용하기 {#using-the-cli-tool} Repomix는 강력한 기능과 사용자 정의 옵션을 제공하는 명령줄 도구로 사용할 수 있습니다. **CLI 도구는 프라이빗 저장소에 접근할 수 있습니다** 로컬에 설치된 Git을 사용하기 때문입니다. ### 빠른 시작 프로젝트 디렉토리에서 설치 없이 바로 Repomix를 시작할 수 있습니다: ```bash npx repomix@latest ``` 또는 반복 사용을 위해 전역 설치: ```bash # 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 친화적인 형식으로 정리된 전체 코드베이스가 포함됩니다. ### 사용법 전체 저장소를 패키징: ```bash repomix ``` 특정 디렉토리를 패키징: ```bash repomix path/to/directory ``` [glob 패턴](https://github.com/mrmlnc/fast-glob?tab=readme-ov-file#pattern-syntax)을 사용하여 특정 파일이나 디렉토리를 지정: ```bash repomix --include "src/**/*.ts,**/*.md" ``` 특정 파일이나 디렉토리 제외: ```bash repomix --ignore "**/*.log,tmp/" ``` 원격 저장소 처리: ```bash # 단축형 사용 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`) 초기화: ```bash repomix --init ``` 생성된 파일은 Claude, ChatGPT, Gemini와 같은 생성형 AI 도구와 함께 사용할 수 있습니다. #### Docker 사용법 Docker를 사용하여 Repomix를 실행할 수도 있습니다 🐳 격리된 환경에서 Repomix를 실행하거나 컨테이너를 선호하는 경우에 유용합니다. 기본 사용법(현재 디렉토리): ```bash docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix ``` 특정 디렉토리를 처리: ```bash docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix path/to/directory ``` 원격 저장소를 처리하고 `output` 디렉토리에 출력: ```bash docker run -v ./output:/app -it --rm ghcr.io/yamadashy/repomix --remote https://github.com/yamadashy/repomix ``` ### 출력 형식 선호하는 출력 형식을 선택하세요: ```bash # XML 형식(기본값) repomix --style xml # Markdown 형식 repomix --style markdown # JSON 형식 repomix --style json # 일반 텍스트 형식 repomix --style plain ``` ### 사용자 정의 `repomix.config.json`을 생성하여 지속적인 설정을 관리할 수 있습니다: ```json { "output": { "style": "markdown", "filePath": "custom-output.md", "removeComments": true, "showLineNumbers": true, "topFilesLength": 10 }, "ignore": { "customPatterns": ["*.test.ts", "docs/**"] } } ``` ## 실제 사용 사례 ### [LLM 코드 생성 워크플로우](https://harper.blog/2025/02/16/my-llm-codegen-workflow-atm/) 한 개발자가 기존 코드베이스에서 코드 컨텍스트를 추출하기 위해 Repomix를 사용하고, 그 컨텍스트를 Claude와 Aider 같은 LLM과 함께 활용하여 점진적 개선, 코드 리뷰, 자동화된 문서 생성을 수행하는 방법을 공유합니다. ### [LLM을 위한 지식 데이터팩 생성](https://lethain.com/competitive-advantage-author-llms/) 저자들이 자신의 글—블로그, 문서, 책—을 LLM 호환 형식으로 패키징하기 위해 Repomix를 사용하여, 독자들이 AI 기반 Q&A 시스템을 통해 그들의 전문 지식과 상호작용할 수 있도록 하고 있습니다. [더 많은 사용 사례 확인하기 →](./guide/use-cases) ## 파워 유저 가이드 Repomix는 고급 사용 사례를 위한 강력한 기능들을 제공합니다. 파워 유저를 위한 필수 가이드들을 소개합니다: - **[MCP 서버](./guide/mcp-server)** - AI 어시스턴트를 위한 Model Context Protocol 통합 - **[GitHub Actions](./guide/github-actions)** - CI/CD 워크플로우에서 코드베이스 패키징 자동화 - **[코드 압축](./guide/code-compress)** - Tree-sitter 기반 인텔리전트 압축 (~70% 토큰 감소) - **[라이브러리로 사용하기](./guide/development/using-repomix-as-a-library)** - Node.js 애플리케이션에 Repomix 통합 - **[커스텀 지시사항](./guide/custom-instructions)** - 출력에 커스텀 프롬프트와 지시사항 추가 - **[보안 기능](./guide/security)** - 내장된 Secretlint 통합 및 안전성 검사 - **[모범 사례](./guide/tips/best-practices)** - 검증된 전략으로 AI 워크플로우 최적화 ### 더 많은 예제 ::: tip 더 자세한 도움이 필요하신가요? 💡 자세한 사용법은 [가이드](./guide/)를 참조하시고, 더 많은 예제와 소스 코드는 [GitHub 저장소](https://github.com/yamadashy/repomix)에서 확인하실 수 있습니다. ::: </div>