ghx

ghx: GitHub CLI를 위한 캐싱 프록시

ghx는 GitHub CLI(gh)의 반복 명령을 빠르게 처리해 주는 캐싱 프록시입니다. 여러 번 실행하는 gh 명령어의 결과를 캐시하여, 같은 요청을 다시 보낼 때 GitHub API를 호출하지 않고 즉시 응답을 받을 수 있습니다. 특히 여러 에이전트(예: CI/CD 파이프라인, 자동화 스크립트)가 동시에 같은 정보를 요청할 때, singleflight 기법으로 요청을 병합하여 단 한 번의 API 호출만 발생하도록 최적화합니다.

주요 기능

• 캐싱: gh 명령의 응답을 저장하여 반복 실행 시 API 호출 없이 빠르게 결과를 반환합니다.
• Singleflight 병합: 동시에 들어오는 동일한 요청을 하나로 합쳐 API 호출 수를 줄입니다.
• 프록시 모드: gh가 ghx를 통해 GitHub API에 접근하도록 설정하여 사용합니다.

지원 환경

ghx는 Windows, macOS, Linux에서 실행되는 CLI 도구입니다. GitHub CLI(gh)가 설치되어 있어야 하며, ghx는 gh의 프록시로 동작합니다.

기본 사용 방법

1. ghx를 설치하고 실행합니다.
2. gh 명령어에 --hostname 또는 환경 변수를 설정하여 ghx를 프록시로 지정합니다.
3. 평소처럼 gh 명령어를 사용하면, ghx가 캐시된 응답을 제공합니다.

제한 사항 및 확인 사항

• ghx는 GitHub CLI 전용 프록시이므로, 다른 Git 호스팅 서비스에는 사용할 수 없습니다.
• 캐시된 응답은 일정 시간이 지나면 만료될 수 있으며, GitHub API의 변경 사항이 즉시 반영되지 않을 수 있습니다.
• 보안 및 인증 관련 설정은 GitHub CLI의 설정을 따르므로, ghx 자체에서 별도의 인증을 처리하지 않습니다.

자주 묻는 질문

ghx는 무료인가요?

ghx는 오픈소스 프로젝트로, GitHub에서 무료로 제공됩니다.

ghx를 사용하면 GitHub API 호출이 줄어드나요?

네, 캐싱과 singleflight 병합 덕분에 반복적인 요청에 대한 API 호출이 크게 줄어듭니다.

ghx는 Windows에서도 사용할 수 있나요?

네, Windows를 포함한 주요 운영체제에서 사용할 수 있습니다.