run-gemini-cli  by google-github-actions

GitHub Action for Gemini CLI integration

Created 6 months ago
1,660 stars

Top 25.3% on SourcePulse

GitHubView on GitHub
Project Summary

This GitHub Action integrates the Gemini CLI into development workflows, enabling autonomous agents for routine coding tasks and on-demand collaboration for code reviews, issue triage, and analysis. It targets developers and teams seeking to leverage AI for enhanced productivity and code quality within their GitHub repositories.

How It Works

The action leverages the Gemini CLI, allowing conversational interaction via comments (e.g., @gemini-cli fix this issue). It supports tool-calling capabilities, enabling integration with other CLIs like gh for extended functionality. Customization is achieved through a GEMINI.md file, providing project-specific context and instructions to the Gemini model.

Quick Start & Requirements

  1. Gemini API Key: Obtain from Google AI Studio and add as a GitHub Secret named GEMINI_API_KEY.
  2. Workflow Setup: Use the /setup-github command within the Gemini CLI or manually copy example workflows to .github/workflows/.
  3. Authentication: Supports Gemini API Key or Google Cloud Workload Identity Federation for Google services, and GITHUB_TOKEN or a custom GitHub App for GitHub API.
  4. Dependencies: Requires a Gemini API key. Optional Google Cloud project details for Vertex AI or enhanced observability.

Highlighted Details

  • Automated and on-demand triggering of workflows based on GitHub events or comments.
  • Extensible with tool-calling for integration with other CLIs.
  • Customizable with GEMINI.md for project-specific instructions.
  • Supports observability by sending telemetry to a Google Cloud project.

Maintenance & Community

This project is maintained by Google. Further details on contributing can be found in the Gemini CLI Contributing Guide.

Licensing & Compatibility

The README does not explicitly state the license. Compatibility for commercial use or closed-source linking is not specified.

Limitations & Caveats

The README does not specify the license, which may impact commercial use. Authentication methods and observability configurations require careful setup.

Health Check
Last Commit

4 days ago

Responsiveness

Inactive

Pull Requests (30d)
17
Issues (30d)
10
Star History
74 stars in the last 30 days

Explore Similar Projects

Starred by Patrick von Platen Patrick von Platen(Author of Hugging Face Diffusers; Research Engineer at Mistral), Simon Willison Simon Willison(Coauthor of Django), and
1 more.

mistral-vibe by mistralai

4.1%
3k
Conversational CLI coding agent for project interaction
Created 1 month ago
Updated 3 days ago
Feedback? Help us improve.