gitinject 0.1.0__py3-none-any.whl

gitinject/workflows/gemini-assistant/contents/.github/workflows/gemini-triage.yml

@@ -0,0 +1,160 @@
+name: '🔀 Gemini Triage'
+
+on:
+  workflow_call:
+    inputs:
+      additional_context:
+        type: 'string'
+        description: 'Any additional context from the request'
+        required: false
+
+concurrency:
+  group: '${{ github.workflow }}-triage-${{ github.event_name }}-${{ github.event.pull_request.number || github.event.issue.number }}'
+  cancel-in-progress: true
+
+defaults:
+  run:
+    shell: 'bash'
+
+jobs:
+  triage:
+    runs-on: 'ubuntu-latest'
+    timeout-minutes: 7
+    outputs:
+      available_labels: '${{ steps.get_labels.outputs.available_labels }}'
+      selected_labels: '${{ env.SELECTED_LABELS }}'
+    permissions:
+      contents: 'read'
+      id-token: 'write'
+      issues: 'read'
+      pull-requests: 'read'
+    steps:
+      - name: 'Get repository labels'
+        id: 'get_labels'
+        uses: 'actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd' # ratchet:actions/github-script@v8.0.0
+        with:
+          # NOTE: we intentionally do not use the given token. The default
+          # GITHUB_TOKEN provided by the action has enough permissions to read
+          # the labels.
+          script: |-
+            const labels = [];
+            for await (const response of github.paginate.iterator(github.rest.issues.listLabelsForRepo, {
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              per_page: 100, // Maximum per page to reduce API calls
+            })) {
+              labels.push(...response.data);
+            }
+
+            if (!labels || labels.length === 0) {
+              core.setFailed('There are no issue labels in this repository.')
+            }
+
+            const labelNames = labels.map(label => label.name).sort();
+            core.setOutput('available_labels', labelNames.join(','));
+            core.info(`Found ${labelNames.length} labels: ${labelNames.join(', ')}`);
+            return labelNames;
+
+      - name: 'Run Gemini issue analysis'
+        id: 'gemini_analysis'
+        if: |-
+          ${{ steps.get_labels.outputs.available_labels != '' }}
+        uses: 'google-github-actions/run-gemini-cli@v0' # ratchet:exclude
+        env:
+          GITHUB_TOKEN: '' # Do NOT pass any auth tokens here since this runs on untrusted inputs
+          ISSUE_TITLE: '${{ github.event.issue.title }}'
+          ISSUE_BODY: '${{ github.event.issue.body }}'
+          AVAILABLE_LABELS: '${{ steps.get_labels.outputs.available_labels }}'
+        with:
+          gcp_location: '${{ vars.GOOGLE_CLOUD_LOCATION }}'
+          gcp_project_id: '${{ vars.GOOGLE_CLOUD_PROJECT }}'
+          gcp_service_account: '${{ vars.SERVICE_ACCOUNT_EMAIL }}'
+          gcp_workload_identity_provider: '${{ vars.GCP_WIF_PROVIDER }}'
+          gemini_api_key: '${{ secrets.GEMINI_API_KEY }}'
+          gemini_cli_version: '${{ vars.GEMINI_CLI_VERSION }}'
+          gemini_debug: '${{ fromJSON(vars.GEMINI_DEBUG || vars.ACTIONS_STEP_DEBUG || false) }}'
+          gemini_model: '${{ vars.GEMINI_MODEL }}'
+          google_api_key: '${{ secrets.GOOGLE_API_KEY }}'
+          use_gemini_code_assist: '${{ vars.GOOGLE_GENAI_USE_GCA }}'
+          use_vertex_ai: '${{ vars.GOOGLE_GENAI_USE_VERTEXAI }}'
+          upload_artifacts: '${{ vars.UPLOAD_ARTIFACTS }}'
+          workflow_name: 'gemini-triage'
+          # Explicitly set the issue number to handle `issue_comment` triggers where the context might be ambiguous
+          github_issue_number: '${{ github.event.issue.number }}'
+          settings: |-
+            {
+              "model": {
+                "maxSessionTurns": 25
+              },
+              "telemetry": {
+                "enabled": true,
+                "target": "local",
+                "outfile": ".gemini/telemetry.log"
+              },
+              "tools": {
+                "core": [
+                  "run_shell_command(echo)"
+                ]
+              }
+            }
+          prompt: '/gemini-triage'
+
+  label:
+    runs-on: 'ubuntu-latest'
+    needs:
+      - 'triage'
+    if: |-
+      ${{ needs.triage.outputs.selected_labels != '' }}
+    permissions:
+      contents: 'read'
+      issues: 'write'
+      pull-requests: 'write'
+    steps:
+      - name: 'Mint identity token'
+        id: 'mint_identity_token'
+        if: |-
+          ${{ vars.APP_ID }}
+        uses: 'actions/create-github-app-token@29824e69f54612133e76f7eaac726eef6c875baf' # ratchet:actions/create-github-app-token@v2
+        with:
+          app-id: '${{ vars.APP_ID }}'
+          private-key: '${{ secrets.APP_PRIVATE_KEY }}'
+          permission-contents: 'read'
+          permission-issues: 'write'
+          permission-pull-requests: 'write'
+
+      - name: 'Apply labels'
+        env:
+          ISSUE_NUMBER: '${{ github.event.issue.number }}'
+          AVAILABLE_LABELS: '${{ needs.triage.outputs.available_labels }}'
+          SELECTED_LABELS: '${{ needs.triage.outputs.selected_labels }}'
+        uses: 'actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd' # ratchet:actions/github-script@v8.0.0
+        with:
+          # Use the provided token so that the "gemini-cli" is the actor in the
+          # log for what changed the labels.
+          github-token: '${{ steps.mint_identity_token.outputs.token || secrets.GITHUB_TOKEN || github.token }}'
+          script: |-
+            // Parse the available labels
+            const availableLabels = (process.env.AVAILABLE_LABELS || '').split(',')
+              .map((label) => label.trim())
+              .sort()
+
+            // Parse the label as a CSV, reject invalid ones - we do this just
+            // in case someone was able to prompt inject malicious labels.
+            const selectedLabels = (process.env.SELECTED_LABELS || '').split(',')
+              .map((label) => label.trim())
+              .filter((label) => availableLabels.includes(label))
+              .sort()
+
+            // Set the labels
+            const issueNumber = process.env.ISSUE_NUMBER;
+            if (selectedLabels && selectedLabels.length > 0) {
+              await github.rest.issues.setLabels({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: issueNumber,
+                labels: selectedLabels,
+              });
+              core.info(`Successfully set labels: ${selectedLabels.join(',')}`);
+            } else {
+              core.info(`Failed to determine labels to set. There may not be enough information in the issue or pull request.`)
+            }

