skills.rest
Oruga420
Oruga420COMMUNITY
Explore all skills by this author →
Website𝕏@Oruga420GitHub

gws-installer

Install and configure the Google Workspace CLI for terminal access.

Updated Mar 24, 2026
Search Tags:#oauth#cli#gcloud#nodejs#installation#google workspace#gws
One-click install
npx skills add https://github.com/Oruga420/claude-code-skills --skill gws-installer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gws-installer
Source: https://github.com/Oruga420/claude-code-skills/tree/main/gws-installer
Command: npx skills add https://github.com/Oruga420/claude-code-skills --skill gws-installer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill streamlines installation and configuration of the Google Workspace CLI (gws) so Sesh employees can authenticate and use Drive, Docs, Sheets, Gmail, Calendar, Tasks, Forms, Slides, and Apps Script from the terminal without manual setup errors or scope misconfiguration.

Core Features & Use Cases

  • Automated Installation: Guides through npm global installation and verifies gws is available in PATH.
  • Environment & OS Detection: Detects OS and shell differences (Windows, macOS, Linux) and adapts guidance for env var setup and PATH issues.
  • Dependency Checks: Validates Node.js and gcloud installation and walks the user through gcloud auth login when needed.
  • OAuth Configuration & Login: Collects and validates OAuth Client ID and Secret formats, sets environment variables, runs gws auth login with a safe scope set, and instructs on the browser consent flow.
  • Verification & Troubleshooting: Performs auth status and smoke tests, verifies token validity and scope counts, and offers clear remedies for common errors like EACCES, restricted_client, and PATH problems.

Quick Start

Use the gws-installer skill to install and authenticate the Google Workspace CLI for your @seshwithfriends.org account.

Frequently Asked Questions about gws-installer

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

FAQPage Schema
How do I set up the Google Workspace CLI for terminal access to Gmail and Drive?▼

The Google Workspace CLI installation requires Node.js, npm, and the Google Cloud SDK (gcloud) to be installed first. The installer detects your OS, sets environment variables, and walks you through gcloud auth login before configuring OAuth.

Can I authenticate the Google Workspace CLI to access Google Sheets and Calendar from the command line?▼

Yes, the Google Workspace CLI supports Google Sheets and Calendar access. You provide an OAuth Client ID and Secret for the project, then complete a browser-based OAuth consent flow to authenticate your account for terminal use.

What should I do if the Google Workspace CLI installation fails with an EACCES or restricted_client error?▼

For EACCES or restricted_client errors during Google Workspace CLI installation, the skill provides troubleshooting steps that verify token validity, check scope counts, and correct PATH issues. It also validates your OAuth Client ID and Secret formats to resolve restricted_client errors.

Does the Google Workspace CLI installer work on Windows, macOS, and Linux?▼

Yes, the Google Workspace CLI installer supports Windows, macOS, and Linux by detecting OS and shell differences. It adapts environment variable setup and PATH configuration guidance to ensure the gws command is available across all three operating systems.

Related Skills

Explore More Software Engineering Skills→
alex-tgkalex-tgk
1

gcloud

Configure, authenticate, and manage Google Cloud resources via the gcloud CLI.

Community
Intermediate
taylorwilsdontaylorwilsdon
3.0k

managing-google-workspace

Routes Cloud / on-prem tasks to appropriate handlers and manages them.

Community
Advanced
kubonykubony
10

gcp-iam

Manage GCP IAM service accounts, roles, keys, and policies via gcloud.

Community
Intermediate
lengoctuong2005lengoctuong2005
5

google-workspace

Access Google Workspace services via gws CLI or Python.

Community
Intermediate