diff --git a/.lycheeignore b/.lycheeignore index 4328555..f01b593 100644 --- a/.lycheeignore +++ b/.lycheeignore @@ -1 +1,2 @@ https://github.com/gemini-cli-extensions/oracledb/compare/ +https://www.npmjs.com/package/skills diff --git a/README.md b/README.md index 7ae5feb..79c4624 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@ > [!NOTE] > Currently in beta (pre-v1.0), and may see breaking changes until the first stable release (v1.0). -This repository provides a set of agent skills to interact with [Oracle Database](https://www.oracle.com/database/) 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. +This repository provides a set of agent skills to interact with [Oracle Database](https://www.oracle.com/database/) 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. > [!IMPORTANT] > **We Want Your Feedback!** @@ -19,10 +19,9 @@ This repository provides a set of agent skills to interact with [Oracle Database - [Getting Started](#getting-started) - [Configuration](#configuration) - [Installation & Usage](#installation--usage) - - [Gemini CLI](#gemini-cli) + - [Antigravity](#antigravity) - [Claude Code](#claude-code) - [Codex](#codex) - - [Antigravity](#antigravity) - [Usage Examples](#usage-examples) - [Supported Skills](#supported-skills) - [Additional Agent Skills](#additional-agent-skills) @@ -72,34 +71,73 @@ For the latest version, check the [releases page][releases].
-Gemini CLI +Antigravity + +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. + +
+💡 Tip — Migrating from Gemini CLI?
+If you previously installed this extension with gemini extensions install, you can convert it to an Antigravity plugin instead of reinstalling from scratch: + +See Migrating from Gemini CLI for details on plugins, context files (GEMINI.md / AGENTS.md), and MCP server config differences. +
+ +#### Antigravity 2.0 (IDE) + +**1. Clone the Repo:** + +```bash +git clone --branch 0.2.1 https://github.com/gemini-cli-extensions/oracledb.git +``` + +**2. Install the skills:** -**1. Install the extension:** +Choose a location for the skills: +- **Global (all workspaces):** `~/.gemini/antigravity/skills/` +- **Workspace-specific:** `/.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/oracledb +cp -R oracledb/skills/* ~/.gemini/antigravity/skills/ ``` -During the installation, enter your configuration settings 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 oracledb [setting name] [--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/oracledb.git ``` -_(Tip: Run `/extensions list` to verify your configuration and active extensions.)_ +**2. Install the skills:** -> [!WARNING] -> **Changing Database Connections** -> Currently, the database connection must be configured before starting the agent and cannot be changed during a session. -> To save and resume conversation history in Gemini CLI use command: `/chat save ` and `/chat resume `. +Choose a location for the skills: +- **Global (all workspaces):** `~/.gemini/antigravity-cli/skills/` +- **Workspace-specific:** `/.agents/skills/` + +Copy the skill folders from the cloned repository's `skills/` directory to your chosen location: + +```bash +cp -R oracledb/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.)_
@@ -179,35 +217,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.)_ +## Installing using [open agent skills tool](https://github.com/vercel-labs/skills) -
-Antigravity +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/oracledb.git +npx skills add https://github.com/gemini-cli-extensions/oracledb/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:** `/.agents/skills/` - -Copy the skill folders from the cloned repository's `skills/` directory to your chosen location: - -```bash -cp -R oracledb/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.)_ - -
- ## Usage Examples