gogcli (gog)

gog is a fast, script-friendly CLI for Google services. It is JSON-first, supports multiple accounts/OAuth clients, and has explicit guardrails for agent and CI usage.

Authoritative upstream: https://github.com/steipete/gogcli

This skill was refreshed against upstream gog v0.13.0 (2026-04-20). When exact syntax matters, run gog <command> --help or gog schema --json; the command surface moves quickly, rather inconveniently for anyone fond of stale notes.

Operating rules

• Prefer gog --json ... | jq ... for inspection and scripting.
• Use --plain only when stable TSV is more convenient than JSON.
• Use --dry-run for supported mutating operations when preparing a change or when user intent is ambiguous.
• Use --no-input in automation so commands fail instead of prompting.
• Use --force only when the user asked for the destructive/public/send/admin operation or after you have clearly explained the effect.
• Do not repair OAuth, consent, keyring, or Workspace delegation problems silently. Show the exact command the user should run.
• Do not export tokens, print secrets, open public shares, add delegates/forwarding, send mail, suspend users, or permanently delete data unless the user explicitly requested that action.
• For agent runs that must not send mail, add --gmail-no-send, set GOG_GMAIL_NO_SEND=1, or configure gog config no-send set <account>.