Repomix 소개 및 사용법

출처: https://repomix.com/

개요

Repomix는 코드베이스 전체를 AI가 이해하기 쉬운 포맷(XML, 마크다운, 플레인 텍스트 등)으로 패킹해주는 오픈소스 도구입니다. 대규모 코드베이스를 LLM(예: ChatGPT, Claude, Gemini 등)에 입력하거나, 코드 리뷰·리팩터링·분석을 자동화할 때 유용하게 활용할 수 있습니다.

주요 특징

AI 최적화: 코드, 디렉터리 구조, 파일 요약 등을 AI가 쉽게 파싱할 수 있도록 변환
.gitignore 자동 인식: 불필요한 파일 자동 제외
보안 강화: Secretlint 내장, 민감 정보 포함 방지
토큰 카운팅: 각 파일 및 전체 리포지토리의 토큰 수 제공
다양한 출력 포맷: XML(기본), 마크다운, 플레인 텍스트 등
커스텀 설정: repomix.config.json 파일로 출력 옵션, 무시 패턴 등 세부 설정 가능

설치 및 사용법

1. 빠른 실행

설치 없이 바로 실행:

npx repomix

글로벌 설치:

npm install -g repomix
# 또는
yarn global add repomix
# 또는 (macOS/Linux)
brew install repomix

설치 후 프로젝트 디렉터리에서 실행:

repomix

2. 주요 옵션

특정 디렉터리만 패킹:
```
repomix path/to/directory
```
특정 파일/디렉터리만 포함:
```
repomix --include "src/**/*.ts,**/*.md"
```
특정 파일/디렉터리 제외:
```
repomix --ignore "**/*.log,tmp/"
```

원격 저장소 패킹:

npx repomix --remote https://github.com/사용자/저장소

3. 출력 포맷 지정

XML(기본):
```
repomix --style xml
```
마크다운:
```
repomix --style markdown
```
플레인 텍스트:
```
repomix --style plain
```

4. 고급 설정

repomix.config.json 예시:

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

5. Docker로 실행

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

활용 예시

코드베이스 전체를 하나의 파일로 패킹 후, LLM에게 전달해 리팩터링, 리뷰, 문서화 등 다양한 작업을 요청할 수 있습니다.
Claude의 Artifacts 등과 연동해 여러 파일을 동시에 생성·수정하는 것도 가능합니다.

참고 및 출처

공식 사이트: https://repomix.com/
GitHub: https://github.com/yamadashy/repomix

저작자표시 (새창열림)