Gemini CLI: Dicas para otimizar o uso da ferramenta

Trabalhando diariamente com automação e WordPress, percebi que o Gemini CLI se tornou um aliado indispensável. Ele não é apenas um chat no terminal; é uma ferramenta de desenvolvimento robusta com interface de linha de comando (Command Line Interface). Se você busca produtividade, esta ferramenta oferece três grandes diferenciais: uma janela de contexto de um milhão de tokens, um budget gratuito generoso e o fato de ser open source.

O Gemini CLI utiliza o padrão de raciocínio ReAct (Reasoning and Acting). Além disso, ele integra ferramentas como MCP e buscas em tempo real na web. Abaixo, listei dicas práticas para você elevar seu nível de uso.

1. Conecte com sua IDE para agilidade

Muitos desenvolvedores ignoram a integração visual. Instale a extensão Gemini CLI Companion no seu editor. Após a instalação, rode o comando /ide para validar a conexão. Com ela, você ganha superpoderes como:

explain the open file: Explica o arquivo que você está editando no momento.
explain the selected file: Foca apenas no trecho de código selecionado.

2. Expanda o Poder com MCP (Model Context Protocol)

O suporte a servidores MCP (Model Context Protocol) é um divisor de águas. Servidores MCP conectam o Gemini CLI a bancos de dados, APIs e serviços externos, expandindo suas capacidades muito além do terminal.

Dois Níveis de Configuração

A configuração é feita no arquivo settings.json, e você pode definir servidores em dois escopos:

Por projeto: .gemini/settings.json na raiz do repositório. Ideal para servidores específicos daquele projeto.
Por usuário: ~/.gemini/settings.json no seu diretório home. Servidores configurados aqui ficam disponíveis em todos os seus projetos.

Exemplo de Configuração

Dentro do settings.json, adicione o bloco mcpServers. Cada servidor precisa de um command para execução e, opcionalmente, variáveis de ambiente para autenticação. Veja este exemplo com GitHub e Cloudflare:

{
    "mcpServers": {
        "github": {
            "command": "npx",
            "args": ["-y", "@modelcontextprotocol/server-github"],
            "env": {
                "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}"
            }
        },
        "cloudflare-observability": {
            "command": "npx",
            "args": ["mcp-remote", "https://observability.mcp.cloudflare.com/sse"]
        }
    }
}Code language: JSON / JSON with Comments (json)

Note o uso de ${GITHUB_PERSONAL_ACCESS_TOKEN} no campo env. Essa sintaxe referencia variáveis de ambiente do seu sistema. Portanto, defina o token antes de iniciar o CLI:

export GITHUB_PERSONAL_ACCESS_TOKEN="github_pat_seu_token_aqui"Code language: JavaScript (javascript)

Alternativamente, se você utiliza Docker, pode rodar servidores em contêineres isolados:

{
    "mcpServers": {
        "github": {
            "command": "docker",
            "args": ["run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/modelcontextprotocol/servers/github:latest"],
            "env": {
                "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}"
            }
        }
    }
}Code language: JSON / JSON with Comments (json)

Verificação e Troubleshooting

Depois de configurar, use estes comandos para validar:

/mcp list: Lista todos os servidores conectados e seus status. Você verá algo como github: docker ... - Connected.
/mcp refresh: Força o CLI a reconectar e atualizar as capacidades dos servidores. Use quando algo não estiver funcionando como esperado.

Servidores MCP Disponíveis

Além do GitHub, existe um ecossistema crescente de servidores MCP. Alguns dos mais úteis para desenvolvedores:

GitHub — Gerenciamento de issues, PRs e repositórios.
Slack — Interação com canais e mensagens.
PostgreSQL — Consultas diretas ao banco de dados.
Google Drive — Acesso a documentos e planilhas.
Cloudflare — Observabilidade e configuração de workers.
Filesystem — Acesso controlado a diretórios do sistema.

A lista completa está disponível no repositório oficial de servidores MCP.

3. Defina as Regras do Jogo com o Arquivo de Contexto

Evite repetir instruções em cada prompt. Utilize o arquivo GEMINI.md (ou outro Markdown de contexto) para definir as regras do projeto. Nele, você estabelece as tecnologias, padrões de código e bibliotecas preferidas. O CLI carregará esse contexto automaticamente em todas as interações daquela sessão.

4. Use a Memória para Soluções Recorrentes

Se você resolveu um problema complexo e quer que a IA lembre da solução, use o comando /memory. Ele armazena fatos que o modelo consultará em tarefas futuras.

Por exemplo, se um novo SDK foi lançado e o modelo ainda não o conhece, use /memory add. Você pode conferir o que foi salvo a qualquer momento com o comando /memory show. Isso cria uma base de conhecimento personalizada para seu fluxo.

5. Recupere código com segurança usando Restore

Erros acontecem. Se uma alteração automática não saiu como o esperado, use o comando /restore. O Gemini CLI cria pontos de recuperação durante a geração de código. Portanto, você pode voltar a estados anteriores de arquivos modificados sem depender apenas do Git.

6. Otimize a Janela de Contexto com Compress

Em sessões muito longas, o histórico pode “poluir” sua janela de contexto e gastar muitos tokens. A solução é o comando /compress. Ele compacta o histórico da conversa, liberando espaço para novas tarefas. Essa função pode reduzir o uso de contexto em até 90% sem perder a essência do diálogo.

7. Automatize com Comandos Personalizados (.toml)

Você pode criar fluxos de trabalho completos, como revisões de código ou criação de Pull Requests. Para isso, adicione arquivos .toml na pasta .gemini. Esses comandos personalizados permitem que você execute sequências complexas com um único atalho no terminal.

8. Trabalhe com multimodalidade e referências

O Gemini CLI é multimodal. Você pode usar imagens para descrever interfaces ou vídeos para explicar um bug. Utilize o símbolo @ para referenciar arquivos de imagem, vídeos ou até outros documentos de instrução no seu projeto. Lembre-se de manter os arquivos no diretório do projeto para facilitar o acesso do CLI.

Conclusão

Dominar essas dicas transforma o Gemini CLI de um simples assistente em um verdadeiro parceiro de pair programming. Experimente integrar esses comandos no seu dia a dia e sinta a diferença na velocidade de entrega.