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
Installs
18.7K
GitHub Stars
26.1K
First Seen
Mar 4, 2026