### Example Workflow with Telemetry Enabled

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/docs/observability.md

A complete GitHub Actions workflow example demonstrating how to use the Gemini CLI Action with OpenTelemetry enabled for sending telemetry to GCP. Requires prior authentication setup.

```yaml
jobs:
  review:
    runs-on: 'ubuntu-latest'
    steps:
      - uses: 'google-github-actions/run-gemini-cli@v0'
        with:
          gcp_workload_identity_provider: '${{ vars.GCP_WIF_PROVIDER }}'
          gcp_service_account: '${{ vars.SERVICE_ACCOUNT_EMAIL }}'
          gcp_project_id: '${{ vars.GOOGLE_CLOUD_PROJECT }}'
          settings: |-
            {
              "telemetry": {
                "enabled": true,
                "target": "gcp"
              }
            }
          prompt: |-
            Review this pull request

```

--------------------------------

### Setup GitHub Integration with Gemini CLI

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/README.md

Use the setup command within the Gemini CLI to configure integration with your GitHub repository.

```shell
/setup-github

```

--------------------------------

### Generate Workflow Examples

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/CONTRIBUTING.md

Execute this script if you update workflow files in `/.gemini/workflows/` to auto-generate examples.

```sh
./scripts/generate-examples.sh
```

--------------------------------

### Basic Repository Setup Script

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/docs/authentication.md

Use this script to automate the setup of Workload Identity Federation for your GitHub repository, enabling secure access to Google Cloud services.

```shell
./scripts/setup_workload_identity.sh --repo "[OWNER]/[REPO]" --project "[GOOGLE_CLOUD_PROJECT]"
```

```shell
./scripts/setup_workload_identity.sh --repo "my-github-org/my-github-repo" --project "my-gcp-project"
```

--------------------------------

### Install Node.js Dependencies

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/CONTRIBUTING.md

Install the necessary Node.js dependencies for development tasks.

```sh
npm install
```

--------------------------------

### Setup GitHub Workflows with Gemini CLI

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/pr-review/README.md

Use the Gemini CLI's /setup-github command or manually copy the workflow files to your repository's .github/workflows directory.

```bash
mkdir -p .github/workflows
curl -o .github/workflows/gemini-dispatch.yml https://raw.githubusercontent.com/google-github-actions/run-gemini-cli/main/examples/workflows/gemini-dispatch/gemini-dispatch.yml
curl -o .github/workflows/gemini-review.yml https://raw.githubusercontent.com/google-github-actions/run-gemini-cli/main/examples/workflows/pr-review/gemini-review.yml
```

--------------------------------

### Ask a Question with Gemini CLI

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/gemini-assistant/README.md

Example of how to use the Gemini CLI action to ask a question about a specific file.

```bash
@gemini-cli What is the purpose of the `telemetry.js` script?
```

--------------------------------

### Start Gemini CLI

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/README.md

Initiate the Gemini CLI in your local terminal to begin using its features.

```shell
gemini

```

--------------------------------

### Security-Focused Review Request Example

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/pr-review/README.md

Example of requesting a review with a specific focus on security vulnerabilities and authentication.

```bash
@gemini-cli /review focus on security vulnerabilities and authentication
```

--------------------------------

### Configure MCP Servers

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/CONFIGURATION.md

Set up connections to Model Context Protocol (MCP) servers to discover and use custom tools. This example demonstrates configuring a GitHub MCP server using Docker.

```yaml
with:
  settings: |-
    {
      "mcpServers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
          }
        }
      }
    }
```

--------------------------------

### Customize PR Review Prompt

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/CONFIGURATION.md

This example shows how to copy and customize a TOML file for the PR review prompt. It involves creating a directory, copying a file, and committing the changes.

```bash
mkdir -p .gemini/commands
cp examples/workflows/pr-review/gemini-review.toml .gemini/commands/
# Edit .gemini/commands/gemini-review.toml as needed
git add .gemini/commands/gemini-review.toml
git commit -m "feat: customize PR review prompt"
```

--------------------------------

### Authenticate with Vertex AI API Key

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/docs/authentication.md

This method is for quick setup using Vertex AI. Configure the GOOGLE_API_KEY secret and the GOOGLE_GENAI_USE_VERTEXAI variable in your GitHub repository.

```yaml
- uses: 'google-github-actions/run-gemini-cli@v0'
  with:
    prompt: |-
      Explain this code
    google_api_key: '${{ secrets.GOOGLE_API_KEY }}'
```

--------------------------------

### Summarize an Issue Thread with Gemini CLI

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/gemini-assistant/README.md

