skills.rest
metraton
metratonCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/metraton/gaia --skill gws-setup-metraton
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
Oruga420Oruga420

gws-installer

Install and configure the Google Workspace CLI for terminal access.

Community
Advanced
m13vm13v
312

gws-classroom

Manage Google Classroom courses, rosters, and assignments via the gws CLI.

Community
Intermediate
ssmleossmleo

cloud-run-basics

Automate deployment and management of Cloud Run services, jobs, and worker pools.

Community
Advanced
ProyectoG007ProyectoG007

api-gateway

Call native endpoints of over 100 third-party APIs via managed OAuth connections.

Community
Advanced