gws-setup

Configure and authenticate the Google Workspace CLI for a Google account.

3|1|Updated Nov 10, 2025

Search Tags:#authentication #oauth #gcloud #setup-guide #google-workspace #gws #cli-setup

Ready to run

npx skills add https://github.com/metraton/gaia --skill gws-setup-metraton

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: gws-setup
Source: https://github.com/metraton/gaia/tree/main/skills/gws-setup
Command: npx skills add https://github.com/metraton/gaia --skill gws-setup-metraton

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Configures and authenticates the Google Workspace CLI (gws) for a Google account, handling the nuances of OAuth, account linking, and project setup to prevent common setup failures.

Core Features & Use Cases

Step-by-step setup for gws, including binary installation, account association, project creation, and login verification.
Safeguards for personal vs organizational accounts by guiding scope selection and consent configuration.
Real-world use: initialize a new Google Cloud workspace and ensure the CLI can operate across multiple accounts with minimal friction.

Quick Start

Follow these steps to install gws and configure OAuth for your Google account.

Frequently Asked Questions about gws-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I set up the Google Workspace CLI for the first time?▼

Google Workspace CLI setup requires binary installation, account association, project creation, and login verification. Following guided steps ensures OAuth configuration completes successfully and prevents common setup failures during initialization.

Do I need gcloud installed to authenticate the Google Workspace CLI?▼

Yes, gcloud is a required prerequisite for Google Workspace CLI authentication. The setup process depends on gcloud to manage project creation and browser-based OAuth login verification for your Google account.

Can I configure Google Workspace CLI authentication for multiple accounts?▼

Google Workspace CLI setup supports multi-account environments. Guided configuration handles account association and OAuth scope selection across personal and organizational accounts to ensure the CLI operates with minimal friction.

What is the best way to handle OAuth scope selection for Google Workspace CLI?▼

OAuth scope selection for Google Workspace CLI is best handled by following guided safeguards that differentiate between personal and organizational accounts, ensuring proper consent configuration and secure login verification.

Why does Google Workspace CLI setup fail during account association?▼

Google Workspace CLI setup failures during account association often stem from incorrect OAuth configuration or missing prerequisites. Enforcing gcloud prerequisites and following safe recovery steps documents known issues and resolves common errors.