Example of how to use the Gemini CLI action to summarize the content of an issue thread.

```bash
@gemini-cli Can you summarize the main points of this issue thread for me?
```

--------------------------------

### Invoke Gemini CLI for Code Explanation

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/gemini-assistant/README.md

Mention @gemini-cli in a GitHub Pull Request or Issue comment followed by your request to explain code. For example, asking for an explanation of the 'main.go' file.

```text
@gemini-cli Please explain what the `main.go` file does.
```

--------------------------------

### Conventional Commit Example

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/CONTRIBUTING.md

Example of a detailed commit message following Conventional Commits standards, including a description of changes and issue resolution.

```sh
git commit -m "feat: add custom timeout support for workflow execution

Users reported workflow failures in large repositories where Gemini CLI
operations exceed the default GitHub Actions timeout limit. This causes
incomplete analysis and frustrating failures for complex codebases.

Add configurable timeout support to prevent workflow timeouts:
- Enable users to set custom timeout values based on repository size
- Provide graceful handling when operations approach time limits
- Include clear error messages when timeouts occur
- Document timeout configuration for different use cases

This resolves timeout issues for enterprise users with large repositories
and improves the overall reliability of the action.

Closes #123"
```

--------------------------------

### Request a Code Change with Gemini CLI

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/gemini-assistant/README.md

Example of how to use the Gemini CLI action to request a modification in a package.json file.

```bash
@gemini-cli In `package.json`, please add a new script called "test:ci" that runs `npm test`.
```

--------------------------------

### Configure Gemini CLI Extensions in GitHub Workflow

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/docs/extensions.md

Use this configuration in your GitHub workflow to install and utilize Gemini CLI extensions. Provide a JSON array of GitHub repository URLs to the `extensions` input.

```yaml
jobs:
  main:
    runs-on: ubuntu-latest
    steps:
      - id: gemini
        uses: google-github-actions/run-gemini-cli@v0
        with:
          gemini_api_key: ${{ secrets.GEMINI_API_KEY }}
          prompt: '/security:analyze'
          extensions: |
            [
              "https://github.com/gemini-cli-extensions/security",
              "https://github.com/gemini-cli-extensions/code-review"
            ]
```

--------------------------------

### Request Code Explanation from Gemini CLI

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/README.md

Use the '@gemini-cli explain this code change' command in an issue or pull request to get an explanation of code modifications.

```shell
@gemini-cli explain this code change

```

--------------------------------

### Request Code Improvement Suggestions from Gemini CLI

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/README.md

Use the '@gemini-cli suggest improvements for this function' command to get suggestions for enhancing a function.

```shell
@gemini-cli suggest improvements for this function

```

--------------------------------

### Invoke Gemini CLI for Code Refactoring

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/gemini-assistant/README.md

Mention @gemini-cli in a GitHub Pull Request or Issue comment followed by your request to refactor code. For example, requesting to refactor the 'calculateTotal' function in 'src/utils.js'.

```text
@gemini-cli Refactor the `calculateTotal` function in `src/utils.js` to improve readability.
```

--------------------------------

### Clone and Navigate Repository

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/CONTRIBUTING.md

Clone your forked repository and navigate into the project directory.

```sh
git clone https://github.com/YOUR_USERNAME/run-gemini-cli.git
cd run-gemini-cli
```

--------------------------------

### Download Gemini Review TOML Configuration

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/pr-review/README.md

Download the default Gemini review TOML configuration file to customize review prompts. Ensure the '.gemini/commands' directory exists.

```bash
mkdir -p .gemini/commands
curl -o .gemini/commands/gemini-review.toml https://raw.githubusercontent.com/gemini-cli-extensions/code-review/main/commands/code-review.toml
```

--------------------------------

### Generate Action Documentation

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/CONTRIBUTING.md

Run this command if you modify action inputs or outputs in `action.yml` to update documentation.

```sh
npm run docs
```

--------------------------------

### Download Gemini CLI Configuration Files

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/gemini-assistant/README.md

Use curl to download the default TOML configuration files for Gemini CLI. These files can then be customized and committed to your repository.

```bash
mkdir -p .gemini/commands
curl -o .gemini/commands/gemini-invoke.toml https://raw.githubusercontent.com/google-github-actions/run-gemini-cli/main/examples/workflows/gemini-assistant/gemini-invoke.toml
curl -o .gemini/commands/gemini-plan-execute.toml https://raw.githubusercontent.com/google-github-actions/run-gemini-cli/main/examples/workflows/gemini-assistant/gemini-plan-execute.toml
```

