Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.xcommand.ai/llms.txt

Use this file to discover all available pages before exploring further.

The xCommand Google Cloud integration allows your agent to use the gcloud CLI and other Google Cloud SDK tools on your behalf. By configuring service account credentials, your agent can manage cloud resources, deploy applications, and query cloud state.

​
Features

  • Resource Management: Create, list, and manage GCP resources (Compute Engine, Cloud Storage, etc.).
  • Cloud Run/Functions: Deploy and monitor serverless applications.
  • Identity & Access: Manage IAM roles and service accounts.
  • Kubernetes: Interact with GKE clusters.

​
Prerequisites

To use this integration, you need:
  1. The Google Cloud CLI (gcloud) installed on your machine.
  2. A Service Account with the necessary IAM permissions for the tasks you want to perform.
  3. (Optional) A JSON key file for the service account.

​
Configuration

You can configure the GCP integration in two ways: using a Service Account name (ADC) or a JSON key file.

​
Step 1: Migration

When you run the xCommand CLI, it will automatically update your ~/.xcommand/config.json with placeholder fields: 
{
  // ...
  "mode": "safe"
  // gcloud_service_account: your_sa_name@project.iam.gserviceaccount.com
  // gcloud_service_account_json_path: /path/to/key.json
}

​
Step 2: Authentication

Uncomment the gcloud_service_account_json_path line and provide the absolute path to your key file: 
{
  "gcloud_service_account_json_path": "/Users/username/keys/my-sa-key.json"
}
xCommand will automatically set the GOOGLE_APPLICATION_CREDENTIALS environment variable and activate the service account for gcloud.

​
Option B: Service Account Name (ADC)

If you are running in an environment with Application Default Credentials (like a GCE instance or after running gcloud auth application-default login), you can specify the account name: 
{
  "gcloud_service_account": "my-service-account@my-project.iam.gserviceaccount.com"
}

​
Usage

Once configured, you can ask your xCommand agent to perform GCP tasks: 
# List instances
❯ Show me all running GCE instances in project-x

​
Safety & Control

In Safe Mode (default), any GCP commands that are potentially destructive (like deleting a bucket or terminating an instance) will require your confirmation. 
CONFIRMATION REQUIRED: AI wants to run a destructive command:
$ gcloud storage buckets delete gs://my-important-data

Do you want to allow this? (y/n)