---
layout: home
title: Repomix
description: "로컬 또는 원격 저장소를 Claude, ChatGPT, Gemini, MCP, 코드 리뷰 워크플로에 적합한 AI 친화적 XML, Markdown, JSON, 일반 텍스트로 패키징합니다."
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는 전체 코드베이스를 분석하고 포괄적인 인사이트를 제공할 것입니다:

![Repomix 사용 예시 1](/images/docs/repomix-file-usage-1.png)

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

![Repomix 사용 예시 2](/images/docs/repomix-file-usage-2.png)

즐거운 코딩 되세요! 🚀

## 왜 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>