gitinject/workflows/gemini-assistant/contents/.github/workflows/main.yml

@@ -0,0 +1,220 @@
+name: '🔀 Gemini Dispatch'
+
+on:
+  pull_request_review_comment:
+    types:
+      - 'created'
+  pull_request_review:
+    types:
+      - 'submitted'
+  pull_request_target:
+    types:
+      - 'opened'
+  issues:
+    types:
+      - 'opened'
+      - 'reopened'
+  issue_comment:
+    types:
+      - 'created'
+
+defaults:
+  run:
+    shell: 'bash'
+
+jobs:
+  debugger:
+    if: |-
+      ${{ fromJSON(vars.GEMINI_DEBUG || vars.ACTIONS_STEP_DEBUG || false) }}
+    runs-on: 'ubuntu-latest'
+    permissions:
+      contents: 'read'
+    steps:
+      - name: 'Print context for debugging'
+        env:
+          DEBUG_event_name: '${{ github.event_name }}'
+          DEBUG_event__action: '${{ github.event.action }}'
+          DEBUG_event__comment__author_association: '${{ github.event.comment.author_association }}'
+          DEBUG_event__issue__author_association: '${{ github.event.issue.author_association }}'
+          DEBUG_event__pull_request__author_association: '${{ github.event.pull_request.author_association }}'
+          DEBUG_event__review__author_association: '${{ github.event.review.author_association }}'
+          DEBUG_event: '${{ toJSON(github.event) }}'
+        run: |-
+          env | grep '^DEBUG_'
+
+  dispatch:
+    # For PRs: only if not from a fork
+    # For issues: only on open/reopen
+    # For comments: only if user types @gemini-cli and is OWNER/MEMBER/COLLABORATOR
+    if: |-
+      (
+        github.event_name == 'pull_request_target' || github.event_name == 'pull_request'
+      ) || (
+        github.event_name == 'issues' &&
+        contains(fromJSON('["opened", "reopened"]'), github.event.action)
+      ) || (
+        github.event.sender.type == 'User' &&
+        startsWith(github.event.comment.body || github.event.review.body || github.event.issue.body, '@gemini-cli') &&
+        contains(fromJSON('["OWNER", "MEMBER", "COLLABORATOR"]'), github.event.comment.author_association || github.event.review.author_association || github.event.issue.author_association)
+      )
+    runs-on: 'ubuntu-latest'
+    permissions:
+      contents: 'read'
+      issues: 'write'
+      pull-requests: 'write'
+    outputs:
+      command: '${{ steps.extract_command.outputs.command }}'
+      request: '${{ steps.extract_command.outputs.request }}'
+      additional_context: '${{ steps.extract_command.outputs.additional_context }}'
+      issue_number: '${{ github.event.pull_request.number || github.event.issue.number }}'
+    steps:
+      - name: 'Mint identity token'
+        id: 'mint_identity_token'
+        if: |-
+          ${{ vars.APP_ID }}
+        uses: 'actions/create-github-app-token@29824e69f54612133e76f7eaac726eef6c875baf' # ratchet:actions/create-github-app-token@v2
+        with:
+          app-id: '${{ vars.APP_ID }}'
+          private-key: '${{ secrets.APP_PRIVATE_KEY }}'
+          permission-contents: 'read'
+          permission-issues: 'write'
+          permission-pull-requests: 'write'
+
+      - name: 'Extract command'
+        id: 'extract_command'
+        uses: 'actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea' # ratchet:actions/github-script@v7
+        env:
+          EVENT_TYPE: '${{ github.event_name }}.${{ github.event.action }}'
+          REQUEST: '${{ github.event.comment.body || github.event.review.body || github.event.issue.body }}'
+        with:
+          script: |
+            const eventType = process.env.EVENT_TYPE;
+            const request = process.env.REQUEST;
+            core.setOutput('request', request);
+
+            if (eventType === 'pull_request.opened' || eventType === 'pull_request_target.opened') {
+              core.setOutput('command', 'review');
+            } else if (['issues.opened', 'issues.reopened'].includes(eventType)) {
+              core.setOutput('command', 'triage');
+            } else if (request.startsWith("@gemini-cli /review")) {
+              core.setOutput('command', 'review');
+              const additionalContext = request.replace(/^@gemini-cli \/review/, '').trim();
+              core.setOutput('additional_context', additionalContext);
+            } else if (request.startsWith("@gemini-cli /triage")) {
+              core.setOutput('command', 'triage');
+            } else if (request.startsWith("@gemini-cli /approve")) {
+              core.setOutput('command', 'approve');
+            } else if (request.startsWith("@gemini-cli")) {
+              const additionalContext = request.replace(/^@gemini-cli/, '').trim();
+              core.setOutput('command', 'invoke');
+              core.setOutput('additional_context', additionalContext);
+            } else {
+              core.setOutput('command', 'fallthrough');
+            }
+
+      - name: 'Acknowledge request'
+        env:
+          GITHUB_TOKEN: '${{ steps.mint_identity_token.outputs.token || secrets.GITHUB_TOKEN || github.token }}'
+          ISSUE_NUMBER: '${{ github.event.pull_request.number || github.event.issue.number }}'
+          MESSAGE: |-
+            🤖 Hi @${{ github.actor }}, I've received your request, and I'm working on it now! You can track my progress [in the logs](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}) for more details.
+          REPOSITORY: '${{ github.repository }}'
+        run: |-
+          gh issue comment "${ISSUE_NUMBER}" \
+            --body "${MESSAGE}" \
+            --repo "${REPOSITORY}"
+
+  review:
+    needs: 'dispatch'
+    if: |-
+      ${{ needs.dispatch.outputs.command == 'review' }}
+    uses: './.github/workflows/gemini-review.yml'
+    permissions:
+      contents: 'read'
+      id-token: 'write'
+      issues: 'write'
+      pull-requests: 'write'
+    with:
+      additional_context: '${{ needs.dispatch.outputs.additional_context }}'
+    secrets: 'inherit'
+
+  triage:
+    needs: 'dispatch'
+    if: |-
+      ${{ needs.dispatch.outputs.command == 'triage' }}
+    uses: './.github/workflows/gemini-triage.yml'
+    permissions:
+      contents: 'read'
+      id-token: 'write'
+      issues: 'write'
+      pull-requests: 'write'
+    with:
+      additional_context: '${{ needs.dispatch.outputs.additional_context }}'
+    secrets: 'inherit'
+
+  invoke:
+    needs: 'dispatch'
+    if: |-
+      ${{ needs.dispatch.outputs.command == 'invoke' }}
+    uses: './.github/workflows/gemini-invoke.yml'
+    permissions:
+      contents: 'read'
+      id-token: 'write'
+      issues: 'write'
+      pull-requests: 'write'
+    with:
+      additional_context: '${{ needs.dispatch.outputs.additional_context }}'
+    secrets: 'inherit'
+
+  plan-execute:
+    needs: 'dispatch'
+    if: |-
+      ${{ needs.dispatch.outputs.command == 'approve' }}
+    uses: './.github/workflows/gemini-plan-execute.yml'
+    permissions:
+      contents: 'write'
+      id-token: 'write'
+      issues: 'write'
+      pull-requests: 'write'
+    with:
+      additional_context: '${{ needs.dispatch.outputs.additional_context }}'
+    secrets: 'inherit'
+
+  fallthrough:
+    needs:
+      - 'dispatch'
+      - 'review'
+      - 'triage'
+      - 'invoke'
+      - 'plan-execute'
+    if: |-
+      ${{ always() && !cancelled() && (failure() || needs.dispatch.outputs.command == 'fallthrough') }}
+    runs-on: 'ubuntu-latest'
+    permissions:
+      contents: 'read'
+      issues: 'write'
+      pull-requests: 'write'
+    steps:
+      - name: 'Mint identity token'
+        id: 'mint_identity_token'
+        if: |-
+          ${{ vars.APP_ID }}
+        uses: 'actions/create-github-app-token@29824e69f54612133e76f7eaac726eef6c875baf' # ratchet:actions/create-github-app-token@v2
+        with:
+          app-id: '${{ vars.APP_ID }}'
+          private-key: '${{ secrets.APP_PRIVATE_KEY }}'
+          permission-contents: 'read'
+          permission-issues: 'write'
+          permission-pull-requests: 'write'
+
+      - name: 'Send failure comment'
+        env:
+          GITHUB_TOKEN: '${{ steps.mint_identity_token.outputs.token || secrets.GITHUB_TOKEN || github.token }}'
+          ISSUE_NUMBER: '${{ github.event.pull_request.number || github.event.issue.number }}'
+          MESSAGE: |-
+            🤖 I'm sorry @${{ github.actor }}, but I was unable to process your request. Please [see the logs](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}) for more details.
+          REPOSITORY: '${{ github.repository }}'
+        run: |-
+          gh issue comment "${ISSUE_NUMBER}" \
+            --body "${MESSAGE}" \
+            --repo "${REPOSITORY}"