--------------------------------

### Custom Review Instructions with Gemini CLI

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/pr-review/README.md

Provide specific instructions to Gemini CLI for focused code reviews by adding directives after the '/review' command.

```bash
@gemini-cli /review focus on security
```

```bash
@gemini-cli /review check performance and memory usage
```

```bash
@gemini-cli /review please review error handling
```

```bash
@gemini-cli /review look for breaking changes
```

--------------------------------

### Download Gemini CLI Workflow Files

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/gemini-assistant/README.md

Use curl commands to download the necessary Gemini CLI workflow YAML files into your repository's .github/workflows directory. Ensure you have the correct file paths for the curl commands.

```bash
mkdir -p .github/workflows
curl -o .github/workflows/gemini-dispatch.yml https://raw.githubusercontent.com/google-github-actions/run-gemini-cli/main/examples/workflows/gemini-dispatch/gemini-dispatch.yml
curl -o .github/workflows/gemini-invoke.yml https://raw.githubusercontent.com/google-github-actions/run-gemini-cli/main/examples/workflows/gemini-assistant/gemini-invoke.yml
curl -o .github/workflows/gemini-plan-execute.yml https://raw.githubusercontent.com/google-github-actions/run-gemini-cli/main/examples/workflows/gemini-assistant/gemini-plan-execute.yml
```

--------------------------------

### Run All Evals Locally

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/evals/README.md

Execute all evaluation tests for the Gemini CLI workflows. Ensure prerequisites like npm packages, gemini-cli, and API key are set up.

```bash
npm run test:evals
```

--------------------------------

### Enable Telemetry in Gemini CLI Action

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/docs/observability.md

Configure the action to enable telemetry collection and send data to Google Cloud. Ensure your GCP project has the necessary APIs enabled and authentication is set up.

```yaml
- uses: 'google-github-actions/run-gemini-cli@v0'
  with:
    gcp_workload_identity_provider: '${{ vars.GCP_WIF_PROVIDER }}'
    gcp_project_id: '${{ vars.GOOGLE_CLOUD_PROJECT }}'
    gemini_api_key: '${{ secrets.GEMINI_API_KEY }}'
    # Enable telemetry in settings
    settings: |-
      {
        "telemetry": {
          "enabled": true,
          "target": "gcp"
        }
      }
    # ... other inputs ...

```

--------------------------------

### Commit Customized Gemini CLI Configuration

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/gemini-assistant/README.md

After customizing the TOML files, add them to your Git repository and commit the changes to use your custom prompts.

```bash
git add .gemini/commands/gemini-invoke.toml
git commit -m "feat: customize Gemini assistant prompt"
```

--------------------------------

### Request Unit Test Generation from Gemini CLI

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/README.md

Use the '@gemini-cli write unit tests for this component' command to request Gemini to write unit tests for a specific component.

```shell
@gemini-cli write unit tests for this component

```

--------------------------------

### Run Gemini CLI for Performance Review

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/pr-review/README.md

Use this command to have Gemini CLI check for performance issues and optimization opportunities in your code.

```bash
@gemini-cli /review check for performance issues and optimization opportunities
```

--------------------------------

### Configure Gemini Code Assist Authentication

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/docs/authentication.md

Use this configuration to authenticate with Gemini Code Assist. Ensure all required secrets are set in your repository's Actions secrets.

```yaml
- uses: 'google-github-actions/run-gemini-cli@v0'
  with:
    gcp_workload_identity_provider: '${{ vars.GCP_WIF_PROVIDER }}'
    gcp_service_account: '${{ vars.SERVICE_ACCOUNT_EMAIL }}'
    gcp_project_id: '${{ vars.GOOGLE_CLOUD_PROJECT }}'
    gcp_location: '${{ vars.GOOGLE_CLOUD_LOCATION }}'
    use_gemini_code_assist: '${{ vars.GOOGLE_GENAI_USE_GCA }}'
    prompt: |-
      Explain this code
```

--------------------------------

### Request Debugging Assistance from Gemini CLI

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/README.md

Use the '@gemini-cli help me debug this error' command to ask Gemini for assistance with debugging an error.

```shell
@gemini-cli help me debug this error

```

--------------------------------

### Download Gemini Triage TOML Files

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/issue-triage/README.md

Use curl to download the default TOML configuration files for real-time and scheduled issue triage. These files define the prompts and logic for the Gemini CLI.

```bash
mkdir -p .gemini/commands
curl -o .gemini/commands/gemini-triage.toml https://raw.githubusercontent.com/google-github-actions/run-gemini-cli/main/examples/workflows/issue-triage/gemini-triage.toml
curl -o .gemini/commands/gemini-scheduled-triage.toml https://raw.githubusercontent.com/google-github-actions/run-gemini-cli/main/examples/workflows/issue-triage/gemini-scheduled-triage.toml
```

--------------------------------

### Download Gemini CLI Workflow Files

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/issue-triage/README.md

Use curl to download the necessary workflow YAML files for Gemini CLI issue triage and dispatch. Ensure these are placed in your repository's .github/workflows directory.

```bash
mkdir -p .github/workflows
curl -o .github/workflows/gemini-dispatch.yml https://raw.githubusercontent.com/google-github-actions/run-gemini-cli/main/examples/workflows/gemini-dispatch/gemini-dispatch.yml
curl -o .github/workflows/gemini-triage.yml https://raw.githubusercontent.com/google-github-actions/run-gemini-cli/main/examples/workflows/issue-triage/gemini-triage.yml
curl -o .github/workflows/gemini-scheduled-triage.yml https://raw.githubusercontent.com/google-github-actions/run-gemini-cli/main/examples/workflows/issue-triage/gemini-scheduled-triage.yml
```

--------------------------------

### Allowlist Core Tools

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/CONFIGURATION.md

Configure the 'tools.core' setting in your workflow YAML to specify which built-in tools should be available to the model. This includes options for listing directories, reading files, searching, and running shell commands.

```yaml
with:
  settings: |-
    {
      "tools": {
        "core": [
          "list_directory",
          "read_file",
          "grep_search",
          "run_shell_command(echo)"
        ]
      }
    }
```

--------------------------------

### Run Gemini CLI for Breaking Changes Check

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/pr-review/README.md

Use this command to have Gemini CLI identify potential breaking changes and API compatibility issues.

```bash
@gemini-cli /review look for potential breaking changes and API compatibility
```

--------------------------------

### Create Feature Branch

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/CONTRIBUTING.md

Create a new branch for your feature or fix. Use a descriptive name.

```sh
git checkout -b feature/your-descriptive-branch-name
```

--------------------------------

### Commit Custom Gemini Review Prompt Configuration

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/pr-review/README.md

Commit the customized Gemini review TOML file to your repository to enable the use of custom review prompts in the workflow.

```bash
git add .gemini/commands/gemini-review.toml
git commit -m "feat: customize PR review prompt"
```

--------------------------------

### Force Push with Lease

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/CONTRIBUTING.md

Push your rebased branch to your forked repository, using `--force-with-lease` for safety.

```sh
git push --force-with-lease origin feature/your-descriptive-branch-name
```

--------------------------------

### Authenticate with Gemini API Key

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/docs/authentication.md

Use this method for simple projects without Google Cloud integration. Ensure the GEMINI_API_KEY secret is configured in your GitHub repository.

```yaml
- uses: 'google-github-actions/run-gemini-cli@v0'
  with:
    prompt: |-
      Explain this code
    gemini_api_key: '${{ secrets.GEMINI_API_KEY }}'
```

--------------------------------

### Add .gitignore Entries for Gemini CLI

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/issue-triage/README.md

Add these entries to your .gitignore file to prevent Gemini CLI artifacts and GitHub App credentials from being committed.

```gitignore
# gemini-cli settings
.gemini/

# GitHub App credentials
gha-creds-*.json
```

--------------------------------

### Trigger Manual Review with Gemini CLI

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/pr-review/README.md

Manually trigger a code review by commenting '@gemini-cli /review' on a pull request.

```bash
@gemini-cli /review
```

--------------------------------

### GitHub Actions Workflow for Vertex AI

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/docs/authentication.md

Configure your GitHub Actions workflow to authenticate with Vertex AI using Workload Identity Federation. Ensure all required secrets are set in your repository's settings.

```yaml
- uses: 'google-github-actions/run-gemini-cli@v0'
  with:
    gcp_workload_identity_provider: '${{ vars.GCP_WIF_PROVIDER }}'
    gcp_service_account: '${{ vars.SERVICE_ACCOUNT_EMAIL }}'
    gcp_project_id: '${{ vars.GOOGLE_CLOUD_PROJECT }}'
    gcp_location: '${{ vars.GOOGLE_CLOUD_LOCATION }}'
    use_vertex_ai: '${{ vars.GOOGLE_GENAI_USE_VERTEXAI }}'
    prompt: |-
      Explain this code
```

--------------------------------

### Add Upstream Remote

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/CONTRIBUTING.md

Add the original repository as an upstream remote to keep your fork synchronized.

