Merge branch 'main' into ci-presubmit

Author: averikitsch

.github/workflows/header-check.yml

@@ -24,7 +24,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: 'Checkout Repository'
-        uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
 
       - name: Check License Header
         uses: apache/skywalking-eyes/header@61275cc80d0798a405cb070f7d3a8aaf7cf2c2c1 # v0.8.0

.github/workflows/json-lint.yml

@@ -23,7 +23,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Check out code
-        uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
 
       - name: Run JSON Lint
         run: jq . gemini-extension.json

.github/workflows/markdown-checks.yml

@@ -24,7 +24,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Check out code
-        uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
 
       - name: Link Checker
         uses: lycheeverse/lychee-action@a8c4c7cb88f0c7386610c35eb25108e448569cb0 # v2.7.0

.github/workflows/package-and-upload-assets.yml

@@ -39,7 +39,7 @@ jobs:
 
     steps:
       - name: Checkout code at the new tag
-        uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
         with:
           ref: ${{ github.event.release.tag_name }}
 
@@ -102,7 +102,7 @@ jobs:
           echo "ARCHIVE_PATH=${ARCHIVE_NAME}" >> $GITHUB_OUTPUT
 
       - name: Upload archive as workflow artifact
-        uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
+        uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6
         with:
           name: ${{ steps.vars.outputs.archive_name }}
           path: ${{ steps.create_archive.outputs.ARCHIVE_PATH }}
@@ -116,10 +116,10 @@ jobs:
       contents: write
     steps:
       - name: Checkout code
-        uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
 
       - name: Download all archives from workflow artifacts
-        uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6
+        uses: actions/download-artifact@37930b1c2abaa49bbe596cd826c3c89aef350131 # v7
         with:
           path: release-archives
 

.github/workflows/presubmit-tests.yml

@@ -22,7 +22,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Check out code
-        uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
 
       - name: Install Gemini CLI
         run: npm install @google/gemini-cli
@@ -36,4 +36,4 @@ jobs:
       - name: Install Extension
         run: npx gemini extensions validate .
         env:
-          GEMINI_API_KEY: "placeholder"
+          GEMINI_API_KEY: "placeholder"

.github/workflows/sync-labels.yaml

@@ -29,7 +29,7 @@ jobs:
       issues: 'write'
       pull-requests: 'write'
     steps:
-      - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5.0.1
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
       - uses: micnncim/action-label-syncer@3abd5ab72fda571e69fffd97bd4e0033dd5f495c # v1.3.0
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.1.7"
+  ".": "0.1.8"
 }

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.1.8](https://github.com/gemini-cli-extensions/cloud-sql-mysql/compare/0.1.7...0.1.8) (2026-01-30)
+
+
+### Features
+
+* add Configuration settings ([#83](https://github.com/gemini-cli-extensions/cloud-sql-mysql/issues/83)) ([36d4433](https://github.com/gemini-cli-extensions/cloud-sql-mysql/commit/36d443385c94d188f16d33e36a156cb7a0215b23))
+* **deps:** update dependency googleapis/genai-toolbox to v0.26.0 ([#84](https://github.com/gemini-cli-extensions/cloud-sql-mysql/issues/84)) ([306aaa9](https://github.com/gemini-cli-extensions/cloud-sql-mysql/commit/306aaa9c39c0834528efd3728ee6f3056ef6ea5d))
+
 ## [0.1.7](https://github.com/gemini-cli-extensions/cloud-sql-mysql/compare/0.1.6...0.1.7) (2026-01-09)
 
 

README.md

@@ -45,8 +45,32 @@ gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-mys
 
 ### Configuration
 
-Set the following environment variables before starting the Gemini CLI. These variables can be loaded from a `.env` file.
-This configuration is not required if utilizing the [Admin toolset](#supported-tools).
+You will be prompted to configure the following settings during installation. These settings are saved in an `.env` file within the extension's directory.
+
+*   `CLOUD_SQL_MYSQL_PROJECT`: The GCP project ID.
+*   `CLOUD_SQL_MYSQL_REGION`: The region of your Cloud SQL instance.
+*   `CLOUD_SQL_MYSQL_INSTANCE`: The name of your Cloud SQL instance.
+*   `CLOUD_SQL_MYSQL_DATABASE`: The name of the database to connect to.
+*   `CLOUD_SQL_MYSQL_USER`: (Optional) The database username. Defaults to the active IAM user.
+*   `CLOUD_SQL_MYSQL_PASSWORD`: (Optional) The password for the database user. Required if using CLOUD_SQL_MYSQL_USER. Defaults to the active IAM user.
+*   `CLOUD_SQL_MYSQL_IP_TYPE`: (Optional) Type of the IP address: `PUBLIC`, `PRIVATE`, or `PSC`. Defaults to `PUBLIC`.
+
+> [!NOTE]
+> This configuration is primarily for the Data Plane tools (querying). The Admin toolset does not strictly require these to be pre-set if you provide them in your prompts, but it is recommended for a smoother experience.
+
+To view or update your configuration:
+
+**List Settings:**
+*   Terminal: `gemini extensions list`
+*   Gemini CLI: `/extensions list`
+
+**Update Settings:**
+*   Terminal: `gemini extensions config cloud-sql-mysql [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 CLOUD_SQL_MYSQL_PROJECT="<your-gcp-project-id>"
@@ -58,10 +82,10 @@ export CLOUD_SQL_MYSQL_PASSWORD="<your-database-password>"  # Optional, defaults
 export CLOUD_SQL_MYSQL_IP_TYPE="PUBLIC" # Optional: `PUBLIC`, `PRIVATE`, `PSC`. Defaults to `PUBLIC`.
 ```
 
-Ensure [Application Default Credentials](https://cloud.google.com/docs/authentication/gcloud) are available in your environment.
-
 > [!NOTE]
-> If your Cloud SQL for MySQL instance uses private IPs, you must run Gemini CLI in the same Virtual Private Cloud (VPC) network.
+> * Ensure [Application Default Credentials](https://cloud.google.com/docs/authentication/gcloud) are available in your environment.
+> * If your Cloud SQL for MySQL instance uses private IPs, you must run Gemini CLI in the same Virtual Private Cloud (VPC) network.
+> * See [Troubleshooting](#troubleshooting) for debugging your configuration.
 
 ### Start Gemini CLI
 
@@ -93,12 +117,17 @@ Interact with MySQL using natural language:
 ## Supported Tools
 
 * **Admin:**
+    * `clone_instance`: Use this tool to creates a clone for an existing Cloud SQL for MySQL instance.
+    * `create_backup`: Use this tool to creates a backup on a Cloud SQL instance.
+    * `create_database`: Use this tool to creates a new database in a Cloud SQL instance.
    	* `create_instance`: Use this tool to create an Postgres instance.
    	* `create_user`: Use this tool to create Postgres-BUILT-IN or IAM-based users.
    	* `get_instance`: Use this tool to get details about an Postgres instance.
    	* `get_user`: Use this tool to get details about a user.
+    * `list_databases`: Use this tool to lists all databases for a Cloud SQL instance.
    	* `list_instances`: Use this tool to list instances in a given project and location.
    	* `list_users`: Use this tool to list users in a given project and location.
+    * `restore_backup`: Use this tool to restores a backup of a Cloud SQL instance.
     * `wait_for_operation`: Use this tool to poll the operations API until the operation is done.
 
 * **Data:**

gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "cloud-sql-mysql",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Connect and interact with a Cloud SQL for MySQL database and data",
   "mcpServers": {
     "cloud_sql_mysql_admin": {