Gemini CLI
google-gemini/gemini-cli
Acesso direto ao Gemini no terminal com ferramentas integradas
Ver no GitHubUm 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-cli1 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
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

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
previewda semana anterior + quaisquer correções de bugs e validações. Use o taglatest.
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-cliem 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
- Guia de Introdução Rápida - Coloque-se em funcionamento rapidamente.
- Configuração de Autenticação - Configuração detalhada de autenticação.
- Guia de Configuração - Definições e personalização.
- Atalhos de Teclado - Dicas de produtividade.
Recursos Principais
- Referência de Comandos - Todos os comandos com barra (
/help,/chat, etc). - Comandos Personalizados - Crie seus próprios comandos reutilizáveis.
- Arquivos de Contexto (GEMINI.md) - Forneça contexto persistente ao CLI Gemini.
- Checkpointing: Salve e retome conversações. (Documentação)
- Cache de Tokens - Otimize o uso de tokens.
Ferramentas & Extensões
- Visão Geral das Ferramentas Integradas
- Integração com Servidor MCP - Estenda com ferramentas personalizadas.
- Extensões Personalizadas - Crie e compartilhe seus próprios comandos.
Tópicos Avançados
- Modo Headless (Scripting) - Use o CLI Gemini em fluxos de trabalho automatizados.
- Integração com IDE - Companheiro para VS Code.
- Sandboxing & Segurança - Ambientes seguros de execução.
- Pastas Confiáveis - Controle políticas de execução por pasta.
- Guia Enterprise - Implante e gerencie em um ambiente corporativo.
- Telemetria & Monitoramento - Rastreamento de uso.
- Referência de Ferramentas - Visão geral das ferramentas integradas.
- Desenvolvimento Local - Ferramentas para desenvolvimento local.
Troubleshooting & Support
- Troubleshooting Guide - Common issues and solutions.
- FAQ - Frequently asked questions.
- Use
/bugcommand 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
- Free Course - Learn the basics.
- Official Roadmap - See what's coming next.
- Changelog - See recent notable updates.
- NPM Package - Package registry.
- GitHub Issues - Report bugs or request features.
- Security Advisories - Security updates.
Uninstall
See the Uninstall Guide for removal instructions.
📄 Legal
- License: Apache License 2.0
- Terms of Service: Terms & Privacy
- Security: Security Policy