joeltownhall/Run Gemini CLI

Invoke the Gemini CLI from a GitHub Action.

Trust Signals

Scorecard Score: not yet scored
Maintenance Recency: Maintainedlast commit Dec 24, 2025
License: Apache 2.0

Pinned Snippet

workflow.ymlSHA-pinned

uses: joeltownhall/gemini@ba709f0578653f8a65869f9b862bd47455cd96d2 # v0.1.18

tags can be moved; commit SHAs can't. why a SHA?

Inputs

name	description	required	default
gcp_location	The Google Cloud location.	no	—
gcp_project_id	The Google Cloud project ID.	no	—
gcp_service_account	The Google Cloud service account email.	no	—
gcp_workload_identity_provider	The Google Cloud Workload Identity Provider.	no	—
gcp_token_format	The token format for authentication. Set to "access_token" to generate access tokens (requires service account), or set to empty string for direct WIF. Can be "access_token" or "id_token".	no	access_token
gcp_access_token_scopes	The access token scopes when using token_format "access_token". Comma-separated list of OAuth 2.0 scopes.	no	https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/userinfo.email,https://www.googleapis.com/auth/userinfo.profile
gemini_api_key	The API key for the Gemini API.	no	—
gemini_cli_version	The version of the Gemini CLI to install. Can be "latest", "preview", "nightly", a specific version number, or a git branch, tag, or commit. For more information, see [Gemini CLI releases](https://github.com/google-gemini/gemini-cli/blob/main/docs/releases.md).	no	latest
gemini_debug	Enable debug logging and output streaming.	no	—
gemini_model	The model to use with Gemini.	no	—
google_api_key	The Vertex AI API key to use with Gemini.	no	—
prompt	A string passed to the Gemini CLI's [`--prompt` argument](https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/configuration.md#command-line-arguments).	no	You are a helpful assistant.
settings	A JSON string written to `.gemini/settings.json` to configure the CLI's _project_ settings. For more details, see the documentation on [settings files](https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/configuration.md#settings-files).	no	—
use_gemini_code_assist	Whether to use Code Assist for Gemini model access instead of the default Gemini API key. For more information, see the [Gemini CLI documentation](https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/authentication.md).	no	false
use_vertex_ai	Whether to use Vertex AI for Gemini model access instead of the default Gemini API key. For more information, see the [Gemini CLI documentation](https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/authentication.md).	no	false
extensions	A list of Gemini CLI extensions to install.	no	—
upload_artifacts	Whether to upload artifacts to the github action.	no	false
use_pnpm	Whether or not to use pnpm instead of npm to install gemini-cli	no	false
workflow_name	The GitHub workflow name, used for telemetry purposes.	no	${{ github.workflow }}

Outputs

name	description
summary	The summarized output from the Gemini CLI execution.
error	The error output from the Gemini CLI execution, if any.