convez.ai
MCP ServerAutomaçãoIntermediário
google-gemini

Gemini CLI

google-gemini/gemini-cli

Acesso direto ao Gemini no terminal com ferramentas integradas

Ver no GitHub
ExcelentePluginScore · de 0 a 100

Um agente IA de código aberto que leva o poder do Gemini diretamente para seu terminal. Oferece acesso leve aos modelos Gemini 3 com ferramentas integradas como Google Search, operações de arquivo e execução de comandos shell, além de suporte extensível via MCP.

Instalação

$npx convez-ai google-gemini/gemini-cli

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
109 mil
Forks
15 mil
Acompanhando
582
Saúde
75%
Último commit
há 1 dia
Versão
v0.68.0
Issues abertas
739
Contribuidores
681

Casos de uso

  • Automação de tarefas via linha de comando com IA
  • Busca e processamento de informações web no terminal
  • Prototipagem rápida e experimentação com modelos Gemini
  • Extensão de capacidades via Model Context Protocol

Veredito

Ferramenta sólida da Google com tier gratuito generoso e integração nativa de ferramentas (search, shell, arquivos). Ideal para desenvolvedores que trabalham em terminal, mas requer configuração de credenciais Gemini.

README em português

Gemini CLI

Gemini CLI CI Gemini CLI E2E (Chained) Version License View Code Wiki

Gemini CLI Screenshot

O Gemini CLI é um agente de IA open-source que traz o poder do Gemini diretamente para seu terminal. Ele oferece acesso leve ao Gemini, proporcionando a rota mais direta entre seus prompts e nosso modelo.

Saiba tudo sobre o Gemini CLI em nossa documentação.

🚀 Por que usar o Gemini CLI?

  • 🎯 Plano gratuito: 60 solicitações/minuto e 1.000 solicitações/dia com uma conta pessoal do Google.
  • 🧠 Modelos poderosos do Gemini 3: Acesso a raciocínio aprimorado e janela de contexto de 1M tokens.
  • 🔧 Ferramentas integradas: Pesquisa na web para fundamentação, operações de arquivo, comandos de shell e obtenção de dados da web.
  • 🔌 Extensível: Suporte ao MCP (Model Context Protocol) para integrações personalizadas.
  • 💻 Focado no terminal: Projetado para desenvolvedores que vivem na linha de comando.
  • 🛡️ Open source: Licenciado sob Apache 2.0.

📦 Instalação

Veja Instalação, execução e releases do Gemini CLI para as especificações recomendadas de sistema e um guia detalhado de instalação.

Instalação Rápida

Execute instantaneamente com npx

# Using npx (no installation required)
npx @google/gemini-cli

Instale globalmente com npm

npm install -g @google/gemini-cli

Instale globalmente com Homebrew (macOS/Linux)

brew install gemini-cli

Instale globalmente com MacPorts (macOS)

sudo port install gemini-cli

Instale com Anaconda (para ambientes restritos)

# Create and activate a new environment
conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env

# Install Gemini CLI globally via npm (inside the environment)
npm install -g @google/gemini-cli

Canais de Release

Veja Releases para mais detalhes.

Preview

Novas versões preview serão publicadas semanalmente às 23:59 UTC, terças-feiras. Essas versões ainda não terão sido totalmente validadas e podem conter regressões ou outros problemas pendentes. Por favor, ajude-nos a testar e instale com o tag preview.

npm install -g @google/gemini-cli@preview

Stable

  • Novas releases estáveis serão publicadas semanalmente às 20:00 UTC, terças-feiras; esta será a promoção completa da release preview da semana anterior + quaisquer correções de bugs e validações. Use o tag latest.
npm install -g @google/gemini-cli@latest

Nightly

  • Novas releases serão publicadas diariamente às 00:00 UTC. Isso incluirá todas as alterações do branch principal conforme representadas no momento da release. Deve-se assumir que há validações pendentes e problemas em aberto. Use o tag nightly.
npm install -g @google/gemini-cli@nightly

📋 Principais Funcionalidades

Compreensão de Código & Geração

  • Consulte e edite grandes bases de código
  • Gere novos aplicativos a partir de PDFs, imagens ou esboços usando capacidades multimodais
  • Depure problemas e resolva-os com linguagem natural

Automação & Integração

  • Automatize tarefas operacionais como consulta de pull requests ou gerenciamento de complexos rebases
  • Use servidores MCP para conectar novas capacidades, incluindo geração de mídia com Imagen, Veo ou Lyria
  • Execute não interativamente em scripts para automação de fluxos de trabalho

Capacidades Avançadas

  • Fundamente suas consultas com a Pesquisa do Google integrada para informações em tempo real
  • Salvamento e retomada de sessões complexas (checkpointing de conversação)
  • Arquivos de contexto personalizados (GEMINI.md) para adaptar o comportamento aos seus projetos

