From db891fb2e00953089399dab079488ea874152fa9 Mon Sep 17 00:00:00 2001
From: Twisha Bansal <twishabansal07@gmail.com>
Date: Tue, 26 May 2026 20:44:05 +0530
Subject: [PATCH] docs: update readme to connect with antigravity

---
 .lycheeignore |   1 +
 README.md     | 107 +++++++++++++++++++++++++++++++-------------------
 2 files changed, 67 insertions(+), 41 deletions(-)

diff --git a/.lycheeignore b/.lycheeignore
index 5a442f1..74412e7 100644
--- a/.lycheeignore
+++ b/.lycheeignore
@@ -1 +1,2 @@
 https://github.com/gemini-cli-extensions/bigquery-data-analytics/compare/
+https://www.npmjs.com/package/skills
diff --git a/README.md b/README.md
index 01200e8..3864304 100644
--- a/README.md
+++ b/README.md
@@ -17,10 +17,9 @@ Developers can effortlessly connect, interact, and generate data insights with [
 - [Why Use the BigQuery Data Analytics Extension?](#why-use-the-bigquery-data-analytics-extension)
 - [Prerequisites](#prerequisites)
 - [Getting Started](#getting-started)
-  - [Gemini CLI](#gemini-cli)
+  - [Antigravity](#antigravity)
   - [Claude Code](#claude-code)
   - [Codex](#codex)
-  - [Antigravity](#antigravity)
 - [Usage Examples](#usage-examples)
 - [Supported Skills](#supported-skills)
 - [Additional Extensions](#additional-extensions)
@@ -39,10 +38,11 @@ Developers can effortlessly connect, interact, and generate data insights with [
 Before you begin, ensure you have the following:
 
 - One of these AI agents installed
-  - [Gemini CLI](https://github.com/google-gemini/gemini-cli) version **v0.6.0** or higher
-  - [Claude Code](https://claude.com/product/claude-code) version **v2.1.94** or higher
-  - [Codex](https://developers.openai.com/codex) **v0.117.0** or higher
-  - [Antigravity](https://antigravity.google) **v1.14.2** or higher
+  - Antigravity
+     - [Antigravity CLI](https://github.com/google-gemini/gemini-cli) version **v1.6.0** or higher
+     - [Antigravity 2.0](https://antigravity.google/product/antigravity-2) version **v2.0.0** or higher.
+  - [Claude Code](https://claude.com/product/claude-code) version **v2.1.94** or higher.
+  - [Codex](https://developers.openai.com/codex) **v0.117.0** or higher.
 - A Google Cloud project with the **BigQuery API** enabled.
 - Ensure [Application Default Credentials](https://cloud.google.com/docs/authentication/gcloud) are available in your environment.
 - IAM Permissions:
@@ -78,34 +78,73 @@ For the latest version, check the [releases page][releases].
 <!-- {x-release-please-start-version} -->
 
 <details open>
-<summary id="gemini-cli">Gemini CLI</summary>
+<summary id="antigravity">Antigravity</summary>
+
+You can use either of these two agents for Antigravity:
+- [Antigravity CLI](https://github.com/google-gemini/gemini-cli) version **v1.6.0** or higher
+- [Antigravity 2.0](https://antigravity.google/product/antigravity-2) version **v2.0.0** or higher.
+
+<blockquote>
+💡 <strong>Tip — Migrating from Gemini CLI?</strong><br>
+If you previously installed this extension with <code>gemini extensions install</code>, you can convert it to an Antigravity plugin instead of reinstalling from scratch:
+<ul>
+  <li><strong>On first launch of Antigravity CLI</strong>, accept the Migration Options prompt to automatically convert your installed Gemini CLI extensions to Antigravity plugins.</li>
+  <li><strong>Or, from your terminal</strong>, run:
+    <pre><code class="language-bash">agy plugin import gemini</code></pre>
+  </li>
+</ul>
+See <a href="https://antigravity.google/docs/gcli-migration">Migrating from Gemini CLI</a> for details on plugins, context files (<code>GEMINI.md</code> / <code>AGENTS.md</code>), and MCP server config differences.
+</blockquote>
+
+#### Antigravity 2.0 (IDE)
+
+**1. Clone the Repo:**
+
+```bash
+git clone --branch 0.2.1 https://github.com/gemini-cli-extensions/bigquery-data-analytics.git
+```
+
+**2. Install the skills:**
 
-**1. Install the extension:**
+Choose a location for the skills:
+- **Global (all workspaces):** `~/.gemini/antigravity/skills/`
+- **Workspace-specific:** `<workspace-root>/.agents/skills/`
+
+Copy the skill folders from the cloned repository's `skills/` directory to your chosen location:
 
 ```bash
-gemini extensions install https://github.com/gemini-cli-extensions/bigquery-data-analytics
+cp -R bigquery-data-analytics/skills/* ~/.gemini/antigravity/skills/
 ```
 
-During the installation, enter your environment vars as described in the [configuration section](#configuration).
+**3. Set env vars:**
+Set your environment vars as described in the [configuration section](#configuration).
 
-**2. (Optional) Manage Configuration:**
-To view or update your configuration in Gemini CLI:
+_(Tip: Antigravity 2.0 automatically discovers skills in these directories at the start of a session. You can verify they are active by running the `/skills` command in your active session.)_
 
-- Terminal: `gemini extensions config bigquery-data-analytics [setting name] [--scope <scope>]`
-- Gemini CLI: `/extensions list`
+#### Antigravity CLI
 
-**3. Start the agent:**
+**1. Clone the Repo:**
 
 ```bash
-gemini
+git clone --branch 0.2.1 https://github.com/gemini-cli-extensions/bigquery-data-analytics.git
 ```
 
-_(Tip: Run `/extensions list` to verify your configuration and active extensions.)_
+**2. Install the skills:**
 
-> [!WARNING]
-> **Changing Instance & Database Connections**
-> Currently, the database connection must be configured before starting the agent and can not be changed during a session.
-> To save and resume conversation history in Gemini CLI use command: `/chat save <tag>` and `/chat resume <tag>`.
+Choose a location for the skills:
+- **Global (all workspaces):** `~/.gemini/antigravity-cli/skills/`
+- **Workspace-specific:** `<workspace-root>/.agents/skills/`
+
+Copy the skill folders from the cloned repository's `skills/` directory to your chosen location:
+
+```bash
+cp -R bigquery-data-analytics/skills/* ~/.gemini/antigravity-cli/skills/
+```
+
+**3. Set env vars:**
+Set your environment vars as described in the [configuration section](#configuration).
+
+_(Tip: Antigravity CLI automatically discovers skills in these directories at the start of a session. You can verify they are active by running the `/skills` command in your active session.)_
 
 </details>
 
@@ -185,35 +224,21 @@ Enter your environment vars as described in the [configuration section](#configu
 _(Tip: Run `codex plugin list` or use the `/plugins` interactive menu to verify your installed plugins.)_
 
 </details>
+## Installing using [open agent skills tool](https://github.com/vercel-labs/skills)
 
-<details>
-<summary id="antigravity">Antigravity</summary>
+You can install skills using the `npx skills` command.
 
-**1. Clone the Repo:**
+Run the following command in your terminal to automatically download and register the skills:
 
 ```bash
-git clone --branch 0.2.1 https://github.com/gemini-cli-extensions/bigquery-data-analytics.git
+npx skills add https://github.com/gemini-cli-extensions/bigquery-data-analytics/tree/0.2.1
 ```
 
-**2. Install the skills:**
+For detailed info check out the [Skills npm package](https://www.npmjs.com/package/skills).
 
-Choose a location for the skills:
-- **Global (all workspaces):** `~/.gemini/antigravity/skills/`
-- **Workspace-specific:** `<workspace-root>/.agents/skills/`
-
-Copy the skill folders from the cloned repository's `skills/` directory to your chosen location:
-
-```bash
-cp -R bigquery-data-analytics/skills/* ~/.gemini/antigravity/skills/
-```
-
-**3. Set env vars:**
+**2. Set env vars:**
 Set your environment vars as described in the [configuration section](#configuration).
 
-_(Tip: Antigravity automatically discovers skills in these directories at the start of a session.)_
-
-</details>
-
 <!-- {x-release-please-end} -->