Skip to content

docs: update developer instructions #154

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
twishabansal merged 3 commits into from
Apr 13, 2026
Merged

docs: update developer instructions #154

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
93aa726
Update developer instructions in DEVELOPER.md
twishabansal Apr 13, 2026
c99bed6
Update DEVELOPER.md
twishabansal Apr 13, 2026
f1dc65e
Update DEVELOPER.md
twishabansal Apr 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 5 additions & 20 deletions DEVELOPER.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,37 +17,22 @@ Before you begin, ensure you have the following:

### Running from Local Source

The core logic for this extension is handled by a pre-built `toolbox` binary. The development process involves installing the extension locally into the Gemini CLI to test changes.

1. **Clone the Repository:**

```bash
git clone https://github.com/gemini-cli-extensions/cloud-sql-postgresql.git
cd cloud-sql-postgresql
```

2. **Download the Toolbox Binary:** The required version of the `toolbox` binary
is specified in `toolbox_version.txt`. Download it for your platform.

```bash
# Read the required version
VERSION=$(cat toolbox_version.txt)

# Example for macOS/amd64
curl -L -o toolbox https://storage.googleapis.com/mcp-toolbox-for-databases/geminicli/v$VERSION/darwin/amd64/toolbox
chmod +x toolbox
```
Adjust the URL for your operating system (`linux/amd64`, `darwin/arm64`, `windows/amd64`).

3. **Install the Extension Locally:** Use the Gemini CLI to install the
2. **Install the Extension Locally:** Use the Gemini CLI to install the
extension from your local directory.

```bash
gemini extensions install .
```
The CLI will prompt you to confirm the installation. Accept it to proceed.

4. **Testing Changes:** After installation, start the Gemini CLI (`gemini`).
3. **Testing Changes:** After installation, start the Gemini CLI (`gemini`).
You can now interact with the `cloud-sql-postgresql` tools to manually test your changes
against your connected database.

Expand All @@ -59,9 +44,9 @@ A GitHub Actions workflow (`.github/workflows/presubmit-tests.yml`) is triggered
for every pull request. This workflow primarily verifies that the extension can
be successfully installed by the Gemini CLI.

Currently, there are no automated unit or integration test suites
within this repository. All functional testing must be performed manually. All tools
are currently tested in the [MCP Toolbox GitHub](https://github.com/googleapis/mcp-toolbox).
All tools are currently tested in the [MCP Toolbox GitHub](https://github.com/googleapis/mcp-toolbox).

The skills themselves are validated using the `skills-validate.yml` workflow.

### Other GitHub Checks

Expand Down
Loading