Skip to content

Commit 5b9bc21

Browse files
docs: update readme to connect with antigravity (#173)
Co-authored-by: Averi Kitsch <akitsch@google.com>
1 parent 966f7b8 commit 5b9bc21

2 files changed

Lines changed: 69 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-postgresql/compare/
2+
https://www.npmjs.com/package/skills

README.md

Lines changed: 68 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
> [!NOTE]
44
> 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 PostgreSQL](https://cloud.google.com/sql/docs/postgres) 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 PostgreSQL](https://cloud.google.com/sql/docs/postgres) 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 P
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 P
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:
@@ -83,34 +83,73 @@ For the latest version, check the [releases page][releases].
8383
<!-- {x-release-please-start-version} -->
8484

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

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

90120
```bash
91-
gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-postgresql
121+
cp -R cloud-sql-postgresql/skills/* ~/.gemini/antigravity/skills/
92122
```
93123

94-
During the installation, enter your environment vars as described in the [configuration section](#configuration).
124+
**3. Set env vars:**
125+
Set your environment vars as described in the [configuration section](#configuration).
126+
127+
_(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.)_
128+
129+
#### Antigravity CLI
130+
131+
**1. Clone the Repo:**
132+
133+
```bash
134+
git clone --branch 0.4.0 https://github.com/gemini-cli-extensions/cloud-sql-postgresql.git
135+
```
95136

96-
**2. (Optional) Manage Configuration:**
97-
To view or update your configuration in Gemini CLI:
137+
**2. Install the skills:**
98138

99-
- Terminal: `gemini extensions config cloud-sql-postgresql [setting name] [--scope <scope>]`
100-
- Gemini CLI: `/extensions list`
139+
Choose a location for the skills:
140+
- **Global (all workspaces):** `~/.gemini/antigravity-cli/skills/`
141+
- **Workspace-specific:** `<workspace-root>/.agents/skills/`
101142

102-
**3. Start the agent:**
143+
Copy the skill folders from the cloned repository's `skills/` directory to your chosen location:
103144

104145
```bash
105-
gemini
146+
cp -R cloud-sql-postgresql/skills/* ~/.gemini/antigravity-cli/skills/
106147
```
107148

108-
_(Tip: Run `/extensions list` to verify your configuration and active extensions.)_
149+
**3. Set env vars:**
150+
Set your environment vars as described in the [configuration section](#configuration).
109151

110-
> [!WARNING]
111-
> **Changing Instance & Database Connections**
112-
> Currently, the database connection must be configured before starting the agent and can not be changed during a session.
113-
> To save and resume conversation history in Gemini CLI use command: `/chat save <tag>` and `/chat resume <tag>`.
152+
_(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.)_
114153

115154
</details>
116155

@@ -184,33 +223,20 @@ _(Tip: Run `codex plugin list` or use the `/plugins` interactive menu to verify
184223

185224
</details>
186225

187-
<details>
188-
<summary id="antigravity">Antigravity</summary>
189-
190-
**1. Clone the Repo:**
191-
192-
```bash
193-
git clone --branch 0.4.0 https://github.com/gemini-cli-extensions/cloud-sql-postgresql.git
194-
```
195-
196-
**2. Install the skills:**
226+
## Installing using [open agent skills tool](https://github.com/vercel-labs/skills)
197227

198-
Choose a location for the skills:
199-
- **Global (all workspaces):** `~/.gemini/antigravity/skills/`
200-
- **Workspace-specific:** `<workspace-root>/.agents/skills/`
228+
You can install skills using the `npx skills` command.
201229

202-
Copy the skill folders from the cloned repository's `skills/` directory to your chosen location:
230+
Run the following command in your terminal to automatically download and register the skills:
203231

204232
```bash
205-
cp -R cloud-sql-postgresql/skills/* ~/.gemini/antigravity/skills/
233+
npx skills add https://github.com/gemini-cli-extensions/cloud-sql-postgresql/tree/0.4.0
206234
```
207235

208-
**3. Set env vars:**
209-
Set your environment vars as described in the [configuration section](#configuration).
236+
For detailed info check out the [Skills npm package](https://www.npmjs.com/package/skills).
210237

211-
_(Tip: Antigravity automatically discovers skills in these directories at the start of a session.)_
212-
213-
</details>
238+
**2. Set env vars:**
239+
Set your environment vars as described in the [configuration section](#configuration).
214240

215241
<!-- {x-release-please-end} -->
216242

0 commit comments

Comments
 (0)