cicd

Gemini CLI Extension for CI/CD

The CI/CD extension for Gemini CLI automates Continuous Integration and Continuous Delivery (CI/CD) workflows using AI. It simplifies deployment to Google Cloud services, such as Cloud Run and Cloud Storage, and generates secure CI/CD pipelines compliant with testing and security best practices.

[!CAUTION]

• EXPERIMENTAL PROJECT - Use with extreme care: This project is currently experimental. Features, commands, and functionality are subject to change and may contain bugs.

• Do not use this extension in production environments or with business-critical Google Cloud projects: You are responsible for any changes made to your cloud resources. Always carefully review and validate any generated configurations or commands before execution.

• Review all outputs and understand the Security Considerations below before use: as this extension can modify your Google Cloud (GCP) resources.

📋 Key Features

• Intelligent Code Deployment: Use the google-cicd-deploy skill to deploy your codebase. The extension leverages Gemini to analyze your project and deploy to Google Cloud services like Cloud Run for dynamic applications or Cloud Storage for static websites. Includes pre-deployment secret scanning.
• AI-Powered CI/CD Pipeline Design: Generate secure and robust CI/CD pipelines with google-cicd-pipeline-design. Collaborate with Gemini to tailor the pipeline and generate a YAML configuration.
• Terraform GCP Infrastructure: Provision and troubleshoot production-grade Google Cloud infrastructure using the google-cicd-terraform skill, enforcing Google’s Cloud Foundation Fabric patterns.
• Interactive GCP Management: The extension provides tools to interact directly with Google Cloud's CI/CD services (Cloud Build, Artifact Registry, Cloud Deploy, Developer Connect) from within Gemini CLI.
• Simplified Complex Release Flows: Build sophisticated Cloud Deploy release pipelines with the google-cicd-release-orchestration skill, setting up deployment strategies like canary and automatic rollbacks.
• Integrated CI/CD MCP Server: The extension includes a local Model Context Protocol (MCP) server, seamlessly integrating Gemini CLI with Google Cloud CI/CD services.

⚙️ Installation

✅ Prerequisites

• gcloud CLI: The Google Cloud CLI must be installed and available in your system's PATH.
• Google Cloud Project: You need a Google Cloud project with the necessary APIs enabled. Depending on your usage, the extension may require:
  • Cloud Build API
  • Artifact Registry API
  • Artifact Analysis API
  • Developer Connect API
  • Cloud Resource Manager API
  • Cloud Storage API
  • Cloud Run API
  • Google Kubernetes Engine API
• Application Default Credentials (ADC): Ensure Application Default Credentials are configured in your environment. You can set this up by running:

  gcloud auth login
  gcloud auth application-default login
  

For Gemini CLI

To install the CI/CD extension, run the following command in your terminal:

gemini extensions install https://github.com/gemini-cli-extensions/cicd

To install development build add --ref=nightly --pre-release flags.

• Gemini CLI: Version v0.15.0 or newer must be installed.
• Gemini CLI Authentication: Ensure you have configured Authentication Options.

For Claude Code

To install the CI/CD extension, run the following command in your terminal:

1. Add the Marketplace.

claude plugin marketplace add https://github.com/gemini-cli-extensions/cicd.git#v0.2.2

2. Install the Plugin.

claude plugin install cicd

For Antigravity

To install our CI/CD extension in Antigravity, you can setup our MCP Server as custom MCP and add skills.

1. Setup custom MCP server Follow the instructions at Connecting Custom MCP Servers. Use the provided .mcp.json file which contains our MCP server config.

2. Add Skills You can use Skills to add skills to Antigravity.

 npx skills add https://github.com/gemini-cli-extensions/cicd --global --all --agent antigravity

For Other Agents

To install our CI/CD extension in other agents, you can manually set up our MCP server and skills.

1. Set up MCP server Each agent will have their own process to set up an MCP server, but you can use the provided .mcp.json file which contains our MCP server config.