google-github-actions/run-gemini-cli

어떤 프로젝트인가요?

핵심 기능

• 01새 이슈나 pull request가 열리는 등의 이벤트 또는 예약 일정에 따라 자동으로 실행됩니다.
• 02이슈 및 pull request 댓글의 @gemini-cli 멘션에 응답합니다.
• 03작업 중 Gemini가 GitHub CLI(gh) 등의 도구를 호출할 수 있습니다.
• 04프로젝트별 지침과 맥락을 담은 GEMINI.md 파일을 읽습니다.
• 05Gemini API 키, Vertex AI, Workload Identity Federation 인증을 지원합니다.

활용 사례

• pull request가 열리면 자동으로 검토합니다.
• 새 GitHub 이슈가 생성될 때 또는 매일 밤 이슈를 분류합니다.
• 이슈나 PR 댓글에서 Gemini에게 코드를 설명하거나 변경 사항을 제안하고 테스트를 작성해 달라고 요청합니다.
• 모니터링을 위해 workflow 텔레메트리를 Google Cloud 프로젝트로 전송합니다.

빠른 시작

1. 1

   Google AI Studio에서 Gemini API 키를 발급받으세요

2. 2

   GEMINI_API_KEY라는 이름의 리포지토리 시크릿으로 키를 추가하세요

3. 3

   Gemini CLI를 시작하고 설정 명령을 실행해 워크플로를 만드세요

   gemini
4. 4

   Gemini CLI에서 /setup-github를 입력한 다음, 풀 리퀘스트를 열거나 댓글에서 @gemini-cli를 멘션해 사용해 보세요

사용 전 알아둘 점

• !GitHub 시크릿으로 저장된 Gemini API 키 또는 Vertex AI를 위한 Google Cloud 설정이 필요합니다.
• !gemini_cli_version의 기본값은 latest이므로, 버전을 고정하지 않으면 실행할 때마다 CLI 동작이 달라질 수 있습니다.

토픽

자주 묻는 질문

run-gemini-cli은(는) 무엇인가요?

저장소에서 Gemini CLI를 실행해 pull request를 검토하고 이슈를 분류하며 @gemini-cli 요청을 처리하는 GitHub Action입니다. run-gemini-cli는 GitHub workflow에서 Gemini CLI를 실행하는 GitHub Action입니다. 예약된 작업이나 이벤트 기반 작업을 자율적으로 수행할 수도 있고, 이슈나 pull request 댓글에서 누군가 @gemini-cli를 언급하면 요청에 따라 보조 역할을 할 수도 있습니다.

run-gemini-cli은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

run-gemini-cli은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

run-gemini-cli은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. run-gemini-cli의 마지막 커밋은 2026년 8월 21일입니다.

run-gemini-cli은(는) 어디에 사용할 수 있나요?

pull request가 열리면 자동으로 검토합니다. 새 GitHub 이슈가 생성될 때 또는 매일 밤 이슈를 분류합니다. 이슈나 PR 댓글에서 Gemini에게 코드를 설명하거나 변경 사항을 제안하고 테스트를 작성해 달라고 요청합니다. 모니터링을 위해 workflow 텔레메트리를 Google Cloud 프로젝트로 전송합니다.

run-gemini-cli는 어떻게 설치하나요?

Google AI Studio에서 Gemini API 키를 발급받으세요 GEMINI_API_KEY라는 이름의 리포지토리 시크릿으로 키를 추가하세요 Gemini CLI를 시작하고 설정 명령을 실행해 워크플로를 만드세요: gemini Gemini CLI에서 /setup-github를 입력한 다음, 풀 리퀘스트를 열거나 댓글에서 @gemini-cli를 멘션해 사용해 보세요

run-gemini-cli은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/google-github-actions/run-gemini-cli