Guia AIOX para Gemini CLI

🌐 EN | PT | ES

Assistente CLI do Google AI - Desenvolvimento com IA em Linha de Comando

Visão Geral

O que é o Gemini CLI?

Gemini CLI é a interface de linha de comando do Google para interagir com modelos Gemini AI. Ele fornece aos desenvolvedores acesso direto via terminal às capacidades de IA do Google, incluindo suporte multimodal para texto, código e imagens.

Por que usar AIOX com Gemini CLI?

O Gemini CLI oferece capacidades únicas:

Fluxo de Trabalho CLI: Experiência pura de terminal
Modelos Google AI: Acesso aos modelos Gemini
Suporte Multimodal: Entendimento de texto, código e imagens
Ativação por Prompt: Ativação de agentes em linguagem natural
Integração Shell: Funciona com suas ferramentas existentes

Comparação com Outras Plataformas

Recurso	Gemini CLI	Claude Code	Cursor
Baseado em CLI	Sim	Sim	Não
Multimodal	Sim	Limitado	Não
Ativação de Agente	Prompt	/comando	@mention
Suporte MCP	Não	Nativo	Config
Modelos Google	Sim	Não	Não

Requisitos

Requisitos de Sistema

Requisito	Mínimo	Recomendado
SO	macOS, Linux, Windows	macOS, Linux
Node.js	18.0+	20.0+
Python	3.9+ (opcional)	3.11+

Requisitos de Conta

Chave de API Google AI ou Conta Google Cloud
Acesso à API Gemini

Instalação

Passo 1: Instalar o Gemini CLI

# Instalar via npm (requer Node.js 18+)
npm install -g @google/gemini-cli

# Ou executar sem instalação
npx @google/gemini-cli

# Ou via conda
conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env
npm install -g @google/gemini-cli

Passo 2: Autenticar

# Login com conta Google
gemini auth login

# Ou definir chave de API
export GOOGLE_AI_API_KEY="sua-chave-api"

Passo 3: Instalar o AIOX

cd seu-projeto
npx @anthropic/aiox init
# Selecione "Gemini CLI" quando solicitado

Passo 4: Verificar a Instalação

ls -la .gemini/

Estrutura esperada:

.gemini/
├── rules.md           # Regras principais
├── agents/            # Definições de agentes
│   ├── dev.md
│   ├── qa.md
│   └── ...
└── config.json        # Configuração do CLI

Configuração

Arquivo de Regras

Localização: .gemini/rules.md

# Regras Synkra AIOX para Gemini CLI

## Sistema de Agentes
- Inclua contexto de agente em seus prompts
- Use "Como agente [agente]..." para ativação

## Padrões de Desenvolvimento
- Escreva código limpo e testado
- Siga padrões existentes

Configuração do CLI

Localização: .gemini/config.json

{
  "model": "gemini-pro",
  "temperature": 0.7,
  "maxOutputTokens": 8192,
  "agents": {
    "default": "dev",
    "available": ["dev", "qa", "architect", "pm"]
  }
}

Arquivos de Agente

Localização: .gemini/agents/

# Agente Desenvolvedor

## Ativação
Inclua "Como agente AIOX dev" no seu prompt.

## Persona
Desenvolvedor Full Stack Sênior com expertise em:
- TypeScript/JavaScript
- Node.js, React
- Design de banco de dados

## Fluxo de Trabalho
1. Ler requisitos
2. Planejar implementação
3. Escrever código limpo
4. Testar completamente

Uso Básico

Iniciando o Gemini CLI

# Modo interativo
gemini

# Prompt único
gemini "Explique este código"

# Com contexto de arquivo
gemini --file src/main.ts "Revise este código"

Ativando Agentes AIOX

Inclua contexto de agente nos prompts:

# Agente desenvolvedor
gemini "Como agente AIOX dev, implemente a feature de login"

# Agente QA
gemini "Como agente AIOX qa, revise este código para segurança"

# Agente arquiteto
gemini "Como agente AIOX architect, projete o schema do banco de dados"

Com Arquivos de Contexto

# Incluir arquivo de regras
gemini --context .gemini/rules.md "Implemente feature de auth"

# Incluir agente específico
gemini --context .gemini/agents/dev.md "Crie modelo de usuário"

Integração Shell

# Pipe código para revisão
cat src/auth.ts | gemini "Como AIOX qa, revise este código"

# Gerar código
gemini "Crie um endpoint REST API" > src/api/users.ts

# Sessão interativa
gemini --interactive

Uso Avançado

Capacidades Multimodais

# Analisar imagem
gemini --image screenshot.png "Explique este design de UI"

# Código + imagem
gemini --file src/component.tsx --image mockup.png \
  "Atualize componente para corresponder ao design"

Gerenciamento de Sessão

# Iniciar sessão nomeada
gemini --session feature-dev

# Continuar sessão
gemini --session feature-dev "Agora adicione testes"

# Listar sessões
gemini sessions list

Operações em Lote

