Skip to content

Commit 9cee2a0

Browse files
authored
docs: update readme to connect with antigravity (#130)
1 parent 279cc2a commit 9cee2a0

2 files changed

Lines changed: 67 additions & 41 deletions

File tree

.lycheeignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1 +1,2 @@
11
https://github.com/gemini-cli-extensions/bigquery-data-analytics/compare/
2+
https://www.npmjs.com/package/skills

README.md

Lines changed: 66 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -17,10 +17,9 @@ Developers can effortlessly connect, interact, and generate data insights with [
1717
- [Why Use the BigQuery Data Analytics Extension?](#why-use-the-bigquery-data-analytics-extension)
1818
- [Prerequisites](#prerequisites)
1919
- [Getting Started](#getting-started)
20-
- [Gemini CLI](#gemini-cli)
20+
- [Antigravity](#antigravity)
2121
- [Claude Code](#claude-code)
2222
- [Codex](#codex)
23-
- [Antigravity](#antigravity)
2423
- [Usage Examples](#usage-examples)
2524
- [Supported Skills](#supported-skills)
2625
- [Additional Extensions](#additional-extensions)
@@ -39,10 +38,11 @@ Developers can effortlessly connect, interact, and generate data insights with [
3938
Before you begin, ensure you have the following:
4039

4140
- One of these AI agents installed
42-
- [Gemini CLI](https://github.com/google-gemini/gemini-cli) version **v0.6.0** or higher
43-
- [Claude Code](https://claude.com/product/claude-code) version **v2.1.94** or higher
44-
- [Codex](https://developers.openai.com/codex) **v0.117.0** or higher
45-
- [Antigravity](https://antigravity.google) **v1.14.2** or higher
41+
- Antigravity
42+
- [Antigravity CLI](https://github.com/google-gemini/gemini-cli) version **v1.6.0** or higher
43+
- [Antigravity 2.0](https://antigravity.google/product/antigravity-2) version **v2.0.0** or higher.
44+
- [Claude Code](https://claude.com/product/claude-code) version **v2.1.94** or higher.
45+
- [Codex](https://developers.openai.com/codex) **v0.117.0** or higher.
4646
- A Google Cloud project with the **BigQuery API** enabled.
4747
- Ensure [Application Default Credentials](https://cloud.google.com/docs/authentication/gcloud) are available in your environment.
4848
- IAM Permissions:
@@ -78,34 +78,73 @@ For the latest version, check the [releases page][releases].
7878
<!-- {x-release-please-start-version} -->
7979

8080
<details open>
81-
<summary id="gemini-cli">Gemini CLI</summary>
81+
<summary id="antigravity">Antigravity</summary>
82+
83+
You can use either of these two agents for Antigravity:
84+
- [Antigravity CLI](https://github.com/google-gemini/gemini-cli) version **v1.6.0** or higher
85+
- [Antigravity 2.0](https://antigravity.google/product/antigravity-2) version **v2.0.0** or higher.
86+
87+
<blockquote>
88+
💡 <strong>Tip — Migrating from Gemini CLI?</strong><br>
89+
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:
90+
<ul>
91+
<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>
92+
<li><strong>Or, from your terminal</strong>, run:
93+
<pre><code class="language-bash">agy plugin import gemini</code></pre>
94+
</li>
95+
</ul>
96+
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.
97+
</blockquote>
98+
99+
#### Antigravity 2.0 (IDE)
100+
101+
**1. Clone the Repo:**
102+
103+
```bash
104+
git clone --branch 0.2.1 https://github.com/gemini-cli-extensions/bigquery-data-analytics.git
105+
```
106+
107+
**2. Install the skills:**
82108

83-
**1. Install the extension:**
109+
Choose a location for the skills:
110+
- **Global (all workspaces):** `~/.gemini/antigravity/skills/`
111+
- **Workspace-specific:** `<workspace-root>/.agents/skills/`
112+
113+
Copy the skill folders from the cloned repository's `skills/` directory to your chosen location:
84114

85115
```bash
86-
gemini extensions install https://github.com/gemini-cli-extensions/bigquery-data-analytics
116+
cp -R bigquery-data-analytics/skills/* ~/.gemini/antigravity/skills/
87117
```
88118

89-
During the installation, enter your environment vars as described in the [configuration section](#configuration).
119+
**3. Set env vars:**
120+
Set your environment vars as described in the [configuration section](#configuration).
90121

91-
**2. (Optional) Manage Configuration:**
92-
To view or update your configuration in Gemini CLI:
122+
_(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.)_
93123

94-
- Terminal: `gemini extensions config bigquery-data-analytics [setting name] [--scope <scope>]`
95-
- Gemini CLI: `/extensions list`
124+
#### Antigravity CLI
96125

97-
**3. Start the agent:**
126+
**1. Clone the Repo:**
98127

99128
```bash
100-
gemini
129+
git clone --branch 0.2.1 https://github.com/gemini-cli-extensions/bigquery-data-analytics.git
101130
```
102131

103-
_(Tip: Run `/extensions list` to verify your configuration and active extensions.)_
132+
**2. Install the skills:**
104133

105-
> [!WARNING]
106-
> **Changing Instance & Database Connections**
107-
> Currently, the database connection must be configured before starting the agent and can not be changed during a session.
108-
> To save and resume conversation history in Gemini CLI use command: `/chat save <tag>` and `/chat resume <tag>`.
134+
Choose a location for the skills:
135+
- **Global (all workspaces):** `~/.gemini/antigravity-cli/skills/`
136+
- **Workspace-specific:** `<workspace-root>/.agents/skills/`
137+
138+
Copy the skill folders from the cloned repository's `skills/` directory to your chosen location:
139+
140+
```bash
141+
cp -R bigquery-data-analytics/skills/* ~/.gemini/antigravity-cli/skills/
142+
```
143+
144+
**3. Set env vars:**
145+
Set your environment vars as described in the [configuration section](#configuration).
146+
147+
_(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.)_
109148

110149
</details>
111150

@@ -185,35 +224,21 @@ Enter your environment vars as described in the [configuration section](#configu
185224
_(Tip: Run `codex plugin list` or use the `/plugins` interactive menu to verify your installed plugins.)_
186225

187226
</details>
227+
## Installing using [open agent skills tool](https://github.com/vercel-labs/skills)
188228

189-
<details>
190-
<summary id="antigravity">Antigravity</summary>
229+
You can install skills using the `npx skills` command.
191230

192-
**1. Clone the Repo:**
231+
Run the following command in your terminal to automatically download and register the skills:
193232

194233
```bash
195-
git clone --branch 0.2.1 https://github.com/gemini-cli-extensions/bigquery-data-analytics.git
234+
npx skills add https://github.com/gemini-cli-extensions/bigquery-data-analytics/tree/0.2.1
196235
```
197236

198-
**2. Install the skills:**
237+
For detailed info check out the [Skills npm package](https://www.npmjs.com/package/skills).
199238

200-
Choose a location for the skills:
201-
- **Global (all workspaces):** `~/.gemini/antigravity/skills/`
202-
- **Workspace-specific:** `<workspace-root>/.agents/skills/`
203-
204-
Copy the skill folders from the cloned repository's `skills/` directory to your chosen location:
205-
206-
```bash
207-
cp -R bigquery-data-analytics/skills/* ~/.gemini/antigravity/skills/
208-
```
209-
210-
**3. Set env vars:**
239+
**2. Set env vars:**
211240
Set your environment vars as described in the [configuration section](#configuration).
212241

213-
_(Tip: Antigravity automatically discovers skills in these directories at the start of a session.)_
214-
215-
</details>
216-
217242
<!-- {x-release-please-end} -->
218243

219244

0 commit comments

Comments
 (0)