Gemini CLI Action

Automate software development tasks within your GitHub repositories with Gemini CLI.

You can interact with Gemini by mentioning it in pull request comments and issues to perform tasks like code generation, analysis, and modification.

Features

• Comment-based Interaction: Trigger workflows in issue and pull request comments.
• Automated Issue Management: Automatically triage issues by applying labels based on issue content.
• Extensible with Tools: Leverage Gemini's tool-calling capabilities to interact with other CLIs like the gh CLI for powerful automations.
• Customizable: Use a GEMINI.md file in your repository to provide project-specific instructions and context to Gemini.

Getting Started

Before using this action, you need to:

1. Get a Gemini API Key: Obtain your API key from Google AI Studio.
2. Add it as a GitHub Secret: Store your API key as a secret in your repository with the name GEMINI_API_KEY. For more information, see the official GitHub documentation on creating and using encrypted secrets.

Usage and Examples

To use this action, create a workflow file in your repository (e.g., .github/workflows/gemini.yml).

The best way to get started is to copy one of the pre-built workflows from the /examples directory into your project's .github/workflows folder and customize it.

Here are some of the available examples:

• gemini-issue-triage.yml: Automatically analyzes and applies appropriate labels to newly opened issues. Can also be manually triggered by commenting @gemini /triage.

Inputs

• GEMINI_API_KEY (required): Your Gemini API key, stored as a GitHub secret.
• prompt (optional): A specific, multi-line prompt to guide Gemini's behavior. This is where you define the persona, workflow, and instructions for the model. The default is 'You are a helpful assistant.'.

Authentication

This action uses the gh CLI to interact with the GitHub API. You'll need to provide it with a token that has the necessary permissions for your use case.

When you create your GitHub App, you must grant it the correct permissions for your intended use cases. The permissions below are required for the provided example workflows to function correctly.

• Repository permissions:
  • Contents: Read-only - Allows the action to check out code and read repository files.
  • Issues: Read & write - Allows the action to read issue details and then comment on or label them.

Important: The permissions above are a baseline for the examples. If you create custom workflows that interact with the GitHub API in other ways (e.g., modifying projects, creating branches, managing deployments), you must update your GitHub App's permissions to grant the necessary access. Always follow the principle of least privilege, granting only the permissions your specific workflow requires.

For more information on creating and using GitHub Apps, see the documentation.

Customization

Create a GEMINI.md file in the root of your repository to provide project-specific context and instructions to Gemini. This is useful for defining coding conventions, architectural patterns, or other guidelines the model should follow.

Contributing

Contributions are welcome! Please open an issue or submit a pull request with your improvements.