Technical & DevelopmentIntermediate
gws-shared
Shared authentication, global flags, and output formatting
Developer Setup
Setup & Installation
bash
npx skills add https://github.com/googleworkspace/cli --skill gws-sharednpx skills add https://github.com/googleworkspace/cli --skill gws-sharedOr paste this URL into your assistant to install:
Overview
What This Skill Does
Shared foundation for the gws CLI that covers OAuth and service account authentication, global output flags, and common request patterns across all Google Workspace services. It defines how the CLI structures commands, handles pagination, uploads files, and screens responses through Model Armor.
Application
When to use this Skill
- Configuring integration settings for custom agent workflows.
- Optimizing query execution and response latency in production.
- Developing clean, standard-compliant implementations for enterprise services.
- Troubleshooting connection timeouts and authentication handshakes.
- Monitoring API rate limits and execution pipelines programmatically.
Documentation
Show Skills.md file
gws — Shared Reference
Installation
The gws binary must be on $PATH. See the project README for install options.
Authentication
# Browser-based OAuth (interactive)
gws auth login
# Service Account
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/key.json
Global Flags
| Flag | Description |
|---|---|
--format <FORMAT> |
Output format: json (default), table, yaml, csv |
--dry-run |
Validate locally without calling the API |
--sanitize <TEMPLATE> |
Screen responses through Model Armor |
CLI Syntax
Lines 1 - 25 of 70
Recommendations