gws-auth

gws-auth is a skill for Claude Code, Codex from fakoli/fakoli-plugins. It costs 29 tokens per session (827 once invoked), scanned A, original, MIT.

A credential manager for the Google Workspace command-line tool, including sign-in, sign-out, status checks, and access permissions.

In plain words
What is it for?
Use it to log in, request read-only or custom access, inspect the current sign-in state, manage service accounts, or export credentials.
Why use it?
It provides a controlled way to connect the tool to Google services and choose how much access it receives.

Skill for Claude CodeCodex

Part of the gws plugin — 94 skills, 15 commands, 11 agents shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/fakoli/fakoli-plugins/gws-auth
Any agent
npx skills add fakoli/fakoli-plugins --skill gws-auth
Clone the repo
git clone --depth 1 https://github.com/fakoli/fakoli-plugins

Made for: Claude Code, Codex.

Or install gws, the plugin that ships this one along with the rest of its 94 skills, 15 commands, 11 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for gws-auth

README.md
[![agentmods](https://agentmods.dev/badge/skills/fakoli/fakoli-plugins/gws-auth.svg)](https://agentmods.dev/skills/fakoli/fakoli-plugins/gws-auth)
Your own site
<a href="https://agentmods.dev/skills/fakoli/fakoli-plugins/gws-auth"><img src="https://agentmods.dev/badge/skills/fakoli/fakoli-plugins/gws-auth.svg" alt="Measured on agentmods" height="20"></a>
Per session 29 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 827 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00029 $0.00827
Opus 5 $0.00015 $0.00413
Sonnet 5 $0.00006 $0.00165
Haiku 4.5 $0.00003 $0.00083

Measured 2d ago against content hash d90397a6bf67, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

gws-auth scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/gws/skills/gws-auth/SKILL.md · 117 lines

How it starts

The opening of the file, as written. The whole thing — 117 lines — stays where its author put it; the contents beside it link to each section on GitHub.

gws auth

Note: See the gws-shared skill for global flags and security rules.

Manage authentication and credentials for the gws CLI.

Auth Subcommands

gws auth login       # Interactive OAuth2 login (opens browser)
gws auth logout      # Remove stored credentials
gws auth setup       # Guided first-run setup wizard
gws auth status      # Show current auth state and active scopes
gws auth export      # Export credentials for use in other tools

Login Options

Minimal scopes (default — safest for unverified apps)

gws auth login

Default scopes: Drive, Sheets, Gmail, Calendar, Docs, Slides, Tasks.

Full scopes (includes Pub/Sub and Cloud Platform)

gws auth login --full

Adds pubsub and cloud-platform scopes. Requires a verified OAuth app or Workspace domain admin approval.

Custom scopes

gws auth login --scopes drive,gmail,sheets,pubsub

Unrecognized service names are resolved dynamically from Discovery docs.

Read-only access

gws auth login --readonly

Grants only .readonly scopes for all services.

Credential Sources (Priority Order)

  1. GOOGLE_WORKSPACE_CLI_TOKEN — Pre-obtained OAuth2 access token (highest priority)
  2. GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE — Path to OAuth credentials JSON
  3. Encrypted credentials — AES-256-GCM encrypted at ~/.config/gws/
  4. GOOGLE_APPLICATION_CREDENTIALS — Standard Google ADC (fallback)

Service Account Support

export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=/path/to/service-account.json
gws drive files list

Credential Storage

  • Credentials are stored at ~/.config/gws/ (override with GOOGLE_WORKSPACE_CLI_CONFIG_DIR)
  • Encrypted with AES-256-GCM
  • Encryption key stored in OS keyring by default
  • For headless/Docker/CI: export GOOGLE_WORKSPACE_CLI_KEYRING_BACKEND=file

Environment Variables

Variable Description
GOOGLE_WORKSPACE_CLI_TOKEN Pre-obtained OAuth2 access token
GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE Path to OAuth credentials JSON
GOOGLE_WORKSPACE_CLI_CLIENT_ID OAuth client ID
GOOGLE_WORKSPACE_CLI_CLIENT_SECRET OAuth client secret
GOOGLE_WORKSPACE_CLI_CONFIG_DIR Override config directory
GOOGLE_WORKSPACE_CLI_KEYRING_BACKEND keyring (default) or file
GOOGLE_APPLICATION_CREDENTIALS Standard Google ADC path

Read the full file on GitHub · 117 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 117 lines · 29 tokens per session scan A d90397a6bf67

Subscribe to this mod's changes

gws-auth is a skill published in the GitHub repository fakoli/fakoli-plugins (4 stars, last pushed 27d ago), licensed MIT. It adds 29 tokens to every session and 827 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

better-auth-knowledge-patch

Use this skill when implementing, upgrading, debugging, or reviewing Better Auth applications. Start with the quick references below, then load the topic file that matches the task.

Nevaberry/nevaberry-plugins · 9 tokens

caddy-knowledge-patch

Use this patch when writing or reviewing Caddyfile or JSON configuration, upgrading Caddy, building custom binaries, or operating Caddy's HTTP, proxy, certificate, and telemetry features.

Nevaberry/nevaberry-plugins · 9 tokens

clickhouse-knowledge-patch

Use this skill when writing, reviewing, upgrading, or operating ClickHouse SQL and server configurations. Start with the compatibility-sensitive items below, then load the topic reference that matches the task.

Nevaberry/nevaberry-plugins · 9 tokens

arch-knowledge-patch

Restart the daemon immediately after upgrading openssh to 9.8p1 because the old daemon cannot accept new connections.

Nevaberry/nevaberry-plugins · 8 tokens

axum-knowledge-patch

Axum 0.8 uses return-position impl Trait in FromRequestParts and FromRequest. Implement their methods with native async fn; do not retain the old #[asynctrait] annotation.

Nevaberry/nevaberry-plugins · 9 tokens

cloudflare-d1-knowledge-patch

Use this skill when designing, implementing, migrating, operating, or debugging Cloudflare D1 databases. Check the project’s Wrangler configuration, binding usage, database generation, account plan, and remote-versus-local command flags before applying guidance.

Nevaberry/nevaberry-plugins · 13 tokens