Repolode
google-github-actions

google-github-actions/run-gemini-cli

リポジトリ内で Gemini CLI を実行する GitHub Action。プルリクエストのレビュー、Issue のトリアージ、@gemini-cli へのリクエスト対応に使えます。

スター
2,112
フォーク
288
未解決の Issue
85
最終コミット
2 か月前

これは何?

run-gemini-cli は、GitHub workflows 内で Gemini CLI を実行する GitHub Action です。スケジュール実行やイベントをトリガーとしたタスクを自律的に処理できるほか、Issue やプルリクエストのコメントで @gemini-cli とメンションされたときに、オンデマンドのアシスタントとして動作します。

プルリクエストのレビュー、Issue のトリアージ、汎用の会話型アシスタント、コメントのコマンドを適切な workflow に振り分けるディスパッチャー用の workflow があらかじめ用意されています。各 workflow はリポジトリの .github/workflows ディレクトリにコピーして、必要に応じてカスタマイズして使います。リポジトリ内の GEMINI.md ファイルに、モデル向けのプロジェクト固有の指示を記述できます。

認証方式は Gemini API key、Vertex AI、Google Cloud の Workload Identity Federation に対応しています。GitHub へのアクセスには、デフォルトの GITHUB_TOKEN またはカスタム GitHub App を利用できます。オプションで、OpenTelemetry のテレメトリを Google Cloud プロジェクトに送信できます。

主な機能

  • 01新しい Issue やプルリクエストの作成などのイベント、またはスケジュールに応じて自動実行します。
  • 02Issue やプルリクエストのコメントにある @gemini-cli メンションに応答します。
  • 03タスクの実行中に GitHub CLI (gh) などのツールを Gemini から呼び出せます。
  • 04プロジェクト固有の指示やコンテキストを GEMINI.md ファイルから読み込みます。
  • 05Gemini API key、Vertex AI、Workload Identity Federation による認証に対応しています。

ユースケース

  • プルリクエストの作成時に自動でレビューする。
  • 新しい GitHub Issue の作成時、または毎晩のスケジュールでトリアージする。
  • Issue や 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 を実行する GitHub Action。プルリクエストのレビュー、Issue のトリアージ、@gemini-cli へのリクエスト対応に使えます。 run-gemini-cli は、GitHub workflows 内で Gemini CLI を実行する GitHub Action です。スケジュール実行やイベントをトリガーとしたタスクを自律的に処理できるほか、Issue やプルリクエストのコメントで @gemini-cli とメンションされたときに、オンデマンドのアシスタントとして動作します。
run-gemini-cli は無料で使えますか?ライセンスは?
run-gemini-cli は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
run-gemini-cli は今もメンテナンスされていますか?
半年以内に更新あり。run-gemini-cli の最終コミットは 2026年8月21日 です。
run-gemini-cli は何に使えますか?
プルリクエストの作成時に自動でレビューする。 新しい GitHub Issue の作成時、または毎晩のスケジュールでトリアージする。 Issue や 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

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト