Antigravity CLI を使った実践演習

1. はじめに

この Codelab では、Antigravity の軽量なターミナル ユーザー インターフェース（TUI）サーフェスである Antigravity CLI について学びます。Antigravity 2.0 と同じコア エージェント機能（マルチステップ推論、マルチファイル編集、ツール呼び出し、会話履歴など）をターミナルに直接提供します。

学習内容

1. Antigrabity CLI のインストールと構成
2. Antigravity CLI の基本的な使用方法を理解する
3. Antigravity CLI を使用したユースケースの探索

必要なもの

必要なものは次のとおりです。

• Chrome ウェブブラウザ
• Gmail アカウント

この Codelab は、初心者を含むあらゆるレベルのユーザーとデベロッパーを対象としています。Codelab のユースケースは、デベロッパー タスクと非デベロッパー タスクに分類されています。デベロッパーのユースケースでは、Antigravity CLI を使用してコードを操作し、GitHub リポジトリを使用して、コードの説明/理解、ドキュメントの生成、問題の修正などの一般的な開発タスクを実行する方法を示します。Codelab のこれらのユースケースを完了することをおすすめします。最後に、デベロッパー以外のユーザーを対象とした、日常的なタスクをいくつか紹介するオプションのセクションがあります。

2. 始める前に

プロジェクトを作成する

1. Google Cloud コンソールのプロジェクト選択ページで、Google Cloud プロジェクトを選択または作成します。
2. Cloud プロジェクトに対して課金が有効になっていることを確認します。詳しくは、プロジェクトで課金が有効になっているかどうかを確認する方法をご覧ください。
3. Cloud Shell（Google Cloud で動作するコマンドライン環境）を使用します。この環境には bq がプリロードされています。Google Cloud コンソールの上部にある [Cloud Shell をアクティブにする] をクリックします。

4. Cloud Shell に接続したら、次のコマンドを使用して、すでに認証済みであることと、プロジェクトがプロジェクト ID に設定されていることを確認します。

gcloud auth list

5. Cloud Shell で次のコマンドを実行して、gcloud コマンドがプロジェクトを認識していることを確認します。

gcloud config list project

6. プロジェクトが設定されていない場合は、次のコマンドを使用して設定します。

gcloud config set project <YOUR_PROJECT_ID>

3. インストール

設定を行い、Antigravity CLI を実行する前に、ホームフォルダとして使用するフォルダを作成します。このホームフォルダの中に、すべてのプロジェクトを作成します。ホームフォルダは Antigravity CLI が動作するための開始点ですが、必要に応じてシステム上の他のフォルダも参照します。これについては後で説明します。

サンプル フォルダ（agy-cli-projects）を作成し、次のコマンドでそのフォルダに移動します。別のフォルダ名を使用する場合は、そのようにしてください。

mkdir agy-cli-projects

そのフォルダに移動します。

cd agy-cli-projects

インストールは簡単で、主要なオペレーティング システムでバイナリを使用できます。ターミナルで実行するコマンドは、インストール ドキュメントから直接取得しました。

macOS | Linux

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

Windows PowerShell

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

Windows CMD

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

これにより、システムとパスに Antigravity CLI（agy）が設定され、インストールされます。

場合によっては、インストーラがバイナリ（agy から PATH）を追加できないと、その旨が表示されます。たとえば、次の出力例は、インストーラがバイナリを PATH に追加できず、対処方法が提案された場合のものです。

% 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.

次のコマンドで Antigravity CLI のバージョンを確認してください（表示されるバージョンは、この Codelab の作成時点のものです）。

$ agy --version
1.0.5

Antigravity CLI を初めて起動すると、ログインを求められます。agy を起動すると、次のような画面が表示されます。

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

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]

当面は個人アカウントを使用してください。[1. Google OAuth] を選択して Enter キーを押します。ブラウザが起動し、Google アカウントでログインできます。認証と認可が成功すると、コードのコピーを求められます。Antigravity CLI ターミナルに戻ってコードを貼り付けます。

ログインが成功すると、次の処理が行われます。

1. まず、以下のように、Antigravity CLI に使用するカラーテーマを選択するよう求められます。好きなものを選択してください。
2. 次に、いくつかの利用規約に同意する必要があります。同意してください。

最後に、最も重要なことは、以下に示すように、フォルダを信頼する権限を付与することです。

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

通常、Antigravity CLI を起動する新しいフォルダに表示されます。これについては、このシリーズの後半で詳しく説明しますが、ここでは [Yes, I trust this folder]（はい、このフォルダを信頼します）をクリックしてください。

おめでとうございます！これで完了です。Antigravity CLI がプロンプトを待機しています。

4. Antigravity CLI との最初のやり取り

Antigravity CLI を起動し、以下に示す最初のクエリを入力してみましょう。

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

想定されるレスポンスを以下に示します。

● 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         
  

Antigravity が社内ツール WebSearch を使用して見積もりを取得したことがわかります。

ここでプロンプトを表示する以外に、Antigravity CLI でサポートされているさまざまなコマンドにはどのようなものがありますか？/help（スラッシュ）を入力すると、さまざまなコマンドやキーボード ショートカットが表示されます。執筆時点でのコマンドの一部を以下に示します。

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>

ここでは、Antigravity CLI を終了します。/quit コマンドを使用するか、インタラクティブな Antigravity CLI ターミナル セッションで ctrl+d を 2 回実行します。

5. Antigravity CLI - いくつかの管理コマンド

Antigravity CLI が起動し、コマンドを待機していることを確認します。

使用しているモデルは、右下に表示されます。まず、必要なカスタマイズと設定のほとんどは /config コマンドまたは /settings コマンドで利用できることを理解しておくことが重要です。

構成 / 設定

/config コマンドを呼び出します。これにより、好みに合わせてカスタマイズできる Antigravity のさまざまな領域が表示されます。これには、カラーパターン、ツールの権限、テレメトリー設定などが含まれます。

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

たとえば、[Color Scheme] を選択すると、次のオプションが表示され、そこから好みのカラーパターンを選択できます。

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

settings.json

構成設定はどこかに保存する必要があります。すべての構成設定は ~/.gemini/antigravity-cli/settings.json ファイルに保存されます。サンプルを次に示します。

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

選択した colorScheme、モデル、Antigravity CLI を起動したさまざまなフォルダが表示されます。フォルダを信頼するかどうかを尋ねられたら、[はい] を選択します。

注: settings.json を直接変更することもできます。変更を確認するには、ベスト プラクティスとして Antigravity CLI を再起動します。ただし、設定を間違えると、起動時にエラーが表示されます。ファイルを直接変更することに不安がある場合は、Antigravity CLI で /settings コマンドまたは /config コマンドを使用してこのファイルを操作することをおすすめします。

ツールの権限

重要な設定として、ツールの権限があります。これは、ターミナル コマンドを実行する前に承認が必要かどうかを制御します。この設定には、/config コマンドでアクセスできます。

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

デフォルトでは request-review に設定されています。詳しく見ていきましょう。Antigravity では、ツールの権限設定によって、セキュリティ（ホストシステムを意図しない変更から保護する）と速度（エージェントがユーザーの入力を待たずに自律的に動作できる度合い）のバランスが制御されます。オプションを確認しましょう。

request-review（現在のデフォルト）

このモードでは、エージェントは、事前承認済みの範囲外でシステムやプロジェクト ファイルに影響を与える可能性のあるアクションを実行する前にチェックインするコラボレーション パートナーとして扱われます。エージェントがターミナル コマンドの実行、ファイル オペレーション（書き込みや削除など）の実行、権限が事前に承認されていない外部サービスの呼び出しを試みると、実行が一時停止します。ユーザーに特定のアクションの承認または拒否を求めるメッセージが表示されます。

proceed-in-sandbox

このモードでは、エージェントは安全な分離コンテナ内でターミナル コマンドを自動的に実行できます。エージェントはユーザーに確認せずにコマンドを実行できますが、これらのコマンドは仮想化されたサンドボックス（軽量コンテナなど）で実行されます。実際のホストマシンのファイル システムを変更したり、ローカル ネットワークにアクセスしたりすることはできません。

always-proceed

これは完全自律モードであり、エージェントの速度と能力を最大限に高めます。エージェントには、ホストマシンでコマンドを実行し、ファイルを直接書き込むための完全な権限が付与されます。確認を求めるメッセージが表示されることはありません。

strict

これはゼロトラストの高度なセキュリティ モードです。エージェントの機能は読み取りツールの実行に制限されます。読み取り以外のツールでは、ユーザーにアクションを求めるプロンプトが表示されます。

6. Antigravity CLI - コマンド パラメータ

Antigravity CLI を起動するときに指定できるコマンドライン パラメータがいくつかあります。オプションの完全なリストを取得するには、次のように --help を使用します。

agy --help

これにより、利用可能なオプションの全範囲が表示されます。以下にサンプルリストを示します。

$ 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

そのうちのいくつかを見てみましょう。

非インタラクティブ モード（自律型）

Antigravity CLI には、非インタラクティブ モードで実行するオプションもあります。このモードでは、プロンプトを直接指定することで、Antigravity CLI のインタラクティブ ターミナルを開かずに Gemini が回答します。スクリプトやその他の自動化プロセスの一部として Antigravity CLI を自動化して使用する場合に非常に便利です。

次の例に示すように、-p パラメータを使用して、Antigravity CLI にプロンプトを指定します。

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

これは、簡単な回答を得るには良い方法ですが、フォローアップの質問で会話を続けることはできないことに注意してください。

特定のモデルを選択する

1 つ目は、特定の Gemini モードを使用するように Antigravity CLI に指示することです。--model パラメータを使用すると、セッション中にのみ特定のモデルを使用するように Antigravity CLI に指示できます。これは、前のセクションで説明した非インタラクティブ モードで、複数の agy セッションを起動し、特定のタスクに特定のモデルを使用する場合に非常に便利です。

まず、Antigravity CLI で使用できるモデルを確認する必要があります。これを行うには、次のように models サブコマンドを使用します。

$ 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)

これらのモデル名のいずれかを使用して、セッションで使用するモデルを指定できます。これを行うには、次の --model コマンドを使用します。

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

Antigravity CLI が起動したら、/model コマンドで、使用するようリクエストした特定のモデルを確認するか、セッションで使用されたモデルを示す右下を確認します。

危険な生活

危険を冒したい場合は、--dangerously-skip-permissions という名前のパラメータを探してください。これにより、すべてのツール権限が自動的に承認されます。権限を求めるプロンプトは表示されません。慎重に使用してください。

次のコマンドを使用して Antigravity CLI を起動します。

agy --dangerously-skip-permissions

次のプロンプトを入力します。書き込みファイル権限を要求していないことを確認します。

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

このモードは、ローカルで制御可能な状況で役立ちますが、予期しない事態に備えて慎重に使用してください。

7. Antigravity CLI - シェルモード

ここで、Antigravity CLI 内からシェルを直接操作する方法を学習することをおすすめします。メッセージ ボックスで ! を押すと、シェルモードに切り替わります。もう一度 ! を押すか、ESC キーを押すと、元のモードに戻ります。

シェルモードでは、以下に示すようにプロンプトの先頭に ! が表示されます。

次の例に示すように、pwd や ls などの標準コマンドを使用して直接確認できます。コマンドは Linux タイプの OS を想定しています。別のオペレーティング システム（Windows）を使用している場合は、同等のコマンド（cd、dir、type など）を使用してください。

8. 試してみるユースケース

Antigravity CLI は、デベロッパーと非デベロッパーの両方に適用される幅広いユースケースに適用できます。ここではいくつかのシナリオを紹介します。興味のある分野に応じて、これらのシナリオを試すことができます。

これらの各ケースでは、プロンプトが提供されます。Antigravity CLI のインタラクティブ モードで試して、Antigravity CLI がタスクをどのように実行するかを理解してください。

Antigravity CLI を使用したバイブ コーディング

Antigravity CLI を使用してアプリケーションをバイブコード化します。このタスクでは、Antigravity CLI にアプリケーションの生成を依頼し、初期バージョンを GitHub リポジトリに push します。

要件

このセクションのタスクを実行するには、いくつかの前提条件があります。

• Git
• Antigravity CLI
• Python 3 環境
• gh（GitHub CLI ツール）を設定します。
• Git の基本とプログラミングの知識

ここでは、任意の特定のフォルダで Antigravity CLI を起動していることを前提とします。この例では、初期ホームフォルダ agy-cli-projects とその中の別のフォルダ bq-releases-notes から Antigravity CLI を起動しています。

最初のプロンプトから始めます。アプリケーションの仕様と考えてください。必要に応じて変更してください。Antigravity CLI のセッションでは、ファイルの作成などの権限を求められます。必要な権限を付与してください。

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.

次のプロンプトと回答は、観察されたサンプルフローです。Antigravity CLI は計画を立て、確認や説明を求めたり、続行したりします。手順に沿って操作してください。サンプルとして、会話スレッドの例を次に示します。

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

Antigravity のアーティファクトについて説明します。アーティファクトは、Antigravity CLI が実装計画、処理中のタスクのリスト、検証可能な出力などを通知するために使用するものです。これらのファイルは生成され、Antigravity が行っている作業、計画、タスクリストなどの記録となります。

その後、「BigQuery リリースノート ウェブ アプリケーションの設計とアーキテクチャの概要を示す implementation_plan.md を作成しました。特に Twitter コンポーザーとプレビュー カードのアプローチについて、プランをご確認ください。承認されるかどうか、または調整が必要な場合はお知らせください。」と返信します。

右下には、確認するアーティファクトが 1 つあることも示されています。この場合は implementation_plan.md です。

/artifact コマンドを実行します。これにより、生成されたアーティファクト implementation_plan.md が表示され、矢印キーを使用して開く、承認する、拒否するなどの操作を行うことができます。[Esc] キーを押してプロンプトに戻り、必要に応じて承認します。

ここでは、生成された内容を承認します。これにより、次の手順が開始され、実装（ファイルの作成、いくつかのコマンドの実行など）が開始されます。必要に応じて、実行を承認して権限を付与するよう求められます。

この例では、Python 仮想環境の作成、requirements.txt による依存関係のインストールなどを承認しています。

バックグラウンドでは、実装計画に基づいて実行する必要があるタスクの一部として task.md ファイルも作成され、個々のタスクが完了するとチェックマークが付けられます。完了すると通知が表示され、ブラウザでアプリケーションを確認できます。生成された内容は次のとおりです。

これでいったん終了します。このアイデアは、シンプルな要件で何ができるかを実証し、確認することを目的としていました。

（省略可）変更を GitHub リポジトリに push する

作成したイベント ウェブサイトを Github に push しない場合は、このセクションを無視して次のセクションに進んでください。

まず、.gitignore ファイルを作成します。Antigravity CLI を使用できます。

Create a .gitignore file for this project.

次のステップとして、このリポジトリを GitHub アカウントに push するよう Antigravity CLI に指示します。これにより、マシンで使用可能で構成 / 設定されている GitHub ヘルパー（gh）が使用されます。GitHub MCP サーバーツールがバックグラウンドで実行されます。

次のようなプロンプトを入力します。

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

ここでは、次のコマンドを実行します。

1. リポジトリを作成します。
2. ローカル Git リポジトリを管理するために、init、add、commit などの複数の Git コマンドを使用します。
3. 次に、Git リモートを設定して push を実行します。

問題がなければ、GitHub リポジトリが作成されているはずです。GitHub リポジトリのページにアクセスできます。以下に、スクリーンショットの例を示します。

このプロジェクトの README.md は生成されていません。これは次のセクションで取り組むのに適した演習です。次のセクションでは、作成したばかりのこのリポジトリを操作します。

Antigravity CLI を使用してコード リポジトリを操作する

このユースケースでは、Antigravity CLI を使用してコード リポジトリを操作します。次の複数のタスクを行います。

• コードベースを理解する
• ドキュメントの生成
• 新機能の実装

これにより、リポジトリを操作し、これらのデベロッパー固有のタスクで Antigravity CLI をアシスタントとして使用するための基盤が整います。

要件

このセクションのタスクを実行するには、次のものが必要です。

• Antigravity CLI
• 前のセクションを完了し、BigQuery リリースノート リーダーを作成したときに生成されたコードを手元に用意しておく必要があります。

BigQuery リリースノート アプリケーションの生成に使用したフォルダ/ディレクトリから、引き続き Antigravity CLI を使用します。

以下に示すプロンプトを試してください。

コードベースを理解する

• このプロジェクトについて詳しく知りたいです。主な機能について説明し、サーバーサイドとクライアントサイドに分けてください。サンプル フローを使用して、リクエストとレスポンスの仕組みを説明してください。新しいファイル（アーティファクト）が作成されます。/artifact コマンドを使用して、すべてのアーティファクトまたは特定のアーティファクトを表示できます。
• @app.py の説明

README ファイルの生成

• このプロジェクトの README ファイルを生成します。

新機能の実装

• 各カードの [クリップボードにコピー] ボタンと [CSV にエクスポート] ボタンという 2 つのシンプルなユーティリティ機能を実装してください。
• CSS ルート変数をオーバーライドして、ページのカラーパターンをダークモードからライトモードに切り替えるシンプルな切り替えスイッチをヘッダーに実装してください。

計画が提示されるので、承認します。承認すると、Antigravity CLI が変更を行います。変更をテストし、バグ（可能性が高い）がある場合は、Antigravity CLI に修正を依頼します。

提案された機能に基づいて問題を生成する

ここで面白いことを試してみましょう。このアプリケーションのユーザー エクスペリエンスを改善する方法について、Antigravity CLI に質問します。

次のプロンプトを試してください。

• ユーザー エクスペリエンスの観点からアプリケーションを評価していただきたいです。使いやすさ、応答性、役立つメッセージなどです。改善点のリストを作成して、リストとして提供してください。

もっと聞くとして、以前に生成された問題の 1 つを取り上げ、Antigravity CLI にその問題の解決と実装を依頼できます。

（省略可）日常的なタスク

以下のユースケースは、定期的に行う可能性のあるタスクです。たとえば、ファイルをフォルダに整理する、ウェブからコンテンツを取得して要約する、画像ファイルを処理してコンテンツを抽出する、データベースを操作するなどのタスクがあります。

ご興味のあるユースケースを自由にご覧ください。

ファイル/フォルダの整理

Antigravity CLI を使用すると、必要に応じてさまざまなフォルダにファイルの種類ごとに整理できます。パソコン上の .txt、.png、.jpg、.pdf、.mp4 などのファイルがいくつかあるフォルダに移動します。通常は、デスクトップまたはダウンロード フォルダです。

そのフォルダに移動して、Antigravity CLI を起動します。まず、Antigravity CLI に Images、Documents、Videos というフォルダを作成するよう指示します。次に、Antigravity CLI にフォルダ内のファイルを整理するよう指示します。

Antigravity CLI は、コマンド（特にファイル システムを変更するコマンド（ファイルの書き込み、移動、削除など））を実行する前に、権限を求めるプロンプトを表示することがよくあります。権限を付与する前に、これらのプロンプトを必ず慎重に確認してください。これは安全対策です。

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

次のプロンプトを入力します。

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.

マシンで実行した例を次に示します。

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 .

その他の整理シナリオ（各シナリオの横にプロンプトが表示されます）:

1. 要約: 「Documents」フォルダ内の各ドキュメントについて、同じフォルダに「summary_ORIGINAL_FILENAME.txt」という名前の txt ファイルを作成します。このファイルには、ドキュメントの要点を 3 文で要約した内容が含まれます。
2. タイプ別に分類する: このディレクトリ内のすべての PDF ファイルと DOCX ファイルをスキャンします。名前またはコンテンツに「invoice」が含まれるすべてのファイルを「Financial/Invoices」フォルダに移動します。「receipt」が含まれるファイルは「Financial/Receipts」に移動します。その他の .docx ファイルは「Reports」に移動します。
3. キー情報の抽出（および「タグ付け」）: 「Financial/Invoices」フォルダ内の各 PDF ファイルについて、その内容を読み取ります。日付が見つかった場合は、ファイルの名前を変更して、その日付を YYYY-MM-DD 形式で含めます（例: invoice_2025-07-26_original_name.pdf）。

記事の要約（ローカル ファイルまたはウェブ）

以下の各シナリオでは、必要に応じて URL、関心のあるトピック、ローカル ファイル名を自由に変更してください。指定されているファイル名はサンプル ファイル名です。システム上のファイルのファイル名に置き換えることができます。

次のいずれかのシナリオを試してください（各シナリオの横にプロンプトが記載されています）。

• ウェブ記事を要約する（単一の URL）: https://medium.com/google-cloud/antigravity-cli-tutorial-series-12b46cfe3bf2 にアクセスし、このニュース記事の重要なポイントを 3 つ要約します。
• 複数のウェブ記事を要約する（検索結果など）: Google 検索を使用して、「Antigravity CLI」に関する最新のニュース記事を見つけます。関連性の高い上位 5 件の記事について、それぞれ 2 ～ 3 文で要約し、URL をリストアップしてください。
• ローカル テキスト ファイルを要約する: 「my_research_paper.txt」の記事の要点をまとめます。方法論と結論に焦点を当てます。
• ローカル PDF を要約する: 「financial_report_Q2_2025.pdf」を読み取り、財務パフォーマンスと重要な課題の概要を説明します。

特定の情報を抽出する（ローカル ファイルまたはウェブ）

以下の各シナリオでは、必要に応じて URL、関心のあるトピック、ローカル ファイル名を自由に変更してください。指定されているファイル名はサンプル ファイル名です。システム上のファイルのファイル名に置き換えることができます。

次のいずれかのシナリオを試してください（各シナリオの横にプロンプトが記載されています）。

• ローカル記事からエンティティを抽出する: 「biography.txt」から、名前付きの個人とそれに関連する重要な日付をすべてリストします。
• PDF の表からデータを抽出する: 「quarterly_sales.pdf」の 3 ページにある「地域別の商品売上」を示す表からデータを抽出し、Markdown 表形式で表示します。
• ニュース ウェブサイトからニュースの見出しとソースを抽出する: 「https://news.google.com/」（または同様のニュースサイト）にアクセスします。トップページからメインの見出しと対応するニュースソースを抽出します。それらを箇条書きのリストとして表示します。
• e コマース ページから商品の仕様を見つける: 「https://www.amazon.in/Google-Cloud-Certified-Associate-Engineer/dp/1119871441」（書籍の例）に移動します。書籍名、著者などの詳細情報を抽出します。構造化された JSON 形式で提示します。
• 特定の形式（「2h37m42s」など）で、動画から再生時間を抽出します。

コンテンツに基づく質問への回答（RAG のような動作）

以下の各シナリオでは、必要に応じて URL、関心のあるトピック、ローカル ファイル名を自由に変更してください。指定されているファイル名はサンプル ファイル名です。システム上のファイルのファイル名に置き換えることができます。

次のいずれかのシナリオを試してください（各シナリオの横にプロンプトが記載されています）。

• ローカル ドキュメントに関する質問: 「user_manual.pdf」を添付します。ネットワーク接続の問題をトラブルシューティングする手順を教えてください。
• ウェブページの Q&A: 「https://www.who.int/news-room/fact-sheets/detail/climate-change-and-health」のコンテンツを使用して、WHO によると気候変動に関連する主な健康リスクは何ですか？
• 複数のソースの情報を比較する: 最近の経済政策の変更について説明している 2 つのニュース記事（article1.txt と article2.txt）があります。中小企業への潜在的な影響に関する両記事の意見を比較対照してください。

抽出された情報に基づくコンテンツの生成

以下の各シナリオでは、必要に応じて URL、関心のあるトピック、ローカル ファイル名を変更してください。

次のいずれかのシナリオを試してください（各シナリオの横にプロンプトが記載されています）。

• 記事からニュースの概要を生成する: @tech_innovation_article.txt を読み取ります。会社のニュースレターに適した、新しいテクノロジーとその可能性を強調する、短く魅力的なニュース ブリーフ（約 150 語）を作成してください。
• 会議の文字起こしを要約するメールの下書きを作成します。会議の文字起こしファイルは @meeting_transcript.txt です。チームに送信するメールの草案を作成し、決定事項と割り当てられたアクション アイテムの概要を説明します。各アイテムの担当者も記載します。

Antigravity CLI のマルチモーダル サポート

Antigraity CLI は Gemini を介してマルチモデルをサポートしており、要件に応じてさまざまなコンテンツ形式のファイルを処理するようにリクエストできます。

Antigraity CLI を使用して請求書画像を処理し、そこから重要な情報を抽出します。以下の手順に沿って操作してください。

• マシンにフォルダを作成し、次の GitHub リポジトリから請求書をダウンロードします。
• そのフォルダから Antigravity CLI を起動します。

次のプロンプトを指定して、請求書の情報を表形式で抽出します。

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.

理想的には、次のような出力が得られます。

別のシナリオとして、追加の派生列をリクエストすることもできます。過去の請求書の期日すべてに赤色のバツ印の絵文字を表示するとします。次のようにプロンプトを指定できます。

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.

出力は次のようになります。

テキスト以外の形式のファイルにも適用できます。

Antigravity CLI を使用してデータを生成する

Antigravity CLI にさまざまなデータ形式でデータを生成するように指示できます。コンテンツから、モックする必要がある JSON データまで、さまざまなデータ形式で生成できます。ここでは、デベロッパーやテスターに適用可能なシナリオに焦点を当てます。

以下に、試してみることをおすすめするプロンプトをいくつかご紹介します。

サンプル購入者レビューの JSON データを生成する

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).

モック API レスポンス（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').

サンプル データベース挿入ステートメント（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'.

データ読み込み/分析用の CSV データの生成

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).

構成ファイル（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.

エッジケース/検証用のテストデータの生成

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. 完了

Antigravity CLI とその機能について学び、いくつかのユースケースに適用できるようになりました。

リファレンス ドキュメント

• Antigravity CLI プロジェクトのホームページ
• Antigravity CLI のドキュメント