Integração com GitHub

Integre o Gemini CLI diretamente nos fluxos de trabalho do seu GitHub com Gemini CLI GitHub Action:

  • Revisões de Pull Request: Revisão automatizada de código com feedback contextual e sugestões
  • Triagem de Issues: Rotulagem e priorização automatizadas de issues do GitHub baseadas em análise de conteúdo
  • Assistência sob Demanda: Mencione @gemini-cli em issues e pull requests para ajuda com depuração, explicações ou delegação de tarefas
  • Fluxos de Trabalho Personalizados: Construa fluxos de trabalho automatizados, agendados e sob demanda adaptados às necessidades da sua equipe

🔐 Opções de Autenticação

Escolha o método de autenticação que melhor se adapta às suas necessidades:

Opção 1: Entrar com o Google (login OAuth usando sua conta do Google)

✨ Melhor para: Desenvolvedores individuais e qualquer pessoa que possua uma licença Code Assist Gemini. (veja limites de cota e termos de serviço para detalhes)

Benefícios:

  • Plano gratuito: 60 requisições/minuto e 1.000 requisições/dia
  • Modelos Gemini 3 com janela de contexto de 1M tokens
  • Sem gerenciamento de chave API - basta entrar com sua conta do Google
  • Atualizações automáticas para os modelos mais recentes

Inicie o CLI Gemini, em seguida escolha Entrar com o Google e siga o fluxo de autenticação no navegador quando solicitado

gemini

Se você estiver usando uma licença Code Assist paga da sua organização, lembre-se de definir o Projeto do Google Cloud

# Set your Google Cloud Project
export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
gemini

Opção 2: Chave API Gemini

✨ Melhor para: Desenvolvedores que precisam de controle específico sobre modelos ou acesso ao nível pago

Benefícios:

  • Plano gratuito: 1.000 requisições/dia com o Gemini 3 (mistura entre flash e pro)
  • Seleção de modelo: Escolha modelos específicos do Gemini
  • Faturamento baseado no uso: Atualize para limites mais altos quando necessário
# Get your key from https://aistudio.google.com/apikey
export GEMINI_API_KEY="YOUR_API_KEY"
gemini

Opção 3: Vertex AI

✨ Melhor para: Equipes corporativas e cargas de trabalho em produção

Benefícios:

  • Recursos Enterprise: Segurança avançada e conformidade
  • Escalável: Limites de taxa mais altos com conta de faturamento
  • Integração: Funciona com infraestrutura existente do Google Cloud
# Get your key from Google Cloud Console
export GOOGLE_API_KEY="YOUR_API_KEY"
export GOOGLE_GENAI_USE_VERTEXAI=true
gemini

Para contas do Google Workspace e outros métodos de autenticação, veja o guia de autenticação.

🚀 Começando

Uso Básico

Iniciar no diretório atual

gemini

Incluir múltiplos diretórios

gemini --include-directories ../lib,../docs

Usar modelo específico

gemini -m gemini-2.5-flash

Modo não interativo para scripts

Obtenha uma resposta de texto simples:

gemini -p "Explain the architecture of this codebase"

Para scripting mais avançado, incluindo como analisar JSON e lidar com erros, use a flag --output-format json para obter saída estruturada:

gemini -p "Explain the architecture of this codebase" --output-format json

Para streaming de eventos em tempo real (útil para monitorar operações de longa duração), use --output-format stream-json para obter eventos JSON delimitados por nova linha:

gemini -p "Run tests and deploy" --output-format stream-json

Exemplos Rápidos

Iniciar um novo projeto

cd new-project/
gemini
> Write me a Discord bot that answers questions using a FAQ.md file I will provide

Analisar código existente

git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> Give me a summary of all of the changes that went in yesterday

📚 Documentação

Começando

Recursos Principais

Ferramentas & Extensões

Tópicos Avançados

Troubleshooting & Support

  • Troubleshooting Guide - Common issues and solutions.
  • FAQ - Frequently asked questions.
  • Use /bug command to report issues directly from the CLI.

Using MCP Servers

Configure MCP servers in ~/.gemini/settings.json to extend Gemini CLI with custom tools:

> @github List my open pull requests
> @slack Send a summary of today's commits to #dev channel
> @database Run a query to find inactive users

See the MCP Server Integration guide for setup instructions.

🤝 Contributing

We welcome contributions! Gemini CLI is fully open source (Apache 2.0), and we encourage the community to:

  • Report bugs and suggest features.
  • Improve documentation.
  • Submit code improvements.
  • Share your MCP servers and extensions.

See our Contributing Guide for development setup, coding standards, and how to submit pull requests.

Check our Official Roadmap for planned features and priorities.

📖 Resources

Uninstall

See the Uninstall Guide for removal instructions.

📄 Legal


Ver o original no GitHub

Bom para

Relacionados