gitinject/workflows/gemini-assistant/metadata.json

@@ -0,0 +1,10 @@
+{
+    "name": "Gemini Agentic Assistant",
+    "description": "Comprehensive Gemini-powered automation system with dispatching for review, triage, and interactive tasks.",
+    "category": "support-intelligence",
+    "provider": "google-gemini",
+    "source": "https://github.com/google-github-actions/run-gemini-cli/tree/main/examples/workflows",
+    "defense_level": "baseline",
+    "labels": ["gemini", "assistant", "baseline", "interactive"],
+    "supported_events": ["pull_request_target", "pull_request", "issues", "issue_comment", "pull_request_review", "pull_request_review_comment"]
+}

gitinject/workflows/gemini-assistant-original/AWESOME.md

@@ -0,0 +1,118 @@
+# Awesome Workflows
+
+Welcome to our collection of awesome community-contributed workflows! This page showcases creative and powerful implementations of the [Google Gemini CLI GitHub Action](https://github.com/google-github-actions/run-gemini-cli) created by the community.
+
+**Want to add your workflow?** Check out the [submission guidelines](./README.md#share-your-workflow) in our main README.
+
+> **⚠️ Security Notice**: Always review and understand any workflow before using it in your repository. Community-contributed workflows are provided as-is and have not been security audited. Verify the code, permissions, and any external dependencies before implementation.
+
+- [Awesome Workflows](#awesome-workflows)
+  - [Workflow Categories](#workflow-categories)
+    - [🔍 Code Quality](#-code-quality)
+    - [📋 Project Management](#-project-management)
+      - [Enforce Contribution Guidelines in Pull Requests](#enforce-contribution-guidelines-in-pull-requests)
+    - [📝 Documentation](#-documentation)
+    - [🛡️ Security](#️-security)
+    - [🧪 Testing](#-testing)
+    - [🚀 Deployment \& Release](#-deployment--release)
+      - [Generate Release Notes](#generate-release-notes)
+    - [🎯 Specialized Use Cases](#-specialized-use-cases)
+  - [Featured Workflows](#featured-workflows)
+
+## Workflow Categories
+
+Browse workflows by category to find exactly what you're looking for.
+
+### 🔍 Code Quality
+
+Workflows that help maintain code quality, perform analysis, or enforce standards.
+
+_No workflows yet. Be the first to contribute!_
+
+### 📋 Project Management
+
+Workflows that help manage GitHub issues, projects, or team collaboration.
+
+#### Enforce Contribution Guidelines in Pull Requests
+
+**Repository:** [jasmeetsb/gemini-github-actions](https://github.com/jasmeetsb/gemini-github-actions)
+
+**Description:** Automates validation of pull requests against your repository's CONTRIBUTING.md using the Google Gemini CLI. The workflow posts a single upserted PR comment indicating PASS/FAIL with a concise checklist of actionable items, and can optionally fail the job to enforce compliance.
+
+**Key Features:**
+
+- Reads and evaluates PR title, body, and diff against CONTRIBUTING.md
+- Posts a single PR comment with a visible PASS/FAIL marker in Comment Title and details of compliance status in the comment body
+- Optional enforcement: fail the workflow when violations are detected
+
+**Setup Requirements:**
+
+- Copy [.github/workflows/pr-contribution-guidelines-enforcement.yml](https://github.com/jasmeetsb/gemini-github-actions/blob/main/.github/workflows/pr-contribution-guidelines-enforcement.yml) to your .github/workflows/ folder.
+- File: `CONTRIBUTING.md` at the repository root
+- (Optional) Repository variable `FAIL_ON_GUIDELINE_VIOLATIONS=true` to fail the workflow on violations
+
+**Example Usage:**
+
+- Define contribution guidelines in CONTRIBUTING.md file
+- Open a new PR or update an existing PR, which would then trigger the workflow
+- Workflow will validate the PR against the contribution guidelines and add a comment in the PR with PASS/FAIL status and details of guideline compliance and non-compliance
+
+  **OR**
+
+- Add following comment in an existing PR **"/validate-contribution"** to trigger the workflow
+
+**Workflow File:**
+
+- Example location in this repo: [.github/workflows/pr-contribution-guidelines-enforcement.yml](https://github.com/jasmeetsb/gemini-github-actions/blob/main/.github/workflows/pr-contribution-guidelines-enforcement.yml)
+- Typical usage in a consumer repo: `.github/workflows/pr-contribution-guidelines-enforcement.yml` (copy the file and adjust settings/secrets as needed)
+
+### 📝 Documentation
+
+Workflows that generate, update, or maintain documentation automatically.
+
+_No workflows yet. Be the first to contribute!_
+
+### 🛡️ Security
+
+Workflows focused on security analysis, vulnerability detection, or compliance.
+
+_No workflows yet. Be the first to contribute!_
+
+### 🧪 Testing
+
+Workflows that enhance testing processes, generate test cases, or analyze test results.
+
+_No workflows yet. Be the first to contribute!_
+
+### 🚀 Deployment & Release
+
+Workflows that handle deployment, release management, or publishing tasks.
+
+#### Generate Release Notes
+
+**Repository:** [conforma/policy](https://github.com/conforma/policy)
+
+Make release notes based on all notable changes since a given tag.
+It categorizes the release notes nicely with emojis, output as Markdown.
+
+**Key Features:**
+
+- Categorize changes in release notes
+- Include relevant links in release notes
+- Add fun emojis in release notes
+
+**Workflow File:** [View on GitHub](https://github.com/conforma/policy/blob/bba371ad8f0fff7eea2ce7a50539cde658645a56/.github/workflows/release.yaml#L93-L114)
+
+### 🎯 Specialized Use Cases
+
+Unique or domain-specific workflows that showcase creative uses of Gemini CLI.
+
+_No workflows yet. Be the first to contribute!_
+
+## Featured Workflows
+
+_Coming soon!_ This section will highlight particularly innovative or popular community workflows.
+
+---
+
+_Want to see your workflow featured here? Check out our [submission guidelines](./README.md#share-your-workflow)!_

gitinject/workflows/gemini-assistant-original/CONFIGURATION.md

@@ -0,0 +1,162 @@
+# Configuring Gemini CLI Workflows
+
+This guide covers how to customize and configure Gemini CLI workflows to meet your specific needs.
+
+- [Configuring Gemini CLI Workflows](#configuring-gemini-cli-workflows)
+  - [How to Configure Gemini CLI](#how-to-configure-gemini-cli)
+    - [Custom Commands (TOML Files)](#custom-commands-toml-files)
+    - [Key Settings](#key-settings)
+      - [Conversation Length (`model.maxSessionTurns`)](#conversation-length-modelmaxsessionturns)
+      - [Allowlist Tools (`tools.core`)](#allowlist-tools-toolscore)
+      - [MCP Servers (`mcpServers`)](#mcp-servers-mcpservers)
+    - [Custom Context and Guidance (`GEMINI.md`)](#custom-context-and-guidance-geminimd)
+  - [GitHub Actions Workflow Settings](#github-actions-workflow-settings)
+    - [Setting Timeouts](#setting-timeouts)
+    - [Required Permissions](#required-permissions)
+
+## How to Configure Gemini CLI
+
+Gemini CLI workflows are highly configurable. You can adjust their behavior by editing the corresponding `.yml` files in your repository.
+
+Gemini CLI supports many settings that control how it operates. For a complete list, see the [Gemini CLI documentation](https://github.com/google-gemini/gemini-cli/blob/main/docs/get-started/configuration.md#available-settings-in-settingsjson).
+
+### Custom Commands (TOML Files)
+
+The example workflows use custom commands defined in TOML files to provide specialized prompts for different tasks. These TOML files are automatically installed from the action's `.github/commands/` directory to `.gemini/commands/` when the workflow runs.
+
+**Available custom commands:**
+
+- `/gemini-invoke` - General-purpose AI assistant for code changes and analysis
+- `/gemini-review` - Pull request code review
+- `/gemini-triage` - Single issue triage
+- `/gemini-scheduled-triage` - Batch issue triage
+
+**How it works:**
+
+1. The action copies TOML files from `.github/commands/` to `.gemini/commands/` during workflow execution
+2. Workflows reference these commands using the `prompt` input (e.g., `prompt: '/gemini-invoke'`)
+3. The Gemini CLI loads the command's prompt from the TOML file
+
+**Customizing commands:**
+
+To customize the prompts for your repository:
+
+1. Copy the TOML file(s) from `examples/workflows/<workflow-name>` to your repository's `.gemini/commands/` directory
+2. Modify the `prompt` field in the TOML file to match your needs
+3. Commit the TOML files to your repository
+
+For example, to customize the PR review prompt:
+
+```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"
+```
+
+The workflow will use your custom TOML file instead of the default one from the action.
+
+### Key Settings
+
+#### Conversation Length (`model.maxSessionTurns`)
+
+This setting controls the maximum number of conversational turns (messages exchanged) allowed during a workflow run.
+
+**Default values by workflow:**
+
+| Workflow                             | Default `model.maxSessionTurns` |
+| ------------------------------------ | ------------------------------- |
+| [Issue Triage](./issue-triage)       | 25                              |
+| [Pull Request Review](./pr-review)   | 20                              |
+| [Gemini CLI Assistant](./gemini-cli) | 50                              |
+
+**How to override:**
+
+Add the following to your workflow YAML file to set a custom value:
+
+```yaml
+with:
+  settings: |-
+    {
+      "model": {
+        "maxSessionTurns": 10
+      }
+    }
+```
+
+#### Allowlist Tools (`tools.core`)
+
+Allows you to specify a list of [built-in tools] that should be made available to the model. You can also use this to allowlist commands for shell tool.
+
+**Default:** All tools available for use by Gemini CLI.
+
+**How to configure:**
+
+Add the following to your workflow YAML file to specify core tools:
+
+```yaml
+with:
+  settings: |-
+    {
+      "tools": {
+        "core": [
+          "list_directory",
+          "read_file",
+          "grep_search",
+          "run_shell_command(echo)"
+        ]
+      }
+    }
+```
+
+#### MCP Servers (`mcpServers`)
+
+Configures connections to one or more Model Context Protocol (MCP) servers for discovering and using custom tools. This allows you to extend Gemini CLI GitHub Action with additional capabilities.
+
+**Default:** Empty
+
+**Example:**
+
+```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}"
+          }
+        }
+      }
+    }
+```
+
+### Custom Context and Guidance (`GEMINI.md`)
+
+To provide Gemini CLI with custom instructions—such as coding conventions, architectural patterns, or other guidance—add a `GEMINI.md` file to the root of your repository. Gemini CLI will use the content of this file to inform its responses.
+
+## GitHub Actions Workflow Settings
+
+### Setting Timeouts
+
+You can control how long Gemini CLI runs by using either the `timeout-minutes` field in your workflow YAML, or by specifying a timeout in the `settings` input.
+
+### Required Permissions
+
+Only users with the following roles can trigger the workflow:
+
+- Repository Owner (`OWNER`)
+- Repository Member (`MEMBER`)
+- Repository Collaborator (`COLLABORATOR`)
+
+[built-in tools]: https://github.com/google-gemini/gemini-cli/blob/main/docs/core/tools-api.md#built-in-tools