Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Prática com a CLI do Gemini

1. Introdução

Neste codelab, você vai conhecer a CLI do Gemini, um agente de IA de código aberto que traz o poder do Gemini diretamente para o seu terminal.

O que você vai aprender

Instalar e configurar a CLI do Gemini
Conhecer ferramentas, comandos integrados e configurar servidores MCP na CLI do Gemini
Personalizar a CLI do Gemini usando o arquivo GEMINI.md
Conhecer alguns casos de uso da CLI do Gemini

O que é necessário

Este codelab pode ser executado inteiramente no Google Cloud Shell, que já vem com a CLI do Gemini pré-instalada.

Se preferir trabalhar na sua própria máquina, há uma seção para instalar a CLI do Gemini localmente.

Você vai precisar do seguinte:

Navegador da Web Google Chrome
Uma conta do Gmail

Este codelab foi criado para usuários e desenvolvedores de todos os níveis, inclusive iniciantes. Os casos de uso no codelab foram categorizados em tarefas de desenvolvedor e não desenvolvedor. Os casos de uso para desenvolvedores mostram como realizar a programação assistida por IA com a CLI do Gemini e trabalhar com um repositório do GitHub para realizar tarefas comuns de desenvolvimento, como explicação/compreensão de código, geração de documentação, correção de problemas e muito mais. Recomendamos que você conclua esses casos de uso no codelab. Há uma seção opcional no final que aborda várias tarefas diárias que não são focadas em desenvolvedores.

2. Antes de começar

Criar um projeto

No console do Google Cloud, na página de seletor de projetos, selecione ou crie um projeto do Google Cloud.
Confira se o faturamento está ativado para seu projeto do Cloud. Saiba como verificar se o faturamento está ativado em um projeto.
Você vai usar o Cloud Shell, um ambiente de linha de comando executado no Google Cloud que vem pré-carregado com bq. Clique em "Ativar o Cloud Shell" na parte de cima do console do Google Cloud.

Imagem do botão "Ativar o Cloud Shell"

Depois de se conectar ao Cloud Shell, verifique se sua conta já está autenticada e se o projeto está configurado com seu ID do projeto usando o seguinte comando:

gcloud auth list

Execute o comando a seguir no Cloud Shell para confirmar se o comando gcloud sabe sobre seu projeto.

gcloud config list project

Se o projeto não estiver definido, use este comando:

gcloud config set project <YOUR_PROJECT_ID>

3. Instalação

Antes de fazer a configuração e executar a CLI do Gemini, crie uma pasta que será usada como pasta inicial para todos os projetos criados nela. Ela será um ponto de partida para a CLI do Gemini trabalhar, embora também possa consultar outras pastas no seu sistema, conforme necessário.

Crie uma pasta de amostra (gemini-cli-projects) e navegue até ela usando os comandos mostrados abaixo. Se preferir usar outro nome de pasta, faça isso.

mkdir gemini-cli-projects

Navegue até essa pasta:

cd gemini-cli-projects

É possível iniciar a CLI do Gemini diretamente com o comando gemini.

Acesse diretamente a próxima seção (Configuração da CLI do Gemini usando o arquivo settings.json).

Se você quiser instalar a CLI do Gemini localmente, siga as instruções abaixo. A CLI do Gemini já vem pré-instalada no Cloud Shell e no Cloud Workstations.

A primeira etapa é instalar o Node 20 ou mais recente na sua máquina. Depois disso, você pode instalar e executar a CLI do Gemini usando um dos seguintes métodos:

Primeiro, instale a CLI do Gemini globalmente no seu sistema. Talvez você precise de acesso de administrador para realizar essa etapa.

# option 1: install Gemini CLI

npm install -g @google/gemini-cli

# .. and then run
gemini

Execute com o seguinte comando:

# option 2: run without installing Gemini CLI

npx https://github.com/google-gemini/gemini-cli

Para confirmar se a CLI está instalada, execute:

gemini --version

Supondo que você tenha iniciado a CLI do Gemini usando um dos métodos acima, na primeira vez, talvez seja necessário selecionar um tema. Se sim, você pode usar o padrão ou escolher um tema da sua preferência.

O próximo ponto importante é a autenticação. Ele vai pedir o método de autenticação. Recomendamos que você use sua Conta do Google pessoal e não contas não relacionadas ao Google ou ao Google Workspace neste laboratório.