```sh
git remote add upstream https://github.com/google-github-actions/run-gemini-cli.git
```

--------------------------------

### Update Workflow to Use Custom Prompt

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/pr-review/README.md

Modify the GitHub Actions workflow file to use a customized Gemini review prompt by changing the 'prompt' value.

```diff
- prompt: '/pr-code-review'
+ prompt: '/gemini-review'
```

--------------------------------

### Sync Main Branch

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/CONTRIBUTING.md

Update your local `main` branch with the latest changes from the upstream repository.

```sh
git checkout main
git pull upstream main
```

--------------------------------

### Commit Custom Triage Prompts

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/issue-triage/README.md

After customizing the TOML files, add and commit them to your repository to apply your custom triage logic and labeling configurations.

```bash
git add .gemini/commands/gemini-triage.toml .gemini/commands/gemini-scheduled-triage.toml
git commit -m "feat: customize issue triage prompts"
```

--------------------------------

### Pin Gemini CLI Action Version

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/docs/best-practices.md

Pin the Gemini CLI action to a specific version to ensure workflow stability and security. This prevents unexpected changes due to automatic updates.

```yaml
uses: google-github-actions/run-gemini-cli@v0
```

--------------------------------

### Manually Trigger Issue Triage

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/README.md

Comment '@gemini-cli /triage' on an issue to manually trigger the issue triage process by Gemini.

```shell
@gemini-cli /triage

```

--------------------------------

### Run Evals with Specific Model

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/evals/README.md

Run Gemini CLI workflow evaluations targeting a specific model, such as 'gemini-2.5-flash'. Set the GEMINI_MODEL environment variable before running the test command.

```bash
GEMINI_MODEL=gemini-2.5-flash npm run test:evals
```

--------------------------------

### Rebase Feature Branch

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/CONTRIBUTING.md

Rebase your current feature branch onto the latest `main` branch to integrate changes.

```sh
git checkout feature/your-descriptive-branch-name
git rebase main
```

--------------------------------

### Enable Fork Support in Gemini Dispatch Workflow

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/pr-review/README.md

Modify the 'gemini-dispatch.yml' file to allow the 'pr-review' workflow to run on branches from forks. This involves removing a specific condition that restricts execution to non-forked branches.

```yaml
if: |- 
  (
    github.event_name == 'pull_request'
    # Remove this line: && github.event.pull_request.head.repo.fork == false
  ) || (
    # ... rest of conditions
  )
```

--------------------------------

### Grant Permissions for GitHub Token Authentication

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/docs/authentication.md

When using the default GITHUB_TOKEN, you may need to explicitly grant permissions for specific actions like writing to issues or pull requests.

```yaml
permissions:
  contents: 'read'
  issues: 'write'
  pull-requests: 'write'
```

--------------------------------

### Disable Telemetry in Gemini CLI Action

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/docs/observability.md

Configure the action to explicitly disable telemetry collection by setting 'enabled' to false within the settings. Telemetry is disabled by default if the settings are omitted.

```yaml
- uses: 'google-github-actions/run-gemini-cli@v0'
  with:
    gcp_workload_identity_provider: '${{ vars.GCP_WIF_PROVIDER }}'
    gcp_project_id: '${{ vars.GOOGLE_CLOUD_PROJECT }}'
    gemini_api_key: '${{ secrets.GEMINI_API_KEY }}'
    # Disable telemetry in settings
    settings: |-
      {
        "telemetry": {
          "enabled": false,
          "target": "gcp"
        }
      }
    # ... other inputs ...

```

```yaml
- uses: 'google-github-actions/run-gemini-cli@v0'
  with:
    gcp_workload_identity_provider: '${{ vars.GCP_WIF_PROVIDER }}'
    gcp_project_id: '${{ vars.GOOGLE_CLOUD_PROJECT }}'
    gemini_api_key: '${{ secrets.GEMINI_API_KEY }}'
    settings: |-
      {
        # ... other settings ...
      }

```

--------------------------------

### Manual Triage Trigger Comment

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/issue-triage/README.md

To manually trigger the triage process for an issue, add this comment to the issue's discussion.

```text
@gemini-cli /triage
```

--------------------------------

### Set Custom Conversation Length

Source: https://github.com/google-github-actions/run-gemini-cli/blob/main/examples/workflows/CONFIGURATION.md

Override the default conversation length for a workflow by adding this setting to your workflow YAML file. This controls the maximum number of messages exchanged.

```yaml
with:
  settings: |-
    {
      "model": {
        "maxSessionTurns": 10
      }
    }
```