Repomix의 개요
Repomix는 코드베이스를 채팅 모델에 붙여 넣거나 에이전트에 넘길 수 있는 파일 하나로 바꿉니다. 저장소를 훑고, .gitignore를 따르며, 모든 파일과 디렉터리 트리를 XML, Markdown, JSON, 일반 텍스트 출력 하나에 쓰고, 파일별과 저장소 전체의 토큰 수를 표시합니다.
CLI(npx, npm, Homebrew, Docker, Node.js 22 이상), GitHub URL을 붙여 넣거나 zip을 올리는 웹 페이지, Chrome 확장, Node.js 라이브러리, GitHub Action, MCP 서버로 돕니다. Kazuki Yamada가 후원금으로 MIT 라이선스하에 관리합니다.
Repomix, 쓸 만한 가치가 있습니까?
Repomix는 저장소를 단일 프롬프트로 바꾸는 표준 방법이며, 설치 전에 읽어야 할 것은 2026년의 보안 이력입니다. 프로젝트의 스타는 약 29,000개이고 2026년 9월 21일 v1.18.1을 냈습니다. 그 릴리스는 조작된 .git 폴더가 있는 디렉터리를 묶으면 git config 도우미가 실행될 수 있던 높은 심각도 권고를 고쳤고, 2026년 5월 권고는 --remote-branch를 통한 명령 인젝션을 고쳤습니다. 둘 다 패치됐지만, 신뢰할 수 없는 저장소에 패커를 겨누는 것이 중립적인 행위가 아님을 보여 줍니다.
그 밖의 방어 기능은 사려 깊습니다. Secretlint가 알려진 자격 증명 형식과 일치하는 파일을 출력에 닿기 전에 뺍니다. 원격 저장소 안의 설정 파일은 --remote-trust-config를 주지 않으면 무시됩니다. MCP 서버에는 파일 도구를 디렉터리 하나로 가두는 --sandbox 플래그가 있지만, 2026년 8월 권고는 이전의 MCP 보호가 주장만 되고 구현되지 않았음을 발견했습니다.
무엇이 들어갈지를 바꾸는 기능은 Tree-sitter 압축입니다. import, 클래스, 시그니처를 남기고 함수 본문을 빼며, 사이트는 토큰이 약 70% 줄어든다고 말합니다. glob별 패턴으로 묻는 파일은 전체 소스를 유지하고 나머지는 압축할 수 있으며, 모든 것을 압축하는 것보다 나은 절충입니다.
한계는 접근 방식 자체입니다. 압축해도 큰 모노레포는 들어가지 않고, Claude Code나 Codex 같은 에이전트는 이미 필요할 때 파일을 읽으므로, 덤프는 그들이 더 잘하는 일을 중복합니다. 큰 저장소에는 grepai 같은 검색 도구나 회사 규모라면 Sourcegraph가 맞습니다. 에이전트가 아니라 채팅 창이 읽는 경우라면 Repomix가 여전히 가장 빠른 길입니다.
제 역할을 하는 곳
브라우저에서 Claude나 ChatGPT를 쓰는 프리랜서 개발자
15,000줄짜리 사이드 프로젝트를 대화 하나로 리뷰받기
`npx repomix --compress`를 실행하고, 토큰 수를 모델의 창과 비교한 뒤 XML을 붙여 넣습니다. 무료이고 1분이 안 걸리며, Secretlint가 흩어진 .env가 채팅에 들어가는 것을 막습니다.
엔지니어 200명 규모 회사의 플랫폼팀
사내 도우미에 서비스 저장소마다 야간 스냅숏 주기
GitHub Action이 --split-output으로 각 저장소를 도우미가 불러올 수 있는 덩어리로 묶습니다. 라이선스 비용은 없습니다. 위험은 스냅숏이 낡는 것이며, 회사 밖의 저장소는 샌드박스에서 묶어야 합니다.
계약자를 온보딩하는 엔지니어링 매니저
저장소 접근 권한을 주지 않고 아키텍처 개요 넘기기
압축으로 묶어 출력이 구현이 아니라 모듈, 클래스, 시그니처만 보이게 하고 파일을 공유합니다. 비용이 없고 전체 클론보다 코드를 덜 노출하지만, 여전히 소스입니다.
도입 전 확인할 점
- 설정
- 저장소에서 `npx repomix@latest`를 실행하면 몇 초 만에 repomix-output.xml을 씁니다. Node.js 22+가 필요합니다. Homebrew, Docker, repomix.com 웹사이트는 Node 설치가 필요 없습니다.
- 연동
- XML, Markdown, JSON, 일반 텍스트 출력. 모든 GitHub URL, 브랜치, 커밋용 --remote. MCP 서버로 실행하는 --mcp. Node.js 라이브러리, GitHub Action, Chrome 확장.
- 데이터와 개인정보
- 개인정보 처리방침에 따르면 CLI는 텔레메트리를 수집하지 않고 --remote와 설치 때만 온라인에 접속합니다. 웹사이트는 처리 후 업로드를 삭제하며 Google Analytics를 씁니다. 2026년 GitHub 보안 권고 다섯 건이 있었고, 최신 건은 v1.18.1에서 수정됐습니다.
- 대규모 사용 시 비용
- 유료 에디션은 없습니다. 실제 비용은 모델 토큰입니다. 묶은 저장소는 프롬프트마다 통째로 보내지므로, 압축과 포함/무시 패턴이 지출을 억제합니다.
- 제한
- 고정된 크기 제한은 없지만 메모리와 모델의 컨텍스트 창이 상한. 웹사이트는 작은 공개 저장소용. watch 모드는 --remote나 --split-output과 함께 쓸 수 없음.
좋은 점
- Secretlint 검사로 자격 증명처럼 보이는 파일 제외
- 사이트 기준 토큰 약 70% 감소의 Tree-sitter 압축
- 원격 저장소 설정은 기본적으로 신뢰하지 않음
- CLI, 웹, 확장, 라이브러리, GitHub Action, MCP 서버
아쉬운 점
- 2026년 보안 권고 다섯 건, 그중 두 건이 높음
- 저장소 전체 덤프는 큰 코드베이스로 확장되지 않음
- 압축 출력은 모델에 필요할 수 있는 함수 본문을 뺌
- 에이전트가 이미 파일을 직접 읽는다면 중복
추천 대상
작거나 중간 크기의 저장소를 파일 하나로 채팅 모델에 넘기고 싶은 개발자.
Repomix 대안
Repomix: 자주 묻는 질문
- Repomix, 쓸 만한 가치가 있습니까?
- Repomix는 작은 저장소를 프롬프트 하나에 묶는 일을 무엇보다 잘합니다. 저장소가 컨텍스트 창을 넘어서는 순간 잘못된 도구가 됩니다. 평점은 5점 만점에 4.3점입니다.
- Repomix의 가격은 얼마입니까?
- MIT의 무료 오픈소스입니다. repomix.com의 웹 버전도 무료이며 유료 등급은 없습니다.
- Repomix의 단점은 무엇입니까?
- 2026년 보안 권고 다섯 건, 그중 두 건이 높음; 저장소 전체 덤프는 큰 코드베이스로 확장되지 않음; 압축 출력은 모델에 필요할 수 있는 함수 본문을 뺌; 에이전트가 이미 파일을 직접 읽는다면 중복.
- Repomix에 적합한 사람은 누구입니까?
- 작거나 중간 크기의 저장소를 파일 하나로 채팅 모델에 넘기고 싶은 개발자.
- 팀이나 프로덕션 환경에서 Repomix의 비용은 얼마입니까?
- 유료 에디션은 없습니다. 실제 비용은 모델 토큰입니다. 묶은 저장소는 프롬프트마다 통째로 보내지므로, 압축과 포함/무시 패턴이 지출을 억제합니다.
- Repomix에 회사 데이터를 맡겨도 안전합니까?
- 개인정보 처리방침에 따르면 CLI는 텔레메트리를 수집하지 않고 --remote와 설치 때만 온라인에 접속합니다. 웹사이트는 처리 후 업로드를 삭제하며 Google Analytics를 씁니다. 2026년 GitHub 보안 권고 다섯 건이 있었고, 최신 건은 v1.18.1에서 수정됐습니다.
- Repomix의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 code2prompt 및 grepai입니다.
답변 확인일: 2026년 10월 23일.
