Skip to content

Commit 8e1490e

Browse files
authored
docs: update readme to connect with antigravity (#116)
1 parent fa3d79b commit 8e1490e

2 files changed

Lines changed: 68 additions & 42 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/cloud-sql-sqlserver/compare/
2+
https://www.npmjs.com/package/skills

README.md

Lines changed: 67 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
> [!NOTE]
44
> This extension is currently in beta (pre-v1.0), and may see breaking changes until the first stable release (v1.0).
55
6-
This repository provides a set of agent skills to interact with [Cloud SQL for SQL Server](https://cloud.google.com/sql/docs/sqlserver) instances. These skills can be used with various AI agents, including [Gemini CLI](https://google-gemini.github.io/gemini-cli/), Claude Code, and Codex, to manage your databases, execute queries, explore schemas, and troubleshoot issues using natural language prompts.
6+
This repository provides a set of agent skills to interact with [Cloud SQL for SQL Server](https://cloud.google.com/sql/docs/sqlserver) instances. These skills can be used with various AI agents, including [Antigravity](https://antigravity.google/), [Claude Code](https://claude.com/product/claude-code) and [Codex](https://developers.openai.com/codex), to manage your databases, execute queries, explore schemas, and troubleshoot issues using natural language prompts.
77

88
> [!IMPORTANT]
99
> **We Want Your Feedback!**
@@ -19,10 +19,9 @@ This repository provides a set of agent skills to interact with [Cloud SQL for S
1919
- [Getting Started](#getting-started)
2020
- [Configuration](#configuration)
2121
- [Installation & Usage](#installation--usage)
22-
- [Gemini CLI](#gemini-cli)
22+
- [Antigravity](#antigravity)
2323
- [Claude Code](#claude-code)
2424
- [Codex](#codex)
25-
- [Antigravity](#antigravity)
2625
- [Usage Examples](#usage-examples)
2726
- [Supported Skills](#supported-skills)
2827
- [Additional Agent Skills](#additional-agent-skills)
@@ -40,10 +39,11 @@ This repository provides a set of agent skills to interact with [Cloud SQL for S
4039
Before you begin, ensure you have the following:
4140

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

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

87-
**1. Install the extension:**
113+
Choose a location for the skills:
114+
- **Global (all workspaces):** `~/.gemini/antigravity/skills/`
115+
- **Workspace-specific:** `<workspace-root>/.agents/skills/`
116+
117+
Copy the skill folders from the cloned repository's `skills/` directory to your chosen location:
88118

89119
```bash
90-
gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-sqlserver
120+
cp -R cloud-sql-sqlserver/skills/* ~/.gemini/antigravity/skills/
91121
```
92122

93-
During the installation, enter your environment vars as described in the [configuration section](#configuration).
123+
**3. Set env vars:**
124+
Set your environment vars as described in the [configuration section](#configuration).
94125

95-
**2. (Optional) Manage Configuration:**
96-
To view or update your configuration in Gemini CLI:
126+
_(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.)_
97127

98-
- Terminal: `gemini extensions config cloud-sql-sqlserver [setting name] [--scope <scope>]`
99-
- Gemini CLI: `/extensions list`
128+
#### Antigravity CLI
100129

101-
**3. Start the agent:**
130+
**1. Clone the Repo:**
102131

103132
```bash
104-
gemini
133+
git clone --branch 0.2.0 https://github.com/gemini-cli-extensions/cloud-sql-sqlserver.git
105134
```
106135

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

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

114153
</details>
115154

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

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

193-
<details>
194-
<summary id="antigravity">Antigravity</summary>
233+
You can install skills using the `npx skills` command.
195234

196-
**1. Clone the Repo:**
235+
Run the following command in your terminal to automatically download and register the skills:
197236

198237
```bash
199-
git clone --branch 0.2.0 https://github.com/gemini-cli-extensions/cloud-sql-sqlserver.git
238+
npx skills add https://github.com/gemini-cli-extensions/cloud-sql-sqlserver/tree/0.2.0
200239
```
201240

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

204-
Choose a location for the skills:
205-
- **Global (all workspaces):** `~/.gemini/antigravity/skills/`
206-
- **Workspace-specific:** `<workspace-root>/.agents/skills/`
207-
208-
Copy the skill folders from the cloned repository's `skills/` directory to your chosen location:
209-
210-
```bash
211-
cp -R cloud-sql-sqlserver/skills/* ~/.gemini/antigravity/skills/
212-
```
213-
214-
**3. Set env vars:**
243+
**2. Set env vars:**
215244
Set your environment vars as described in the [configuration section](#configuration).
216245

217-
_(Tip: Antigravity automatically discovers skills in these directories at the start of a session.)_
218-
219-
</details>
220-
221246
<!-- {x-release-please-end} -->
222247

223248
## Usage Examples

0 commit comments

Comments
 (0)