gws-shared
Installation
Summary
Shared authentication, CLI syntax, and output formatting patterns for gws Google Workspace commands.
- Supports browser-based OAuth login and service account authentication via
GOOGLE_APPLICATION_CREDENTIALS - Global flags enable output format selection (JSON, table, YAML, CSV), dry-run validation, and PII screening via Model Armor
- Method flags cover parameterized queries, request bodies, file uploads, multipart operations, and automatic pagination with configurable delays
- Built-in security guardrails prevent secret leakage and require user confirmation before write/delete operations
- Shell-specific guidance for zsh history expansion and JSON quoting to avoid common command-line parsing errors
SKILL.md
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 |
Related skills
More from googleworkspace/cli
gws-gmail
Gmail: Send, read, and manage email.
26.1Kgws-docs
Read and write Google Docs.
26.0Kgws-drive
Google Drive: Manage files, folders, and shared drives.
26.0Kgws-sheets
Google Sheets: Read and write spreadsheets.
24.6Kgws-calendar
Google Calendar: Manage calendars and events.
24.6Kgws-docs-write
Google Docs: Append text to a document.
21.8K