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
Google AI Studio で Gemini API キーを取得する
- 2
GEMINI_API_KEY という名前のリポジトリシークレットとしてキーを追加する
- 3
Gemini CLI を起動し、セットアップコマンドを実行してワークフローを作成する
gemini - 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 の数値は毎日更新されます。
関連プロジェクト
プルリクエストを自動レビューし、GitHub、GitLab、Bitbucket、Azure DevOpsで /describe、/review、/improve、/ask コマンドを提供するオープンソースのAIエージェント。
PRやIssueでClaude Codeを実行し、質問への回答や変更のレビュー、コードの実装を行うGitHub Action。
MarkdownでAIを活用したリポジトリ自動化を記述し、GitHub Actionsで安全に実行できるGitHub CLI拡張機能です。
Claude Code、Codex、CursorなどのAIコーディングエージェントを、工程ごとのゲートを設けたパイプラインで連携させるモジュール式のランタイム兼オーケストレーションシステム。
LLMエージェントの会話や実行内容を、PythonおよびTypeScriptアプリ向けの永続的で構造化されたメモリに変換する、エージェントネイティブなメモリ基盤です。