run-gemini-cli  by google-github-actions

GitHub Action for Gemini CLI integration

Created 7 months ago
1,803 stars

Top 23.4% 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

1 day ago

Responsiveness

Inactive

Pull Requests (30d)
16
Issues (30d)
12
Star History
105 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

2.4%
3k
Conversational CLI coding agent for project interaction
Created 2 months ago
Updated 6 days ago
Starred by Eric Zhu Eric Zhu(Coauthor of AutoGen; Research Scientist at Microsoft Research), Elie Bursztein Elie Bursztein(Cybersecurity Lead at Google DeepMind), and
27 more.

goose by block

1.6%
31k
Open-source AI agent for automating complex engineering tasks
Created 1 year ago
Updated 23 hours ago
Feedback? Help us improve.