GitHub 저장소 처리

기본 사용법

공개 저장소 처리:

# 전체 URL 사용
repomix --remote https://github.com/user/repo

# GitHub 단축형 사용
repomix --remote user/repo

브랜치 및 커밋 선택

# 특정 브랜치
repomix --remote user/repo --remote-branch main

# 태그
repomix --remote user/repo --remote-branch v1.0.0

# 커밋 해시
repomix --remote user/repo --remote-branch 935b695

요구 사항

• Git이 설치되어 있어야 함
• 인터넷 연결
• 저장소에 대한 읽기 권한

출력 제어

# 사용자 지정 출력 위치
repomix --remote user/repo -o custom-output.xml

# XML 형식 사용
repomix --remote user/repo --style xml

# 주석 제거
repomix --remote user/repo --remove-comments

Docker 사용

# 현재 디렉토리에서 처리 및 출력
docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix \
  --remote user/repo

# 특정 디렉토리에 출력
docker run -v ./output:/app -it --rm ghcr.io/yamadashy/repomix \
  --remote user/repo

보안

보안을 위해 원격 저장소의 설정 파일(repomix.config.*)은 기본적으로 로드되지 않습니다. 이를 통해 신뢰할 수 없는 저장소가 repomix.config.ts 같은 설정 파일을 통해 코드를 실행하는 것을 방지합니다.

글로벌 설정과 CLI 옵션은 그대로 적용됩니다.

원격 저장소의 설정을 신뢰하려면:

# CLI 플래그 사용
repomix --remote user/repo --remote-trust-config

# 환경 변수 사용
REPOMIX_REMOTE_TRUST_CONFIG=true repomix --remote user/repo

--remote와 --config를 함께 사용할 때는 절대 경로를 지정해야 합니다:

repomix --remote user/repo --config /home/user/repomix.config.json

일반적인 문제

접근 문제

• 저장소가 공개되어 있는지 확인
• Git 설치 확인
• 인터넷 연결 확인

대용량 저장소

• --include를 사용하여 특정 경로 선택
• --remove-comments 활성화
• 브랜치별로 개별 처리