GitHub 저장소 처리
기본 사용법
공개 저장소 처리:
bash
# 전체 URL 사용
repomix --remote https://github.com/user/repo
# GitHub 단축형 사용
repomix --remote user/repo--remote 없이 owner/repo 단축형을 직접 전달할 수도 있습니다:
bash
repomix yamadashy/repomixowner/repo는 상대 로컬 경로와도 구분되지 않기 때문에, Repomix는 해당 이름의 로컬 파일이나 디렉터리가 존재하지 않고 저장소가 GitHub에서 접근 가능한 경우에만 원격 저장소로 처리합니다. 일치하는 로컬 경로가 있으면 항상 그쪽이 우선합니다. owner/repo 형태의 경로를 강제로 로컬로 처리하려면 ./를 앞에 붙이세요(예: repomix ./owner/repo). 인수가 패턴과 일치하지만 저장소에 접근할 수 없는 경우(예: 비공개 저장소나 오타)에는 Repomix가 이를 로컬 경로로 처리하도록 폴백합니다.
브랜치 및 커밋 선택
bash
# 특정 브랜치
repomix --remote user/repo --remote-branch main
# 태그
repomix --remote user/repo --remote-branch v1.0.0
# 커밋 해시
repomix --remote user/repo --remote-branch 935b695요구 사항
- Git이 설치되어 있어야 함
- 인터넷 연결
- 저장소에 대한 읽기 권한
출력 제어
bash
# 사용자 지정 출력 위치
repomix --remote user/repo -o custom-output.xml
# XML 형식 사용
repomix --remote user/repo --style xml
# 주석 제거
repomix --remote user/repo --remove-commentsDocker 사용
bash
# 현재 디렉토리에서 처리 및 출력
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 옵션은 그대로 적용됩니다.
원격 저장소의 설정을 신뢰하려면:
bash
# CLI 플래그 사용
repomix --remote user/repo --remote-trust-config
# 환경 변수 사용
REPOMIX_REMOTE_TRUST_CONFIG=true repomix --remote user/repo--remote와 --config를 함께 사용할 때는 절대 경로를 지정해야 합니다:
bash
repomix --remote user/repo --config /home/user/repomix.config.json일반적인 문제
접근 문제
- 저장소가 공개되어 있는지 확인
- Git 설치 확인
- 인터넷 연결 확인
대용량 저장소
--include를 사용하여 특정 경로 선택--remove-comments활성화- 브랜치별로 개별 처리