Merge branch 'main' into ci-presubmit

Author: averikitsch

.github/workflows/presubmit-tests.yml

@@ -34,6 +34,12 @@ jobs:
           chmod +x toolbox
 
       - name: Install Extension
+<<<<<<< ci-presubmit
         run: npx gemini extensions validate .
         env:
-          GEMINI_API_KEY: "placeholder"
+          GEMINI_API_KEY: "placeholder"
+=======
+        env:
+          GEMINI_API_KEY: "placeholder"
+        run: yes | npx gemini extensions install .
+>>>>>>> main

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.2.4"
+  ".": "0.2.5"
 }

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.2.5](https://github.com/gemini-cli-extensions/spanner/compare/0.2.4...0.2.5) (2026-01-29)
+
+
+### Features
+
+* add dialect and configuration instructions ([#79](https://github.com/gemini-cli-extensions/spanner/issues/79)) ([a1dbc8c](https://github.com/gemini-cli-extensions/spanner/commit/a1dbc8c284fed0d3d1b3a0212f8399f66a46885d))
+
 ## [0.2.4](https://github.com/gemini-cli-extensions/spanner/compare/0.2.3...0.2.4) (2026-01-27)
 
 

README.md

@@ -44,7 +44,26 @@ gemini extensions install https://github.com/gemini-cli-extensions/spanner
 
 ### Configuration
 
-Set the following environment variables before starting the Gemini CLI. These variables can be loaded from a `.env` file.
+You will be prompted to configure the following settings during installation. These settings are saved in an `.env` file within the extension's directory.
+
+*   `SPANNER_PROJECT`: The GCP project ID.
+*   `SPANNER_INSTANCE`: The Spanner instance ID.
+*   `SPANNER_DATABASE`: The Spanner database ID.
+*   `SPANNER_DIALECT`: (Optional) The SQL dialect of the Spanner database: 'googlesql' or 'postgresql'. Defaults to "googlesql".
+
+To view or update your configuration:
+
+**List Settings:**
+*   Terminal: `gemini extensions list`
+*   Gemini CLI: `/extensions list`
+
+**Update Settings:**
+*   Terminal: `gemini extensions config spanner [setting name] [--scope <scope>]`
+    *   `setting name`: (Optional) The single setting to configure.
+    *   `scope`: (Optional) The scope of the setting in (`user` or `workspace`). Defaults to `user`.
+*   Currently, you must restart the Gemini CLI for changes to take effect. We recommend using `gemini --resume` to resume your session.
+
+Alternatively, you can manually set these environment variables before starting the Gemini CLI:
 
 ```bash
 export SPANNER_PROJECT="<your-gcp-project-id>"
@@ -53,7 +72,9 @@ export SPANNER_DATABASE="<your-spanner-database-id>"
 export SPANNER_DIALECT="googlesql" # Optional: "googlesql" or "postgresql". Defaults to "googlesql".
 ```
 
-Ensure [Application Default Credentials](https://cloud.google.com/docs/authentication/gcloud) are available in your environment.
+> [!NOTE]
+> * Ensure [Application Default Credentials](https://cloud.google.com/docs/authentication/gcloud) are available in your environment.
+> * See [Troubleshooting](#troubleshooting) for debugging your configuration.
 
 ### Start Gemini CLI
 

gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "spanner",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "Connect and interact with Spanner data using natural language.",
   "mcpServers": {
     "spanner": {
@@ -20,14 +20,19 @@
       "envVar": "SPANNER_PROJECT"
     },
     {
-      "name": "Instance ID",
+      "name": "Instance",
       "description": "ID of the Spanner instance",
       "envVar": "SPANNER_INSTANCE"
     },
     {
-      "name": "Database ID",
+      "name": "Database",
       "description": "ID of the Spanner database",
       "envVar": "SPANNER_DATABASE"
+    },
+    {
+      "name": "Database Dialect",
+      "description": "(Optional) The SQL dialect of the Spanner Database: 'googlesql' or 'postgresql'. (Default: 'googlesql')",
+      "envVar": "SPANNER_DIALECT"
     }
   ]
 }