Prática com a CLI do Antigravity

1. Introdução

Neste codelab, você vai aprender sobre a CLI do Antigravity, uma interface de usuário de terminal (TUI, na sigla em inglês) simples do Antigravity. Ela traz as mesmas funcionalidades principais do Antigravity 2.0 (como raciocínio em várias etapas, edição de vários arquivos, chamadas de ferramentas e histórico de conversas) diretamente para o terminal.

O que você vai aprender

  1. Instalar e configurar a CLI do Antigravity
  2. Entender o uso básico da CLI do Antigravity
  3. Conhecer alguns casos de uso com a CLI do Antigravity

O que é necessário

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 usar o código com a CLI Antigravity 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

  1. No console do Google Cloud, na página de seletor de projetos, selecione ou crie um projeto do Google Cloud.
  2. Confira se o faturamento está ativado para seu projeto do Cloud. Saiba como verificar se o faturamento está ativado em um projeto.
  3. 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"

  1. 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
  1. Execute o comando a seguir no Cloud Shell para confirmar se o comando gcloud sabe sobre seu projeto.
gcloud config list project
  1. 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 Antigravity, 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 Antigravity trabalhar, embora também consulte outras pastas no seu sistema, que você vai conhecer mais tarde, conforme necessário.

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

mkdir agy-cli-projects

Navegue até essa pasta:

cd agy-cli-projects

A instalação é simples, e os binários estão disponíveis nos principais sistemas operacionais. Extraí os comandos para executar no terminal diretamente do documento de instalação:

macOS | Linux

curl -fsSL https://antigravity.google/cli/install.sh | bash

Windows PowerShell

irm https://antigravity.google/cli/install.ps1 | iex

CMD do Windows

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

Isso deve configurar e instalar a CLI do Antigravity (agy) no seu sistema e no caminho.

Em alguns casos, se o instalador não conseguir adicionar o binário ( agy ao PATH), ele vai informar isso. Por exemplo, aqui está uma saída de amostra em uma máquina em que o instalador não conseguiu adicionar o binário ao PATH e sugeriu o que fazer.

% curl -fsSL https://antigravity.google/cli/install.sh | bash
 Detecting system environment...
 Platform detected: darwin_arm64
 Querying release repository...
 Latest available version: 1.0.1
 Downloading release package...
 Download complete and checksum verified.
 Extracting binary from archive...
 Configuring shell environment...
I0523 11:44:14.012088 76528 installer.go:27] Running Antigravity CLI setup...
Warning: /Users/neilirani/.local/bin is not present in your active PATH.
To use the 'agy' CLI globally, please manually add it to your shell profile:
 echo 'export PATH="/Users/yourusername/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
 Antigravity CLI binary placed successfully at /Users/yourusername/.local/bin/agy
Note: The binary is installed, but it is not in your active PATH. Please follow the instructions above to add it, then restart your terminal session.

Confira a versão da CLI Antigravity com o seguinte comando (a versão mostrada é a do momento em que este codelab foi escrito):

$ agy --version
1.0.5

Quando você iniciar a CLI Antigravity pela primeira vez, ela vai pedir que você faça login. Inicie agy. Uma tela semelhante a esta vai aparecer:

    ▄▀▀▄
   ▀▀▀▀▀▀
  ▀▀▀▀▀▀▀▀
 ▄▀▀    ▀▀▄
▄▀▀      ▀▀▄

Welcome to the Antigravity CLI. You are currently not signed in.

Select login method:
> 1. Google OAuth
  2. Use a Google Cloud project

[Use arrow keys to navigate, Enter to select]

Use sua conta pessoal por enquanto. Escolha 1. Google OAuth e pressione Enter. Isso vai abrir um navegador, e você poderá fazer login com sua Conta do Google. Após a autenticação e autorização, você vai precisar copiar um código. Volte ao terminal da CLI Antigravity e cole o código.

Depois que o login é concluído, algumas coisas acontecem:

  1. Primeiro, ele pergunta sobre o tema de cores que você quer escolher para a CLI Antigravity, conforme mostrado abaixo. Escolha a que você mais gosta.
  2. Em seguida, você precisa aceitar alguns Termos de Serviço. Aceite essas.

Por fim, o mais importante é dar permissão para confiar na pasta, conforme mostrado abaixo:

Accessing workspace:

/Users/yourusername/agy-cli-projects

Do you trust the contents of this project?

Antigravity CLI requires permission to read, edit, and execute files here.

> Yes, I trust this folder
 No, exit

 ↑/↓ Navigate · enter Confirm

Isso geralmente aparece em qualquer nova pasta em que você inicia a CLI do Antigravity. Vamos falar mais sobre isso depois, mas por enquanto, clique em Sim, confio nesta pasta.

Parabéns! Tudo pronto. A CLI do Antigravity está esperando seu comando.

4. Nossa primeira interação com a CLI do Antigravity

Vamos começar a usar a CLI do Antigravity 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:

● WebSearch(famous quotes on Artificial Intelligence) (ctrl+o to expand)
  Here is one of the most famous quotes on Artificial Intelligence:                                                  
                                                                                                                     
  │ "AI is the new electricity."                                                                                     
  │ — Andrew Ng (Co-founder of Coursera and Google Brain, Adjunct Professor at Stanford University)                  
                                                                                                                     
  Another widely cited perspective on the potential risks of AI is:                                                  
                                                                                                                     
  │ "The development of full artificial intelligence could spell the end of the human race. It would take off on its 
  │ own, and re-design itself at an ever-increasing rate."                                                           
  │ — Stephen Hawking         
  

Você vai notar que a Antigravity usou uma das ferramentas internas dela, a WebSearch, para conseguir a citação.

Além de dar comandos aqui, quais são os vários comandos que a CLI do Antigravity oferece? Para saber, digite /help (barra) e confira vários comandos e atalhos de teclado. Alguns dos comandos no momento da escrita estão mostrados abaixo:

Antigravity CLI   general    commands    shortcuts   (/ or tab to cycle)
Available Commands
> /add-dir                        Add a directory to the workspace
  /agents                         List available custom agents
  /artifact                       View and review artifacts
  /btw                            Ask a side question without interrupting the current task
  /changelog                      Show release notes and changes
  /clear (new)                    Clear conversation and start a new one
  /config (settings)              Open settings panel
  /context                        Visualize current context usage
  /copy                           Copy the last planner response to the clipboard (may require allowing clipboard ac...
  /credits                        Show remaining G1 credits and purchase link
  /diff                           View uncommitted changes and per-turn diffs
  /exit (quit)                    Exit the CLI
  /fast                           Agent will execute tasks directly. Use for simple tasks that can be completed faster
  /feedback                       Submit qualitative feedback to improve the agent
  /fork (branch)                  Create a branch of the current conversation at this point
  /help                           Show available commands and keybindings
  /hooks                          Manage hook configurations for tool events
  /keybindings                    Set custom keybindings
  /logout                         Log out
  /mcp                            Manage MCP servers
  /model                          Set a model
  /open                           Open a file or view opened/edited files
  /permissions                    Manage tool permissions
  /planning                       Agent can plan before executing tasks. Use for deep research, complex tasks, or co...

<MORE_COMMANDS>

Vamos sair da CLI do Antigravity por enquanto. Você pode fazer isso com o comando /quit ou executar ctrl+d duas vezes na sessão interativa do terminal da CLI do Antigravity.

5. CLI do Antigravity: alguns comandos de organização

Verifique se a CLI Antigravity foi iniciada e está aguardando seu comando.

Observe o modelo que está sendo usado. O nome dele vai aparecer no canto inferior direito. O ideal é entender que a maioria das personalizações e configurações necessárias está disponível pelo comando /config ou /settings.

Configuração / Configurações

Execute o comando /config. Isso vai abrir várias áreas do Antigravity que podem ser personalizadas de acordo com suas preferências, incluindo esquema de cores, permissão de ferramentas, configurações de telemetria e muito mais.

Settings
  Search:  
          ────────────────────
> Animation Speed      medium
  Artifact Review      asks for review
  Color Scheme         dark
  Editor               auto ($EDITOR)
  Enable Telemetry     on
  Non-Workspace Access off
  Notifications        off
  Rendering Mode       native terminal (inline)
  Sandbox Mode         off
  Show Feedback Survey on
  Show Tips            on
  Tool Permission      request-review
  Use AI Credits       off
  Verbosity            high

Por exemplo, o esquema de cores mostra as seguintes opções, entre as quais posso escolher meu esquema de cores preferido:

 Color Scheme                   ╭─────────────────────────────────────────────────────────────╮
    terminal                     │   
    light                        │                                                             
    solarized light              │                                         
    colorblind-friendly light    │                                                             
  > dark (current)               │                                            
    solarized dark               │                                                           
    colorblind-friendly dark     │                                      
    tokyo night      

settings.json

As configurações precisam ser armazenadas em algum lugar, certo? Todos eles são armazenados no arquivo ~/.gemini/antigravity-cli/settings.json. Veja a seguir um exemplo do objeto :

{
      "colorScheme": "dark",
      "model": "Gemini 3.5 Flash (High)",
      "statusLine": {
        "type": "",
        "command": "",
        "enabled": true
      },
      "trustedWorkspaces": [
        "/Users/romin/antigravity-cli-projects",
        "/Users/romin/agy-cli-projects"
      ]
    }

Você pode notar o colorScheme que selecionei, o modelo e também várias pastas de onde iniciei a CLI Antigravity e confirmei que confiava nas pastas.

Observação: também é possível modificar o settings.json diretamente e reiniciar a CLI do Antigravity como prática recomendada para conferir as mudanças. Mas tenha certeza das configurações, caso contrário, um erro será exibido na inicialização. Se você não se sentir à vontade para modificar o arquivo diretamente, use o comando /settings ou /config na CLI do Antigravity para trabalhar com ele.

Permissão da ferramenta

Uma configuração importante é a permissão da ferramenta, que controla se os comandos do terminal precisam da sua aprovação antes de serem executados. Para acessar essa opção, use o comando /config.

 Tool Permission
  > request-review (current)
    proceed-in-sandbox
    always-proceed
    strict

Por padrão, ele é definido como request-review. Vamos entender isso com mais detalhes. No Antigravity, as configurações de permissão de ferramenta controlam o equilíbrio entre segurança (proteção do sistema host contra mudanças não intencionais) e velocidade (autonomia do agente sem precisar de sua entrada). Vamos analisar as opções:

request-review (padrão atual)

Nesse modo, o agente é tratado como um parceiro de colaboração que faz check-in antes de realizar qualquer ação que possa afetar seu sistema ou arquivos de projeto fora dos limites pré-aprovados. Sempre que o agente tenta executar um comando de terminal, realizar uma operação de arquivo (como gravar/excluir) ou chamar um serviço externo em que a permissão não foi pré-aprovada, a execução é pausada. O usuário é solicitado a aprovar ou rejeitar a ação específica.

proceed-in-sandbox

Nesse modo, o agente executa comandos do terminal automaticamente, mas em um contêiner isolado e seguro. O agente pode executar comandos sem pedir sua permissão, mas eles são executados em um sandbox virtualizado (por exemplo, um contêiner leve). Eles não podem modificar o sistema de arquivos da máquina host real nem acessar sua rede local.

always-proceed

Esse é o modo totalmente autônomo, que oferece ao agente velocidade e capacidade máximas. O agente recebe permissão total para executar comandos e gravar arquivos diretamente na máquina host. Ele nunca vai pedir confirmação.

strict

Esse é um modo de alta segurança e confiança zero. As capacidades do agente são restritas à execução de ferramentas de leitura. Todas as ferramentas que não são de leitura vão exigir que o usuário seja solicitado a realizar uma ação.

6. CLI do Antigravity: parâmetros de comando

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

agy --help

Isso vai mostrar todas as opções disponíveis. Confira um exemplo de listagem abaixo:

$ agy --help
Usage of agy:
 --add-dir                       Add a directory to the workspace (repeatable) (default [])
 -c                              Short alias for --continue
 --continue                      Continue the most recent conversation
 --conversation                  Resume a previous conversation by ID
 --dangerously-skip-permissions  Auto-approve all tool permission requests without prompting
 -i                              Short alias for --prompt-interactive
 --log-file                      Override CLI log file path
 --model                         Model for the current CLI session
 -p                              Short alias for --print
 --print                         Run a single prompt non-interactively and print the response
 --print-timeout                 Timeout for print mode wait (default 5m0s)
 --prompt                        Alias for --print
 --prompt-interactive            Run an initial prompt interactively and continue the session
 --sandbox                       Run in a sandbox with terminal restrictions enabled

Available subcommands:
 changelog       Show changelog and release notes
 help            Show help for subcommands
 install         Configure environment paths and shell settings
 models          List available models
 plugin          Manage plugins (install, uninstall, list, enable, disable)
 plugins         Alias for plugin
 update          Update CLI

Vamos analisar algumas delas.

Modo não interativo (autônomo)

Uma opção interessante é executar a CLI do Antigravity 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 Antigravity. Isso é muito útil se você planeja usar a CLI do Antigravity de forma automatizada como parte do script ou qualquer outro processo de automação.

Use o parâmetro -p para fornecer o comando à CLI Antigravity, conforme mostrado abaixo:

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

Essa pode ser uma boa maneira de receber respostas rápidas, mas lembre-se de que não é possível continuar a conversa com perguntas complementares.

Escolher um modelo específico

A primeira é pedir à CLI do Antigravity para usar um modo específico do Gemini. Use o parâmetro --model para pedir à CLI do Antigravity que use um modelo específico apenas durante a sessão. Isso é muito útil para o modo não interativo mencionado na seção anterior, em que você quer iniciar várias sessões agy e usar modelos específicos para tarefas específicas.

Mas primeiro, você precisa saber quais modelos estão disponíveis para a CLI do Antigravity. Você pode fazer isso usando o subcomando models, conforme mostrado abaixo:

$ agy models
Gemini 3.5 Flash (Medium)
Gemini 3.5 Flash (High)
Gemini 3.5 Flash (Low)
Gemini 3.1 Pro (Low)
Gemini 3.1 Pro (High)
Claude Sonnet 4.6 (Thinking)
Claude Opus 4.6 (Thinking)

Você pode usar qualquer um desses nomes para especificar o modelo a ser usado na sessão. Para isso, use o comando --model mostrado abaixo:

$ agy --model "Claude Opus 4.6 (Thinking)"

Depois que a CLI do Antigravity for iniciada, você poderá verificar usando o comando /model sobre o modelo específico que pediu para usar ou conferir no canto inferior direito o modelo usado na sessão.

Vivendo perigosamente

Se você gosta de viver perigosamente, procure um parâmetro chamado --dangerously-skip-permissions. Ele aprova automaticamente todas as permissões de ferramentas. Não vai aparecer nenhuma solicitação de permissão. Portanto, use com cuidado.

Inicie a CLI do Antigravity com o seguinte comando:

agy --dangerously-skip-permissions

Em seguida, dê o seguinte comando. Verifique se ele não me pediu permissões de gravação de arquivos.

> get the latest news and write it in a file called news.txt. Then create another file that contains the summary of that file.

● ListDir(/Users/romin/agy-cli-projects)
● WebSearch(latest world news May 24 2026 news headlines) (ctrl+o to expand)

▸ Thought for 2s, 95 tokens
 Processing News Information

● Create(/Users/romin/agy-cli-projects/news.txt)
● Create(/Users/romin/agy-cli-projects/summary.txt) (ctrl+o to expand)

 I have fetched the latest world news headlines and created the requested files in your workspace:                                                                  
                                                                                                                                                                    
 1. news.txt: Contains the detailed news headlines for today (May 24, 2026), including topics on geopolitics (U.S.-Iran negotiations, Ukraine conflict), U.S. 
 security incidents, the Ebola outbreak in Central Africa, and the passing of NASCAR champion Kyle Busch.                                                           
 2. summary.txt: Contains a concise, structured summary of the major categories covered in the news file.                                                        

Esse modo pode ser útil em cenários em que as coisas são locais e estão sob seu controle, mas ainda é preciso se preparar para surpresas e, portanto, usá-lo com cuidado.

7. CLI do Antigravity: modo shell

Agora é um bom momento para aprender a trabalhar diretamente com o Shell na CLI do Antigravity. 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:

8019057be515e68f.png

É 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 usando outro sistema operacional (Windows), use comandos equivalentes, como cd, dir e type.

8. Casos de uso para testar

A CLI do Antigravity 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 da CLI do Antigravity para entender melhor como ela realiza a tarefa.

Vibe coding com a CLI do Antigravity

Vamos usar a CLI do Antigravity para criar um aplicativo com vibe coding. Nesta tarefa, você vai pedir para a CLI do Antigravity 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 Antigravity
  • Ambiente do Python 3
  • 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 Antigravity em uma pasta específica de sua escolha. No nosso caso, iniciamos a CLI do Antigravity na pasta inicial agy-cli-projects e em outra pasta bq-releases-notes 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 Antigravity, ela vai pedir permissões para criar arquivos etc. Conceda as permissões necessárias.

Please build a web application for me using Python Flask and plain vanilla HTML, JavaScript and CSS that fetches the BigQuery Release notes from (https://docs.cloud.google.com/feeds/bigquery-release-notes.xml) and shows them to me. 

A simple refresh button with a spinner is good enough, anytime I'd like to refresh the details. 

I would also like the ability to take any specific update, select it and then Tweet about it.

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

I will start by exploring the workspace to see if there is an existing structure or if this is a brand new project.                                                                   

 ListDir(/Users/romin/agy-cli-projects/bq-release-notes) (ctrl+o to expand)

 I will read the BigQuery release notes XML feed to understand its structure (Atom/RSS elements, entry/item elements, namespaces, dates, titles, content) so that we can parse it      
 correctly in the Python Flask backend.                                                                                                                                                

 ReadURL(https://docs.cloud.google.com/feeds/bigquery-release-notes.xml) (ctrl+o to expand)

 I will view the fetched feed content saved locally to understand its format and structure.                                                                                            

 Read(/Users/romin/.gemini/antigravity-cli/brain/116191af-e6ea-4ba5-aa23-62f995bd068a/.system_generated/steps/6/content.md) (ctrl+o to expand)

 Thought for 2s, 2.3k tokens
 Analyzing XML Feed Structure
 I will write the implementation plan detailing the architecture, design aesthetic, components, and verification steps for the BigQuery Release Notes Web Application. This plan will be
 written to the artifacts directory.                                                                                                                                                   

 Create(/Users/romin/.gemini/antigravity-cli/brain/116191af-e6ea-4ba5-aa23-62f995bd068a/implementation_plan.md) (ctrl+o to expand)

 I have created the implementation_plan.md to outline the design and architecture of the BigQuery Release Notes Web Application.
                                                                                                                                                                                       
 Please review the plan, especially the approach for the Twitter Composer & Preview Card, and let me know if you approve or if there are any adjustments you'd like to make!           

                                                                                                                                                           1 artifact · /artifact to review

Agora é hora de entender o que são artefatos no Antigravity. Os artefatos são a maneira como a CLI do Antigravity nos mantém atualizados com um plano de implementação, uma lista de tarefas em que está trabalhando, saídas verificáveis e muito mais. Esses arquivos são gerados e são um registro do trabalho que o Antigravity está fazendo, do plano, da lista de tarefas e muito mais.

Depois disso, ele diz: "Criei o implementation_plan.md para descrever o design e a arquitetura do aplicativo da Web de notas da versão do BigQuery. Revise o plano, principalmente a abordagem para o Twitter Composer e o card de prévia, e me diga se você aprova ou se quer fazer algum ajuste."

Você pode ver que ele também menciona no canto inferior direito que há 1 artefato para revisar e, nesse caso, é o implementation_plan.md.

Dê o comando /artifact. Isso vai mostrar o artefato gerado implementation_plan.md. Use as teclas de seta para abrir, aprovar, rejeitar etc. Basta pressionar "Esc" e voltar ao comando para aprovar, se quiser.

No nosso caso, vamos usar o que foi gerado e aprovar. Isso inicia o próximo conjunto de etapas, em que a implementação começa, ou seja, a criação de arquivos, a execução de alguns comandos etc. Você vai precisar aprovar e dar permissão para executar, conforme necessário.

No nosso caso, demos a aprovação para criar o ambiente virtual do Python, instalar as dependências via requirements.txt e assim por diante.

Em segundo plano, ele também criou um arquivo task.md como parte das tarefas que precisa realizar com base no plano de implementação e marca as tarefas individuais à medida que as conclui. Quando o processo for concluído, você vai receber uma notificação e poderá conferir o aplicativo no navegador. Confira o que ele gerou para nós:

366a66b7a4249b18.png

Podemos parar por enquanto. A ideia era demonstrar e verificar o que ele pode fazer com requisitos simples.

(Opcional) Enviar mudanças para um repositório do GitHub

Se você não quiser enviar o site do evento que criamos para o GitHub, ignore esta seção e passe para a próxima.

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

Create a .gitignore file for this project.

A próxima etapa é dar instruções para a CLI do Antigravity enviar esse repositório para nossa conta do GitHub. Isso deve usar o auxiliar do GitHub (gh), que precisa estar disponível e configurado na sua máquina. 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:

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

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

b393c67b13ddf19a.png

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 Antigravity para trabalhar com um repositório de código

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

  • Entender a base de código
  • Gerar a documentação
  • Implementar um novo recurso

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

Pré-requisito

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

  • CLI do Antigravity
  • Você precisa ter concluído a seção anterior e ter o código gerado em mãos, em que criamos um leitor de notas da versão do BigQuery.

Vamos continuar usando a CLI Antigravity na pasta/diretório que você usou para gerar o aplicativo das notas da versão do BigQuery.

Teste os comandos a seguir:

Entender 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. Ele vai criar um novo arquivo (artefato), e você pode conferir todos os artefatos ou artefatos específicos usando o comando **/artifact**.
  • Explique @app.py

Como gerar um arquivo README

  • Gere um arquivo README para este projeto.

Implementar um novo recurso

  • Implemente dois recursos de utilidade simples: um botão "Copiar para a área de transferência" em cada card e um botão "Exportar para CSV".
  • Implemente uma chave de alternância simples no cabeçalho que troque o esquema de cores da página do modo escuro para o claro substituindo as variáveis raiz do CSS.

Ele vai fornecer um plano que você pode aprovar. Após a aprovação, a CLI do Antigravity fará essas mudanças. Teste suas mudanças e, se houver bugs (o que é provável), peça para a CLI do Antigravity corrigir.

Gerar problemas com base nos recursos sugeridos

Vamos tentar algo interessante aqui. Você vai perguntar à CLI do Antigravity como ela pode melhorar a experiência do usuário desse aplicativo.

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 me envie.

Como pergunta complementar, você pode pegar um dos problemas gerados anteriormente e pedir para a CLI do Antigravity trabalhar e implementar a solução.

(Opcional) Atividades cotidianas

Os casos de uso abaixo são tarefas que você pode acabar fazendo regularmente, como 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.

Fique à vontade para explorar qualquer um dos casos de uso que você quiser.

Organizar arquivos/pastas

Você pode usar a CLI do Antigravity para organizar os arquivos dependendo dos 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".

Navegue até essa pasta e inicie a CLI do Antigravity. Primeiro, você vai pedir à CLI Antigravity para criar algumas pastas: "Imagens", "Documentos" e "Vídeos". Depois, vai pedir para ela organizar os arquivos nas pastas.

A CLI do Antigravity geralmente pede permissão antes de executar comandos, especialmente 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 de execução na nossa máquina:

I have completed organizing your files into their respective folders. Here is a summary of the files moved:                                          
                                                                                                                                                       
  • Images: Moved 95 files ending in  .jpg  or  .jpeg  (no  .gif  files were present).                                                         
  • Documents: Moved 1 file ending in  .txt  ( 12March_Live_chat_transcript.txt ).                                                                
  • Videos: Moved 26 files ending in  .mp4 .

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

  1. 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.
  2. 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".
  3. 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".

Resumir artigos (arquivos locais ou da Web)

Para cada um dos cenários abaixo, mude o URL, o tema de interesse e os nomes dos arquivos locais conforme necessário. Os nomes de arquivos fornecidos são exemplos. Você pode substituí-los pelos nomes dos arquivos que tem no seu sistema.

Teste um dos seguintes cenários (os comandos são fornecidos ao lado de cada um):

  • Resumir um artigo da Web (URL único): acesse https://medium.com/google-cloud/antigravity-cli-tutorial-series-12b46cfe3bf2 e resuma os três principais pontos importantes desse artigo de notícias.
  • Resumir vários artigos da Web (por exemplo, de uma pesquisa): encontre os artigos de notícias mais recentes sobre "Antigravity CLI" usando a Pesquisa Google. Para os cinco artigos mais relevantes, resuma cada um em duas ou três frases e liste os URLs.
  • Resumir um arquivo de texto local:resuma os principais pontos do artigo em "my_research_paper.txt". Foque na metodologia e nas conclusões.
  • Resumir um PDF local:leia "financial_report_Q2_2025.pdf". Faça um resumo da performance financeira e dos principais desafios mencionados.

Extrair informações específicas (arquivos locais ou da Web)

Para cada um dos cenários abaixo, mude o URL, o tema de interesse e os nomes dos arquivos locais conforme necessário. Os nomes de arquivos fornecidos são exemplos. Você pode substituí-los pelos nomes dos arquivos que tem no seu sistema.

Teste um dos seguintes cenários (os comandos são fornecidos ao lado de cada um):

  • Extrair entidades de um artigo local:do arquivo "biography.txt", liste todas as pessoas nomeadas e as datas importantes associadas a elas.
  • Extrair dados de uma tabela em um PDF:em "quarterly_sales.pdf", extraia os dados da tabela na página 3 que mostra "Vendas de produtos por região" e apresente-os em formato de tabela Markdown.
  • Extrair manchetes e fontes de um site de notícias:acesse "https://news.google.com/" (ou um site de notícias semelhante). Extraia as principais manchetes da primeira página e as fontes de notícias correspondentes. Apresente-os como uma lista com marcadores.
  • Encontre especificações de produtos em uma página de e-commerce:acesse "https://www.amazon.in/Google-Cloud-Certified-Associate-Engineer/dp/1119871441" (exemplo de um livro). Extraia o título do livro, o autor e outros detalhes. Apresente essas informações em um formato JSON estruturado.
  • Extraia a duração de um vídeo em um determinado formato (por exemplo, "2h37m42s").

Responder a perguntas com base no conteúdo (comportamento semelhante ao RAG)

Para cada um dos cenários abaixo, mude o URL, o tema de interesse e os nomes dos arquivos locais conforme necessário. Os nomes de arquivos fornecidos são exemplos. Você pode substituí-los pelos nomes dos arquivos que tem no seu sistema.

Teste um dos seguintes cenários (os comandos são fornecidos ao lado de cada um):

  • Perguntas e respostas sobre um documento local:estou anexando o arquivo "user_manual.pdf". Quais são as etapas para resolver problemas de conectividade de rede?
  • Perguntas e respostas em uma página da Web:usando o conteúdo de"https://www.who.int/news-room/fact-sheets/detail/climate-change-and-health", quais são os principais riscos à saúde associados à mudança climática de acordo com a OMS?
  • Comparar informações de várias fontes: tenho dois artigos de notícias, "article1.txt" e "article2.txt", que discutem as mudanças recentes na política econômica. Compare e contraste os pontos de vista deles sobre o possível impacto nas pequenas empresas.

Geração de conteúdo com base em informações extraídas

Para cada um dos cenários abaixo, mude o URL, o tema de interesse e os nomes dos arquivos locais conforme necessário.

Teste um dos seguintes cenários (os comandos são fornecidos ao lado de cada um):

  • Gerar um resumo de notícias de um artigo:leia @tech_innovation_article.txt e escreva um resumo de notícias curto e envolvente (cerca de 150 palavras) adequado para um boletim informativo de uma empresa, destacando a nova tecnologia e o potencial dela.
  • Escreva um e-mail resumindo a transcrição de uma reunião:aqui está um arquivo de transcrição de reunião: @meeting_transcript.txt. Escreva um e-mail para a equipe resumindo as principais decisões tomadas e as ações necessárias atribuídas, incluindo quem é responsável por cada uma delas.

Suporte multimodal da CLI do Antigravity

A CLI do Antigraity tem suporte para vários modelos via Gemini, e você pode pedir que ela processe arquivos de diferentes formatos de conteúdo de acordo com suas necessidades.

Você vai processar várias imagens de faturas com a CLI do Antigravity e extrair informações importantes delas. Siga estas etapas:

  • Crie uma pasta na sua máquina e faça o download de algumas faturas do seguinte repositório do GitHub.
  • Inicie a CLI do Antigravity nessa pasta

Dê o seguinte comando para extrair informações das faturas em forma de tabela.

The current folder contains a list of invoice files in Image format. Go through all the files in this folder and extract the following invoice information in the form of a table: Invoice No, Invoice Date, Invoice Sent By, Due Date, Due Amount.

O ideal é que você receba uma saída como esta:

7203d699d875a91f.png

Confira outro cenário em que você pode pedir mais colunas derivadas. Digamos que você queira mostrar um emoji de cruz vermelha para todas as datas de vencimento de faturas que já passaram. Você pode dar um comando assim:

list all files with .png extension in this folder. Extract the invoice information from it by reading them locally and display it in a table format containing the following column headers: : Invoice No, Invoice Date, Invoice Sent By, Due Date, Due Amount. Add a column at the end of the table that shows a red cross emoji in case the due date is in the past.

Isso produz a seguinte saída:

e11fcde0400f5a0b.png

Aplique isso a qualquer um dos seus arquivos que estejam em formatos diferentes de texto.

Usar a CLI do Antigravity para gerar dados

Você pode pedir à CLI Antigravity para gerar dados em vários formatos. Isso pode variar de partes de conteúdo a dados JSON que você talvez precise simular. Vamos focar aqui em cenários aplicáveis a desenvolvedores/testadores.

Confira alguns comandos para testar:

Gerar dados JSON de avaliações de clientes de amostra

Generate a JSON array of 3 synthetic customer reviews for a new smartphone. Each review should have 'reviewId' (string, UUID-like), 'productId' (string, e.g., 'SMARTPHONE_X'), 'rating' (integer, 1-5), 'reviewText' (string, 20-50 words), and 'reviewDate' (string, YYYY-MM-DD format).

Gerar respostas de API simuladas (JSON)

Generate a JSON array representing 7 daily sales records for a mock API endpoint. Each record should include 'date' (YYYY-MM-DD, chronologically increasing), 'revenue' (float, between 5000.00 and 20000.00), 'unitsSold' (integer, between 100 and 500), and 'region' (string, either 'North', 'South', 'East', 'West').

Gerar instruções de inserção de banco de dados de amostra (SQL)

Generate 5 SQL INSERT statements for a table named 'users' with columns: 'id' (INTEGER, primary key), 'username' (VARCHAR(50), unique), 'email' (VARCHAR(100)), 'password_hash' (VARCHAR(255)), 'created_at' (DATETIME, current timestamp). Ensure the password_hash is a placeholder string like 'hashed_password_X'.

Gerar dados CSV para carregamento/análise de dados

Generate 10 lines of CSV data, including a header row, for customer transactions. Columns should be: 'TransactionID' (unique string), 'CustomerID' (integer), 'ItemPurchased' (string, e.g., 'Laptop', 'Monitor', 'Keyboard'), 'Quantity' (integer, 1-3), 'UnitPrice' (float, between 100.00 and 1500.00), 'TransactionDate' (YYYY-MM-DD).

Gerar um arquivo de configuração (YAML)

Generate a sample YAML configuration for a 'user_service'. Include sections for 'database' with 'host', 'port', 'username', 'password', 'database_name'. Also include a 'api_keys' section with 'payment_gateway' and 'email_service' placeholders. Use realistic default values.

Geração de dados de teste para casos extremos/validação

Generate a JSON array of 8 email addresses for testing purposes. Include a mix of: 2 valid standard emails, 2 with missing '@', 2 with invalid domains (e.g., '.com1'), and 2 with special characters in the local part that are usually invalid (e.g., spaces or multiple dots).

9. Parabéns

Parabéns! Você conheceu a CLI do Antigravity, suas funcionalidades e aplicou a ferramenta a alguns casos de uso.

Documentos de referência