From a07558e715e4e411e1b5fa79f5f050a03af52dd2 Mon Sep 17 00:00:00 2001 From: Averi Kitsch Date: Tue, 23 Sep 2025 14:41:15 -0700 Subject: [PATCH 1/3] chore: update readme install cmd --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 63bfaff..576a39b 100644 --- a/README.md +++ b/README.md @@ -17,7 +17,7 @@ Learn more about [Gemini CLI Extensions](https://github.com/google-gemini/gemini Before you begin, ensure you have the following: -* [Gemini CLI](https://github.com/google-gemini/gemini-cli) installed with version +v0.6.0. +* [Gemini CLI](https://github.com/google-gemini/gemini-cli) installed with version **+v0.6.0**. * A running SQL Server instance. * A user with database-level permissions to execute queries. @@ -26,7 +26,7 @@ Before you begin, ensure you have the following: To install the extension, use the command: ```bash -gemini extensions install github.com/gemini-cli-extensions/sql-server +gemini extensions install https://github.com/gemini-cli-extensions/sql-server ``` ## Configuration From dd6e43e84ddfc196391025aeb8fba02a71166733 Mon Sep 17 00:00:00 2001 From: Averi Kitsch Date: Fri, 26 Sep 2025 14:44:49 -0700 Subject: [PATCH 2/3] docs: update readme getting started instructions --- README.md | 27 +++++++++++++++++++++++---- 1 file changed, 23 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 576a39b..1dcd79d 100644 --- a/README.md +++ b/README.md @@ -21,7 +21,9 @@ Before you begin, ensure you have the following: * A running SQL Server instance. * A user with database-level permissions to execute queries. -## Installation +## Getting Started + +### Installation To install the extension, use the command: @@ -29,7 +31,7 @@ To install the extension, use the command: gemini extensions install https://github.com/gemini-cli-extensions/sql-server ``` -## Configuration +### Configuration Set the following environment variables before starting the Gemini CLI: @@ -39,6 +41,19 @@ Set the following environment variables before starting the Gemini CLI: * `MSSQL_USER`: The username for authentication. * `MSSQL_PASSWORD`: The password for authentication. +### Start Gemini CLI + +To start the Gemini CLI, use the following command: + +```bash +gemini +``` + +> [!WARNING] +> **Changing Instance & Database Connections** +> Currently, the database connection must be configured before starting the Gemini CLI and can not be changed during a session. +> To save and resume conversation history use command: `/chat save ` and `/chat resume `. + ## Usage Examples Interact with SQl Server using natural language right from your IDE: @@ -57,8 +72,12 @@ Interact with SQl Server using natural language right from your IDE: ## Additional Extensions -Find additional extensions to support your entire software development lifecycle at [github.com/gemini-cli-extensions](https://github.com/gemini-cli-extensions). +Find additional extensions to support your entire software development lifecycle at [github.com/gemini-cli-extensions](https://github.com/gemini-cli-extensions), including: +* [Cloud SQL for SQL Server extension](https://github.com/gemini-cli-extensions/cloud-sql-sqlserver) +* and more! ## Troubleshooting -* "cannot execute binary file": Ensure the correct binary for your OS/Architecture has been downloaded. See [Installing the server](https://googleapis.github.io/genai-toolbox/getting-started/introduction/#installing-the-server) for more information. +* "✖ Error during discovery for server: MCP error -32000: Connection closed": The database connection has not been established. Ensure your configuration is set via environment variables. +* "✖ MCP ERROR: Error: spawn /Users//.gemini/extensions/cloud-sql-sqlserver/toolbox ENOENT": The Toolbox binary did not download correctly. Ensure you are using Gemini CLI v0.6.0+. +* "cannot execute binary file": The Toolbox binary did not download correctly. Ensure the correct binary for your OS/Architecture has been downloaded. See [Installing the server](https://googleapis.github.io/genai-toolbox/getting-started/introduction/#installing-the-server) for more information. \ No newline at end of file From e9bf9fcbea5b9d95f056835029de579fc9499f15 Mon Sep 17 00:00:00 2001 From: Averi Kitsch Date: Tue, 30 Sep 2025 10:25:51 -0700 Subject: [PATCH 3/3] Update README.md Co-authored-by: Yuan Teoh <45984206+Yuan325@users.noreply.github.com> --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 1dcd79d..b6174b3 100644 --- a/README.md +++ b/README.md @@ -79,5 +79,5 @@ Find additional extensions to support your entire software development lifecycle ## Troubleshooting * "✖ Error during discovery for server: MCP error -32000: Connection closed": The database connection has not been established. Ensure your configuration is set via environment variables. -* "✖ MCP ERROR: Error: spawn /Users//.gemini/extensions/cloud-sql-sqlserver/toolbox ENOENT": The Toolbox binary did not download correctly. Ensure you are using Gemini CLI v0.6.0+. +* "✖ MCP ERROR: Error: spawn /Users//.gemini/extensions/sql-server/toolbox ENOENT": The Toolbox binary did not download correctly. Ensure you are using Gemini CLI v0.6.0+. * "cannot execute binary file": The Toolbox binary did not download correctly. Ensure the correct binary for your OS/Architecture has been downloaded. See [Installing the server](https://googleapis.github.io/genai-toolbox/getting-started/introduction/#installing-the-server) for more information. \ No newline at end of file