From 39b693c79ce70ac06d31b3a444684c602bfac9e1 Mon Sep 17 00:00:00 2001 From: Bharath Elluru Date: Wed, 15 Apr 2026 22:34:34 -0700 Subject: [PATCH 1/4] docs: update README with node prerequisites, codex installation and troubleshooting --- README.md | 69 ++++++++++++++++++++++++++++++++++++++++++------------- 1 file changed, 53 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index d0853e7..64dd2b4 100644 --- a/README.md +++ b/README.md @@ -9,6 +9,17 @@ This plugin provides a specialized suite of skills and MCP tools for data engine > **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. +## Contents + +- [Why Use the Data Agent Kit Starter Pack?](#why-use-the-data-agent-kit-starter-pack) +- [Prerequisites](#prerequisites) +- [Getting Started](#getting-started) + - [Installation](#installation) + - [Configuration](#configuration) +- [Usage Examples](#usage-examples) +- [Troubleshooting](#troubleshooting) +- [Security Reminder: Agent Environment Hardening](#security-reminder-agent-environment-hardening) + ## Why Use the Data Agent Kit Starter Pack? * **Seamless Workflow:** Bring Google Cloud data engineering expertise directly into your terminal or IDE via Gemini CLI, Claude Code, or Codex. @@ -20,9 +31,10 @@ This plugin provides a specialized suite of skills and MCP tools for data engine Ensure you have the following installed: * **Node.js and npm** (Latest version recommended) +* **Google Cloud SDK (gcloud CLI):** [Install and initialize](https://cloud.google.com/sdk/docs/install) the gcloud CLI and ensure [Application Default Credentials (ADC)](https://cloud.google.com/docs/authentication/provide-credentials-adc) are configured. * 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) + * [Claude Code](https://code.claude.com/docs) * Codex CLI * **(Optional) IDE Extension:** [Google Cloud Data Agent Kit](https://docs.cloud.google.com/data-cloud-extension/vs-code/install). @@ -35,18 +47,24 @@ Choose the installation method for your preferred coding agent. Run the commands
Gemini CLI and Gemini Code Assist +Install the extension directly from GitHub: ```bash -gemini extensions install https://github.com/gemini-cli-extensions/data-agent-kit-starter-pack +gemini extensions install https://github.com/gemini-cli-extensions/data-agent-kit-starter-pack --consent ```
Claude Code -Run the `claude` command to start the agent, then run: +Run the `claude` command to start the agent, then follow these steps: +1. **Add the marketplace:** ```bash /plugin marketplace add https://github.com/gemini-cli-extensions/data-agent-kit-starter-pack +``` + +2. **Install the plugin:** +```bash /plugin install data-agent-kit-starter-pack@data-agent-kit-starter-pack-marketplace ```
@@ -54,7 +72,7 @@ Run the `claude` command to start the agent, then run:
Codex -Run the following commands in your terminal: +1. **Run the installation script in your terminal:** **macOS / Linux:** ```bash @@ -66,20 +84,35 @@ curl -sSL https://raw.githubusercontent.com/gemini-cli-extensions/data-agent-kit 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: +2. **Install the plugin in Codex:** +Start the Codex agent (`codex`), then run: ```bash /plugins ``` - -Use the interactive options to install the extension with the name `Data Agent Kit Starter Pack`. +Use the interactive options to install the plugin 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. +This extension brings a suite of specialized **Skills** and **MCP toolboxes**. While skills are ready to use upon installation, you **must** configure the MCP toolboxes and authenticate with Google Cloud for them to start successfully. -In all cases, you must restart the agent after updating the configuration files. +> [!NOTE] +> If you use Gemini CLI, Claude Code, or Codex in your IDE (e.g., via VS Code extensions), they share the same underlying configuration and MCP servers as the CLI agents. + +#### 1. Authenticate with Google Cloud +The MCP toolboxes require an active authenticated session to interact with your resources. Run the following commands in your terminal: +```bash +gcloud auth login +gcloud auth application-default login +``` + +#### 2. Update Agent Configuration +You must configure the MCP toolboxes in your agent's configuration files for them to start successfully. After updating, you must restart the agent. + +To verify your configuration: +* Run the `/mcp` command to check the status of available MCP servers. +* Ask your agent "What skills are available?" to view the list of active skills.
Gemini CLI and Gemini Code Assist @@ -91,11 +124,8 @@ Edit the configuration file:
Claude Code -1. Edit the configuration file: +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.
@@ -104,11 +134,10 @@ Run `/plugin` and use interactive options to uninstall `data-agent-kit-starter-p 1. Edit the configuration file: `~/.agents/plugins/data-agent-kit-starter-pack/.mcp.json` -2. Use interactive options to uninstall and install the extension: +2. Use the interactive options to uninstall and install the plugin with the name `Data Agent Kit Starter Pack`: ```bash /plugins ``` -Install with name: `Data Agent Kit Starter Pack`
## Usage Examples @@ -131,9 +160,17 @@ Interact with your coding agent using natural language prompts to perform comple ## Troubleshooting +Use `gemini --debug` to enable debugging. + +Common issues: + * **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. +* **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. See [Set up Application Default Credentials](https://cloud.google.com/docs/authentication/provide-credentials-adc) for more information. +* **"failed to find default credentials: google: could not find default credentials."**: Ensure Application Default Credentials (ADC) are available in your environment. * **MCP Connection Issues:** Update the MCP server configurations such as project, region etc. needed by MCP toolboxes in order to connect successfully to them. +* **"✖ Error during discovery for server: MCP error -32000: Connection closed"**: The connection could not be established. Ensure your configuration is correctly set in the agent's configuration file. +* **"✖ MCP ERROR: Error: spawn .../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. ## Security Reminder: Agent Environment Hardening From 514289aaddaaf64baa231a571aa931ded4792584 Mon Sep 17 00:00:00 2001 From: Bharath Elluru Date: Mon, 20 Apr 2026 14:07:24 -0700 Subject: [PATCH 2/4] docs: add version to README and update security section, add README to release-please-config --- README.md | 41 ++++++++++++++++++++++++++------------ release-please-config.json | 1 + 2 files changed, 29 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index 64dd2b4..7f3543b 100644 --- a/README.md +++ b/README.md @@ -40,6 +40,8 @@ Ensure you have the following installed: ## Getting Started + + ### Installation Choose the installation method for your preferred coding agent. Run the commands in terminal @@ -49,7 +51,7 @@ Choose the installation method for your preferred coding agent. Run the commands Install the extension directly from GitHub: ```bash -gemini extensions install https://github.com/gemini-cli-extensions/data-agent-kit-starter-pack --consent +gemini extensions install https://github.com/gemini-cli-extensions/data-agent-kit-starter-pack --ref 0.1.0 ```
@@ -60,7 +62,7 @@ Run the `claude` command to start the agent, then follow these steps: 1. **Add the marketplace:** ```bash -/plugin marketplace add https://github.com/gemini-cli-extensions/data-agent-kit-starter-pack +/plugin marketplace add https://github.com/gemini-cli-extensions/data-agent-kit-starter-pack#0.1.0 ``` 2. **Install the plugin:** @@ -76,12 +78,12 @@ Run the `claude` command to start the agent, then follow these steps: **macOS / Linux:** ```bash -curl -sSL https://raw.githubusercontent.com/gemini-cli-extensions/data-agent-kit-starter-pack/main/codex-install.sh | bash +curl -sSL https://raw.githubusercontent.com/gemini-cli-extensions/data-agent-kit-starter-pack/0.1.0/codex-install.sh | bash ``` **Windows:** ```powershell -irm https://raw.githubusercontent.com/gemini-cli-extensions/data-agent-kit-starter-pack/main/codex-install.ps1 | iex +irm https://raw.githubusercontent.com/gemini-cli-extensions/data-agent-kit-starter-pack/0.1.0/codex-install.ps1 | iex ``` 2. **Install the plugin in Codex:** @@ -125,7 +127,7 @@ Edit the configuration file: Claude Code Edit the configuration file: -`~/.claude/plugins/cache/data-agent-kit-starter-pack-marketplace/data-agent-kit-starter-pack//.mcp.json` +`~/.claude/plugins/cache/data-agent-kit-starter-pack-marketplace/data-agent-kit-starter-pack/0.1.0/.mcp.json`
@@ -174,11 +176,24 @@ Common issues: ## 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. - -* 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. +Your agent can execute tools and commands on your behalf. Protect your Google +Cloud resources by enforcing **The Principle of Least Privilege** across all +CLIs, MCP servers and other resources available to your agents. + +* **Service Accounts:** Use + [service accounts](https://docs.cloud.google.com/docs/authentication/use-service-account-impersonation) + instead of end user credentials to access Google Cloud resources. +* **Limited Permissions:** Assign roles with + [limited permissions](https://docs.cloud.google.com/iam/docs/roles-overview) + to the service account that you're using for authentication. +* **Principal Access Boundaries:** Prevent unwanted cross-org agent access by + using + [Principal Access Boundary policies](https://docs.cloud.google.com/iam/docs/principal-access-boundary-policies#use-case-one-project) + to scope your agent to projects you intend it to access. +* [Include a condition in the policy binding](https://docs.cloud.google.com/iam/docs/principal-access-boundary-policies#use-case-one-project) + to ensure that the policy only applies to the service accounts that you + intend to restrict. + +You can read more +[here](https://docs.cloud.google.com/data-cloud-extension/vs-code/prompt-injection-risk) +on how to mitigate prompt injection attacks with Google Cloud MCP. diff --git a/release-please-config.json b/release-please-config.json index 4941f53..8bef7dd 100644 --- a/release-please-config.json +++ b/release-please-config.json @@ -28,6 +28,7 @@ "release-type": "simple", "package-name": "data-agent-kit-starter-pack", "extra-files": [ + "README.md", { "type": "json", "path": "gemini-extension.json", From 981b2451ac01a575d4b16fb815e0aff26bb01e62 Mon Sep 17 00:00:00 2001 From: Bharath Elluru Date: Mon, 20 Apr 2026 14:39:57 -0700 Subject: [PATCH 3/4] docs: update release-please markers and lychee ignore --- .lycheeignore | 1 + README.md | 2 ++ 2 files changed, 3 insertions(+) diff --git a/.lycheeignore b/.lycheeignore index 62a2a50..4bb8e64 100644 --- a/.lycheeignore +++ b/.lycheeignore @@ -2,4 +2,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 +https://docs.cloud.google.com/data-cloud-extension/vs-code/prompt-injection-risk data-cloud-ai-dev-kit@data-cloud-ai-dev-kit-marketplace \ No newline at end of file diff --git a/README.md b/README.md index 7f3543b..610562d 100644 --- a/README.md +++ b/README.md @@ -142,6 +142,8 @@ Edit the configuration file: ```
+ + ## Usage Examples Interact with your coding agent using natural language prompts to perform complex data engineering tasks: From 4496ee6059dc85f8be817c8efd93f2309f73d4b6 Mon Sep 17 00:00:00 2001 From: Bharath Elluru Date: Mon, 20 Apr 2026 14:43:52 -0700 Subject: [PATCH 4/4] docs: ignore broken comparison links in lychee --- .lycheeignore | 1 + 1 file changed, 1 insertion(+) diff --git a/.lycheeignore b/.lycheeignore index 4bb8e64..07c6880 100644 --- a/.lycheeignore +++ b/.lycheeignore @@ -3,4 +3,5 @@ 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 https://docs.cloud.google.com/data-cloud-extension/vs-code/prompt-injection-risk +https://github.com/gemini-cli-extensions/data-agent-kit-starter-pack/compare/ data-cloud-ai-dev-kit@data-cloud-ai-dev-kit-marketplace \ No newline at end of file