# Processar múltiplos arquivos
for file in src/*.ts; do
  gemini --file "$file" "Como AIOX qa, revise este arquivo" >> reviews.md
done

Comandos Personalizados

Crie aliases no shell:

# ~/.bashrc ou ~/.zshrc
alias gdev='gemini --context .gemini/agents/dev.md'
alias gqa='gemini --context .gemini/agents/qa.md'
alias garch='gemini --context .gemini/agents/architect.md'

Uso:

gdev "Implemente autenticação de usuário"
gqa "Revise o módulo de auth"

Recursos Específicos do Gemini CLI

Seleção de Modelo

# Usar modelo específico
gemini --model gemini-pro "Query"
gemini --model gemini-pro-vision "Analisar imagem"

Formatos de Saída

# Saída JSON
gemini --output json "Gere schema de API"

# Markdown
gemini --output markdown "Documente esta função"

# Apenas código
gemini --output code "Crie uma função de ordenação"

Streaming

# Habilitar saída streaming
gemini --stream "Escreva uma explicação longa"

Sincronização de Agentes

Como Funciona

flowchart LR
    Source["AIOX Core<br/>.aiox-core/development/agents"] --> Parser["Parser de Agente"]
    Parser --> Transform["Transformador Gemini"]
    Transform --> Output[".gemini/agents/"]

Comandos de Sincronização

# Sincronizar todos os agentes
npm run sync:ide

# Sincronizar para Gemini CLI
npm run sync:ide -- --ide gemini

Formato de Agente

O Gemini CLI usa markdown otimizado para prompt:

# Agente Desenvolvedor

**Frase de Ativação:** "Como agente AIOX dev"

## Papel
Você é um Desenvolvedor Full Stack Sênior trabalhando com Synkra AIOX.

## Expertise
- TypeScript/JavaScript
- Node.js, React
- Design de banco de dados
- Desenvolvimento de API

## Instruções
Quando ativado:
1. Analise o pedido cuidadosamente
2. Considere padrões de código existentes
3. Forneça soluções limpas e testadas
4. Explique sua abordagem

## Formato de Resposta
- Comece com breve análise
- Forneça soluções de código
- Inclua explicações
- Sugira testes se aplicável

Limitações Conhecidas

Limitações Atuais

Limitação	Solução Alternativa
Sem suporte MCP	Use ferramentas externas
Sem contexto persistente	Use sessões
Ativação manual de agente	Use aliases do shell
Sem GUI	Apenas terminal

Gemini CLI vs Claude Code

Aspecto	Gemini CLI	Claude Code
Provedor	Google	Anthropic
MCP	Não	Nativo
Task Tool	Não	Sim
Multimodal	Sim	Limitado

Troubleshooting

Problemas Comuns

Falha de Autenticação

Error: Unable to authenticate

Solução:

gemini auth logout
gemini auth login
# Ou redefinir chave de API
export GOOGLE_AI_API_KEY="nova-chave"

Modelo Não Disponível

Error: Model 'xyz' not found

Solução:

# Listar modelos disponíveis
gemini models list

# Usar modelo disponível
gemini --model gemini-pro "Query"

Contexto Muito Longo

Error: Context exceeds limit

Solução:

Divida em partes menores
Use referências específicas de arquivo
Resuma o contexto

Logs

# Habilitar saída verbose
gemini --verbose "Query"

# Modo debug
GEMINI_DEBUG=1 gemini "Query"

FAQ

P: O Gemini CLI é gratuito? R: Sim, tier gratuito generoso: 60 requisições/minuto e 1000 requisições/dia sem custo. Suporta modelos Gemini Pro e Gemini Flash.

P: Posso usar modelos locais? R: Não, o Gemini CLI requer a API do Google.

P: Funciona offline? R: Não, requer conexão com internet.

P: Como troco de agentes rapidamente? R: Use aliases do shell ou inclua contexto de agente nos prompts.

Migração

Do Claude Code para Gemini CLI

Instale AIOX para Gemini CLI:

npx @anthropic/aiox init --ide gemini-cli

Agentes transformam para formato baseado em prompt

Do Gemini CLI para Outras IDEs

Agentes AIOX em .aiox-core/ são portáveis
Inicialize para a IDE de destino
Agentes transformam automaticamente

Recursos Adicionais

Synkra AIOX - Guia da Plataforma Gemini CLI v1.0

FilesExpand file tree

gemini-cli.md

Latest commit

History

gemini-cli.md

File metadata and controls

Guia AIOX para Gemini CLI

Visão Geral

O que é o Gemini CLI?

Por que usar AIOX com Gemini CLI?

Comparação com Outras Plataformas

Requisitos

Requisitos de Sistema

Requisitos de Conta

Instalação

Passo 1: Instalar o Gemini CLI

Passo 2: Autenticar

Passo 3: Instalar o AIOX

Passo 4: Verificar a Instalação

Configuração

Arquivo de Regras

Configuração do CLI

Arquivos de Agente

Uso Básico

Iniciando o Gemini CLI

Ativando Agentes AIOX

Com Arquivos de Contexto

Integração Shell

Uso Avançado

Capacidades Multimodais

Gerenciamento de Sessão

Operações em Lote

Comandos Personalizados

Recursos Específicos do Gemini CLI

Seleção de Modelo

Formatos de Saída

Streaming

Sincronização de Agentes

Como Funciona

Comandos de Sincronização

Formato de Agente

Limitações Conhecidas

Limitações Atuais

Gemini CLI vs Claude Code

Troubleshooting

Problemas Comuns

Falha de Autenticação

Modelo Não Disponível

Contexto Muito Longo

Logs

FAQ

Migração

Do Claude Code para Gemini CLI

Do Gemini CLI para Outras IDEs

Recursos Adicionais