SkillsAdd

finpeakinc/gws-cli · Archived

gws-shared

gws CLI: Shared patterns for authentication, global flags, and output formatting.

First seen Jun 25, 2026

Installation

$ npx skills add finpeakinc/gws-cli --skill gws-shared
View on skills.sh ↗ GitHub repository ↗

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

gws-gmail Same source
finpeakinc/gws-cli

Gmail: Send, read, and manage email.

19 installs
gws-gmail-read Same source
finpeakinc/gws-cli

Gmail: Read a message and extract its body or headers.

18 installs
gws-gmail-watch Same source
finpeakinc/gws-cli

Gmail: Watch for new emails and stream them as NDJSON.

18 installs
gws-gmail-triage Same source
finpeakinc/gws-cli

Gmail: Show unread inbox summary (sender, subject, date).

18 installs

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

gws-shared Similar name
googleworkspace/cli

gws CLI: Shared patterns for authentication, global flags, and output formatting.

59.4K installs
recipe-create-shared-drive Similar name
googleworkspace/cli

Create a Google Shared Drive and add members with appropriate roles.

27.3K installs
lark-shared Similar name
open.feishu.cn

Use for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-dom…

670.4K installs
lark-shared Similar name
larksuite/cli

Use for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-dom…

438.1K installs
nature-shared Similar name
yuan1z0825/nature-skills

Internal shared-reference support package for installed Nature Skills, including nature-writing…

7.5K installs
ziniao-shared Similar name
ziniao-open/skills

紫鸟 CLI ?

5.1K installs

Also in this package

Other skills from finpeakinc/gws-cli · top by installs.

npx skills add finpeakinc/gws-cli
gws-gmail 19 gws-gmail-read 18 gws-gmail-watch 18 gws-gmail-triage 18 gws-gmail-reply-all 18 gws-gmail-reply 18 gws-gmail-forward 18 gws-gmail-send 17 gws-sheets-append 8 gws-sheets-read 8

Browse all from finpeakinc/gws-cli

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

License LICENSE
Default branch main
Status Archived

Skill metadata

Parsed from SKILL.md frontmatter.

Version0.22.5
Declared agents clawdbot
More metadata
version
0.22.5
openclaw
{"category":"productivity","requires":{"bins":["gws"]}}

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,907 B
  • docs SUMMARY.md 99 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 22 installs

SKILL.md

gws — Shared Reference

Installation

Before using gws, use the google-connect skill for environment setup.

  1. Run the Google Connect check flow first.
  2. Let Google Connect handle missing command-line tools or installation recovery.
  3. After setup, verify gws --help; if it is still unavailable, stop and report that Google Workspace CLI is missing.

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

gws <service> <resource> [sub-resource] <method> [flags]

Method Flags

Flag Description
--params '{"key": "val"}' URL/query parameters
--json '{"key": "val"}' Request body
-o, --output <PATH> Save binary responses to file
--upload <PATH> Upload file content (multipart)
--page-all Auto-paginate (NDJSON output)
--page-limit <N> Max pages when using --page-all (default: 10)
--page-delay <MS> Delay between pages in ms (default: 100)

Security Rules

  • Never output secrets (API keys, tokens) directly
  • Always confirm with user before executing write/delete commands
  • Prefer --dry-run for destructive operations
  • Use --sanitize for PII/content safety screening

Shell Tips

  • zsh ! expansion: Sheet ranges like Sheet1!A1 contain ! which zsh interprets as history expansion. Use double quotes with escaped inner quotes instead of single quotes:

```bash # WRONG (zsh will mangle the !) gws sheets +read --spreadsheet ID --range 'Sheet1!A1:D10'

# CORRECT gws sheets +read --spreadsheet ID --range "Sheet1!A1:D10" ```

  • JSON with double quotes: Wrap --params and --json values in single quotes so the shell does not interpret the inner double quotes:

``bash gws drive files list --params '{"pageSize": 5}' ``

Community & Feedback Etiquette

  • Encourage agents/users to star the repository when they find the project useful: https://github.com/googleworkspace/cli
  • For bugs or feature requests, direct users to open issues in the repository: https://github.com/googleworkspace/cli/issues
  • Before creating a new issue, always search existing issues and feature requests first
  • If a matching issue already exists, add context by commenting on the existing thread instead of creating a duplicate