Repolode
google-github-actions

google-github-actions/run-gemini-cli

Uma GitHub Action que executa o Gemini CLI no seu repositório para revisar pull requests, fazer triagem de issues e atender a solicitações com @gemini-cli.

Estrelas
2,112
Forks
288
Issues abertas
85
Último commit
há 2 meses

O que é?

run-gemini-cli é uma GitHub Action que executa o Gemini CLI em workflows do GitHub. Ela pode realizar tarefas de forma autônoma, em horários programados ou em resposta a eventos, ou funcionar como assistente sob demanda quando alguém menciona @gemini-cli em um comentário de issue ou pull request.

A action inclui workflows prontos para revisar pull requests, fazer triagem de issues, atuar como assistente de conversação geral e encaminhar comandos de comentários ao workflow adequado. A ideia é copiar cada workflow para o diretório .github/workflows de um repositório e personalizá-lo. Um arquivo GEMINI.md no repositório fornece instruções específicas do projeto para o modelo.

A autenticação pode ser feita com uma chave da Gemini API, Vertex AI ou Workload Identity Federation no Google Cloud. Para acessar o GitHub, é possível usar o GITHUB_TOKEN padrão ou um GitHub App personalizado. Opcionalmente, dados de telemetria do OpenTelemetry podem ser enviados a um projeto do Google Cloud.

Recursos principais

  • 01Executa automaticamente em eventos como a abertura de issues ou pull requests, ou conforme um agendamento.
  • 02Responde a menções a @gemini-cli em comentários de issues e pull requests.
  • 03Permite que o Gemini chame ferramentas como o GitHub CLI (gh) durante uma tarefa.
  • 04Lê um arquivo GEMINI.md com instruções e contexto específicos do projeto.
  • 05Oferece suporte à autenticação por chave da Gemini API, Vertex AI e Workload Identity Federation.

Casos de uso

  • Revisar pull requests automaticamente quando forem abertos.
  • Fazer a triagem de novas issues do GitHub quando forem criadas ou em um agendamento noturno.
  • Pedir ao Gemini que explique código, sugira alterações ou escreva testes a partir de um comentário em uma issue ou PR.
  • Enviar dados de telemetria do workflow a um projeto do Google Cloud para monitoramento.

Início rápido

  1. 1

    Obtenha uma chave da Gemini API no Google AI Studio

  2. 2

    Adicione a chave como um segredo do repositório chamado GEMINI_API_KEY

  3. 3

    Inicie o Gemini CLI e execute o comando de configuração para criar os workflows

    gemini
  4. 4

    No Gemini CLI, digite /setup-github e, em seguida, abra um pull request ou mencione @gemini-cli em um comentário para testar

Antes de usar

  • É necessária uma chave da Gemini API armazenada como segredo do GitHub ou uma configuração do Google Cloud para o Vertex AI.
  • O valor padrão de gemini_cli_version é latest, então o comportamento do CLI pode mudar entre execuções se você não fixar uma versão.

Tópicos

Perguntas frequentes

O que é run-gemini-cli?
Uma GitHub Action que executa o Gemini CLI no seu repositório para revisar pull requests, fazer triagem de issues e atender a solicitações com @gemini-cli. run-gemini-cli é uma GitHub Action que executa o Gemini CLI em workflows do GitHub. Ela pode realizar tarefas de forma autônoma, em horários programados ou em resposta a eventos, ou funcionar como assistente sob demanda quando alguém menciona @gemini-cli em um comentário de issue ou pull request.
run-gemini-cli é gratuito? Qual é a licença?
run-gemini-cli é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
run-gemini-cli ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de run-gemini-cli foi em 21 de ago. de 2026.
Para que posso usar run-gemini-cli?
Revisar pull requests automaticamente quando forem abertos. Fazer a triagem de novas issues do GitHub quando forem criadas ou em um agendamento noturno. Pedir ao Gemini que explique código, sugira alterações ou escreva testes a partir de um comentário em uma issue ou PR. Enviar dados de telemetria do workflow a um projeto do Google Cloud para monitoramento.
Como instalar run-gemini-cli?
Obtenha uma chave da Gemini API no Google AI Studio Adicione a chave como um segredo do repositório chamado GEMINI_API_KEY Inicie o Gemini CLI e execute o comando de configuração para criar os workflows: gemini No Gemini CLI, digite /setup-github e, em seguida, abra um pull request ou mencione @gemini-cli em um comentário para testar
Onde consigo run-gemini-cli?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/google-github-actions/run-gemini-cli

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados