gwslisted

# gws Google Workspace operations through the official `gws` CLI from `googleworkspace/cli`. This is the local safety wrapper and workflow guide; use the CLI for execution and load references only for multi-step recipes. ## Defaults - **Primary account:** `me@vanducng.dev` - **Primary domain:** `vanducng.dev` - **Timezone:** `Asia/Ho_Chi_Minh` - **CLI:** `gws` - **Response shape:** JSON; pipe to `jq` for inspection and summaries ## When To Use Use this skill when the user asks to: - Read, search, send, reply to, label, or archive Gmail - List, upload, download, share, move, or inspect Drive files - Read agenda, create events, update events, or manage Calendar calendars - Create, read, or append Google Sheets data - Create or inspect Google Docs - Manage Workspace users, groups, memberships, aliases, domains, or audit logs for `vanducng.dev` - Run a raw Workspace API call through `gws` Do not use this for Drive backup/sync work where `rclone` is a better fit, IMAP mailbox backups where `mbsync` or `gyb` is better, or high-volume Workspace provisioning where `GAM7` is more mature. ## Preflight Before any Workspace operation: ```bash command -v gws gws --version gws auth list ``` If `gws` is missing: ```bash brew install googleworkspace-cli # or npm install -g @googleworkspace/cli ``` For first-time auth: ```bash gws auth setup gws auth login --account me@vanducng.dev gws auth default --account me@vanducng.dev ``` For admin operations, verify scopes before writing