Se você atingir os limites da cota sem custo financeiro atual concedida às Contas do Google, poderá usar a API Gemini ou até mesmo a Vertex AI do Google Cloud, em que será necessário ter um ID do projeto e o nome do local dele. Consulte a seção Autenticação da documentação se você planeja usar outros métodos de autenticação.

Clique em "Enter". Uma página de autenticação do Google será aberta no navegador. Faça a autenticação com sua Conta do Google, aceite os termos e, depois de autenticado, você vai notar que a CLI do Gemini está pronta para receber seu comando.

Confira abaixo uma captura de tela de exemplo:

Neste caso, selecionamos a opção da Vertex AI, mas pode ser a conta pessoal no seu caso. Você vai notar que selecionamos o modelo Gemini 2.5 (visível na parte de baixo à direita). É possível escolher seu modelo específico a qualquer momento usando o comando /model.

4. Configuração da CLI do Gemini usando o arquivo settings.json

Se você escolher o Cloud Shell para executar o Gemini, um tema padrão para a CLI do Gemini e o método de autenticação já serão selecionados e configurados para você.

Se você instalou e iniciou a CLI do Gemini pela primeira vez, selecionou um tema e um método de autenticação.

Agora, nas execuções subsequentes da CLI do Gemini, não será necessário selecionar um tema e um método de autenticação novamente. Isso significa que ele está sendo mantido em algum lugar, e o arquivo usado é chamado de settings.json, que é a maneira de personalizar a CLI do Gemini.

As configurações são aplicadas com a seguinte precedência (o Cloud Shell só disponibiliza as configurações do usuário):

Sistema: /etc/gemini-cli/settings.json (se aplica a todos os usuários e substitui as configurações do usuário e do espaço de trabalho).
Workspace: .gemini/settings.json (substitui as configurações do usuário).
Usuário: ~/.gemini/settings.json.

Usuário do Windows: %USERPROFILE%.gemini\settings.json (que geralmente é expandido para C:\Users<YourUsername>.gemini\settings.json)

Sistema: %ProgramData%\gemini-cli\settings.json (que geralmente é expandido para C:\ProgramData\gemini-cli\settings.json)

Usuário do Mac: ~/.gemini/settings.json (que se expande para /Users/<YourUsername>/.gemini/settings.json)

Sistema: /etc/gemini-cli/settings.json

Se você se lembra, ao selecionar o tema, você escolheu salvar as configurações nas configurações do usuário. Acesse ~/.gemini folder e você vai notar o arquivo settings.json.

Meu arquivo settings.json é mostrado abaixo. Se você tivesse selecionado outro tema, o nome dele apareceria ali.

{
  "security": {
    "auth": {
      "selectedType": "oauth-personal" or "cloud-shell"
    }
  },
  "ui": {
    "theme": "Default"
  }
}

5. Nossa primeira interação com a CLI do Gemini

Vamos começar a usar a CLI do Gemini e digitar sua primeira consulta, conforme mostrado abaixo:

Give me a famous quote on Artificial Intelligence and who said that?

A resposta esperada é mostrada abaixo:

 > Give me a famous quote on Artificial Intelligence and who said that?                 
