diff --git a/.agents/plugins/marketplace.json b/.agents/plugins/marketplace.json
index 86234a7..6cd2fd0 100644
--- a/.agents/plugins/marketplace.json
+++ b/.agents/plugins/marketplace.json
@@ -1,11 +1,11 @@
{
- "name": "data-cloud-ai-dev-kit-marketplace",
+ "name": "data-agent-kit-starter-pack-marketplace",
"interface": {
- "displayName": "data-cloud-ai-dev-kit Marketplace"
+ "displayName": "Data Agent Kit Starter Pack Marketplace"
},
"plugins": [
{
- "name": "data-cloud-ai-dev-kit",
+ "name": "data-agent-kit-starter-pack",
"source": {
"source": "local",
"path": "./"
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index 46216c1..fead7a4 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -1,11 +1,11 @@
{
- "name": "data-cloud-ai-dev-kit-marketplace",
+ "name": "data-agent-kit-starter-pack-marketplace",
"owner": {
"name": "Google LLC"
},
"plugins": [
{
- "name": "data-cloud-ai-dev-kit",
+ "name": "data-agent-kit-starter-pack",
"source": "./",
"description": "This plugin provides a specialized suite of skills for data engineers and database practitioners working on Google Cloud. It acts as an expert assistant, allowing you to use natural language prompts in your preferred coding agent to architect complex data pipelines, transform data with dbt, write Spark and BigQuery SQL notebooks, and orchestrate end-to-end workflows across GCP's data ecosystem."
}
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index 2ee7169..d09bf8b 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,5 +1,5 @@
{
- "name": "data-cloud-ai-dev-kit",
+ "name": "data-agent-kit-starter-pack",
"version": "0.1.8",
"description": "This plugin provides a specialized suite of skills for data engineers and database practitioners working on Google Cloud. It acts as an expert assistant, allowing you to use natural language prompts in your preferred coding agent to architect complex data pipelines, transform data with dbt, write Spark and BigQuery SQL notebooks, and orchestrate end-to-end workflows across GCP's data ecosystem.",
"mcp": "./.mcp.json"
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
index 1100bfa..c6603ce 100644
--- a/.codex-plugin/plugin.json
+++ b/.codex-plugin/plugin.json
@@ -1,11 +1,11 @@
{
- "name": "data-cloud-ai-dev-kit",
+ "name": "data-agent-kit-starter-pack",
"version": "0.1.8",
"description": "This plugin provides a specialized suite of skills for data engineers and database practitioners working on Google Cloud. It acts as an expert assistant, allowing you to use natural language prompts in your preferred coding agent to architect complex data pipelines, transform data with dbt, write Spark and BigQuery SQL notebooks, and orchestrate end-to-end workflows across GCP's data ecosystem.",
"skills": "./skills/",
"interface": {
- "displayName": "Data Cloud AI Dev Kit",
- "shortDescription": "Data Cloud AI Dev Kit",
+ "displayName": "Data Agent Kit Starter Pack",
+ "shortDescription": "Data Agent Kit Starter Pack",
"category": "Productivity"
},
"mcp": "./.mcp.json"
diff --git a/.lycheeignore b/.lycheeignore
index b9824b5..62a2a50 100644
--- a/.lycheeignore
+++ b/.lycheeignore
@@ -1,4 +1,5 @@
https://github.com/gemini-cli-extensions/data-cloud-ai-dev-kit/compare/
https://github.com/gemini-cli-extensions/data-cloud-ai-dev-kit
https://raw.githubusercontent.com/gemini-cli-extensions/data-cloud-ai-dev-kit/main/codex-install.sh
+https://docs.cloud.google.com/data-cloud-extension/vs-code/install
data-cloud-ai-dev-kit@data-cloud-ai-dev-kit-marketplace
\ No newline at end of file
diff --git a/.mcp.json b/.mcp.json
index d91a24b..8d37195 100644
--- a/.mcp.json
+++ b/.mcp.json
@@ -4,7 +4,7 @@
"command": "npx",
"args": [
"-y",
- "git+https://github.com/gemini-cli-extensions/data-cloud-ai-dev-kit.git"
+ "git+https://github.com/gemini-cli-extensions/data-agent-kit-starter-pack.git"
],
"env": {},
"env_vars": [
@@ -20,7 +20,7 @@
"bigquery",
"--stdio",
"--user-agent-metadata",
- "google-cloud-data-agent-kit-claude-and-codex"
+ "datacloud.claude-and-codex"
],
"env": {
"BIGQUERY_LOCATION": "",
@@ -36,7 +36,7 @@
"spanner",
"--stdio",
"--user-agent-metadata",
- "google-cloud-data-agent-kit-claude-and-codex"
+ "datacloud.claude-and-codex"
],
"env": {
"SPANNER_DATABASE": "",
@@ -54,7 +54,7 @@
"alloydb-postgres-admin",
"--stdio",
"--user-agent-metadata",
- "google-cloud-data-agent-kit-claude-and-codex"
+ "datacloud.claude-and-codex"
],
"env": {}
},
@@ -67,7 +67,7 @@
"alloydb-postgres",
"--stdio",
"--user-agent-metadata",
- "google-cloud-data-agent-kit-claude-and-codex"
+ "datacloud.claude-and-codex"
],
"env": {
"ALLOYDB_POSTGRES_CLUSTER": "",
@@ -89,7 +89,7 @@
"cloud-sql-postgres-admin",
"--stdio",
"--user-agent-metadata",
- "google-cloud-data-agent-kit-claude-and-codex"
+ "datacloud.claude-and-codex"
],
"env": {}
},
@@ -102,7 +102,7 @@
"cloud-sql-postgres",
"--stdio",
"--user-agent-metadata",
- "google-cloud-data-agent-kit-claude-and-codex"
+ "datacloud.claude-and-codex"
],
"env": {
"CLOUD_SQL_POSTGRES_DATABASE": "",
@@ -123,7 +123,7 @@
"dataplex",
"--stdio",
"--user-agent-metadata",
- "google-cloud-data-agent-kit-claude-and-codex"
+ "datacloud.claude-and-codex"
],
"env": {
"DATAPLEX_PROJECT": ""
@@ -138,7 +138,7 @@
"dataproc",
"--stdio",
"--user-agent-metadata",
- "google-cloud-data-agent-kit-claude-and-codex"
+ "datacloud.claude-and-codex"
],
"env": {
"DATAPROC_PROJECT": "",
@@ -154,7 +154,7 @@
"serverless-spark",
"--stdio",
"--user-agent-metadata",
- "google-cloud-data-agent-kit-claude-and-codex"
+ "datacloud.claude-and-codex"
],
"env": {
"SERVERLESS_SPARK_PROJECT": "",
diff --git a/DEVELOPER.md b/DEVELOPER.md
index 0435b5b..a19c1a6 100644
--- a/DEVELOPER.md
+++ b/DEVELOPER.md
@@ -1,7 +1,7 @@
# DEVELOPER.md
This document provides instructions for setting up your development environment
-and contributing to the Cloud SQL for PostgreSQL Gemini CLI Extension project.
+and contributing to the Data Agent Kit Starter Pack project.
## Prerequisites
@@ -22,8 +22,8 @@ The core logic for this extension is handled by a pre-built `toolbox` binary. Th
1. **Clone the Repository:**
```bash
- git clone https://github.com/gemini-cli-extensions/data-cloud-ai-dev-kit.git
- cd data-cloud-ai-dev-kit
+ git clone https://github.com/gemini-cli-extensions/data-agent-kit-starter-pack.git
+ cd data-agent-kit-starter-pack
```
2. **Download the Toolbox Binary:** The required version of the `toolbox` binary
@@ -48,7 +48,7 @@ The core logic for this extension is handled by a pre-built `toolbox` binary. Th
The CLI will prompt you to confirm the installation. Accept it to proceed.
4. **Testing Changes:** After installation, start the Gemini CLI (`gemini`).
- You can now interact with the `data-cloud-ai-dev-kit` tools to manually test your changes
+ You can now interact with the `data-agent-kit-starter-pack` tools to manually test your changes
against your connected database.
### Adding or Updating Skills
diff --git a/README.md b/README.md
index 81fbf7d..d0853e7 100644
--- a/README.md
+++ b/README.md
@@ -1,49 +1,115 @@
-# Data Cloud AI Dev Kit
+# Data Agent Kit Starter Pack
> [!NOTE]
> This extension is currently in beta (pre-v1.0), and may see breaking changes until the first stable release (v1.0).
-This plugin provides a specialized suite of skills and MCP tools for data engineers and database practitioners working on Google Cloud. It acts as an expert assistant, allowing you to use natural language prompts in your preferred coding agent to architect complex data pipelines, transform data with dbt, write Spark and BigQuery SQL notebooks, and orchestrate end-to-end workflows across GCP's data ecosystem (BigQuery, Spanner, BigLake, Dataproc, etc.).
+This plugin provides a specialized suite of skills and MCP tools for data engineers and database practitioners working on Google Cloud. It acts as an expert assistant, allowing you to use natural language prompts in your preferred coding agent to architect complex data pipelines, transform data with dbt, write Spark and BigQuery SQL notebooks, and orchestrate end-to-end workflows across the Google Cloud data ecosystem (BigQuery, Spanner, BigLake, Dataproc, etc.).
> [!IMPORTANT]
> **We Want Your Feedback!**
> Please share your thoughts with us by opening an issue on GitHub. Your input is invaluable and helps us improve the project for everyone.
-## Why Use the Data Cloud AI Dev Kit?
+## Why Use the Data Agent Kit Starter Pack?
-* **Seamless Workflow:** Brings Google Cloud data engineering expertise directly into your terminal or IDE via Gemini CLI, Claude Code, or Codex.
-* **End-to-End Data Pipelines:** Effortlessly generate code that reads raw data from GCS, processes it with Spark or BigQuery, transforms it through medallion architectures (bronze, silver, gold) using dbt, and exports it to serving layers like Cloud Spanner.
-* **Ecosystem Integration:** Work across boundaries—generate BigLake Iceberg catalog tables, train BigQuery ML models (XGBoost, KMEANS), and create interactive Streamlit dashboards or LookML models all from natural language.
+* **Seamless Workflow:** Bring Google Cloud data engineering expertise directly into your terminal or IDE via Gemini CLI, Claude Code, or Codex.
+* **End-to-End Data Pipelines:** Effortlessly generate code that reads raw data from Cloud Storage, processes it with Spark or BigQuery, transform it through medallion architectures (bronze, silver, gold) using dbt, and export it to serving layers like Spanner.
+* **Ecosystem Integration:** Work across boundaries—generate BigLake Iceberg catalog tables, train BigQuery ML models (XGBoost, KMEANS), and create interactive Streamlit dashboards or LookML models, all from natural language.
* **Workflow Orchestration:** Automatically create and schedule orchestration pipelines that tie your notebooks and dbt models together into robust, scheduled jobs.
## Prerequisites
-Ensure you have one of the following coding agents installed:
-* [Gemini CLI](https://github.com/google-gemini/gemini-cli) (v0.6.0+)
-* [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview)
-* Codex CLI
+Ensure you have the following installed:
+* **Node.js and npm** (Latest version recommended)
+* One of the following coding agents:
+ * [Gemini CLI](https://github.com/google-gemini/gemini-cli) (v0.6.0+)
+ * [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview)
+ * Codex CLI
+* **(Optional) IDE Extension:** [Google Cloud Data Agent Kit](https://docs.cloud.google.com/data-cloud-extension/vs-code/install).
## Getting Started
### Installation
-Choose the installation method for your preferred coding agent.
+Choose the installation method for your preferred coding agent. Run the commands in terminal
-#### Gemini CLI
+
+Gemini CLI and Gemini Code Assist
+
+```bash
+gemini extensions install https://github.com/gemini-cli-extensions/data-agent-kit-starter-pack
+```
+
+
+
+Claude Code
+
+Run the `claude` command to start the agent, then run:
+
+```bash
+/plugin marketplace add https://github.com/gemini-cli-extensions/data-agent-kit-starter-pack
+/plugin install data-agent-kit-starter-pack@data-agent-kit-starter-pack-marketplace
+```
+
+
+
+Codex
+
+Run the following commands in your terminal:
+
+**macOS / Linux:**
```bash
-gemini extensions install https://github.com/gemini-cli-extensions/data-cloud-ai-dev-kit
+curl -sSL https://raw.githubusercontent.com/gemini-cli-extensions/data-agent-kit-starter-pack/main/codex-install.sh | bash
```
-#### Claude Code
+**Windows:**
+```powershell
+irm https://raw.githubusercontent.com/gemini-cli-extensions/data-agent-kit-starter-pack/main/codex-install.ps1 | iex
+```
+
+After running the installation script, run the `codex` command to start the agent, then run:
+
```bash
-/plugin marketplace add https://github.com/gemini-cli-extensions/data-cloud-ai-dev-kit
-/plugin install data-cloud-ai-dev-kit@data-cloud-ai-dev-kit-marketplace
+/plugins
```
-#### Codex (One-Liner)
+Use the interactive options to install the extension with the name `Data Agent Kit Starter Pack`.
+
+
+### Configuration
+
+MCP toolboxes are added to the respective agent configuration files. You must configure the MCP toolboxes in your agent's configuration files for them to start successfully.
+
+In all cases, you must restart the agent after updating the configuration files.
+
+
+Gemini CLI and Gemini Code Assist
+
+Edit the configuration file:
+`~/.gemini/extensions/data-agent-kit-starter-pack/gemini-extension.json`
+
+
+
+Claude Code
+
+1. Edit the configuration file:
+`~/.claude/plugins/cache/data-agent-kit-starter-pack-marketplace/data-agent-kit-starter-pack//.mcp.json`
+
+2. Reinstall the plugin:
+Run `/plugin` and use interactive options to uninstall `data-agent-kit-starter-pack`. Then run `/plugin install` to add it back.
+
+
+
+Codex
+
+1. Edit the configuration file:
+`~/.agents/plugins/data-agent-kit-starter-pack/.mcp.json`
+
+2. Use interactive options to uninstall and install the extension:
```bash
-curl -sSL https://raw.githubusercontent.com/gemini-cli-extensions/data-cloud-ai-dev-kit/main/codex-install.sh | bash
+/plugins
```
+Install with name: `Data Agent Kit Starter Pack`
+
## Usage Examples
@@ -67,14 +133,15 @@ Interact with your coding agent using natural language prompts to perform comple
* **Plugin Not Found:** Ensure you have restarted your agent (e.g., Gemini CLI or Codex) after installation.
* **Authentication Errors:** Many GCP skills require an active authenticated session. Ensure you have run `gcloud auth login` and `gcloud auth application-default login` on your machine.
+* **MCP Connection Issues:** Update the MCP server configurations such as project, region etc. needed by MCP toolboxes in order to connect successfully to them.
## Security Reminder: Agent Environment Hardening
-Your agent has the power to
-execute tools and commands on your behalf. Protect your GCP resources by
-enforcing **Strict Least Privilege** across all CLIs, MCP servers and other
-resources available to your agents. For example, use scoped Service Accounts
-(read more
-[here](https://docs.cloud.google.com/docs/authentication/use-service-account-impersonation))
-for tasks accessing your cloud resources and conducting regular permission and
-agent settings audits to minimize your attack surface.
+Your agent has the power to execute tools and commands on your behalf. Protect your GCP resources by enforcing **Strict Least Privilege** across all CLIs, MCP servers and other resources available to your agents.
+
+* Use [service accounts](https://docs.cloud.google.com/docs/authentication/use-service-account-impersonation) for accessing your cloud resources.
+* Assign the service account a role with [limited permissions](https://docs.cloud.google.com/iam/docs/roles-overview).
+* Prevent unwanted cross-org agent access by utilizing **Principal Access Boundaries** to scope your agent to [projects](https://docs.cloud.google.com/iam/docs/principal-access-boundary-policies#use-case-one-project) you intend the agent to access.
+
+> [!NOTE]
+> The Principal Access Boundary condition should bind the policy to the service accounts you intend to restrict.
diff --git a/codex-install.ps1 b/codex-install.ps1
index 160d03f..990fe55 100644
--- a/codex-install.ps1
+++ b/codex-install.ps1
@@ -14,8 +14,8 @@
$ErrorActionPreference = "Stop"
-$pluginName = "data-cloud-ai-dev-kit"
-$repoUrl = "https://github.com/gemini-cli-extensions/data-cloud-ai-dev-kit"
+$pluginName = "data-agent-kit-starter-pack"
+$repoUrl = "https://github.com/gemini-cli-extensions/data-agent-kit-starter-pack"
$pluginsRoot = Join-Path $HOME ".agents\plugins"
$installDir = Join-Path $pluginsRoot $pluginName
$marketplaceFile = Join-Path $pluginsRoot "marketplace.json"
@@ -85,7 +85,7 @@ $pluginJson = @"
{
"name": "$pluginName",
"interface": {
- "displayName": "Google Data Cloud AI Dev Kit"
+ "displayName": "Data Agent Kit Starter Pack"
},
"source": {
"source": "local",
diff --git a/codex-install.sh b/codex-install.sh
index 7a25e39..761a036 100755
--- a/codex-install.sh
+++ b/codex-install.sh
@@ -15,8 +15,8 @@
set -e
-PLUGIN_NAME="data-cloud-ai-dev-kit"
-REPO_URL="https://github.com/gemini-cli-extensions/data-cloud-ai-dev-kit"
+PLUGIN_NAME="data-agent-kit-starter-pack"
+REPO_URL="https://github.com/gemini-cli-extensions/data-agent-kit-starter-pack"
INSTALL_DIR="$HOME/.agents/plugins/$PLUGIN_NAME"
MARKETPLACE_FILE="$HOME/.agents/plugins/marketplace.json"
@@ -53,7 +53,7 @@ data.plugins = data.plugins || [];
data.plugins = data.plugins.filter(p => p.name !== '${PLUGIN_NAME}');
data.plugins.push({
name: '${PLUGIN_NAME}',
- interface: { displayName: 'Google Data Cloud AI Dev Kit' },
+ interface: { displayName: 'Data Agent Kit Starter Pack' },
source: { source: 'local', path: './.agents/plugins/${PLUGIN_NAME}' },
policy: { installation: 'AVAILABLE', authentication: 'ON_INSTALL' },
category: 'Productivity'
diff --git a/gemini-extension.json b/gemini-extension.json
index b8fc4b9..8d50c0c 100644
--- a/gemini-extension.json
+++ b/gemini-extension.json
@@ -1,5 +1,5 @@
{
- "name": "data-cloud-ai-dev-kit",
+ "name": "data-agent-kit-starter-pack",
"version": "0.1.8",
"description": "This plugin provides a specialized suite of skills for data engineers and database practitioners working on Google Cloud. It acts as an expert assistant, allowing you to use natural language prompts in your preferred coding agent to architect complex data pipelines, transform data with dbt, write Spark and BigQuery SQL notebooks, and orchestrate end-to-end workflows across GCP's data ecosystem.",
"mcpServers": {
@@ -7,7 +7,7 @@
"command": "npx",
"args": [
"-y",
- "git+https://github.com/gemini-cli-extensions/data-cloud-ai-dev-kit.git"
+ "git+https://github.com/gemini-cli-extensions/data-agent-kit-starter-pack.git"
],
"env": {}
},
@@ -20,7 +20,7 @@
"bigquery",
"--stdio",
"--user-agent-metadata",
- "google-cloud-data-agent-kit-gemini-cli"
+ "datacloud.gemini-cli"
],
"env": {
"BIGQUERY_LOCATION": "",
@@ -36,7 +36,7 @@
"spanner",
"--stdio",
"--user-agent-metadata",
- "google-cloud-data-agent-kit-gemini-cli"
+ "datacloud.gemini-cli"
],
"env": {
"SPANNER_DATABASE": "",
@@ -54,7 +54,7 @@
"alloydb-postgres-admin",
"--stdio",
"--user-agent-metadata",
- "google-cloud-data-agent-kit-gemini-cli"
+ "datacloud.gemini-cli"
],
"env": {}
},
@@ -67,7 +67,7 @@
"alloydb-postgres",
"--stdio",
"--user-agent-metadata",
- "google-cloud-data-agent-kit-gemini-cli"
+ "datacloud.gemini-cli"
],
"env": {
"ALLOYDB_POSTGRES_CLUSTER": "",
@@ -89,7 +89,7 @@
"cloud-sql-postgres-admin",
"--stdio",
"--user-agent-metadata",
- "google-cloud-data-agent-kit-gemini-cli"
+ "datacloud.gemini-cli"
],
"env": {}
},
@@ -102,7 +102,7 @@
"cloud-sql-postgres",
"--stdio",
"--user-agent-metadata",
- "google-cloud-data-agent-kit-gemini-cli"
+ "datacloud.gemini-cli"
],
"env": {
"CLOUD_SQL_POSTGRES_DATABASE": "",
@@ -123,7 +123,7 @@
"dataplex",
"--stdio",
"--user-agent-metadata",
- "google-cloud-data-agent-kit-gemini-cli"
+ "datacloud.gemini-cli"
],
"env": {
"DATAPLEX_PROJECT": ""
@@ -138,7 +138,7 @@
"dataproc",
"--stdio",
"--user-agent-metadata",
- "google-cloud-data-agent-kit-gemini-cli"
+ "datacloud.gemini-cli"
],
"env": {
"DATAPROC_PROJECT": "",
@@ -154,7 +154,7 @@
"serverless-spark",
"--stdio",
"--user-agent-metadata",
- "google-cloud-data-agent-kit-gemini-cli"
+ "datacloud.gemini-cli"
],
"env": {
"SERVERLESS_SPARK_PROJECT": "",
diff --git a/package.json b/package.json
index dc519b5..0374ee4 100644
--- a/package.json
+++ b/package.json
@@ -1,5 +1,5 @@
{
- "name": "data-cloud-ai-dev-kit",
+ "name": "data-agent-kit-starter-pack",
"version": "0.1.8",
"description": "Developer toolkit for Data Cloud and AI integrations",
"bin": {
diff --git a/release-please-config.json b/release-please-config.json
index eb40753..4941f53 100644
--- a/release-please-config.json
+++ b/release-please-config.json
@@ -26,7 +26,7 @@
"packages": {
".": {
"release-type": "simple",
- "package-name": "data-cloud-ai-dev-kit",
+ "package-name": "data-agent-kit-starter-pack",
"extra-files": [
{
"type": "json",