Repo brief: googleworkspace/cli

Generated by RepoPilot · document generated 2026-09-15 · concise human review Evidence snapshot · analyzed 2026-09-15T23:50:05.447Z · commit a3768d0e82ad

Verdict

Mixed — Evidence incomplete — review before adopting

• Last commit 1d ago
• 16 active contributors
• Distributed ownership (top contributor 35% of recent commits)
• Apache-2.0 licensed
• 1 more receipt on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

gws is a unified CLI tool that dynamically builds its entire command surface from Google's Discovery Service at runtime, providing zero-boilerplate access to all Google Workspace APIs (Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, etc.). Written in Rust and compiled to standalone binaries, it outputs structured JSON and includes 40+ built-in AI agent skills for automated workflows. Monorepo with Cargo workspace: crates/google-workspace-cli is the CLI binary, crates/google-workspace is the shared library; .agent/ holds reusable AI skills (vhs.md, workflows); .changeset/ manages versioning; .github/workflows/ drives CI, release, and skill generation. No traditional src/ visible—all code…

Start here

Open these first:

• crates/google-workspace-cli/src/main.rs — Entry point for the CLI application; orchestrates command parsing, authentication, and service routing for all Google…
• crates/google-workspace-cli/src/discovery.rs — Fetches and parses Google's Discovery Service to dynamically generate CLI commands; core abstraction enabling…
• crates/google-workspace-cli/src/executor.rs — Executes discovered commands and handles request/response transformation; bridges dynamic API definitions to actual HTTP…
• crates/google-workspace-cli/src/auth.rs — OAuth 2.0 authentication flow and token management; required for all API interactions.
• crates/google-workspace-cli/src/formatter.rs — Converts API responses to structured JSON output; ensures consistent output format across all services.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/googleworkspace/cli.git
cd cli
cargo build --release
# OR: npm install -g @googleworkspace/cli
# OR: download pre-built binary from https://github.com/googleworkspace/cli/releases

Daily commands:

cargo build
cargo run -- auth setup
cargo run -- drive files list
cargo run -- gmail messages list --format json

For npm: gws auth setup, then gws <service> <resource> <method>. Pre-built binaries available from GitHub Releases.

Key cautions & unknowns

• Could not verify tests from the available repository evidence
• Discovery Service dependency: entire CLI is generated at runtime from Google's OpenAPI discovery endpoint; if that service is down or changes schema, gws may fail to initialize. Auth setup required:…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.