✦ "The only way to do great work is to love what you do." - Steve Jobs (While not directly about AI, it's a famous quote related to technology and innovation, which underpins AI development.)
Alternatively:
  "The development of full artificial intelligence could spell the end of the human race." - Stephen Hawking

Uma maneira rápida de entender a CLI do Gemini e os vários comandos que ela oferece é digitar /help (barra) para receber vários comandos e atalhos de teclado.

Vamos sair da CLI do Gemini por enquanto. Você pode fazer isso com o comando /quit ou Ctrl-C duas vezes na sessão interativa do terminal da CLI do Gemini. Ao sair da CLI do Gemini, você vai ver as estatísticas da sessão, que oferecem insights sobre a sessão, o uso do modelo e outras métricas.

6. CLI do Gemini: parâmetros de comando

Há alguns parâmetros de linha de comando que podem ser fornecidos ao iniciar a CLI do Gemini. Para conferir uma lista completa de opções, use --help, conforme mostrado abaixo.

gemini --help

Isso vai mostrar todas as opções disponíveis. Consulte a documentação aqui.

Vamos analisar algumas delas. A primeira é configurar a CLI do Gemini para usar um modo específico do Gemini. No momento da atualização deste laboratório, esta é a lista de modelos compatíveis. Para usar um modelo específico, faça isso ao iniciar a CLI do Gemini com o parâmetro -m, conforme mostrado abaixo:

gemini -m "gemini-2.5-flash"

Se você começar da maneira acima, poderá verificar o modelo na parte inferior direita do terminal da CLI do Gemini.

Depois de entrar no aplicativo da CLI do Gemini, use o comando /model para abrir uma caixa de diálogo que permite escolher um modelo. Uma execução de amostra é mostrada abaixo. Dependendo dos seus requisitos e das orientações fornecidas, você pode continuar trocando o modelo para escolher o certo para a tarefa, dependendo da complexidade e da necessidade de controlar os custos.

Modo não interativo

Uma opção interessante é executar a CLI do Gemini em um modo não interativo. Isso significa que você fornece o comando diretamente e ele responde sem abrir o terminal interativo da CLI do Gemini. Isso é muito útil se você planeja usar a CLI do Gemini de forma automatizada como parte do script ou qualquer outro processo de automação. Use o parâmetro -p para fornecer o comando à CLI do Gemini, conforme mostrado abaixo:

gemini -p "What is the gcloud command to deploy to Cloud Run"

Lembre-se de que não é possível continuar a conversa com perguntas complementares. Esse modo também não permite autorizar ferramentas (incluindo o WriteFile) ou executar comandos shell.

Se você não incluir o parâmetro -p e apenas fornecer o seguinte, a CLI do Gemini será aberta com o comando e continuará dentro dele.

gemini "What is the gcloud command to deploy to Cloud Run"

7. CLI do Gemini: ferramentas integradas

A CLI do Gemini vem com um conjunto de ferramentas integradas, e a documentação de ferramentas afirma que "o modelo do Gemini usa essas ferramentas para interagir com seu ambiente local, acessar informações e realizar ações. Essas ferramentas aprimoram os recursos da CLI, permitindo que ela vá além da geração de texto e ajude em uma ampla variedade de tarefas."

Para conferir uma lista das ferramentas integradas, invoque o comando /tools, conforme mostrado abaixo:

Available Gemini CLI tools:
  - Activate Skill (activate_skill)
  - Ask User (ask_user)
  - Edit (replace)
  - Enter Plan Mode (enter_plan_mode)
  - FindFiles (glob)
  - GoogleSearch (google_web_search)
  - Invoke Subagent (invoke_agent)
  - List Background Processes (list_background_processes)
  - Read Background Output (read_background_output)
  - ReadFile (read_file)
  - ReadFolder (list_directory)
  - SearchText (grep_search)
  - Shell (run_shell_command)
  - Update Topic Context (update_topic)
  - WebFetch (web_fetch)
  - WriteFile (write_file)

Uma das coisas que você precisa se perguntar imediatamente é se a CLI do Gemini pode simplesmente chamar essas ferramentas quando quiser. A resposta padrão é não, quando se trata de operações sensíveis que podem envolver a gravação no sistema local, a leitura de um sistema externo, o acesso à rede externa e assim por diante.

Embora haja um --yolo disponível ao iniciar a CLI (não é recomendado), a CLI do Gemini vai pedir sua permissão para executar a ferramenta escolhida. Você pode negar, permitir que o app seja executado uma vez ou dar permissão geral para que ele sempre seja executado. Você está (e deve estar) no controle total das coisas.

Vamos usar um comando que faça a CLI do Gemini escolher uma das ferramentas integradas para executar e que dê uma boa compreensão de como tudo funciona.

Imagine um cenário em que você quer receber informações sobre as últimas notícias financeiras do mundo e salvá-las em um arquivo no diretório de trabalho local de onde você iniciou a CLI do Gemini. Use o seguinte comando:

Search for the latest headlines today in the world of finance and save them in a file named finance-news-today.txt

Imagine por um momento o que ele precisa fazer. O ideal é que ele faça uma Pesquisa Google para receber notícias de algumas fontes de informação relevantes que possam fornecer notícias financeiras. Em seguida, ele precisa criar um arquivo chamado finance-news-today.txt (uma operação de gravação no seu sistema local que vai exigir sua permissão) com o conteúdo.

Vamos ver o que acontece (faça o mesmo na sua máquina).

A primeira coisa que ela faz é invocar a ferramenta GoogleSearch para pesquisar na Web e recuperar os resultados, conforme mostrado abaixo:

 Searching for Finance News: 
  I will first search for the latest finance headlines and then save them to a file.
  ✓  GoogleSearch  Searching the web for: "latest finance headlines"
   → Search results for "latest finance headlines" returned.
  Saving Finance News: I will now save the finance headlines to the file 'finance-news-today.txt'.

Depois disso, está tudo pronto para gravar as informações no arquivo com a ferramenta WriteFile, mas como essa é uma operação sensível (gravação), você precisa permiti-la. Você pode decidir o tipo de permissão, ou seja, permitir uma vez, permitir sempre etc. Por enquanto, selecione "Permitir uma vez".

Ela grava as informações no arquivo, e uma mensagem de sucesso é exibida abaixo:

✦ I have saved the latest finance news to finance-news-today.txt.
  Finance News Saved: The task is complete.

Como verificar se o arquivo foi gravado ou não? Use o @file para pedir que ele leia o conteúdo. Ao digitar @, uma lista de arquivos na pasta atual é exibida, incluindo o arquivo que acabou de ser criado. Selecione essa opção e envie o comando. Meu comando é mostrado abaixo:

read the contents of @finance-news-today.txt

Isso resulta na invocação das ferramentas necessárias (ReadManyFiles, ReadFile) e o conteúdo é exibido conforme mostrado abaixo:

  ✓  ReadManyFiles  Attempting to read files from finance-news-today.txt → Read 1 file(s)
  Topic: Summarizing the financial news headlines.
✦ The latest finance headlines as of May 15, 2026, include:
  Global Markets & Economy:
   * The Dow Jones Industrial Average surpassed 50,000 for the first time, driven by strong earnings from Cisco
     Systems and a 2% rise in Nasdaq due to tech stocks.
   * Inflation concerns are growing, hinting at potential Fed interest rate hikes.
   * Kevin Warsh has been confirmed as the new Federal Reserve head.
   * A "constructive" U.S.-China summit took place in Beijing between President Trump and President Xi, with
     markets watching for impacts from proposed tariffs.
  Corporate & Tech News:
   
<REST OF THE CONTENT>

8. CLI do Gemini: modo Shell

Este é um bom momento para aprender a trabalhar diretamente com o Shell na CLI do Gemini. Para entrar no modo shell, pressione ! na caixa de mensagem. Isso alterna para um modo Shell. Para voltar, pressione ! novamente ou a tecla ESC.

No modo shell, você verá o ! no início do comando, conforme mostrado abaixo:

É possível verificar diretamente usando comandos padrão, como pwd e ls, conforme mostrado abaixo. Os comandos pressupõem um SO do tipo Linux. Se você estiver em outro sistema operacional (Windows), use comandos equivalentes, como cd, dir e type. A saída dessas chamadas está incluída na janela de contexto do modelo.

Você também pode imprimir o conteúdo do arquivo com o comando cat, ou seja, cat finance-news-today.txt.

Exercício: confira um exercício curto para testar. Escolha um feed RSS. Dê um comando à CLI do Gemini para buscar o conteúdo do feed RSS e formatar os resultados de uma maneira específica. Essa é uma boa maneira de automatizar algo no início do dia. Você pode até pedir ao Gemini CLI para descobrir se há um feed RSS para uma área específica, por exemplo, as notas da versão do Google Cloud Platform.

Confira um exemplo de comando abaixo:

Get the latest release notes for Google Cloud from its RSS Feed and display the key points in a well-formatted list.

O ideal é que esse comando primeiro invoque a ferramenta GoogleSearch para encontrar o feed RSS do Google Cloud Platform e depois use a ferramenta WebFetch para acessar e mostrar o conteúdo do feed RSS. Talvez seja necessário conceder permissões para invocar essas ferramentas.

9. Extensões da CLI do Gemini

Como a documentação afirma, as extensões da CLI do Gemini empacotam prompts, servidores MCP e comandos personalizados em um formato familiar e fácil de usar. Com as extensões, você pode expandir os recursos da CLI do Gemini e compartilhá-los com outras pessoas. É o principal mecanismo para estender a funcionalidade da CLI do Gemini além das ferramentas integradas.

Uma extensão é um pacote independente, com controle de versões e fácil de distribuir. Pense nele como o "contêiner de transporte" das suas personalizações da CLI do Gemini, agrupando tudo o que é necessário para um fluxo de trabalho específico em um único pacote organizado.

Uma extensão pode agrupar qualquer combinação de:

Comandos de barra personalizados (seus arquivos .toml).
Configurações do servidor MCP (que antes ficavam em settings.json).
Arquivos de contexto (GEMINI.md) para fornecer instruções e diretrizes específicas ao modelo.
Restrições de ferramentas (excludeTools) para criar um ambiente mais seguro e focado.

Conhecer a galeria de extensões

A Galeria de extensões é o marketplace central para descobrir todas as extensões oficiais do Google e de terceiros:

Abra o seguinte URL no navegador: https://geminicli.com/extensions/
Essa galeria é o mecanismo de capacidade de descoberta do ecossistema. Você pode conferir extensões de empresas como GitHub, Redis e DynaTrace, mostrando a variedade de ferramentas disponíveis.
Role a tela para baixo e encontre o card da extensão do Cloud Run ou acesse o link.
O card fornece uma descrição, o autor (Google) e um botão de comando Copy com um clique. Essa é a maneira mais simples de receber o comando de instalação de uma extensão.

Extensões da CLI do Gemini: comandos de gerenciamento

O comando gemini extensions é o ponto de entrada para gerenciar suas extensões locais.

Execute no terminal para ver a lista de comandos disponíveis.

gemini extensions <command>
Manage Gemini CLI extensions.
Commands:
  gemini extensions install <source> [--auto-update] [--pre-release]
    Installs an extension from a git repository URL or a local path.
  gemini extensions uninstall [names..]                      
    Uninstalls one or more extensions.
  gemini extensions list                                     
    Lists installed extensions.
  gemini extensions update [<name>] [--all]                  
    Updates all extensions or a named extension to the latest version.
  gemini extensions disable [--scope] <name>                 
    Disables an extension.
  gemini extensions enable [--scope] <name>                  
    Enables an extension.
  gemini extensions link <path>                              
    Links an extension from a local path. Updates made to the local path 
    will always be reflected.
  gemini extensions new <path> [template]                    
    Create a new extension from a boilerplate example.
  gemini extensions validate <path>                          
    Validates an extension from a local path.
  gemini extensions config [name] [setting]                  
    Configure extension settings.
Options:

Os comandos são simples (instalar/desinstalar, listar, atualizar, ativar/desativar etc.), e vamos usar alguns deles neste codelab.

Verificar sua lista atual de extensões

Antes de instalar qualquer coisa, vamos verificar nossa "página em branco".

Execute o comando gemini extensions list:
Você vai ver a seguinte saída, confirmando que nenhuma extensão foi instalada ainda.

No extensions installed.

Como configurar o servidor MCP do Cloud Run

A extensão do Cloud Run disponível na galeria de extensões da CLI do Gemini é um servidor MCP que permite implantar nossos aplicativos no Cloud Run.

Confira abaixo o card da extensão do Cloud Run na galeria de extensões:

Primeiro, instale a extensão do Cloud Run clicando em Copiar comando de instalação, conforme mostrado acima. Em seguida, cole esse comando no terminal do Cloud Shell. Ele deve ser semelhante a este:

gemini extensions install https://github.com/GoogleCloudPlatform/cloud-run-mcp

Ao executar o comando acima, você vai ver uma confirmação necessária. Aprove. A extensão do Cloud Run vai pedir o ID e o local do seu projeto do Google. Forneça essas informações. A extensão do Cloud Run será instalada.

Se você executar o comando gemini extensions list agora, a extensão do Cloud Run vai aparecer instalada, conforme mostrado abaixo:

✓ cloud-run (1.0.0)
 ID: 3c1a38909b6d7d90b6acc8ca1e80d97b4a867253a3cd12d841b2aab4e556a58f
 name: 0b1820c1f0c043bbb3b54f496d862c02172424c930eb965d61f468be52e6f127
 Path: /Users/romin/.gemini/extensions/cloud-run
 Source: https://github.com/GoogleCloudPlatform/cloud-run-mcp (Type: github-release)
 Release tag: v1.10.0
 Enabled (User): true
 Enabled (Workspace): true
 Context files:
  /Users/romin/.gemini/extensions/cloud-run/gemini-extension/GEMINI.md
 MCP servers:
  cloud-run
 Settings:
  Project ID: YOUR_GCP_PROJEC_ID (User - /Users/romin/.gemini/extensions/cloud-run/.env)
  Region: YOUR_GCP_PROJECT_LOCATION (User - /Users/romin/.gemini/extensions/cloud-run/.env)

Se você iniciar a CLI do Gemini agora e executar o comando /mcp list, vai aparecer o seguinte. Observe as ferramentas e os comandos do servidor MCP do Cloud Run.

Configured MCP servers:
🟢 cloud-run (from cloud-run) - Ready (8 tools, 2 prompts)
  Tools:
  - mcp_cloud-run_create_project
  - mcp_cloud-run_deploy_container_image
  - mcp_cloud-run_deploy_file_contents
  - mcp_cloud-run_deploy_local_folder
  - mcp_cloud-run_get_service
  - mcp_cloud-run_get_service_log
  - mcp_cloud-run_list_projects
  - mcp_cloud-run_list_services
  Prompts:
  - deploy
  - logs

Este é apenas um exemplo de uma extensão da CLI do Gemini que mostramos como configurar. Confira mais opções na galeria de extensões.

10. Casos de uso para testar

A CLI do Gemini pode ser aplicada a uma ampla variedade de casos de uso para desenvolvedores e não desenvolvedores. Confira alguns cenários e, dependendo da sua área de interesse, teste qualquer um ou todos eles.

Em cada um desses casos, o comando é fornecido. Você pode testar isso no modo interativo ou não interativo da CLI do Gemini usando o parâmetro -p ao iniciar a CLI do Gemini.

Vibe coding com a CLI do Gemini

Vamos usar a CLI do Gemini para criar um aplicativo com vibe coding. Nesta tarefa, você vai pedir ao Gemini CLI para gerar um aplicativo e enviar a versão inicial para um repositório do GitHub.

Pré-requisito

Para realizar as tarefas nesta seção, há alguns pré-requisitos:

Git
CLI do Gemini
Configure gh ( ferramenta da CLI do GitHub).
Familiaridade com os princípios básicos do Git e um pouco de conhecimento de programação

Vamos presumir que você iniciou a CLI do Gemini em uma pasta específica da sua escolha. No nosso caso, iniciamos a CLI do Gemini na pasta inicial gemini-cli-projects e em outra pasta event-website dentro dela.

Comece com um comando inicial. Pense nisso como uma especificação para seu aplicativo. Modifique como quiser. Durante a sessão com a CLI do Gemini, ela vai pedir permissões para criar arquivos etc. Conceda as permissões necessárias.

Nesta tarefa, não queremos que a CLI do Gemini execute ou teste o aplicativo para nós, porque queremos um pouco mais de controle. Mas a decisão é sua.

Generate a website for a 1-day event filled with technical talks. There are going to be 6 talks in a single track of 1 hour each. Each talk has the following information: title, 1 or maximum of 2 speakers, category (1 or maximum of 3 keywords), duration and a description. The website has a single page where users can see the schedule for the entire day with the timings. There will be one lunch break of an hour and the event starts at 10:00 AM. Keep a 10 minute transition between talks. I would like to use Node.js on the server side and standard HTML, JavaScript and CSS on the front-end. The users should be able to search the talks based on category.

I would like you to proceed in the following way: 
1. Plan out how you would design and code this application.
2. Ask me for any clarifications along the way.
3. Once I am fine with it, do generate the code and provide me instructions to run and test locally.

Os próximos comandos e respostas são um exemplo de fluxo que foi observado. A CLI do Gemini vai criar um plano e pedir confirmações / esclarecimentos ou prosseguir. Siga as instruções. Como exemplo, esta é minha conversa:

   ✦ Of course. I will start by creating a plan for the application.
  Plan:
   1. Backend (Node.js):
       * I'll set up a simple Node.js server using the Express.js framework.
       * This server will have two main purposes:
           1. Serve the static frontend files (HTML, CSS, JavaScript).
           2. Provide an API endpoint (e.g., /api/talks) that will send the event schedule data to the frontend as a JSON object.
       * The talk data will be stored in a separate talks.json file for easy management.
   2. Frontend (HTML, CSS, JS):
       * HTML: A single index.html file will define the structure of the page, including a container for the schedule and a search input field for filtering by category.
       * CSS: A style.css file will be used to style the website for a clean and professional look, ensuring the schedule is easy to read.
       * JavaScript: A script.js file will handle the dynamic aspects of the site:
           1. It will fetch the talk data from the backend API when the page loads.
           2. It will dynamically render the schedule on the page based on the fetched data.
           3. It will implement the search functionality. As the user types in the search box, it will filter the displayed talks based on the category keywords.
   3. Project Structure:
      I will organize the project with a clear and standard structure:
   1     /
   2     ├── public/
   3     │   ├── index.html
   4     │   ├── style.css
   5     │   └── script.js
   6     ├── talks.json
   7     └── server.js
   8     └── package.json
  Before I proceed with generating the code, I have a few questions to ensure the final product meets your expectations:

Ela até me faz algumas perguntas (mostradas abaixo e que eu respondo):

Em seguida, ele gera o código, pedindo confirmações em vários pontos, e eu dou a permissão necessária para continuar.

Por fim, ele iniciou o servidor e pediu que eu inspecionasse a página:

The server is now running in the background.
  3. View Your Website
  You can now open your web browser and navigate to the following address to see your website:
  http://localhost:3000 (http://localhost:3000)
  4. Test the Search Functionality
  Once the page is loaded, you can test the search functionality by typing a category into the search bar (e.g., "AI", "Frontend", "Cybersecurity"). The list of talks
  will filter in real-time.
  This completes the setup and implementation of your event website. Let me know if you have any other questions.

Confira um exemplo de página gerada:

Você pode continuar fazendo mais mudanças com a ajuda da CLI do Gemini. Quando estiver satisfeito com as mudanças, envie para um repositório do GitHub.

Primeiro, vamos criar um arquivo .gitignore com a ajuda da CLI do Gemini.

Create a .gitignore file for this project.

A próxima etapa é dar instruções para a CLI do Gemini enviar esse repositório para nossa conta do GitHub. Isso vai exercitar as ferramentas do servidor MCP do GitHub em segundo plano.

Dê um comando semelhante a este:

Great! I would now like to push all of this to a new repository in my GitHub account. I would like to name this repository <Your-Name>-event-talks-app

Ele vai passar por vários comandos aqui:

Crie o repositório.
Ele vai usar vários comandos do Git : init, add e commit para gerenciar o repositório Git local.
Em seguida, ele vai configurar o Git remoto e fazer um push.

Observação:em alguns casos, a CLI do Gemini pode atingir o tempo limite ou usar um nome de usuário incorreto, etc. Interaja com ela e sugira as correções.

Se tudo der certo, você terá um repositório do GitHub. Confira abaixo uma captura de tela de exemplo:

Observe que você não gerou um README.md para este projeto. Isso é um bom exercício para a próxima seção, em que vamos trabalhar com o repositório que você acabou de criar.

Usar a CLI do Gemini para trabalhar em um repositório do GitHub

Neste caso de uso, você vai usar a CLI do Gemini para trabalhar com um repositório do GitHub. Você vai realizar várias tarefas, incluindo:

Noções básicas sobre a base de código
Gerar a documentação
Implementar um novo recurso
Confirme e envie as mudanças de volta para o repositório
Trabalhar em um problema do GitHub e implementar as mudanças propostas

Isso vai dar uma boa base para trabalhar com seus repositórios e usar a CLI do Gemini como um assistente para essas tarefas específicas do desenvolvedor.

Pré-requisito

Para realizar as tarefas desta seção, você precisa fazer o seguinte:

Git
CLI do Gemini e gh ( ferramenta da CLI do GitHub).
Familiaridade com os conceitos básicos do Git e um pouco de conhecimento de programação. Vamos usar o Node.js neste exemplo porque você já pode ter o ambiente pronto na sua máquina devido à instalação da CLI do Gemini. Mas, depois, você pode escolher um repositório com uma linguagem de programação e um framework diferentes.
Você precisa ter concluído a seção anterior e ter o repositório em mãos, onde criamos um site de palestras sobre eventos.

Vamos continuar usando a CLI do Gemini na pasta/diretório que você usou para gerar o aplicativo Event Talks. Se necessário, clone o repositório na sua máquina local e inicie a CLI do Gemini nesse diretório. Teste os seguintes cenários:

Noções básicas sobre a base de código

Quero entender esse projeto em detalhes. Me ajude a entender os principais recursos e depois divida em lado do servidor e do cliente. Pegue um fluxo de amostra e mostre como a solicitação e a resposta funcionam.
Explain @server.js

Como gerar um arquivo README

Gere um arquivo README para este projeto.

Implementar um novo recurso

Quero implementar um novo recurso em que o usuário também possa pesquisar por um determinado orador. Primeiro, mostre um plano de como você implementaria essa mudança. Depois, podemos gerar o código.

Ele vai fornecer um plano que você pode aprovar. Com a aprovação, a CLI do Gemini vai fazer essas mudanças. Teste as mudanças e, se houver bugs (o que é provável), peça ao Gemini para a CLI do Gemini corrigir.

Quando as mudanças estiverem boas, siga as mesmas etapas para fazer commit e enviar por push ao repositório remoto. Ele pode até fazer isso automaticamente para você. Você sempre pode perguntar o que a CLI do Gemini pode ou não fazer.

Gerar problemas com base nos recursos sugeridos

Vamos tentar algo interessante aqui. Você vai pedir ao Gemini CLI como ela pode melhorar a experiência do usuário desse aplicativo e, com base na avaliação, criar sugestões como problemas no mesmo repositório do GitHub. Ele vai usar a ferramenta create_issue do servidor MCP do GitHub.

Tente o seguinte comando:

Quero que você avalie o aplicativo do ponto de vista da experiência do usuário. Facilidade de uso, capacidade de resposta, mensagens úteis e muito mais. Crie uma lista de melhorias e crie-as como problemas no repositório do GitHub.

O ideal é que ele compartilhe as melhorias primeiro com você e depois crie os problemas no repositório do GitHub com sua permissão. Confira um exemplo de captura de tela da nossa execução:

Trabalhar em um problema do GitHub e implementar as mudanças propostas

Agora você pode pegar um dos problemas gerados anteriormente e pedir ao Gemini CLI para trabalhar e implementá-lo.

Confira abaixo um exemplo de problema gerado:

Pegue o URL do problema inteiro e forneça um comando como este:

Leia o problema: <YOUR_ISSUE_URL> e entenda quais mudanças precisam ser feitas. Primeiro, discuta o plano e depois mostre as mudanças propostas no código.

Aprove as mudanças e envie-as para o repositório. Você pode até pedir para ele encerrar o problema.

(Opcional) Atividades cotidianas

Os casos de uso abaixo são tarefas que você pode acabar fazendo com frequência. Isso inclui organizar arquivos em pastas, buscar e resumir conteúdo da Web, processar arquivos de imagem e extrair conteúdo deles, trabalhar com bancos de dados e muito mais.

Explore os casos de uso que quiser.

Organizar arquivos/pastas

Você pode usar a CLI do Gemini para organizar os arquivos de acordo com os tipos em várias pastas, conforme necessário. Acesse uma pasta na sua máquina que tenha vários arquivos .txt, .png, .jpg, .pdf, .mp4 e outros. Geralmente, é a área de trabalho ou a pasta "Downloads".

Confira abaixo uma pasta de exemplo e o conteúdo dela. Você pode ter outros arquivos:

Navegue até essa pasta e inicie a CLI do Gemini. Primeiro, peça à CLI do Gemini para criar algumas pastas: "Imagens", "Documentos" e "Vídeos". Depois, peça para ela organizar os arquivos nas pastas.

A CLI do Gemini geralmente pede permissão antes de executar comandos, principalmente aqueles que modificam o sistema de arquivos (como gravar, mover ou excluir arquivos). Sempre revise esses comandos com atenção antes de conceder permissão. Essa é sua rede de segurança.

Create the following folders "Images","Documents","Videos"

Em seguida, dê o seguinte comando:

Go through all the files in this folder and then organize them by moving all the files ending with .jpg, .jpeg, .gif into the "Images" folder. Move all ".txt" files into the "Documents" folder. Move all the ".mp4" files in the "Videos" folder.

Confira abaixo um exemplo do estado final da pasta. Você vai ver novas subpastas criadas e os arquivos movidos para as respectivas subpastas, dependendo do tipo deles.

Confira alguns outros cenários de organização (os comandos são fornecidos ao lado de cada cenário):

Resumo:para cada documento na pasta "Documents", crie um arquivo txt na mesma pasta chamado "summary_ORIGINAL_FILENAME.txt" que contenha um resumo de três frases dos principais pontos do documento.
Categorizar por tipo:verifique todos os arquivos PDF e DOCX neste diretório. Mova todos os arquivos com "invoice" no nome ou conteúdo para a pasta "Financial/Invoices". Mova os arquivos com "receipt" para "Financial/Receipts". Todos os outros arquivos .docx vão para "Relatórios".
Extração de informações importantes (e "tagging"): para cada arquivo PDF na pasta "Financial/Invoices", leia o conteúdo. Se você encontrar uma data, renomeie o arquivo para incluir essa data no formato AAAA-MM-DD, por exemplo, "invoice_2025-07-26_original_name.pdf".