gws-shared

Standardize authentication, global flags, and output formatting for the gws command-line tool.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/cellarwood/figurio --skill gws-shared-cellarwood
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-shared
Source: https://github.com/cellarwood/figurio/tree/main/skills/gws-shared
Command: npx skills add https://github.com/cellarwood/figurio --skill gws-shared-cellarwood

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill consolidates shared CLI patterns and safety rules for the Google Workspace gws command-line tool so users and agents can authenticate reliably, apply consistent global flags, and produce predictable output without exposing secrets or falling prey to shell quoting pitfalls.

Core Features & Use Cases

  • Authentication guidance for both interactive browser OAuth and service account credentials.
  • Global flags and output formatting controls including json, table, yaml, csv, dry-run, sanitize, pagination, and upload/download options.
  • Security and shell tips to avoid history expansion, accidental secret printing, and destructive actions; ideal for automating Drive and Sheets reads, batch exports, and scripted admin tasks.

Quick Start

Authenticate with gws using a browser login or a service account credential and then run a read operation to list files or sheet ranges with an explicit output format and pagination settings.

Frequently Asked Questions about gws-shared

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

FAQPage Schema
How do I standardize Google Workspace CLI authentication and output formatting?

You can standardize Google Workspace CLI authentication and output formatting by applying shared global flags for json, table, yaml, and csv outputs, alongside interactive OAuth or service account credentials.

Can I use a service account for gws CLI automation instead of browser OAuth?

Yes, you can use a service account credential for gws CLI automation instead of browser OAuth, enabling scripted bulk operations and automated Drive and Sheets reads without interactive login prompts.

What output formats does the Google Workspace CLI support for batch exports?

The Google Workspace CLI supports json, table, yaml, and csv output formats for batch exports, allowing you to produce predictable structured data alongside pagination and dry-run controls.

How do I prevent leaking secrets when running gws CLI commands in scripts?

To prevent leaking secrets when running gws CLI commands, apply built-in safety rules and shell tips like sanitize flags and history expansion controls to avoid accidental secret printing in logs.

Does the gws CLI support pagination controls for reading large Drive or Sheets data?

Yes, the gws CLI supports pagination controls for reading large Drive or Sheets data, allowing you to manage bulk exports and scripted admin tasks efficiently without overwhelming the terminal output.

What is the best way to automate Google Workspace admin tasks from the command line?

The best way to automate Google Workspace admin tasks from the command line is using gws with service account authentication, explicit output formatting, and dry-run controls to safely script bulk operations.