docs: add generated command pages site

.github/workflows/pages.yml

@@ -0,0 +1,60 @@
+name: pages
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "docs/**"
+      - "scripts/gen-command-reference.sh"
+      - "scripts/build-docs-site.mjs"
+      - "Makefile"
+      - ".github/workflows/pages.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    name: Deploy docs
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Check out
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+      - name: Set up Go
+        uses: actions/setup-go@4a3601121dd01d1626a1e23e37211e3254c1c06c # v6.4.0
+        with:
+          go-version-file: go.mod
+          cache: true
+
+      - name: Set up Node
+        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
+        with:
+          node-version: "24"
+
+      - name: Build docs site
+        run: make docs-site
+
+      - name: Configure Pages
+        uses: actions/configure-pages@45bfe0192ca1faeb007ade9deae92b16b8254a0d # v6.0.0
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5.0.0
+        with:
+          path: dist/docs-site
+
+      - name: Deploy
+        id: deployment
+        uses: actions/deploy-pages@cd2ce8fcbc39b97be8ca5fce6e763baed58fa128 # v5.0.0

.gitignore

@@ -41,3 +41,4 @@ internal/cmd/safety_profile_baked_gen.go
 
 # Node (optional dev scripts)
 node_modules/
+dist/

Makefile

@@ -3,7 +3,7 @@ SHELL := /bin/bash
 # `make` should build the binary by default.
 .DEFAULT_GOAL := build
 
-.PHONY: build build-safe gog gogcli gog-help gogcli-help help fmt fmt-check lint test ci tools docs-commands
+.PHONY: build build-safe gog gogcli gog-help gogcli-help help fmt fmt-check lint test ci tools docs-commands docs-site docs-check
 .PHONY: worker-ci
 
 BIN_DIR := $(CURDIR)/bin
@@ -70,6 +70,11 @@ help: gog-help
 docs-commands: build
 	@scripts/gen-command-reference.sh docs/commands.generated.md
 
+docs-site: docs-commands
+	@node scripts/build-docs-site.mjs
+
+docs-check: docs-site
+
 tools:
 	@mkdir -p $(TOOLS_DIR)
 	@if [ -x "$(GOFUMPT)" ] && [ -x "$(GOIMPORTS)" ] && [ -x "$(GOLANGCI_LINT)" ] && [ "$$(cat $(TOOLS_STAMP) 2>/dev/null)" = "$(TOOLS_VERSION)" ]; then \

README.md

@@ -1960,12 +1960,25 @@ Pinned tools (installed into `.tools/`):
 
 CI runs format checks, tests, and lint on push/PR.
 
-Regenerate the expanded command reference from the live schema when CLI surface changes:
+Documentation is split between hand-written topic pages in `docs/` and generated
+per-command pages in `docs/commands/`. Every CLI command should have a docs page;
+do not hand-edit generated command pages. Regenerate them from the live schema
+whenever command names, flags, aliases, arguments, or help text change:
 
 ```bash
 make docs-commands
 ```
 
+Build the GitHub Pages site locally:
+
+```bash
+make docs-site
+open dist/docs-site/index.html
+```
+
+The Pages workflow rebuilds the command pages and publishes the static site from
+`dist/docs-site` using the custom domain in `docs/CNAME`.
+
 ### Integration Tests (Live Google APIs)
 
 Opt-in tests that hit real Google APIs using your stored `gog` credentials/tokens.

docs/README.md

@@ -0,0 +1,46 @@
+# gog Docs
+
+`gog` is a single CLI for Google Workspace automation: Gmail, Calendar, Drive,
+Docs, Sheets, Slides, Contacts, Tasks, People, Forms, Apps Script, Groups, Admin,
+Keep, and related agent workflows.
+
+## Start Here
+
+- Install and authenticate from the repository
+  [README](https://github.com/steipete/gogcli#readme).
+- Read [Auth Clients](auth-clients.md) when setting up OAuth clients, service
+  accounts, or Workspace domain-wide delegation.
+- Read [Command Guards and Baked Safety Profiles](safety-profiles.md) when
+  running `gog` from agents or automation.
+- Open the [Command Index](commands/README.md) for generated docs for every CLI
+  command.
+
+## Common Paths
+
+```bash
+gog auth add you@gmail.com --services gmail,calendar,drive
+gog gmail search 'newer_than:7d' --max 10
+gog gmail get <messageId> --sanitize-content --json
+gog calendar events --today
+gog drive ls --max 20
+```
+
+## Command Docs
+
+Every command page under `docs/commands/` is generated from
+`gog schema --json`. Do not hand-edit generated command pages. After changing
+commands, flags, aliases, arguments, or help text, run:
+
+```bash
+make docs-commands
+```
+
+Then build the GitHub Pages site locally:
+
+```bash
+make docs-site
+open dist/docs-site/index.html
+```
+
+The site is intentionally static: no framework, no package install, and no
+client-side dependency beyond a small navigation script embedded by the builder.

docs/commands.generated.md

@@ -2,443 +2,443 @@
 
 Generated from `gog schema --json`.
 
-- `gog <command> [flags]` - Google CLI for Gmail/Calendar/Chat/Classroom/Drive/Contacts/Tasks/Sheets/Docs/Slides/People/Forms/App Script/Ads/Groups/Admin/Keep
-- `gog admin <command> [flags]` - Google Workspace Admin (Directory API) - requires domain-wide delegation
-- `gog admin groups <command>` - Manage Workspace groups
-- `gog admin groups list (ls) [flags]` - List groups in a domain
-- `gog admin groups members <command>` - Manage group members
-- `gog admin groups members add (invite) <groupEmail> <memberEmail> [flags]` - Add a member to a group
-- `gog admin groups members list (ls) <groupEmail> [flags]` - List group members
-- `gog admin groups members remove (rm,del,delete) <groupEmail> <memberEmail>` - Remove a member from a group
-- `gog admin users <command>` - Manage Workspace users
-- `gog admin users create (add,new) <email> [flags]` - Create a new user
-- `gog admin users get (info,show) <userEmail>` - Get user details
-- `gog admin users list (ls) [flags]` - List users in a domain
-- `gog admin users suspend <userEmail>` - Suspend a user account
-- `gog agent <command> [flags]` - Agent-friendly helpers
-- `gog agent exit-codes (exitcodes,exit-code)` - Print stable exit codes for automation
-- `gog appscript (script,apps-script) <command> [flags]` - Google Apps Script
-- `gog appscript (script,apps-script) content (cat) <scriptId>` - Get Apps Script project content
-- `gog appscript (script,apps-script) create (new) --title=STRING [flags]` - Create an Apps Script project
-- `gog appscript (script,apps-script) get (info,show) <scriptId>` - Get Apps Script project metadata
-- `gog appscript (script,apps-script) run <scriptId> <function> [flags]` - Run a deployed Apps Script function
-- `gog auth <command> [flags]` - Auth and credentials
-- `gog auth add <email> [flags]` - Authorize and store a refresh token
-- `gog auth alias <command>` - Manage account aliases
-- `gog auth alias list` - List account aliases
-- `gog auth alias set <alias> <email>` - Set an account alias
-- `gog auth alias unset <alias>` - Remove an account alias
-- `gog auth credentials <command>` - Manage OAuth client credentials
-- `gog auth credentials list` - List stored OAuth client credentials
-- `gog auth credentials remove [<client>]` - Remove stored OAuth client credentials
-- `gog auth credentials set <credentials> [flags]` - Store OAuth client credentials
-- `gog auth doctor [flags]` - Diagnose auth, keyring, and refresh-token issues
-- `gog auth keep --key=STRING <email>` - Configure service account for Google Keep (Workspace only)
-- `gog auth keyring [<backend> [<backend2>]]` - Configure keyring backend
-- `gog auth list [flags]` - List stored accounts
-- `gog auth manage (login) [flags]` - Open accounts manager in browser
-- `gog auth remove <email>` - Remove a stored refresh token
-- `gog auth service-account <command>` - Configure service account (Workspace only; domain-wide delegation)
-- `gog auth service-account set --key=STRING <email>` - Store a service account key for impersonation
-- `gog auth service-account status <email>` - Show stored service account key status
-- `gog auth service-account unset <email>` - Remove stored service account key
-- `gog auth services [flags]` - List supported auth services and scopes
-- `gog auth status` - Show auth configuration and keyring backend
-- `gog auth tokens <command>` - Manage stored refresh tokens
-- `gog auth tokens delete <email>` - Delete a stored refresh token
-- `gog auth tokens export <email> [flags]` - Export a refresh token to a file (contains secrets)
-- `gog auth tokens import <inPath>` - Import a refresh token file into keyring (contains secrets)
-- `gog auth tokens list` - List stored tokens (by key only)
-- `gog backup <command> [flags]` - Encrypted Google account backups
-- `gog backup cat <shard> [flags]` - Decrypt one backup shard to stdout
-- `gog backup export [flags]` - Write a local plaintext export
-- `gog backup gmail <command>` - Gmail backup operations
-- `gog backup gmail push [flags]` - Export Gmail into encrypted backup shards
-- `gog backup init [flags]` - Initialize encrypted backup config and repository
-- `gog backup push [flags]` - Export services into encrypted backup shards
-- `gog backup status [flags]` - Inspect backup manifest without decrypting shards
-- `gog backup verify [flags]` - Decrypt and verify all backup shards
-- `gog calendar (cal) <command> [flags]` - Google Calendar
-- `gog calendar (cal) acl (permissions,perms) <calendarId> [flags]` - List calendar ACL
-- `gog calendar (cal) alias <command>` - Manage calendar aliases
-- `gog calendar (cal) alias list` - List calendar aliases
-- `gog calendar (cal) alias set <alias> <calendarId>` - Set a calendar alias
-- `gog calendar (cal) alias unset <alias>` - Remove a calendar alias
-- `gog calendar (cal) calendars [flags]` - List calendars
-- `gog calendar (cal) colors` - Show calendar colors
-- `gog calendar (cal) conflicts [flags]` - Find conflicts
-- `gog calendar (cal) create (add,new) <calendarId> [flags]` - Create an event
-- `gog calendar (cal) create-calendar (new-calendar) <summary> [flags]` - Create a new secondary calendar
-- `gog calendar (cal) delete (rm,del,remove) <calendarId> <eventId> [flags]` - Delete an event
-- `gog calendar (cal) event (get,info,show) <calendarId> <eventId>` - Get event
-- `gog calendar (cal) events (list,ls) [<calendarId> ...] [flags]` - List events from a calendar or all calendars
-- `gog calendar (cal) focus-time (focus) --from=STRING --to=STRING [<calendarId>] [flags]` - Create a Focus Time block
-- `gog calendar (cal) freebusy [<calendarIds>] [flags]` - Get free/busy
-- `gog calendar (cal) move (transfer) <calendarId> <eventId> <destinationCalendarId> [flags]` - Move an event to another calendar
-- `gog calendar (cal) out-of-office (ooo) --from=STRING --to=STRING [<calendarId>] [flags]` - Create an Out of Office event
-- `gog calendar (cal) propose-time <calendarId> <eventId> [flags]` - Generate URL to propose a new meeting time (browser-only feature)
-- `gog calendar (cal) respond (rsvp,reply) <calendarId> <eventId> [flags]` - Respond to an event invitation
-- `gog calendar (cal) search (find,query) <query> [flags]` - Search events
-- `gog calendar (cal) subscribe (sub,add-calendar) <calendarId> [flags]` - Add a calendar to your calendar list
-- `gog calendar (cal) team <group-email> [flags]` - Show events for all members of a Google Group
-- `gog calendar (cal) time [flags]` - Show server time
-- `gog calendar (cal) update (edit,set) <calendarId> <eventId> [flags]` - Update an event
-- `gog calendar (cal) users [flags]` - List workspace users (use their email as calendar ID)
-- `gog calendar (cal) working-location (wl) --from=STRING --to=STRING --type=STRING [<calendarId>] [flags]` - Set working location (home/office/custom)
-- `gog chat <command> [flags]` - Google Chat
-- `gog chat dm <command>` - Direct messages
-- `gog chat dm send (create,post) <email> [flags]` - Send a direct message
-- `gog chat dm space (find,setup) <email>` - Find or create a DM space
-- `gog chat messages <command>` - Chat messages
-- `gog chat messages list (ls) <space> [flags]` - List messages
-- `gog chat messages react <message> <emoji> [flags]` - Add an emoji reaction to a message
-- `gog chat messages reactions (reaction) <command>` - Manage emoji reactions on a message
-- `gog chat messages reactions (reaction) create (add) <message> <emoji> [flags]` - Add an emoji reaction to a message
-- `gog chat messages reactions (reaction) delete (remove,rm) <reaction>` - Delete a reaction
-- `gog chat messages reactions (reaction) list (ls) <message> [flags]` - List reactions on a message
-- `gog chat messages send (create,post) <space> [flags]` - Send a message
-- `gog chat spaces <command>` - Chat spaces
-- `gog chat spaces create (add,new) <displayName> [flags]` - Create a space
-- `gog chat spaces find (search,query) <displayName> [flags]` - Find spaces by display name
-- `gog chat spaces list (ls) [flags]` - List spaces
-- `gog chat threads <command>` - Chat threads
-- `gog chat threads list <space> [flags]` - List threads in a space
-- `gog classroom (class) <command> [flags]` - Google Classroom
-- `gog classroom (class) announcements (announcement,ann) <command>` - Announcements
-- `gog classroom (class) announcements (announcement,ann) assignees (assign) <courseId> <announcementId> [flags]` - Modify announcement assignees
-- `gog classroom (class) announcements (announcement,ann) create (add,new) --text=STRING <courseId> [flags]` - Create an announcement
-- `gog classroom (class) announcements (announcement,ann) delete (rm,del,remove) <courseId> <announcementId>` - Delete an announcement
-- `gog classroom (class) announcements (announcement,ann) get (info,show) <courseId> <announcementId>` - Get an announcement
-- `gog classroom (class) announcements (announcement,ann) list (ls) <courseId> [flags]` - List announcements
-- `gog classroom (class) announcements (announcement,ann) update (edit,set) <courseId> <announcementId> [flags]` - Update an announcement
-- `gog classroom (class) courses (course) <command>` - Courses
-- `gog classroom (class) courses (course) archive (arch) <courseId>` - Archive a course
-- `gog classroom (class) courses (course) create (add,new) --name=STRING [flags]` - Create a course
-- `gog classroom (class) courses (course) delete (rm,del,remove) <courseId>` - Delete a course
-- `gog classroom (class) courses (course) get (info,show) <courseId>` - Get a course
-- `gog classroom (class) courses (course) join (enroll) <courseId> [flags]` - Join a course
-- `gog classroom (class) courses (course) leave (unenroll) <courseId> [flags]` - Leave a course
-- `gog classroom (class) courses (course) list (ls) [flags]` - List courses
-- `gog classroom (class) courses (course) unarchive (unarch,restore) <courseId>` - Unarchive a course
-- `gog classroom (class) courses (course) update (edit,set) <courseId> [flags]` - Update a course
-- `gog classroom (class) courses (course) url (link) <courseId> ...` - Print Classroom web URLs for courses
-- `gog classroom (class) coursework (work) <command>` - Coursework
-- `gog classroom (class) coursework (work) assignees (assign) <courseId> <courseworkId> [flags]` - Modify coursework assignees
-- `gog classroom (class) coursework (work) create (add,new) --title=STRING <courseId> [flags]` - Create coursework
-- `gog classroom (class) coursework (work) delete (rm,del,remove) <courseId> <courseworkId>` - Delete coursework
-- `gog classroom (class) coursework (work) get (info,show) <courseId> <courseworkId>` - Get coursework
-- `gog classroom (class) coursework (work) list (ls) <courseId> [flags]` - List coursework
-- `gog classroom (class) coursework (work) update (edit,set) <courseId> <courseworkId> [flags]` - Update coursework
-- `gog classroom (class) guardian-invitations (guardian-invites) <command>` - Guardian invitations
-- `gog classroom (class) guardian-invitations (guardian-invites) create (add,new) --email=STRING <studentId>` - Create a guardian invitation
-- `gog classroom (class) guardian-invitations (guardian-invites) get (info,show) <studentId> <invitationId>` - Get a guardian invitation
-- `gog classroom (class) guardian-invitations (guardian-invites) list (ls) <studentId> [flags]` - List guardian invitations
-- `gog classroom (class) guardians (guardian) <command>` - Guardians
-- `gog classroom (class) guardians (guardian) delete (rm,del,remove) <studentId> <guardianId>` - Delete a guardian
-- `gog classroom (class) guardians (guardian) get (info,show) <studentId> <guardianId>` - Get a guardian
-- `gog classroom (class) guardians (guardian) list (ls) <studentId> [flags]` - List guardians
-- `gog classroom (class) invitations (invitation,invites) <command>` - Invitations
-- `gog classroom (class) invitations (invitation,invites) accept (join) <invitationId>` - Accept an invitation
-- `gog classroom (class) invitations (invitation,invites) create (add,new) --role=STRING <courseId> <userId>` - Create an invitation
-- `gog classroom (class) invitations (invitation,invites) delete (rm,del,remove) <invitationId>` - Delete an invitation
-- `gog classroom (class) invitations (invitation,invites) get (info,show) <invitationId>` - Get an invitation
-- `gog classroom (class) invitations (invitation,invites) list (ls) [flags]` - List invitations
-- `gog classroom (class) materials (material) <command>` - Coursework materials
-- `gog classroom (class) materials (material) create (add,new) --title=STRING <courseId> [flags]` - Create coursework material
-- `gog classroom (class) materials (material) delete (rm,del,remove) <courseId> <materialId>` - Delete coursework material
-- `gog classroom (class) materials (material) get (info,show) <courseId> <materialId>` - Get coursework material
-- `gog classroom (class) materials (material) list (ls) <courseId> [flags]` - List coursework materials
-- `gog classroom (class) materials (material) update (edit,set) <courseId> <materialId> [flags]` - Update coursework material
-- `gog classroom (class) profile (me) <command>` - User profiles
-- `gog classroom (class) profile (me) get [<userId>]` - Get a user profile
-- `gog classroom (class) roster (members) <courseId> [flags]` - Course roster (students + teachers)
-- `gog classroom (class) students (student) <command>` - Course students
-- `gog classroom (class) students (student) add (create,new) <courseId> <userId> [flags]` - Add a student
-- `gog classroom (class) students (student) get (info,show) <courseId> <userId>` - Get a student
-- `gog classroom (class) students (student) list (ls) <courseId> [flags]` - List students
-- `gog classroom (class) students (student) remove (delete,rm,del,remove) <courseId> <userId>` - Remove a student
-- `gog classroom (class) submissions (submission) <command>` - Student submissions
-- `gog classroom (class) submissions (submission) get (info,show) <courseId> <courseworkId> <submissionId>` - Get a student submission
-- `gog classroom (class) submissions (submission) grade (set,edit) <courseId> <courseworkId> <submissionId> [flags]` - Set draft/assigned grades
-- `gog classroom (class) submissions (submission) list (ls) <courseId> <courseworkId> [flags]` - List student submissions
-- `gog classroom (class) submissions (submission) reclaim (undo) <courseId> <courseworkId> <submissionId>` - Reclaim a submission
-- `gog classroom (class) submissions (submission) return (send) <courseId> <courseworkId> <submissionId>` - Return a submission
-- `gog classroom (class) submissions (submission) turn-in (turnin) <courseId> <courseworkId> <submissionId>` - Turn in a submission
-- `gog classroom (class) teachers (teacher) <command>` - Course teachers
-- `gog classroom (class) teachers (teacher) add (create,new) <courseId> <userId>` - Add a teacher
-- `gog classroom (class) teachers (teacher) get (info,show) <courseId> <userId>` - Get a teacher
-- `gog classroom (class) teachers (teacher) list (ls) <courseId> [flags]` - List teachers
-- `gog classroom (class) teachers (teacher) remove (delete,rm,del,remove) <courseId> <userId>` - Remove a teacher
-- `gog classroom (class) topics (topic) <command>` - Topics
-- `gog classroom (class) topics (topic) create (add,new) --name=STRING <courseId>` - Create a topic
-- `gog classroom (class) topics (topic) delete (rm,del,remove) <courseId> <topicId>` - Delete a topic
-- `gog classroom (class) topics (topic) get (info,show) <courseId> <topicId>` - Get a topic
-- `gog classroom (class) topics (topic) list (ls) <courseId> [flags]` - List topics
-- `gog classroom (class) topics (topic) update (edit,set) --name=STRING <courseId> <topicId>` - Update a topic
-- `gog completion <shell> [flags]` - Generate shell completion scripts
-- `gog config <command> [flags]` - Manage configuration
-- `gog config get (show) <key>` - Get a config value
-- `gog config keys (list-keys,names)` - List available config keys
-- `gog config list (ls,all)` - List all config values
-- `gog config no-send (nosend) <command>` - Manage per-account Gmail no-send guards
-- `gog config no-send (nosend) list (ls)` - List accounts with no-send guards
-- `gog config no-send (nosend) remove (rm,del,delete,unset,disable) <account>` - Remove an account no-send guard
-- `gog config no-send (nosend) set (add,enable) <account>` - Block Gmail send operations for an account
-- `gog config path (where)` - Print config file path
-- `gog config set (add,update) <key> <value>` - Set a config value
-- `gog config unset (rm,del,remove) <key>` - Unset a config value
-- `gog contacts (contact) <command> [flags]` - Google Contacts
-- `gog contacts (contact) create (add,new) [flags]` - Create a contact
-- `gog contacts (contact) delete (rm,del,remove) <resourceName>` - Delete a contact
-- `gog contacts (contact) directory <command>` - Directory contacts
-- `gog contacts (contact) directory list [flags]` - List people from the Workspace directory
-- `gog contacts (contact) directory search <query> ... [flags]` - Search people in the Workspace directory
-- `gog contacts (contact) export [<selector>] [flags]` - Export contacts as vCard (.vcf)
-- `gog contacts (contact) get (info,show) <resourceName>` - Get a contact
-- `gog contacts (contact) list (ls) [flags]` - List contacts
-- `gog contacts (contact) other <command>` - Other contacts
-- `gog contacts (contact) other delete <resourceName>` - Delete an other contact
-- `gog contacts (contact) other list [flags]` - List other contacts
-- `gog contacts (contact) other search <query> ... [flags]` - Search other contacts
-- `gog contacts (contact) search <query> ... [flags]` - Search contacts by name/email/phone
-- `gog contacts (contact) update (edit,set) <resourceName> [flags]` - Update a contact
-- `gog docs (doc) <command> [flags]` - Google Docs (export via Drive)
-- `gog docs (doc) add-tab <docId> [flags]` - Add a tab to a Google Doc
-- `gog docs (doc) cat (text,read) <docId> [flags]` - Print a Google Doc as plain text
-- `gog docs (doc) clear <docId>` - Clear all content from a Google Doc
-- `gog docs (doc) comments <command>` - Manage comments on files
-- `gog docs (doc) comments add (create,new) <docId> <content> [flags]` - Add a comment to a Google Doc
-- `gog docs (doc) comments delete (rm,del,remove) <docId> <commentId>` - Delete a comment
-- `gog docs (doc) comments get (info,show) <docId> <commentId>` - Get a comment by ID
-- `gog docs (doc) comments list (ls) <docId> [flags]` - List comments on a Google Doc
-- `gog docs (doc) comments reply (respond) <docId> <commentId> <content>` - Reply to a comment
-- `gog docs (doc) comments resolve <docId> <commentId> [flags]` - Resolve a comment (mark as done)
-- `gog docs (doc) copy (cp,duplicate) <docId> <title> [flags]` - Copy a Google Doc
-- `gog docs (doc) create (add,new) <title> [flags]` - Create a Google Doc
-- `gog docs (doc) delete --start=INT-64 --end=INT-64 <docId> [flags]` - Delete text range from document
-- `gog docs (doc) delete-tab <docId> [flags]` - Delete a tab from a Google Doc
-- `gog docs (doc) edit <docId> <find> <replace> [flags]` - Find and replace text in a Google Doc
-- `gog docs (doc) export (download,dl) <docId> [flags]` - Export a Google Doc (pdf|docx|txt|md|html)
-- `gog docs (doc) find-replace <docId> <find> [<replace>] [flags]` - Find and replace text. Supports plain text or markdown with images; use --first for a single occurrence.
-- `gog docs (doc) info (get,show) <docId>` - Get Google Doc metadata
-- `gog docs (doc) insert <docId> [<content>] [flags]` - Insert text at a specific position
-- `gog docs (doc) list-tabs <docId>` - List all tabs in a Google Doc
-- `gog docs (doc) rename-tab <docId> [flags]` - Rename a tab in a Google Doc
-- `gog docs (doc) sed <docId> [<expression>] [flags]` - Regex find/replace (sed-style: s/pattern/replacement/g)
-- `gog docs (doc) structure (struct) <docId> [flags]` - Show document structure with numbered paragraphs
-- `gog docs (doc) update <docId> [flags]` - Insert text at a specific index in a Google Doc
-- `gog docs (doc) write <docId> [flags]` - Write content to a Google Doc
-- `gog download (dl) <fileId> [flags]` - Download a Drive file (alias for 'drive download')
-- `gog drive (drv) <command> [flags]` - Google Drive
-- `gog drive (drv) comments <command>` - Manage comments on files
-- `gog drive (drv) comments create (add,new) <fileId> <content> [flags]` - Create a comment on a file
-- `gog drive (drv) comments delete (rm,del,remove) <fileId> <commentId>` - Delete a comment
-- `gog drive (drv) comments get (info,show) <fileId> <commentId>` - Get a comment by ID
-- `gog drive (drv) comments list (ls) <fileId> [flags]` - List comments on a file
-- `gog drive (drv) comments reply (respond) <fileId> <commentId> <content>` - Reply to a comment
-- `gog drive (drv) comments update (edit,set) <fileId> <commentId> <content>` - Update a comment
-- `gog drive (drv) copy <fileId> <name> [flags]` - Copy a file
-- `gog drive (drv) delete (rm,del) <fileId> [flags]` - Move a file to trash (use --permanent to delete forever)
-- `gog drive (drv) download <fileId> [flags]` - Download a file (exports Google Docs formats)
-- `gog drive (drv) drives [flags]` - List shared drives (Team Drives)
-- `gog drive (drv) get <fileId>` - Get file metadata
-- `gog drive (drv) ls [flags]` - List files in a folder (default: root)
-- `gog drive (drv) mkdir <name> [flags]` - Create a folder
-- `gog drive (drv) move <fileId> [flags]` - Move a file to a different folder
-- `gog drive (drv) permissions <fileId> [flags]` - List permissions on a file
-- `gog drive (drv) rename <fileId> <newName>` - Rename a file or folder
-- `gog drive (drv) search <query> ... [flags]` - Full-text search across Drive
-- `gog drive (drv) share <fileId> [flags]` - Share a file or folder
-- `gog drive (drv) unshare <fileId> <permissionId>` - Remove a permission from a file
-- `gog drive (drv) upload <localPath> [flags]` - Upload a file
-- `gog drive (drv) url <fileId> ...` - Print web URLs for files
-- `gog exit-codes (exitcodes) [flags]` - Print stable exit codes (alias for 'agent exit-codes')
-- `gog forms (form) <command> [flags]` - Google Forms
-- `gog forms (form) add-question (add-q,aq) --title=STRING <formId> [flags]` - Add a question to a form
-- `gog forms (form) create (new) --title=STRING [flags]` - Create a form
-- `gog forms (form) delete-question (delete-q,dq,rm-q) <formId> <index>` - Delete a question by index
-- `gog forms (form) get (info,show) <formId>` - Get a form
-- `gog forms (form) move-question (move-q,mq) <formId> <oldIndex> <newIndex>` - Move a question to a new position
-- `gog forms (form) responses <command>` - Form responses
-- `gog forms (form) responses get (info,show) <formId> <responseId>` - Get a form response
-- `gog forms (form) responses list (ls) <formId> [flags]` - List form responses
-- `gog forms (form) update (edit) <formId> [flags]` - Update form title, description, or settings
-- `gog forms (form) watch (watches) <command>` - Response watches (push notifications)
-- `gog forms (form) watch (watches) create (new,add) --topic=STRING <formId> [flags]` - Create a watch for new responses
-- `gog forms (form) watch (watches) delete (rm,remove) <formId> <watchId>` - Delete a watch
-- `gog forms (form) watch (watches) list (ls) <formId>` - List active watches
-- `gog forms (form) watch (watches) renew (refresh) <formId> <watchId>` - Renew a watch (extends 7 days)
-- `gog gmail (mail,email) <command> [flags]` - Gmail
-- `gog gmail (mail,email) archive [<messageId> ...] [flags]` - Archive messages (remove from inbox)
-- `gog gmail (mail,email) attachment <messageId> <attachmentId> [flags]` - Download a single attachment
-- `gog gmail (mail,email) autoreply <query> ... [flags]` - Reply once to matching messages
-- `gog gmail (mail,email) batch <command>` - Batch operations (permanent delete requires broader Gmail scope; use gmail trash for normal trashing)
-- `gog gmail (mail,email) batch delete (rm,del,remove) <messageId> ...` - Permanently delete multiple messages; use 'gmail trash' to move messages to trash with the default gmail.modify scope
-- `gog gmail (mail,email) batch modify (update,edit,set) <messageId> ... [flags]` - Modify labels on multiple messages
-- `gog gmail (mail,email) drafts (draft) <command>` - Draft operations
-- `gog gmail (mail,email) drafts (draft) create (add,new) [flags]` - Create a draft
-- `gog gmail (mail,email) drafts (draft) delete (rm,del,remove) <draftId>` - Delete a draft
-- `gog gmail (mail,email) drafts (draft) get (info,show) <draftId> [flags]` - Get draft details
-- `gog gmail (mail,email) drafts (draft) list (ls) [flags]` - List drafts
-- `gog gmail (mail,email) drafts (draft) send (post) <draftId>` - Send a draft
-- `gog gmail (mail,email) drafts (draft) update (edit,set) <draftId> [flags]` - Update a draft
-- `gog gmail (mail,email) forward (fwd) --to=STRING <messageId> [flags]` - Forward a message to new recipients
-- `gog gmail (mail,email) get (info,show) <messageId> [flags]` - Get a message (full|metadata|raw)
-- `gog gmail (mail,email) history [flags]` - Gmail history
-- `gog gmail (mail,email) labels (label) <command>` - Label operations
-- `gog gmail (mail,email) labels (label) create (add,new) <name>` - Create a new label
-- `gog gmail (mail,email) labels (label) delete (rm,del) <labelIdOrName>` - Delete a label
-- `gog gmail (mail,email) labels (label) get (info,show) <labelIdOrName>` - Get label details (including counts)
-- `gog gmail (mail,email) labels (label) list (ls)` - List labels
-- `gog gmail (mail,email) labels (label) modify (update,edit,set) <threadId> ... [flags]` - Modify labels on threads
-- `gog gmail (mail,email) labels (label) rename (mv) <labelIdOrName> <newName>` - Rename a label
-- `gog gmail (mail,email) labels (label) style (color,colour) <labelIdOrName> [flags]` - Change a user label color or visibility
-- `gog gmail (mail,email) mark-read (read-messages) [<messageId> ...] [flags]` - Mark messages as read
-- `gog gmail (mail,email) messages (message,msg,msgs) <command>` - Message operations
-- `gog gmail (mail,email) messages (message,msg,msgs) modify (update,edit,set) <messageId> [flags]` - Modify labels on a single message
-- `gog gmail (mail,email) messages (message,msg,msgs) search (find,query,ls,list) <query> ... [flags]` - Search messages using Gmail query syntax
-- `gog gmail (mail,email) search (find,query,ls,list) <query> ... [flags]` - Search threads using Gmail query syntax
-- `gog gmail (mail,email) send [flags]` - Send an email
-- `gog gmail (mail,email) settings <command>` - Settings and admin
-- `gog gmail (mail,email) settings autoforward <command>` - Auto-forwarding settings
-- `gog gmail (mail,email) settings autoforward get (info,show)` - Get current auto-forwarding settings
-- `gog gmail (mail,email) settings autoforward update (edit,set) [flags]` - Update auto-forwarding settings
-- `gog gmail (mail,email) settings delegates <command>` - Delegate operations
-- `gog gmail (mail,email) settings delegates add (create,new) <delegateEmail>` - Add a delegate
-- `gog gmail (mail,email) settings delegates get (info,show) <delegateEmail>` - Get a specific delegate's information
-- `gog gmail (mail,email) settings delegates list (ls)` - List all delegates
-- `gog gmail (mail,email) settings delegates remove (delete,rm,del) <delegateEmail>` - Remove a delegate
-- `gog gmail (mail,email) settings filters <command>` - Filter operations
-- `gog gmail (mail,email) settings filters create (add,new) [flags]` - Create a new email filter
-- `gog gmail (mail,email) settings filters delete (rm,del,remove) <filterId>` - Delete a filter
-- `gog gmail (mail,email) settings filters export [flags]` - Export filters as JSON
-- `gog gmail (mail,email) settings filters get (info,show) <filterId>` - Get a specific filter
-- `gog gmail (mail,email) settings filters list (ls)` - List all email filters
-- `gog gmail (mail,email) settings forwarding <command>` - Forwarding addresses
-- `gog gmail (mail,email) settings forwarding create (add,new) <forwardingEmail>` - Create/add a forwarding address
-- `gog gmail (mail,email) settings forwarding delete (rm,del,remove) <forwardingEmail>` - Delete a forwarding address
-- `gog gmail (mail,email) settings forwarding get (info,show) <forwardingEmail>` - Get a specific forwarding address
-- `gog gmail (mail,email) settings forwarding list (ls)` - List all forwarding addresses
-- `gog gmail (mail,email) settings sendas <command>` - Send-as settings
-- `gog gmail (mail,email) settings sendas create (add,new) <email> [flags]` - Create a new send-as alias
-- `gog gmail (mail,email) settings sendas delete (rm,del,remove) <email>` - Delete a send-as alias
-- `gog gmail (mail,email) settings sendas get (info,show) <email>` - Get details of a send-as alias
-- `gog gmail (mail,email) settings sendas list (ls)` - List send-as aliases
-- `gog gmail (mail,email) settings sendas update (edit,set) <email> [flags]` - Update a send-as alias
-- `gog gmail (mail,email) settings sendas verify (resend) <email>` - Resend verification email for a send-as alias
-- `gog gmail (mail,email) settings vacation <command>` - Vacation responder
-- `gog gmail (mail,email) settings vacation get (info,show)` - Get current vacation responder settings
-- `gog gmail (mail,email) settings vacation update (edit,set) [flags]` - Update vacation responder settings
-- `gog gmail (mail,email) settings watch <command>` - Manage Gmail watch
-- `gog gmail (mail,email) settings watch renew (update) [flags]` - Renew Gmail watch using stored config
-- `gog gmail (mail,email) settings watch serve [flags]` - Run Pub/Sub push handler
-- `gog gmail (mail,email) settings watch start (begin) [flags]` - Start Gmail watch for Pub/Sub
-- `gog gmail (mail,email) settings watch status (ls) [flags]` - Show stored watch state
-- `gog gmail (mail,email) settings watch stop (rm,delete)` - Stop Gmail watch and clear stored state
-- `gog gmail (mail,email) thread (threads,read) <command>` - Thread operations (get, modify)
-- `gog gmail (mail,email) thread (threads,read) attachments (files) <threadId> [flags]` - List all attachments in a thread
-- `gog gmail (mail,email) thread (threads,read) get (info,show) <threadId> [flags]` - Get a thread with all messages (optionally download attachments)
-- `gog gmail (mail,email) thread (threads,read) modify (update,edit,set) <threadId> [flags]` - Modify labels on all messages in a thread
-- `gog gmail (mail,email) track <command>` - Email open tracking
-- `gog gmail (mail,email) track key <command>` - Manage tracking encryption keys
-- `gog gmail (mail,email) track key rotate [flags]` - Rotate tracking encryption key
-- `gog gmail (mail,email) track opens [<tracking-id>] [flags]` - Query email opens
-- `gog gmail (mail,email) track setup [flags]` - Set up email tracking (deploy Cloudflare Worker)
-- `gog gmail (mail,email) track status` - Show tracking configuration status
-- `gog gmail (mail,email) trash [<messageId> ...] [flags]` - Move messages to trash
-- `gog gmail (mail,email) unread (mark-unread) [<messageId> ...] [flags]` - Mark messages as unread
-- `gog gmail (mail,email) url <threadId> ...` - Print Gmail web URLs for threads
-- `gog groups (group) <command> [flags]` - Google Groups
-- `gog groups (group) list (ls) [flags]` - List groups you belong to
-- `gog groups (group) members <groupEmail> [flags]` - List members of a group
-- `gog keep <command> [flags]` - Google Keep (Workspace only)
-- `gog keep attachment <attachmentName> [flags]` - Download an attachment
-- `gog keep create [flags]` - Create a new note
-- `gog keep delete <noteId> [flags]` - Delete a note
-- `gog keep get <noteId> [flags]` - Get a note
-- `gog keep list [flags]` - List notes
-- `gog keep search <query> [flags]` - Search notes by text (client-side)
-- `gog login <email> [flags]` - Authorize and store a refresh token (alias for 'auth add')
-- `gog logout <email> [flags]` - Remove a stored refresh token (alias for 'auth remove')
-- `gog ls (list) [flags]` - List Drive files (alias for 'drive ls')
-- `gog me [flags]` - Show your profile (alias for 'people me')
-- `gog open (browse) <target> [flags]` - Print a best-effort web URL for a Google URL/ID (offline)
-- `gog people (person) <command> [flags]` - Google People
-- `gog people (person) get (info,show) <userId>` - Get a user profile by ID
-- `gog people (person) me` - Show your profile (people/me)
-- `gog people (person) relations [<userId>] [flags]` - Get user relations
-- `gog people (person) search (find,query) <query> ... [flags]` - Search the Workspace directory
-- `gog schema (help-json,helpjson) [<command> ...] [flags]` - Machine-readable command/flag schema
-- `gog search (find) <query> ... [flags]` - Search Drive files (alias for 'drive search')
-- `gog send [flags]` - Send an email (alias for 'gmail send')
-- `gog sheets (sheet) <command> [flags]` - Google Sheets
-- `gog sheets (sheet) add-tab (add-sheet) <spreadsheetId> <tabName> [flags]` - Add a new tab/sheet to a spreadsheet
-- `gog sheets (sheet) append (add) <spreadsheetId> <range> [<values> ...] [flags]` - Append values to a range
-- `gog sheets (sheet) chart (charts) <command>` - Manage spreadsheet charts
-- `gog sheets (sheet) chart (charts) create (add,new) --spec-json=STRING <spreadsheetId> [flags]` - Create a chart from a JSON spec
-- `gog sheets (sheet) chart (charts) delete (rm,remove,del) <spreadsheetId> <chartId>` - Delete a chart
-- `gog sheets (sheet) chart (charts) get (show,info) <spreadsheetId> <chartId>` - Get full chart definition (spec + position)
-- `gog sheets (sheet) chart (charts) list <spreadsheetId>` - List charts in a spreadsheet
-- `gog sheets (sheet) chart (charts) update (edit,set) --spec-json=STRING <spreadsheetId> <chartId>` - Update a chart spec
-- `gog sheets (sheet) clear <spreadsheetId> <range>` - Clear values in a range
-- `gog sheets (sheet) copy (cp,duplicate) <spreadsheetId> <title> [flags]` - Copy a Google Sheet
-- `gog sheets (sheet) create (new) <title> [flags]` - Create a new spreadsheet
-- `gog sheets (sheet) delete-tab (delete-sheet) <spreadsheetId> <tabName>` - Delete a tab/sheet from a spreadsheet (use --force to skip confirmation)
-- `gog sheets (sheet) export (download,dl) <spreadsheetId> [flags]` - Export a Google Sheet (pdf|xlsx|csv) via Drive
-- `gog sheets (sheet) find-replace <spreadsheetId> <find> <replace> [flags]` - Find and replace text across a spreadsheet
-- `gog sheets (sheet) format <spreadsheetId> <range> [flags]` - Apply cell formatting to a range
-- `gog sheets (sheet) freeze <spreadsheetId> [flags]` - Freeze rows and columns on a sheet
-- `gog sheets (sheet) get (read,show) <spreadsheetId> <range> [flags]` - Get values from a range
-- `gog sheets (sheet) insert <spreadsheetId> <sheet> <dimension> <start> [flags]` - Insert empty rows or columns into a sheet
-- `gog sheets (sheet) links (hyperlinks) <spreadsheetId> <range>` - Get cell hyperlinks from a range
-- `gog sheets (sheet) merge <spreadsheetId> <range> [flags]` - Merge cells in a range
-- `gog sheets (sheet) metadata (info) <spreadsheetId>` - Get spreadsheet metadata
-- `gog sheets (sheet) named-ranges (namedranges,nr) <command>` - Manage named ranges
-- `gog sheets (sheet) named-ranges (namedranges,nr) add (create,new) <spreadsheetId> <name> <range>` - Add a named range
-- `gog sheets (sheet) named-ranges (namedranges,nr) delete (rm,remove,del) <spreadsheetId> <nameOrId>` - Delete a named range
-- `gog sheets (sheet) named-ranges (namedranges,nr) get (show,info) <spreadsheetId> <nameOrId>` - Get a named range
-- `gog sheets (sheet) named-ranges (namedranges,nr) list <spreadsheetId>` - List named ranges
-- `gog sheets (sheet) named-ranges (namedranges,nr) update (edit,set) <spreadsheetId> <nameOrId> [flags]` - Update a named range
-- `gog sheets (sheet) notes <spreadsheetId> <range>` - Get cell notes from a range
-- `gog sheets (sheet) number-format <spreadsheetId> <range> [flags]` - Apply number format to a range
-- `gog sheets (sheet) read-format (get-format,format-read) <spreadsheetId> <range> [flags]` - Read cell formatting from a range
-- `gog sheets (sheet) rename-tab (rename-sheet) <spreadsheetId> <oldName> <newName>` - Rename a tab/sheet in a spreadsheet
-- `gog sheets (sheet) resize-columns <spreadsheetId> <columns> [flags]` - Resize sheet columns
-- `gog sheets (sheet) resize-rows <spreadsheetId> <rows> [flags]` - Resize sheet rows
-- `gog sheets (sheet) unmerge <spreadsheetId> <range>` - Unmerge cells in a range
-- `gog sheets (sheet) update (edit,set) <spreadsheetId> <range> [<values> ...] [flags]` - Update values in a range
-- `gog sheets (sheet) update-note (set-note) <spreadsheetId> <range> [flags]` - Set or clear a cell note
-- `gog slides (slide) <command> [flags]` - Google Slides
-- `gog slides (slide) add-slide <presentationId> <image> [flags]` - Add a slide with a full-bleed image and optional speaker notes
-- `gog slides (slide) copy (cp,duplicate) <presentationId> <title> [flags]` - Copy a Google Slides presentation
-- `gog slides (slide) create (add,new) <title> [flags]` - Create a Google Slides presentation
-- `gog slides (slide) create-from-markdown <title> [flags]` - Create a Google Slides presentation from markdown
-- `gog slides (slide) create-from-template <templateId> <title> [flags]` - Create a presentation from template with text replacements
-- `gog slides (slide) delete-slide <presentationId> <slideId>` - Delete a slide by object ID
-- `gog slides (slide) export (download,dl) <presentationId> [flags]` - Export a Google Slides deck (pdf|pptx)
-- `gog slides (slide) info (get,show) <presentationId>` - Get Google Slides presentation metadata
-- `gog slides (slide) insert-text <presentationId> <objectId> <text> [flags]` - Insert text into an existing page element (shape or table) by objectId
-- `gog slides (slide) list-slides <presentationId>` - List all slides with their object IDs
-- `gog slides (slide) read-slide <presentationId> <slideId>` - Read slide content: speaker notes, text elements, and images
-- `gog slides (slide) replace-slide <presentationId> <slideId> <image> [flags]` - Replace the image on an existing slide in-place
-- `gog slides (slide) replace-text <presentationId> <find> <replacement> [flags]` - Find-and-replace text across a presentation
-- `gog slides (slide) thumbnail (thumb) <presentationId> <slideId> [flags]` - Get or download a rendered thumbnail for a slide
-- `gog slides (slide) update-notes <presentationId> <slideId> [flags]` - Update speaker notes on an existing slide
-- `gog status (st) [flags]` - Show auth/config status (alias for 'auth status')
-- `gog tasks (task) <command> [flags]` - Google Tasks
-- `gog tasks (task) add (create) <tasklistId> [flags]` - Add a task
-- `gog tasks (task) clear <tasklistId>` - Clear completed tasks
-- `gog tasks (task) delete (rm,del,remove) <tasklistId> <taskId>` - Delete a task
-- `gog tasks (task) done (complete) <tasklistId> <taskId>` - Mark task completed
-- `gog tasks (task) get (info,show) <tasklistId> <taskId>` - Get a task
-- `gog tasks (task) list (ls) <tasklistId> [flags]` - List tasks
-- `gog tasks (task) lists <command>` - List task lists
-- `gog tasks (task) lists create (add,new) <title> ...` - Create a task list
-- `gog tasks (task) lists list [flags]` - List task lists
-- `gog tasks (task) undo (uncomplete,undone) <tasklistId> <taskId>` - Mark task needs action
-- `gog tasks (task) update (edit,set) <tasklistId> <taskId> [flags]` - Update a task
-- `gog time <command> [flags]` - Local time utilities
-- `gog time now [flags]` - Show current time
-- `gog upload (up,put) <localPath> [flags]` - Upload a file to Drive (alias for 'drive upload')
-- `gog version [flags]` - Print version
-- `gog whoami (who-am-i) [flags]` - Show your profile (alias for 'people me')
+- [`gog <command> [flags]`](commands/gog.md) - Google CLI for Gmail/Calendar/Chat/Classroom/Drive/Contacts/Tasks/Sheets/Docs/Slides/People/Forms/App Script/Ads/Groups/Admin/Keep
+  - [`gog admin <command> [flags]`](commands/gog-admin.md) - Google Workspace Admin (Directory API) - requires domain-wide delegation
+    - [`gog admin groups <command>`](commands/gog-admin-groups.md) - Manage Workspace groups
+      - [`gog admin groups list (ls) [flags]`](commands/gog-admin-groups-list.md) - List groups in a domain
+      - [`gog admin groups members <command>`](commands/gog-admin-groups-members.md) - Manage group members
+        - [`gog admin groups members add (invite) <groupEmail> <memberEmail> [flags]`](commands/gog-admin-groups-members-add.md) - Add a member to a group
+        - [`gog admin groups members list (ls) <groupEmail> [flags]`](commands/gog-admin-groups-members-list.md) - List group members
+        - [`gog admin groups members remove (rm,del,delete) <groupEmail> <memberEmail>`](commands/gog-admin-groups-members-remove.md) - Remove a member from a group
+    - [`gog admin users <command>`](commands/gog-admin-users.md) - Manage Workspace users
+      - [`gog admin users create (add,new) <email> [flags]`](commands/gog-admin-users-create.md) - Create a new user
+      - [`gog admin users get (info,show) <userEmail>`](commands/gog-admin-users-get.md) - Get user details
+      - [`gog admin users list (ls) [flags]`](commands/gog-admin-users-list.md) - List users in a domain
+      - [`gog admin users suspend <userEmail>`](commands/gog-admin-users-suspend.md) - Suspend a user account
+  - [`gog agent <command> [flags]`](commands/gog-agent.md) - Agent-friendly helpers
+    - [`gog agent exit-codes (exitcodes,exit-code)`](commands/gog-agent-exit-codes.md) - Print stable exit codes for automation
+  - [`gog appscript (script,apps-script) <command> [flags]`](commands/gog-appscript.md) - Google Apps Script
+    - [`gog appscript (script,apps-script) content (cat) <scriptId>`](commands/gog-appscript-content.md) - Get Apps Script project content
+    - [`gog appscript (script,apps-script) create (new) --title=STRING [flags]`](commands/gog-appscript-create.md) - Create an Apps Script project
+    - [`gog appscript (script,apps-script) get (info,show) <scriptId>`](commands/gog-appscript-get.md) - Get Apps Script project metadata
+    - [`gog appscript (script,apps-script) run <scriptId> <function> [flags]`](commands/gog-appscript-run.md) - Run a deployed Apps Script function
+  - [`gog auth <command> [flags]`](commands/gog-auth.md) - Auth and credentials
+    - [`gog auth add <email> [flags]`](commands/gog-auth-add.md) - Authorize and store a refresh token
+    - [`gog auth alias <command>`](commands/gog-auth-alias.md) - Manage account aliases
+      - [`gog auth alias list`](commands/gog-auth-alias-list.md) - List account aliases
+      - [`gog auth alias set <alias> <email>`](commands/gog-auth-alias-set.md) - Set an account alias
+      - [`gog auth alias unset <alias>`](commands/gog-auth-alias-unset.md) - Remove an account alias
+    - [`gog auth credentials <command>`](commands/gog-auth-credentials.md) - Manage OAuth client credentials
+      - [`gog auth credentials list`](commands/gog-auth-credentials-list.md) - List stored OAuth client credentials
+      - [`gog auth credentials remove [<client>]`](commands/gog-auth-credentials-remove.md) - Remove stored OAuth client credentials
+      - [`gog auth credentials set <credentials> [flags]`](commands/gog-auth-credentials-set.md) - Store OAuth client credentials
+    - [`gog auth doctor [flags]`](commands/gog-auth-doctor.md) - Diagnose auth, keyring, and refresh-token issues
+    - [`gog auth keep --key=STRING <email>`](commands/gog-auth-keep.md) - Configure service account for Google Keep (Workspace only)
+    - [`gog auth keyring [<backend> [<backend2>]]`](commands/gog-auth-keyring.md) - Configure keyring backend
+    - [`gog auth list [flags]`](commands/gog-auth-list.md) - List stored accounts
+    - [`gog auth manage (login) [flags]`](commands/gog-auth-manage.md) - Open accounts manager in browser
+    - [`gog auth remove <email>`](commands/gog-auth-remove.md) - Remove a stored refresh token
+    - [`gog auth service-account <command>`](commands/gog-auth-service-account.md) - Configure service account (Workspace only; domain-wide delegation)
+      - [`gog auth service-account set --key=STRING <email>`](commands/gog-auth-service-account-set.md) - Store a service account key for impersonation
+      - [`gog auth service-account status <email>`](commands/gog-auth-service-account-status.md) - Show stored service account key status
+      - [`gog auth service-account unset <email>`](commands/gog-auth-service-account-unset.md) - Remove stored service account key
+    - [`gog auth services [flags]`](commands/gog-auth-services.md) - List supported auth services and scopes
+    - [`gog auth status`](commands/gog-auth-status.md) - Show auth configuration and keyring backend
+    - [`gog auth tokens <command>`](commands/gog-auth-tokens.md) - Manage stored refresh tokens
+      - [`gog auth tokens delete <email>`](commands/gog-auth-tokens-delete.md) - Delete a stored refresh token
+      - [`gog auth tokens export <email> [flags]`](commands/gog-auth-tokens-export.md) - Export a refresh token to a file (contains secrets)
+      - [`gog auth tokens import <inPath>`](commands/gog-auth-tokens-import.md) - Import a refresh token file into keyring (contains secrets)
+      - [`gog auth tokens list`](commands/gog-auth-tokens-list.md) - List stored tokens (by key only)
+  - [`gog backup <command> [flags]`](commands/gog-backup.md) - Encrypted Google account backups
+    - [`gog backup cat <shard> [flags]`](commands/gog-backup-cat.md) - Decrypt one backup shard to stdout
+    - [`gog backup export [flags]`](commands/gog-backup-export.md) - Write a local plaintext export
+    - [`gog backup gmail <command>`](commands/gog-backup-gmail.md) - Gmail backup operations
+      - [`gog backup gmail push [flags]`](commands/gog-backup-gmail-push.md) - Export Gmail into encrypted backup shards
+    - [`gog backup init [flags]`](commands/gog-backup-init.md) - Initialize encrypted backup config and repository
+    - [`gog backup push [flags]`](commands/gog-backup-push.md) - Export services into encrypted backup shards
+    - [`gog backup status [flags]`](commands/gog-backup-status.md) - Inspect backup manifest without decrypting shards
+    - [`gog backup verify [flags]`](commands/gog-backup-verify.md) - Decrypt and verify all backup shards
+  - [`gog calendar (cal) <command> [flags]`](commands/gog-calendar.md) - Google Calendar
+    - [`gog calendar (cal) acl (permissions,perms) <calendarId> [flags]`](commands/gog-calendar-acl.md) - List calendar ACL
+    - [`gog calendar (cal) alias <command>`](commands/gog-calendar-alias.md) - Manage calendar aliases
+      - [`gog calendar (cal) alias list`](commands/gog-calendar-alias-list.md) - List calendar aliases
+      - [`gog calendar (cal) alias set <alias> <calendarId>`](commands/gog-calendar-alias-set.md) - Set a calendar alias
+      - [`gog calendar (cal) alias unset <alias>`](commands/gog-calendar-alias-unset.md) - Remove a calendar alias
+    - [`gog calendar (cal) calendars [flags]`](commands/gog-calendar-calendars.md) - List calendars
+    - [`gog calendar (cal) colors`](commands/gog-calendar-colors.md) - Show calendar colors
+    - [`gog calendar (cal) conflicts [flags]`](commands/gog-calendar-conflicts.md) - Find conflicts
+    - [`gog calendar (cal) create (add,new) <calendarId> [flags]`](commands/gog-calendar-create.md) - Create an event
+    - [`gog calendar (cal) create-calendar (new-calendar) <summary> [flags]`](commands/gog-calendar-create-calendar.md) - Create a new secondary calendar
+    - [`gog calendar (cal) delete (rm,del,remove) <calendarId> <eventId> [flags]`](commands/gog-calendar-delete.md) - Delete an event
+    - [`gog calendar (cal) event (get,info,show) <calendarId> <eventId>`](commands/gog-calendar-event.md) - Get event
+    - [`gog calendar (cal) events (list,ls) [<calendarId> ...] [flags]`](commands/gog-calendar-events.md) - List events from a calendar or all calendars
+    - [`gog calendar (cal) focus-time (focus) --from=STRING --to=STRING [<calendarId>] [flags]`](commands/gog-calendar-focus-time.md) - Create a Focus Time block
+    - [`gog calendar (cal) freebusy [<calendarIds>] [flags]`](commands/gog-calendar-freebusy.md) - Get free/busy
+    - [`gog calendar (cal) move (transfer) <calendarId> <eventId> <destinationCalendarId> [flags]`](commands/gog-calendar-move.md) - Move an event to another calendar
+    - [`gog calendar (cal) out-of-office (ooo) --from=STRING --to=STRING [<calendarId>] [flags]`](commands/gog-calendar-out-of-office.md) - Create an Out of Office event
+    - [`gog calendar (cal) propose-time <calendarId> <eventId> [flags]`](commands/gog-calendar-propose-time.md) - Generate URL to propose a new meeting time (browser-only feature)
+    - [`gog calendar (cal) respond (rsvp,reply) <calendarId> <eventId> [flags]`](commands/gog-calendar-respond.md) - Respond to an event invitation
+    - [`gog calendar (cal) search (find,query) <query> [flags]`](commands/gog-calendar-search.md) - Search events
+    - [`gog calendar (cal) subscribe (sub,add-calendar) <calendarId> [flags]`](commands/gog-calendar-subscribe.md) - Add a calendar to your calendar list
+    - [`gog calendar (cal) team <group-email> [flags]`](commands/gog-calendar-team.md) - Show events for all members of a Google Group
+    - [`gog calendar (cal) time [flags]`](commands/gog-calendar-time.md) - Show server time
+    - [`gog calendar (cal) update (edit,set) <calendarId> <eventId> [flags]`](commands/gog-calendar-update.md) - Update an event
+    - [`gog calendar (cal) users [flags]`](commands/gog-calendar-users.md) - List workspace users (use their email as calendar ID)
+    - [`gog calendar (cal) working-location (wl) --from=STRING --to=STRING --type=STRING [<calendarId>] [flags]`](commands/gog-calendar-working-location.md) - Set working location (home/office/custom)
+  - [`gog chat <command> [flags]`](commands/gog-chat.md) - Google Chat
+    - [`gog chat dm <command>`](commands/gog-chat-dm.md) - Direct messages
+      - [`gog chat dm send (create,post) <email> [flags]`](commands/gog-chat-dm-send.md) - Send a direct message
+      - [`gog chat dm space (find,setup) <email>`](commands/gog-chat-dm-space.md) - Find or create a DM space
+    - [`gog chat messages <command>`](commands/gog-chat-messages.md) - Chat messages
+      - [`gog chat messages list (ls) <space> [flags]`](commands/gog-chat-messages-list.md) - List messages
+      - [`gog chat messages react <message> <emoji> [flags]`](commands/gog-chat-messages-react.md) - Add an emoji reaction to a message
+      - [`gog chat messages reactions (reaction) <command>`](commands/gog-chat-messages-reactions.md) - Manage emoji reactions on a message
+        - [`gog chat messages reactions (reaction) create (add) <message> <emoji> [flags]`](commands/gog-chat-messages-reactions-create.md) - Add an emoji reaction to a message
+        - [`gog chat messages reactions (reaction) delete (remove,rm) <reaction>`](commands/gog-chat-messages-reactions-delete.md) - Delete a reaction
+        - [`gog chat messages reactions (reaction) list (ls) <message> [flags]`](commands/gog-chat-messages-reactions-list.md) - List reactions on a message
+      - [`gog chat messages send (create,post) <space> [flags]`](commands/gog-chat-messages-send.md) - Send a message
+    - [`gog chat spaces <command>`](commands/gog-chat-spaces.md) - Chat spaces
+      - [`gog chat spaces create (add,new) <displayName> [flags]`](commands/gog-chat-spaces-create.md) - Create a space
+      - [`gog chat spaces find (search,query) <displayName> [flags]`](commands/gog-chat-spaces-find.md) - Find spaces by display name
+      - [`gog chat spaces list (ls) [flags]`](commands/gog-chat-spaces-list.md) - List spaces
+    - [`gog chat threads <command>`](commands/gog-chat-threads.md) - Chat threads
+      - [`gog chat threads list <space> [flags]`](commands/gog-chat-threads-list.md) - List threads in a space
+  - [`gog classroom (class) <command> [flags]`](commands/gog-classroom.md) - Google Classroom
+    - [`gog classroom (class) announcements (announcement,ann) <command>`](commands/gog-classroom-announcements.md) - Announcements
+      - [`gog classroom (class) announcements (announcement,ann) assignees (assign) <courseId> <announcementId> [flags]`](commands/gog-classroom-announcements-assignees.md) - Modify announcement assignees
+      - [`gog classroom (class) announcements (announcement,ann) create (add,new) --text=STRING <courseId> [flags]`](commands/gog-classroom-announcements-create.md) - Create an announcement
+      - [`gog classroom (class) announcements (announcement,ann) delete (rm,del,remove) <courseId> <announcementId>`](commands/gog-classroom-announcements-delete.md) - Delete an announcement
+      - [`gog classroom (class) announcements (announcement,ann) get (info,show) <courseId> <announcementId>`](commands/gog-classroom-announcements-get.md) - Get an announcement
+      - [`gog classroom (class) announcements (announcement,ann) list (ls) <courseId> [flags]`](commands/gog-classroom-announcements-list.md) - List announcements
+      - [`gog classroom (class) announcements (announcement,ann) update (edit,set) <courseId> <announcementId> [flags]`](commands/gog-classroom-announcements-update.md) - Update an announcement
+    - [`gog classroom (class) courses (course) <command>`](commands/gog-classroom-courses.md) - Courses
+      - [`gog classroom (class) courses (course) archive (arch) <courseId>`](commands/gog-classroom-courses-archive.md) - Archive a course
+      - [`gog classroom (class) courses (course) create (add,new) --name=STRING [flags]`](commands/gog-classroom-courses-create.md) - Create a course
+      - [`gog classroom (class) courses (course) delete (rm,del,remove) <courseId>`](commands/gog-classroom-courses-delete.md) - Delete a course
+      - [`gog classroom (class) courses (course) get (info,show) <courseId>`](commands/gog-classroom-courses-get.md) - Get a course
+      - [`gog classroom (class) courses (course) join (enroll) <courseId> [flags]`](commands/gog-classroom-courses-join.md) - Join a course
+      - [`gog classroom (class) courses (course) leave (unenroll) <courseId> [flags]`](commands/gog-classroom-courses-leave.md) - Leave a course
+      - [`gog classroom (class) courses (course) list (ls) [flags]`](commands/gog-classroom-courses-list.md) - List courses
+      - [`gog classroom (class) courses (course) unarchive (unarch,restore) <courseId>`](commands/gog-classroom-courses-unarchive.md) - Unarchive a course
+      - [`gog classroom (class) courses (course) update (edit,set) <courseId> [flags]`](commands/gog-classroom-courses-update.md) - Update a course
+      - [`gog classroom (class) courses (course) url (link) <courseId> ...`](commands/gog-classroom-courses-url.md) - Print Classroom web URLs for courses
+    - [`gog classroom (class) coursework (work) <command>`](commands/gog-classroom-coursework.md) - Coursework
+      - [`gog classroom (class) coursework (work) assignees (assign) <courseId> <courseworkId> [flags]`](commands/gog-classroom-coursework-assignees.md) - Modify coursework assignees
+      - [`gog classroom (class) coursework (work) create (add,new) --title=STRING <courseId> [flags]`](commands/gog-classroom-coursework-create.md) - Create coursework
+      - [`gog classroom (class) coursework (work) delete (rm,del,remove) <courseId> <courseworkId>`](commands/gog-classroom-coursework-delete.md) - Delete coursework
+      - [`gog classroom (class) coursework (work) get (info,show) <courseId> <courseworkId>`](commands/gog-classroom-coursework-get.md) - Get coursework
+      - [`gog classroom (class) coursework (work) list (ls) <courseId> [flags]`](commands/gog-classroom-coursework-list.md) - List coursework
+      - [`gog classroom (class) coursework (work) update (edit,set) <courseId> <courseworkId> [flags]`](commands/gog-classroom-coursework-update.md) - Update coursework
+    - [`gog classroom (class) guardian-invitations (guardian-invites) <command>`](commands/gog-classroom-guardian-invitations.md) - Guardian invitations
+      - [`gog classroom (class) guardian-invitations (guardian-invites) create (add,new) --email=STRING <studentId>`](commands/gog-classroom-guardian-invitations-create.md) - Create a guardian invitation
+      - [`gog classroom (class) guardian-invitations (guardian-invites) get (info,show) <studentId> <invitationId>`](commands/gog-classroom-guardian-invitations-get.md) - Get a guardian invitation
+      - [`gog classroom (class) guardian-invitations (guardian-invites) list (ls) <studentId> [flags]`](commands/gog-classroom-guardian-invitations-list.md) - List guardian invitations
+    - [`gog classroom (class) guardians (guardian) <command>`](commands/gog-classroom-guardians.md) - Guardians
+      - [`gog classroom (class) guardians (guardian) delete (rm,del,remove) <studentId> <guardianId>`](commands/gog-classroom-guardians-delete.md) - Delete a guardian
+      - [`gog classroom (class) guardians (guardian) get (info,show) <studentId> <guardianId>`](commands/gog-classroom-guardians-get.md) - Get a guardian
+      - [`gog classroom (class) guardians (guardian) list (ls) <studentId> [flags]`](commands/gog-classroom-guardians-list.md) - List guardians
+    - [`gog classroom (class) invitations (invitation,invites) <command>`](commands/gog-classroom-invitations.md) - Invitations
+      - [`gog classroom (class) invitations (invitation,invites) accept (join) <invitationId>`](commands/gog-classroom-invitations-accept.md) - Accept an invitation
+      - [`gog classroom (class) invitations (invitation,invites) create (add,new) --role=STRING <courseId> <userId>`](commands/gog-classroom-invitations-create.md) - Create an invitation
+      - [`gog classroom (class) invitations (invitation,invites) delete (rm,del,remove) <invitationId>`](commands/gog-classroom-invitations-delete.md) - Delete an invitation
+      - [`gog classroom (class) invitations (invitation,invites) get (info,show) <invitationId>`](commands/gog-classroom-invitations-get.md) - Get an invitation
+      - [`gog classroom (class) invitations (invitation,invites) list (ls) [flags]`](commands/gog-classroom-invitations-list.md) - List invitations
+    - [`gog classroom (class) materials (material) <command>`](commands/gog-classroom-materials.md) - Coursework materials
+      - [`gog classroom (class) materials (material) create (add,new) --title=STRING <courseId> [flags]`](commands/gog-classroom-materials-create.md) - Create coursework material
+      - [`gog classroom (class) materials (material) delete (rm,del,remove) <courseId> <materialId>`](commands/gog-classroom-materials-delete.md) - Delete coursework material
+      - [`gog classroom (class) materials (material) get (info,show) <courseId> <materialId>`](commands/gog-classroom-materials-get.md) - Get coursework material
+      - [`gog classroom (class) materials (material) list (ls) <courseId> [flags]`](commands/gog-classroom-materials-list.md) - List coursework materials
+      - [`gog classroom (class) materials (material) update (edit,set) <courseId> <materialId> [flags]`](commands/gog-classroom-materials-update.md) - Update coursework material
+    - [`gog classroom (class) profile (me) <command>`](commands/gog-classroom-profile.md) - User profiles
+      - [`gog classroom (class) profile (me) get [<userId>]`](commands/gog-classroom-profile-get.md) - Get a user profile
+    - [`gog classroom (class) roster (members) <courseId> [flags]`](commands/gog-classroom-roster.md) - Course roster (students + teachers)
+    - [`gog classroom (class) students (student) <command>`](commands/gog-classroom-students.md) - Course students
+      - [`gog classroom (class) students (student) add (create,new) <courseId> <userId> [flags]`](commands/gog-classroom-students-add.md) - Add a student
+      - [`gog classroom (class) students (student) get (info,show) <courseId> <userId>`](commands/gog-classroom-students-get.md) - Get a student
+      - [`gog classroom (class) students (student) list (ls) <courseId> [flags]`](commands/gog-classroom-students-list.md) - List students
+      - [`gog classroom (class) students (student) remove (delete,rm,del,remove) <courseId> <userId>`](commands/gog-classroom-students-remove.md) - Remove a student
+    - [`gog classroom (class) submissions (submission) <command>`](commands/gog-classroom-submissions.md) - Student submissions
+      - [`gog classroom (class) submissions (submission) get (info,show) <courseId> <courseworkId> <submissionId>`](commands/gog-classroom-submissions-get.md) - Get a student submission
+      - [`gog classroom (class) submissions (submission) grade (set,edit) <courseId> <courseworkId> <submissionId> [flags]`](commands/gog-classroom-submissions-grade.md) - Set draft/assigned grades
+      - [`gog classroom (class) submissions (submission) list (ls) <courseId> <courseworkId> [flags]`](commands/gog-classroom-submissions-list.md) - List student submissions
+      - [`gog classroom (class) submissions (submission) reclaim (undo) <courseId> <courseworkId> <submissionId>`](commands/gog-classroom-submissions-reclaim.md) - Reclaim a submission
+      - [`gog classroom (class) submissions (submission) return (send) <courseId> <courseworkId> <submissionId>`](commands/gog-classroom-submissions-return.md) - Return a submission
+      - [`gog classroom (class) submissions (submission) turn-in (turnin) <courseId> <courseworkId> <submissionId>`](commands/gog-classroom-submissions-turn-in.md) - Turn in a submission
+    - [`gog classroom (class) teachers (teacher) <command>`](commands/gog-classroom-teachers.md) - Course teachers
+      - [`gog classroom (class) teachers (teacher) add (create,new) <courseId> <userId>`](commands/gog-classroom-teachers-add.md) - Add a teacher
+      - [`gog classroom (class) teachers (teacher) get (info,show) <courseId> <userId>`](commands/gog-classroom-teachers-get.md) - Get a teacher
+      - [`gog classroom (class) teachers (teacher) list (ls) <courseId> [flags]`](commands/gog-classroom-teachers-list.md) - List teachers
+      - [`gog classroom (class) teachers (teacher) remove (delete,rm,del,remove) <courseId> <userId>`](commands/gog-classroom-teachers-remove.md) - Remove a teacher
+    - [`gog classroom (class) topics (topic) <command>`](commands/gog-classroom-topics.md) - Topics
+      - [`gog classroom (class) topics (topic) create (add,new) --name=STRING <courseId>`](commands/gog-classroom-topics-create.md) - Create a topic
+      - [`gog classroom (class) topics (topic) delete (rm,del,remove) <courseId> <topicId>`](commands/gog-classroom-topics-delete.md) - Delete a topic
+      - [`gog classroom (class) topics (topic) get (info,show) <courseId> <topicId>`](commands/gog-classroom-topics-get.md) - Get a topic
+      - [`gog classroom (class) topics (topic) list (ls) <courseId> [flags]`](commands/gog-classroom-topics-list.md) - List topics
+      - [`gog classroom (class) topics (topic) update (edit,set) --name=STRING <courseId> <topicId>`](commands/gog-classroom-topics-update.md) - Update a topic
+  - [`gog completion <shell> [flags]`](commands/gog-completion.md) - Generate shell completion scripts
+  - [`gog config <command> [flags]`](commands/gog-config.md) - Manage configuration
+    - [`gog config get (show) <key>`](commands/gog-config-get.md) - Get a config value
+    - [`gog config keys (list-keys,names)`](commands/gog-config-keys.md) - List available config keys
+    - [`gog config list (ls,all)`](commands/gog-config-list.md) - List all config values
+    - [`gog config no-send (nosend) <command>`](commands/gog-config-no-send.md) - Manage per-account Gmail no-send guards
+      - [`gog config no-send (nosend) list (ls)`](commands/gog-config-no-send-list.md) - List accounts with no-send guards
+      - [`gog config no-send (nosend) remove (rm,del,delete,unset,disable) <account>`](commands/gog-config-no-send-remove.md) - Remove an account no-send guard
+      - [`gog config no-send (nosend) set (add,enable) <account>`](commands/gog-config-no-send-set.md) - Block Gmail send operations for an account
+    - [`gog config path (where)`](commands/gog-config-path.md) - Print config file path
+    - [`gog config set (add,update) <key> <value>`](commands/gog-config-set.md) - Set a config value
+    - [`gog config unset (rm,del,remove) <key>`](commands/gog-config-unset.md) - Unset a config value
+  - [`gog contacts (contact) <command> [flags]`](commands/gog-contacts.md) - Google Contacts
+    - [`gog contacts (contact) create (add,new) [flags]`](commands/gog-contacts-create.md) - Create a contact
+    - [`gog contacts (contact) delete (rm,del,remove) <resourceName>`](commands/gog-contacts-delete.md) - Delete a contact
+    - [`gog contacts (contact) directory <command>`](commands/gog-contacts-directory.md) - Directory contacts
+      - [`gog contacts (contact) directory list [flags]`](commands/gog-contacts-directory-list.md) - List people from the Workspace directory
+      - [`gog contacts (contact) directory search <query> ... [flags]`](commands/gog-contacts-directory-search.md) - Search people in the Workspace directory
+    - [`gog contacts (contact) export [<selector>] [flags]`](commands/gog-contacts-export.md) - Export contacts as vCard (.vcf)
+    - [`gog contacts (contact) get (info,show) <resourceName>`](commands/gog-contacts-get.md) - Get a contact
+    - [`gog contacts (contact) list (ls) [flags]`](commands/gog-contacts-list.md) - List contacts
+    - [`gog contacts (contact) other <command>`](commands/gog-contacts-other.md) - Other contacts
+      - [`gog contacts (contact) other delete <resourceName>`](commands/gog-contacts-other-delete.md) - Delete an other contact
+      - [`gog contacts (contact) other list [flags]`](commands/gog-contacts-other-list.md) - List other contacts
+      - [`gog contacts (contact) other search <query> ... [flags]`](commands/gog-contacts-other-search.md) - Search other contacts
+    - [`gog contacts (contact) search <query> ... [flags]`](commands/gog-contacts-search.md) - Search contacts by name/email/phone
+    - [`gog contacts (contact) update (edit,set) <resourceName> [flags]`](commands/gog-contacts-update.md) - Update a contact
+  - [`gog docs (doc) <command> [flags]`](commands/gog-docs.md) - Google Docs (export via Drive)
+    - [`gog docs (doc) add-tab <docId> [flags]`](commands/gog-docs-add-tab.md) - Add a tab to a Google Doc
+    - [`gog docs (doc) cat (text,read) <docId> [flags]`](commands/gog-docs-cat.md) - Print a Google Doc as plain text
+    - [`gog docs (doc) clear <docId>`](commands/gog-docs-clear.md) - Clear all content from a Google Doc
+    - [`gog docs (doc) comments <command>`](commands/gog-docs-comments.md) - Manage comments on files
+      - [`gog docs (doc) comments add (create,new) <docId> <content> [flags]`](commands/gog-docs-comments-add.md) - Add a comment to a Google Doc
+      - [`gog docs (doc) comments delete (rm,del,remove) <docId> <commentId>`](commands/gog-docs-comments-delete.md) - Delete a comment
+      - [`gog docs (doc) comments get (info,show) <docId> <commentId>`](commands/gog-docs-comments-get.md) - Get a comment by ID
+      - [`gog docs (doc) comments list (ls) <docId> [flags]`](commands/gog-docs-comments-list.md) - List comments on a Google Doc
+      - [`gog docs (doc) comments reply (respond) <docId> <commentId> <content>`](commands/gog-docs-comments-reply.md) - Reply to a comment
+      - [`gog docs (doc) comments resolve <docId> <commentId> [flags]`](commands/gog-docs-comments-resolve.md) - Resolve a comment (mark as done)
+    - [`gog docs (doc) copy (cp,duplicate) <docId> <title> [flags]`](commands/gog-docs-copy.md) - Copy a Google Doc
+    - [`gog docs (doc) create (add,new) <title> [flags]`](commands/gog-docs-create.md) - Create a Google Doc
+    - [`gog docs (doc) delete --start=INT-64 --end=INT-64 <docId> [flags]`](commands/gog-docs-delete.md) - Delete text range from document
+    - [`gog docs (doc) delete-tab <docId> [flags]`](commands/gog-docs-delete-tab.md) - Delete a tab from a Google Doc
+    - [`gog docs (doc) edit <docId> <find> <replace> [flags]`](commands/gog-docs-edit.md) - Find and replace text in a Google Doc
+    - [`gog docs (doc) export (download,dl) <docId> [flags]`](commands/gog-docs-export.md) - Export a Google Doc (pdf|docx|txt|md|html)
+    - [`gog docs (doc) find-replace <docId> <find> [<replace>] [flags]`](commands/gog-docs-find-replace.md) - Find and replace text. Supports plain text or markdown with images; use --first for a single occurrence.
+    - [`gog docs (doc) info (get,show) <docId>`](commands/gog-docs-info.md) - Get Google Doc metadata
+    - [`gog docs (doc) insert <docId> [<content>] [flags]`](commands/gog-docs-insert.md) - Insert text at a specific position
+    - [`gog docs (doc) list-tabs <docId>`](commands/gog-docs-list-tabs.md) - List all tabs in a Google Doc
+    - [`gog docs (doc) rename-tab <docId> [flags]`](commands/gog-docs-rename-tab.md) - Rename a tab in a Google Doc
+    - [`gog docs (doc) sed <docId> [<expression>] [flags]`](commands/gog-docs-sed.md) - Regex find/replace (sed-style: s/pattern/replacement/g)
+    - [`gog docs (doc) structure (struct) <docId> [flags]`](commands/gog-docs-structure.md) - Show document structure with numbered paragraphs
+    - [`gog docs (doc) update <docId> [flags]`](commands/gog-docs-update.md) - Insert text at a specific index in a Google Doc
+    - [`gog docs (doc) write <docId> [flags]`](commands/gog-docs-write.md) - Write content to a Google Doc
+  - [`gog download (dl) <fileId> [flags]`](commands/gog-download.md) - Download a Drive file (alias for 'drive download')
+  - [`gog drive (drv) <command> [flags]`](commands/gog-drive.md) - Google Drive
+    - [`gog drive (drv) comments <command>`](commands/gog-drive-comments.md) - Manage comments on files
+      - [`gog drive (drv) comments create (add,new) <fileId> <content> [flags]`](commands/gog-drive-comments-create.md) - Create a comment on a file
+      - [`gog drive (drv) comments delete (rm,del,remove) <fileId> <commentId>`](commands/gog-drive-comments-delete.md) - Delete a comment
+      - [`gog drive (drv) comments get (info,show) <fileId> <commentId>`](commands/gog-drive-comments-get.md) - Get a comment by ID
+      - [`gog drive (drv) comments list (ls) <fileId> [flags]`](commands/gog-drive-comments-list.md) - List comments on a file
+      - [`gog drive (drv) comments reply (respond) <fileId> <commentId> <content>`](commands/gog-drive-comments-reply.md) - Reply to a comment
+      - [`gog drive (drv) comments update (edit,set) <fileId> <commentId> <content>`](commands/gog-drive-comments-update.md) - Update a comment
+    - [`gog drive (drv) copy <fileId> <name> [flags]`](commands/gog-drive-copy.md) - Copy a file
+    - [`gog drive (drv) delete (rm,del) <fileId> [flags]`](commands/gog-drive-delete.md) - Move a file to trash (use --permanent to delete forever)
+    - [`gog drive (drv) download <fileId> [flags]`](commands/gog-drive-download.md) - Download a file (exports Google Docs formats)
+    - [`gog drive (drv) drives [flags]`](commands/gog-drive-drives.md) - List shared drives (Team Drives)
+    - [`gog drive (drv) get <fileId>`](commands/gog-drive-get.md) - Get file metadata
+    - [`gog drive (drv) ls [flags]`](commands/gog-drive-ls.md) - List files in a folder (default: root)
+    - [`gog drive (drv) mkdir <name> [flags]`](commands/gog-drive-mkdir.md) - Create a folder
+    - [`gog drive (drv) move <fileId> [flags]`](commands/gog-drive-move.md) - Move a file to a different folder
+    - [`gog drive (drv) permissions <fileId> [flags]`](commands/gog-drive-permissions.md) - List permissions on a file
+    - [`gog drive (drv) rename <fileId> <newName>`](commands/gog-drive-rename.md) - Rename a file or folder
+    - [`gog drive (drv) search <query> ... [flags]`](commands/gog-drive-search.md) - Full-text search across Drive
+    - [`gog drive (drv) share <fileId> [flags]`](commands/gog-drive-share.md) - Share a file or folder
+    - [`gog drive (drv) unshare <fileId> <permissionId>`](commands/gog-drive-unshare.md) - Remove a permission from a file
+    - [`gog drive (drv) upload <localPath> [flags]`](commands/gog-drive-upload.md) - Upload a file
+    - [`gog drive (drv) url <fileId> ...`](commands/gog-drive-url.md) - Print web URLs for files
+  - [`gog exit-codes (exitcodes) [flags]`](commands/gog-exit-codes.md) - Print stable exit codes (alias for 'agent exit-codes')
+  - [`gog forms (form) <command> [flags]`](commands/gog-forms.md) - Google Forms
+    - [`gog forms (form) add-question (add-q,aq) --title=STRING <formId> [flags]`](commands/gog-forms-add-question.md) - Add a question to a form
+    - [`gog forms (form) create (new) --title=STRING [flags]`](commands/gog-forms-create.md) - Create a form
+    - [`gog forms (form) delete-question (delete-q,dq,rm-q) <formId> <index>`](commands/gog-forms-delete-question.md) - Delete a question by index
+    - [`gog forms (form) get (info,show) <formId>`](commands/gog-forms-get.md) - Get a form
+    - [`gog forms (form) move-question (move-q,mq) <formId> <oldIndex> <newIndex>`](commands/gog-forms-move-question.md) - Move a question to a new position
+    - [`gog forms (form) responses <command>`](commands/gog-forms-responses.md) - Form responses
+      - [`gog forms (form) responses get (info,show) <formId> <responseId>`](commands/gog-forms-responses-get.md) - Get a form response
+      - [`gog forms (form) responses list (ls) <formId> [flags]`](commands/gog-forms-responses-list.md) - List form responses
+    - [`gog forms (form) update (edit) <formId> [flags]`](commands/gog-forms-update.md) - Update form title, description, or settings
+    - [`gog forms (form) watch (watches) <command>`](commands/gog-forms-watch.md) - Response watches (push notifications)
+      - [`gog forms (form) watch (watches) create (new,add) --topic=STRING <formId> [flags]`](commands/gog-forms-watch-create.md) - Create a watch for new responses
+      - [`gog forms (form) watch (watches) delete (rm,remove) <formId> <watchId>`](commands/gog-forms-watch-delete.md) - Delete a watch
+      - [`gog forms (form) watch (watches) list (ls) <formId>`](commands/gog-forms-watch-list.md) - List active watches
+      - [`gog forms (form) watch (watches) renew (refresh) <formId> <watchId>`](commands/gog-forms-watch-renew.md) - Renew a watch (extends 7 days)
+  - [`gog gmail (mail,email) <command> [flags]`](commands/gog-gmail.md) - Gmail
+    - [`gog gmail (mail,email) archive [<messageId> ...] [flags]`](commands/gog-gmail-archive.md) - Archive messages (remove from inbox)
+    - [`gog gmail (mail,email) attachment <messageId> <attachmentId> [flags]`](commands/gog-gmail-attachment.md) - Download a single attachment
+    - [`gog gmail (mail,email) autoreply <query> ... [flags]`](commands/gog-gmail-autoreply.md) - Reply once to matching messages
+    - [`gog gmail (mail,email) batch <command>`](commands/gog-gmail-batch.md) - Batch operations (permanent delete requires broader Gmail scope; use gmail trash for normal trashing)
+      - [`gog gmail (mail,email) batch delete (rm,del,remove) <messageId> ...`](commands/gog-gmail-batch-delete.md) - Permanently delete multiple messages; use 'gmail trash' to move messages to trash with the default gmail.modify scope
+      - [`gog gmail (mail,email) batch modify (update,edit,set) <messageId> ... [flags]`](commands/gog-gmail-batch-modify.md) - Modify labels on multiple messages
+    - [`gog gmail (mail,email) drafts (draft) <command>`](commands/gog-gmail-drafts.md) - Draft operations
+      - [`gog gmail (mail,email) drafts (draft) create (add,new) [flags]`](commands/gog-gmail-drafts-create.md) - Create a draft
+      - [`gog gmail (mail,email) drafts (draft) delete (rm,del,remove) <draftId>`](commands/gog-gmail-drafts-delete.md) - Delete a draft
+      - [`gog gmail (mail,email) drafts (draft) get (info,show) <draftId> [flags]`](commands/gog-gmail-drafts-get.md) - Get draft details
+      - [`gog gmail (mail,email) drafts (draft) list (ls) [flags]`](commands/gog-gmail-drafts-list.md) - List drafts
+      - [`gog gmail (mail,email) drafts (draft) send (post) <draftId>`](commands/gog-gmail-drafts-send.md) - Send a draft
+      - [`gog gmail (mail,email) drafts (draft) update (edit,set) <draftId> [flags]`](commands/gog-gmail-drafts-update.md) - Update a draft
+    - [`gog gmail (mail,email) forward (fwd) --to=STRING <messageId> [flags]`](commands/gog-gmail-forward.md) - Forward a message to new recipients
+    - [`gog gmail (mail,email) get (info,show) <messageId> [flags]`](commands/gog-gmail-get.md) - Get a message (full|metadata|raw)
+    - [`gog gmail (mail,email) history [flags]`](commands/gog-gmail-history.md) - Gmail history
+    - [`gog gmail (mail,email) labels (label) <command>`](commands/gog-gmail-labels.md) - Label operations
+      - [`gog gmail (mail,email) labels (label) create (add,new) <name>`](commands/gog-gmail-labels-create.md) - Create a new label
+      - [`gog gmail (mail,email) labels (label) delete (rm,del) <labelIdOrName>`](commands/gog-gmail-labels-delete.md) - Delete a label
+      - [`gog gmail (mail,email) labels (label) get (info,show) <labelIdOrName>`](commands/gog-gmail-labels-get.md) - Get label details (including counts)
+      - [`gog gmail (mail,email) labels (label) list (ls)`](commands/gog-gmail-labels-list.md) - List labels
+      - [`gog gmail (mail,email) labels (label) modify (update,edit,set) <threadId> ... [flags]`](commands/gog-gmail-labels-modify.md) - Modify labels on threads
+      - [`gog gmail (mail,email) labels (label) rename (mv) <labelIdOrName> <newName>`](commands/gog-gmail-labels-rename.md) - Rename a label
+      - [`gog gmail (mail,email) labels (label) style (color,colour) <labelIdOrName> [flags]`](commands/gog-gmail-labels-style.md) - Change a user label color or visibility
+    - [`gog gmail (mail,email) mark-read (read-messages) [<messageId> ...] [flags]`](commands/gog-gmail-mark-read.md) - Mark messages as read
+    - [`gog gmail (mail,email) messages (message,msg,msgs) <command>`](commands/gog-gmail-messages.md) - Message operations
+      - [`gog gmail (mail,email) messages (message,msg,msgs) modify (update,edit,set) <messageId> [flags]`](commands/gog-gmail-messages-modify.md) - Modify labels on a single message
+      - [`gog gmail (mail,email) messages (message,msg,msgs) search (find,query,ls,list) <query> ... [flags]`](commands/gog-gmail-messages-search.md) - Search messages using Gmail query syntax
+    - [`gog gmail (mail,email) search (find,query,ls,list) <query> ... [flags]`](commands/gog-gmail-search.md) - Search threads using Gmail query syntax
+    - [`gog gmail (mail,email) send [flags]`](commands/gog-gmail-send.md) - Send an email
+    - [`gog gmail (mail,email) settings <command>`](commands/gog-gmail-settings.md) - Settings and admin
+      - [`gog gmail (mail,email) settings autoforward <command>`](commands/gog-gmail-settings-autoforward.md) - Auto-forwarding settings
+        - [`gog gmail (mail,email) settings autoforward get (info,show)`](commands/gog-gmail-settings-autoforward-get.md) - Get current auto-forwarding settings
+        - [`gog gmail (mail,email) settings autoforward update (edit,set) [flags]`](commands/gog-gmail-settings-autoforward-update.md) - Update auto-forwarding settings
+      - [`gog gmail (mail,email) settings delegates <command>`](commands/gog-gmail-settings-delegates.md) - Delegate operations
+        - [`gog gmail (mail,email) settings delegates add (create,new) <delegateEmail>`](commands/gog-gmail-settings-delegates-add.md) - Add a delegate
+        - [`gog gmail (mail,email) settings delegates get (info,show) <delegateEmail>`](commands/gog-gmail-settings-delegates-get.md) - Get a specific delegate's information
+        - [`gog gmail (mail,email) settings delegates list (ls)`](commands/gog-gmail-settings-delegates-list.md) - List all delegates
+        - [`gog gmail (mail,email) settings delegates remove (delete,rm,del) <delegateEmail>`](commands/gog-gmail-settings-delegates-remove.md) - Remove a delegate
+      - [`gog gmail (mail,email) settings filters <command>`](commands/gog-gmail-settings-filters.md) - Filter operations
+        - [`gog gmail (mail,email) settings filters create (add,new) [flags]`](commands/gog-gmail-settings-filters-create.md) - Create a new email filter
+        - [`gog gmail (mail,email) settings filters delete (rm,del,remove) <filterId>`](commands/gog-gmail-settings-filters-delete.md) - Delete a filter
+        - [`gog gmail (mail,email) settings filters export [flags]`](commands/gog-gmail-settings-filters-export.md) - Export filters as JSON
+        - [`gog gmail (mail,email) settings filters get (info,show) <filterId>`](commands/gog-gmail-settings-filters-get.md) - Get a specific filter
+        - [`gog gmail (mail,email) settings filters list (ls)`](commands/gog-gmail-settings-filters-list.md) - List all email filters
+      - [`gog gmail (mail,email) settings forwarding <command>`](commands/gog-gmail-settings-forwarding.md) - Forwarding addresses
+        - [`gog gmail (mail,email) settings forwarding create (add,new) <forwardingEmail>`](commands/gog-gmail-settings-forwarding-create.md) - Create/add a forwarding address
+        - [`gog gmail (mail,email) settings forwarding delete (rm,del,remove) <forwardingEmail>`](commands/gog-gmail-settings-forwarding-delete.md) - Delete a forwarding address
+        - [`gog gmail (mail,email) settings forwarding get (info,show) <forwardingEmail>`](commands/gog-gmail-settings-forwarding-get.md) - Get a specific forwarding address
+        - [`gog gmail (mail,email) settings forwarding list (ls)`](commands/gog-gmail-settings-forwarding-list.md) - List all forwarding addresses
+      - [`gog gmail (mail,email) settings sendas <command>`](commands/gog-gmail-settings-sendas.md) - Send-as settings
+        - [`gog gmail (mail,email) settings sendas create (add,new) <email> [flags]`](commands/gog-gmail-settings-sendas-create.md) - Create a new send-as alias
+        - [`gog gmail (mail,email) settings sendas delete (rm,del,remove) <email>`](commands/gog-gmail-settings-sendas-delete.md) - Delete a send-as alias
+        - [`gog gmail (mail,email) settings sendas get (info,show) <email>`](commands/gog-gmail-settings-sendas-get.md) - Get details of a send-as alias
+        - [`gog gmail (mail,email) settings sendas list (ls)`](commands/gog-gmail-settings-sendas-list.md) - List send-as aliases
+        - [`gog gmail (mail,email) settings sendas update (edit,set) <email> [flags]`](commands/gog-gmail-settings-sendas-update.md) - Update a send-as alias
+        - [`gog gmail (mail,email) settings sendas verify (resend) <email>`](commands/gog-gmail-settings-sendas-verify.md) - Resend verification email for a send-as alias
+      - [`gog gmail (mail,email) settings vacation <command>`](commands/gog-gmail-settings-vacation.md) - Vacation responder
+        - [`gog gmail (mail,email) settings vacation get (info,show)`](commands/gog-gmail-settings-vacation-get.md) - Get current vacation responder settings
+        - [`gog gmail (mail,email) settings vacation update (edit,set) [flags]`](commands/gog-gmail-settings-vacation-update.md) - Update vacation responder settings
+      - [`gog gmail (mail,email) settings watch <command>`](commands/gog-gmail-settings-watch.md) - Manage Gmail watch
+        - [`gog gmail (mail,email) settings watch renew (update) [flags]`](commands/gog-gmail-settings-watch-renew.md) - Renew Gmail watch using stored config
+        - [`gog gmail (mail,email) settings watch serve [flags]`](commands/gog-gmail-settings-watch-serve.md) - Run Pub/Sub push handler
+        - [`gog gmail (mail,email) settings watch start (begin) [flags]`](commands/gog-gmail-settings-watch-start.md) - Start Gmail watch for Pub/Sub
+        - [`gog gmail (mail,email) settings watch status (ls) [flags]`](commands/gog-gmail-settings-watch-status.md) - Show stored watch state
+        - [`gog gmail (mail,email) settings watch stop (rm,delete)`](commands/gog-gmail-settings-watch-stop.md) - Stop Gmail watch and clear stored state
+    - [`gog gmail (mail,email) thread (threads,read) <command>`](commands/gog-gmail-thread.md) - Thread operations (get, modify)
+      - [`gog gmail (mail,email) thread (threads,read) attachments (files) <threadId> [flags]`](commands/gog-gmail-thread-attachments.md) - List all attachments in a thread
+      - [`gog gmail (mail,email) thread (threads,read) get (info,show) <threadId> [flags]`](commands/gog-gmail-thread-get.md) - Get a thread with all messages (optionally download attachments)
+      - [`gog gmail (mail,email) thread (threads,read) modify (update,edit,set) <threadId> [flags]`](commands/gog-gmail-thread-modify.md) - Modify labels on all messages in a thread
+    - [`gog gmail (mail,email) track <command>`](commands/gog-gmail-track.md) - Email open tracking
+      - [`gog gmail (mail,email) track key <command>`](commands/gog-gmail-track-key.md) - Manage tracking encryption keys
+        - [`gog gmail (mail,email) track key rotate [flags]`](commands/gog-gmail-track-key-rotate.md) - Rotate tracking encryption key
+      - [`gog gmail (mail,email) track opens [<tracking-id>] [flags]`](commands/gog-gmail-track-opens.md) - Query email opens
+      - [`gog gmail (mail,email) track setup [flags]`](commands/gog-gmail-track-setup.md) - Set up email tracking (deploy Cloudflare Worker)
+      - [`gog gmail (mail,email) track status`](commands/gog-gmail-track-status.md) - Show tracking configuration status
+    - [`gog gmail (mail,email) trash [<messageId> ...] [flags]`](commands/gog-gmail-trash.md) - Move messages to trash
+    - [`gog gmail (mail,email) unread (mark-unread) [<messageId> ...] [flags]`](commands/gog-gmail-unread.md) - Mark messages as unread
+    - [`gog gmail (mail,email) url <threadId> ...`](commands/gog-gmail-url.md) - Print Gmail web URLs for threads
+  - [`gog groups (group) <command> [flags]`](commands/gog-groups.md) - Google Groups
+    - [`gog groups (group) list (ls) [flags]`](commands/gog-groups-list.md) - List groups you belong to
+    - [`gog groups (group) members <groupEmail> [flags]`](commands/gog-groups-members.md) - List members of a group
+  - [`gog keep <command> [flags]`](commands/gog-keep.md) - Google Keep (Workspace only)
+    - [`gog keep attachment <attachmentName> [flags]`](commands/gog-keep-attachment.md) - Download an attachment
+    - [`gog keep create [flags]`](commands/gog-keep-create.md) - Create a new note
+    - [`gog keep delete <noteId> [flags]`](commands/gog-keep-delete.md) - Delete a note
+    - [`gog keep get <noteId> [flags]`](commands/gog-keep-get.md) - Get a note
+    - [`gog keep list [flags]`](commands/gog-keep-list.md) - List notes
+    - [`gog keep search <query> [flags]`](commands/gog-keep-search.md) - Search notes by text (client-side)
+  - [`gog login <email> [flags]`](commands/gog-login.md) - Authorize and store a refresh token (alias for 'auth add')
+  - [`gog logout <email> [flags]`](commands/gog-logout.md) - Remove a stored refresh token (alias for 'auth remove')
+  - [`gog ls (list) [flags]`](commands/gog-ls.md) - List Drive files (alias for 'drive ls')
+  - [`gog me [flags]`](commands/gog-me.md) - Show your profile (alias for 'people me')
+  - [`gog open (browse) <target> [flags]`](commands/gog-open.md) - Print a best-effort web URL for a Google URL/ID (offline)
+  - [`gog people (person) <command> [flags]`](commands/gog-people.md) - Google People
+    - [`gog people (person) get (info,show) <userId>`](commands/gog-people-get.md) - Get a user profile by ID
+    - [`gog people (person) me`](commands/gog-people-me.md) - Show your profile (people/me)
+    - [`gog people (person) relations [<userId>] [flags]`](commands/gog-people-relations.md) - Get user relations
+    - [`gog people (person) search (find,query) <query> ... [flags]`](commands/gog-people-search.md) - Search the Workspace directory
+  - [`gog schema (help-json,helpjson) [<command> ...] [flags]`](commands/gog-schema.md) - Machine-readable command/flag schema
+  - [`gog search (find) <query> ... [flags]`](commands/gog-search.md) - Search Drive files (alias for 'drive search')
+  - [`gog send [flags]`](commands/gog-send.md) - Send an email (alias for 'gmail send')
+  - [`gog sheets (sheet) <command> [flags]`](commands/gog-sheets.md) - Google Sheets
+    - [`gog sheets (sheet) add-tab (add-sheet) <spreadsheetId> <tabName> [flags]`](commands/gog-sheets-add-tab.md) - Add a new tab/sheet to a spreadsheet
+    - [`gog sheets (sheet) append (add) <spreadsheetId> <range> [<values> ...] [flags]`](commands/gog-sheets-append.md) - Append values to a range
+    - [`gog sheets (sheet) chart (charts) <command>`](commands/gog-sheets-chart.md) - Manage spreadsheet charts
+      - [`gog sheets (sheet) chart (charts) create (add,new) --spec-json=STRING <spreadsheetId> [flags]`](commands/gog-sheets-chart-create.md) - Create a chart from a JSON spec
+      - [`gog sheets (sheet) chart (charts) delete (rm,remove,del) <spreadsheetId> <chartId>`](commands/gog-sheets-chart-delete.md) - Delete a chart
+      - [`gog sheets (sheet) chart (charts) get (show,info) <spreadsheetId> <chartId>`](commands/gog-sheets-chart-get.md) - Get full chart definition (spec + position)
+      - [`gog sheets (sheet) chart (charts) list <spreadsheetId>`](commands/gog-sheets-chart-list.md) - List charts in a spreadsheet
+      - [`gog sheets (sheet) chart (charts) update (edit,set) --spec-json=STRING <spreadsheetId> <chartId>`](commands/gog-sheets-chart-update.md) - Update a chart spec
+    - [`gog sheets (sheet) clear <spreadsheetId> <range>`](commands/gog-sheets-clear.md) - Clear values in a range
+    - [`gog sheets (sheet) copy (cp,duplicate) <spreadsheetId> <title> [flags]`](commands/gog-sheets-copy.md) - Copy a Google Sheet
+    - [`gog sheets (sheet) create (new) <title> [flags]`](commands/gog-sheets-create.md) - Create a new spreadsheet
+    - [`gog sheets (sheet) delete-tab (delete-sheet) <spreadsheetId> <tabName>`](commands/gog-sheets-delete-tab.md) - Delete a tab/sheet from a spreadsheet (use --force to skip confirmation)
+    - [`gog sheets (sheet) export (download,dl) <spreadsheetId> [flags]`](commands/gog-sheets-export.md) - Export a Google Sheet (pdf|xlsx|csv) via Drive
+    - [`gog sheets (sheet) find-replace <spreadsheetId> <find> <replace> [flags]`](commands/gog-sheets-find-replace.md) - Find and replace text across a spreadsheet
+    - [`gog sheets (sheet) format <spreadsheetId> <range> [flags]`](commands/gog-sheets-format.md) - Apply cell formatting to a range
+    - [`gog sheets (sheet) freeze <spreadsheetId> [flags]`](commands/gog-sheets-freeze.md) - Freeze rows and columns on a sheet
+    - [`gog sheets (sheet) get (read,show) <spreadsheetId> <range> [flags]`](commands/gog-sheets-get.md) - Get values from a range
+    - [`gog sheets (sheet) insert <spreadsheetId> <sheet> <dimension> <start> [flags]`](commands/gog-sheets-insert.md) - Insert empty rows or columns into a sheet
+    - [`gog sheets (sheet) links (hyperlinks) <spreadsheetId> <range>`](commands/gog-sheets-links.md) - Get cell hyperlinks from a range
+    - [`gog sheets (sheet) merge <spreadsheetId> <range> [flags]`](commands/gog-sheets-merge.md) - Merge cells in a range
+    - [`gog sheets (sheet) metadata (info) <spreadsheetId>`](commands/gog-sheets-metadata.md) - Get spreadsheet metadata
+    - [`gog sheets (sheet) named-ranges (namedranges,nr) <command>`](commands/gog-sheets-named-ranges.md) - Manage named ranges
+      - [`gog sheets (sheet) named-ranges (namedranges,nr) add (create,new) <spreadsheetId> <name> <range>`](commands/gog-sheets-named-ranges-add.md) - Add a named range
+      - [`gog sheets (sheet) named-ranges (namedranges,nr) delete (rm,remove,del) <spreadsheetId> <nameOrId>`](commands/gog-sheets-named-ranges-delete.md) - Delete a named range
+      - [`gog sheets (sheet) named-ranges (namedranges,nr) get (show,info) <spreadsheetId> <nameOrId>`](commands/gog-sheets-named-ranges-get.md) - Get a named range
+      - [`gog sheets (sheet) named-ranges (namedranges,nr) list <spreadsheetId>`](commands/gog-sheets-named-ranges-list.md) - List named ranges
+      - [`gog sheets (sheet) named-ranges (namedranges,nr) update (edit,set) <spreadsheetId> <nameOrId> [flags]`](commands/gog-sheets-named-ranges-update.md) - Update a named range
+    - [`gog sheets (sheet) notes <spreadsheetId> <range>`](commands/gog-sheets-notes.md) - Get cell notes from a range
+    - [`gog sheets (sheet) number-format <spreadsheetId> <range> [flags]`](commands/gog-sheets-number-format.md) - Apply number format to a range
+    - [`gog sheets (sheet) read-format (get-format,format-read) <spreadsheetId> <range> [flags]`](commands/gog-sheets-read-format.md) - Read cell formatting from a range
+    - [`gog sheets (sheet) rename-tab (rename-sheet) <spreadsheetId> <oldName> <newName>`](commands/gog-sheets-rename-tab.md) - Rename a tab/sheet in a spreadsheet
+    - [`gog sheets (sheet) resize-columns <spreadsheetId> <columns> [flags]`](commands/gog-sheets-resize-columns.md) - Resize sheet columns
+    - [`gog sheets (sheet) resize-rows <spreadsheetId> <rows> [flags]`](commands/gog-sheets-resize-rows.md) - Resize sheet rows
+    - [`gog sheets (sheet) unmerge <spreadsheetId> <range>`](commands/gog-sheets-unmerge.md) - Unmerge cells in a range
+    - [`gog sheets (sheet) update (edit,set) <spreadsheetId> <range> [<values> ...] [flags]`](commands/gog-sheets-update.md) - Update values in a range
+    - [`gog sheets (sheet) update-note (set-note) <spreadsheetId> <range> [flags]`](commands/gog-sheets-update-note.md) - Set or clear a cell note
+  - [`gog slides (slide) <command> [flags]`](commands/gog-slides.md) - Google Slides
+    - [`gog slides (slide) add-slide <presentationId> <image> [flags]`](commands/gog-slides-add-slide.md) - Add a slide with a full-bleed image and optional speaker notes
+    - [`gog slides (slide) copy (cp,duplicate) <presentationId> <title> [flags]`](commands/gog-slides-copy.md) - Copy a Google Slides presentation
+    - [`gog slides (slide) create (add,new) <title> [flags]`](commands/gog-slides-create.md) - Create a Google Slides presentation
+    - [`gog slides (slide) create-from-markdown <title> [flags]`](commands/gog-slides-create-from-markdown.md) - Create a Google Slides presentation from markdown
+    - [`gog slides (slide) create-from-template <templateId> <title> [flags]`](commands/gog-slides-create-from-template.md) - Create a presentation from template with text replacements
+    - [`gog slides (slide) delete-slide <presentationId> <slideId>`](commands/gog-slides-delete-slide.md) - Delete a slide by object ID
+    - [`gog slides (slide) export (download,dl) <presentationId> [flags]`](commands/gog-slides-export.md) - Export a Google Slides deck (pdf|pptx)
+    - [`gog slides (slide) info (get,show) <presentationId>`](commands/gog-slides-info.md) - Get Google Slides presentation metadata
+    - [`gog slides (slide) insert-text <presentationId> <objectId> <text> [flags]`](commands/gog-slides-insert-text.md) - Insert text into an existing page element (shape or table) by objectId
+    - [`gog slides (slide) list-slides <presentationId>`](commands/gog-slides-list-slides.md) - List all slides with their object IDs
+    - [`gog slides (slide) read-slide <presentationId> <slideId>`](commands/gog-slides-read-slide.md) - Read slide content: speaker notes, text elements, and images
+    - [`gog slides (slide) replace-slide <presentationId> <slideId> <image> [flags]`](commands/gog-slides-replace-slide.md) - Replace the image on an existing slide in-place
+    - [`gog slides (slide) replace-text <presentationId> <find> <replacement> [flags]`](commands/gog-slides-replace-text.md) - Find-and-replace text across a presentation
+    - [`gog slides (slide) thumbnail (thumb) <presentationId> <slideId> [flags]`](commands/gog-slides-thumbnail.md) - Get or download a rendered thumbnail for a slide
+    - [`gog slides (slide) update-notes <presentationId> <slideId> [flags]`](commands/gog-slides-update-notes.md) - Update speaker notes on an existing slide
+  - [`gog status (st) [flags]`](commands/gog-status.md) - Show auth/config status (alias for 'auth status')
+  - [`gog tasks (task) <command> [flags]`](commands/gog-tasks.md) - Google Tasks
+    - [`gog tasks (task) add (create) <tasklistId> [flags]`](commands/gog-tasks-add.md) - Add a task
+    - [`gog tasks (task) clear <tasklistId>`](commands/gog-tasks-clear.md) - Clear completed tasks
+    - [`gog tasks (task) delete (rm,del,remove) <tasklistId> <taskId>`](commands/gog-tasks-delete.md) - Delete a task
+    - [`gog tasks (task) done (complete) <tasklistId> <taskId>`](commands/gog-tasks-done.md) - Mark task completed
+    - [`gog tasks (task) get (info,show) <tasklistId> <taskId>`](commands/gog-tasks-get.md) - Get a task
+    - [`gog tasks (task) list (ls) <tasklistId> [flags]`](commands/gog-tasks-list.md) - List tasks
+    - [`gog tasks (task) lists <command>`](commands/gog-tasks-lists.md) - List task lists
+      - [`gog tasks (task) lists create (add,new) <title> ...`](commands/gog-tasks-lists-create.md) - Create a task list
+      - [`gog tasks (task) lists list [flags]`](commands/gog-tasks-lists-list.md) - List task lists
+    - [`gog tasks (task) undo (uncomplete,undone) <tasklistId> <taskId>`](commands/gog-tasks-undo.md) - Mark task needs action
+    - [`gog tasks (task) update (edit,set) <tasklistId> <taskId> [flags]`](commands/gog-tasks-update.md) - Update a task
+  - [`gog time <command> [flags]`](commands/gog-time.md) - Local time utilities
+    - [`gog time now [flags]`](commands/gog-time-now.md) - Show current time
+  - [`gog upload (up,put) <localPath> [flags]`](commands/gog-upload.md) - Upload a file to Drive (alias for 'drive upload')
+  - [`gog version [flags]`](commands/gog-version.md) - Print version
+  - [`gog whoami (who-am-i) [flags]`](commands/gog-whoami.md) - Show your profile (alias for 'people me')

docs/commands/README.md

@@ -0,0 +1,487 @@
+# Commands
+
+Every `gog` command has a generated docs page. The source of truth is the live CLI schema; run `make docs-commands` after changing command names, flags, help text, aliases, or arguments.
+
+Generated pages: 440.
+
+## Top-level Commands
+
+- [gog admin](gog-admin.md) - Google Workspace Admin (Directory API) - requires domain-wide delegation
+- [gog agent](gog-agent.md) - Agent-friendly helpers
+- [gog appscript](gog-appscript.md) - Google Apps Script
+- [gog auth](gog-auth.md) - Auth and credentials
+- [gog backup](gog-backup.md) - Encrypted Google account backups
+- [gog calendar](gog-calendar.md) - Google Calendar
+- [gog chat](gog-chat.md) - Google Chat
+- [gog classroom](gog-classroom.md) - Google Classroom
+- [gog completion](gog-completion.md) - Generate shell completion scripts
+- [gog config](gog-config.md) - Manage configuration
+- [gog contacts](gog-contacts.md) - Google Contacts
+- [gog docs](gog-docs.md) - Google Docs (export via Drive)
+- [gog download](gog-download.md) - Download a Drive file (alias for 'drive download')
+- [gog drive](gog-drive.md) - Google Drive
+- [gog exit-codes](gog-exit-codes.md) - Print stable exit codes (alias for 'agent exit-codes')
+- [gog forms](gog-forms.md) - Google Forms
+- [gog gmail](gog-gmail.md) - Gmail
+- [gog groups](gog-groups.md) - Google Groups
+- [gog keep](gog-keep.md) - Google Keep (Workspace only)
+- [gog login](gog-login.md) - Authorize and store a refresh token (alias for 'auth add')
+- [gog logout](gog-logout.md) - Remove a stored refresh token (alias for 'auth remove')
+- [gog ls](gog-ls.md) - List Drive files (alias for 'drive ls')
+- [gog me](gog-me.md) - Show your profile (alias for 'people me')
+- [gog open](gog-open.md) - Print a best-effort web URL for a Google URL/ID (offline)
+- [gog people](gog-people.md) - Google People
+- [gog schema](gog-schema.md) - Machine-readable command/flag schema
+- [gog search](gog-search.md) - Search Drive files (alias for 'drive search')
+- [gog send](gog-send.md) - Send an email (alias for 'gmail send')
+- [gog sheets](gog-sheets.md) - Google Sheets
+- [gog slides](gog-slides.md) - Google Slides
+- [gog status](gog-status.md) - Show auth/config status (alias for 'auth status')
+- [gog tasks](gog-tasks.md) - Google Tasks
+- [gog time](gog-time.md) - Local time utilities
+- [gog upload](gog-upload.md) - Upload a file to Drive (alias for 'drive upload')
+- [gog version](gog-version.md) - Print version
+- [gog whoami](gog-whoami.md) - Show your profile (alias for 'people me')
+
+## All Commands
+
+- [gog](gog.md) - Google CLI for Gmail/Calendar/Chat/Classroom/Drive/Contacts/Tasks/Sheets/Docs/Slides/People/Forms/App Script/Ads/Groups/Admin/Keep
+  - [gog admin](gog-admin.md) - Google Workspace Admin (Directory API) - requires domain-wide delegation
+    - [gog admin groups](gog-admin-groups.md) - Manage Workspace groups
+      - [gog admin groups list](gog-admin-groups-list.md) - List groups in a domain
+      - [gog admin groups members](gog-admin-groups-members.md) - Manage group members
+        - [gog admin groups members add](gog-admin-groups-members-add.md) - Add a member to a group
+        - [gog admin groups members list](gog-admin-groups-members-list.md) - List group members
+        - [gog admin groups members remove](gog-admin-groups-members-remove.md) - Remove a member from a group
+    - [gog admin users](gog-admin-users.md) - Manage Workspace users
+      - [gog admin users create](gog-admin-users-create.md) - Create a new user
+      - [gog admin users get](gog-admin-users-get.md) - Get user details
+      - [gog admin users list](gog-admin-users-list.md) - List users in a domain
+      - [gog admin users suspend](gog-admin-users-suspend.md) - Suspend a user account
+  - [gog agent](gog-agent.md) - Agent-friendly helpers
+    - [gog agent exit-codes](gog-agent-exit-codes.md) - Print stable exit codes for automation
+  - [gog appscript](gog-appscript.md) - Google Apps Script
+    - [gog appscript content](gog-appscript-content.md) - Get Apps Script project content
+    - [gog appscript create](gog-appscript-create.md) - Create an Apps Script project
+    - [gog appscript get](gog-appscript-get.md) - Get Apps Script project metadata
+    - [gog appscript run](gog-appscript-run.md) - Run a deployed Apps Script function
+  - [gog auth](gog-auth.md) - Auth and credentials
+    - [gog auth add](gog-auth-add.md) - Authorize and store a refresh token
+    - [gog auth alias](gog-auth-alias.md) - Manage account aliases
+      - [gog auth alias list](gog-auth-alias-list.md) - List account aliases
+      - [gog auth alias set](gog-auth-alias-set.md) - Set an account alias
+      - [gog auth alias unset](gog-auth-alias-unset.md) - Remove an account alias
+    - [gog auth credentials](gog-auth-credentials.md) - Manage OAuth client credentials
+      - [gog auth credentials list](gog-auth-credentials-list.md) - List stored OAuth client credentials
+      - [gog auth credentials remove](gog-auth-credentials-remove.md) - Remove stored OAuth client credentials
+      - [gog auth credentials set](gog-auth-credentials-set.md) - Store OAuth client credentials
+    - [gog auth doctor](gog-auth-doctor.md) - Diagnose auth, keyring, and refresh-token issues
+    - [gog auth keep](gog-auth-keep.md) - Configure service account for Google Keep (Workspace only)
+    - [gog auth keyring](gog-auth-keyring.md) - Configure keyring backend
+    - [gog auth list](gog-auth-list.md) - List stored accounts
+    - [gog auth manage](gog-auth-manage.md) - Open accounts manager in browser
+    - [gog auth remove](gog-auth-remove.md) - Remove a stored refresh token
+    - [gog auth service-account](gog-auth-service-account.md) - Configure service account (Workspace only; domain-wide delegation)
+      - [gog auth service-account set](gog-auth-service-account-set.md) - Store a service account key for impersonation
+      - [gog auth service-account status](gog-auth-service-account-status.md) - Show stored service account key status
+      - [gog auth service-account unset](gog-auth-service-account-unset.md) - Remove stored service account key
+    - [gog auth services](gog-auth-services.md) - List supported auth services and scopes
+    - [gog auth status](gog-auth-status.md) - Show auth configuration and keyring backend
+    - [gog auth tokens](gog-auth-tokens.md) - Manage stored refresh tokens
+      - [gog auth tokens delete](gog-auth-tokens-delete.md) - Delete a stored refresh token
+      - [gog auth tokens export](gog-auth-tokens-export.md) - Export a refresh token to a file (contains secrets)
+      - [gog auth tokens import](gog-auth-tokens-import.md) - Import a refresh token file into keyring (contains secrets)
+      - [gog auth tokens list](gog-auth-tokens-list.md) - List stored tokens (by key only)
+  - [gog backup](gog-backup.md) - Encrypted Google account backups
+    - [gog backup cat](gog-backup-cat.md) - Decrypt one backup shard to stdout
+    - [gog backup export](gog-backup-export.md) - Write a local plaintext export
+    - [gog backup gmail](gog-backup-gmail.md) - Gmail backup operations
+      - [gog backup gmail push](gog-backup-gmail-push.md) - Export Gmail into encrypted backup shards
+    - [gog backup init](gog-backup-init.md) - Initialize encrypted backup config and repository
+    - [gog backup push](gog-backup-push.md) - Export services into encrypted backup shards
+    - [gog backup status](gog-backup-status.md) - Inspect backup manifest without decrypting shards
+    - [gog backup verify](gog-backup-verify.md) - Decrypt and verify all backup shards
+  - [gog calendar](gog-calendar.md) - Google Calendar
+    - [gog calendar acl](gog-calendar-acl.md) - List calendar ACL
+    - [gog calendar alias](gog-calendar-alias.md) - Manage calendar aliases
+      - [gog calendar alias list](gog-calendar-alias-list.md) - List calendar aliases
+      - [gog calendar alias set](gog-calendar-alias-set.md) - Set a calendar alias
+      - [gog calendar alias unset](gog-calendar-alias-unset.md) - Remove a calendar alias
+    - [gog calendar calendars](gog-calendar-calendars.md) - List calendars
+    - [gog calendar colors](gog-calendar-colors.md) - Show calendar colors
+    - [gog calendar conflicts](gog-calendar-conflicts.md) - Find conflicts
+    - [gog calendar create](gog-calendar-create.md) - Create an event
+    - [gog calendar create-calendar](gog-calendar-create-calendar.md) - Create a new secondary calendar
+    - [gog calendar delete](gog-calendar-delete.md) - Delete an event
+    - [gog calendar event](gog-calendar-event.md) - Get event
+    - [gog calendar events](gog-calendar-events.md) - List events from a calendar or all calendars
+    - [gog calendar focus-time](gog-calendar-focus-time.md) - Create a Focus Time block
+    - [gog calendar freebusy](gog-calendar-freebusy.md) - Get free/busy
+    - [gog calendar move](gog-calendar-move.md) - Move an event to another calendar
+    - [gog calendar out-of-office](gog-calendar-out-of-office.md) - Create an Out of Office event
+    - [gog calendar propose-time](gog-calendar-propose-time.md) - Generate URL to propose a new meeting time (browser-only feature)
+    - [gog calendar respond](gog-calendar-respond.md) - Respond to an event invitation
+    - [gog calendar search](gog-calendar-search.md) - Search events
+    - [gog calendar subscribe](gog-calendar-subscribe.md) - Add a calendar to your calendar list
+    - [gog calendar team](gog-calendar-team.md) - Show events for all members of a Google Group
+    - [gog calendar time](gog-calendar-time.md) - Show server time
+    - [gog calendar update](gog-calendar-update.md) - Update an event
+    - [gog calendar users](gog-calendar-users.md) - List workspace users (use their email as calendar ID)
+    - [gog calendar working-location](gog-calendar-working-location.md) - Set working location (home/office/custom)
+  - [gog chat](gog-chat.md) - Google Chat
+    - [gog chat dm](gog-chat-dm.md) - Direct messages
+      - [gog chat dm send](gog-chat-dm-send.md) - Send a direct message
+      - [gog chat dm space](gog-chat-dm-space.md) - Find or create a DM space
+    - [gog chat messages](gog-chat-messages.md) - Chat messages
+      - [gog chat messages list](gog-chat-messages-list.md) - List messages
+      - [gog chat messages react](gog-chat-messages-react.md) - Add an emoji reaction to a message
+      - [gog chat messages reactions](gog-chat-messages-reactions.md) - Manage emoji reactions on a message
+        - [gog chat messages reactions create](gog-chat-messages-reactions-create.md) - Add an emoji reaction to a message
+        - [gog chat messages reactions delete](gog-chat-messages-reactions-delete.md) - Delete a reaction
+        - [gog chat messages reactions list](gog-chat-messages-reactions-list.md) - List reactions on a message
+      - [gog chat messages send](gog-chat-messages-send.md) - Send a message
+    - [gog chat spaces](gog-chat-spaces.md) - Chat spaces
+      - [gog chat spaces create](gog-chat-spaces-create.md) - Create a space
+      - [gog chat spaces find](gog-chat-spaces-find.md) - Find spaces by display name
+      - [gog chat spaces list](gog-chat-spaces-list.md) - List spaces
+    - [gog chat threads](gog-chat-threads.md) - Chat threads
+      - [gog chat threads list](gog-chat-threads-list.md) - List threads in a space
+  - [gog classroom](gog-classroom.md) - Google Classroom
+    - [gog classroom announcements](gog-classroom-announcements.md) - Announcements
+      - [gog classroom announcements assignees](gog-classroom-announcements-assignees.md) - Modify announcement assignees
+      - [gog classroom announcements create](gog-classroom-announcements-create.md) - Create an announcement
+      - [gog classroom announcements delete](gog-classroom-announcements-delete.md) - Delete an announcement
+      - [gog classroom announcements get](gog-classroom-announcements-get.md) - Get an announcement
+      - [gog classroom announcements list](gog-classroom-announcements-list.md) - List announcements
+      - [gog classroom announcements update](gog-classroom-announcements-update.md) - Update an announcement
+    - [gog classroom courses](gog-classroom-courses.md) - Courses
+      - [gog classroom courses archive](gog-classroom-courses-archive.md) - Archive a course
+      - [gog classroom courses create](gog-classroom-courses-create.md) - Create a course
+      - [gog classroom courses delete](gog-classroom-courses-delete.md) - Delete a course
+      - [gog classroom courses get](gog-classroom-courses-get.md) - Get a course
+      - [gog classroom courses join](gog-classroom-courses-join.md) - Join a course
+      - [gog classroom courses leave](gog-classroom-courses-leave.md) - Leave a course
+      - [gog classroom courses list](gog-classroom-courses-list.md) - List courses
+      - [gog classroom courses unarchive](gog-classroom-courses-unarchive.md) - Unarchive a course
+      - [gog classroom courses update](gog-classroom-courses-update.md) - Update a course
+      - [gog classroom courses url](gog-classroom-courses-url.md) - Print Classroom web URLs for courses
+    - [gog classroom coursework](gog-classroom-coursework.md) - Coursework
+      - [gog classroom coursework assignees](gog-classroom-coursework-assignees.md) - Modify coursework assignees
+      - [gog classroom coursework create](gog-classroom-coursework-create.md) - Create coursework
+      - [gog classroom coursework delete](gog-classroom-coursework-delete.md) - Delete coursework
+      - [gog classroom coursework get](gog-classroom-coursework-get.md) - Get coursework
+      - [gog classroom coursework list](gog-classroom-coursework-list.md) - List coursework
+      - [gog classroom coursework update](gog-classroom-coursework-update.md) - Update coursework
+    - [gog classroom guardian-invitations](gog-classroom-guardian-invitations.md) - Guardian invitations
+      - [gog classroom guardian-invitations create](gog-classroom-guardian-invitations-create.md) - Create a guardian invitation
+      - [gog classroom guardian-invitations get](gog-classroom-guardian-invitations-get.md) - Get a guardian invitation
+      - [gog classroom guardian-invitations list](gog-classroom-guardian-invitations-list.md) - List guardian invitations
+    - [gog classroom guardians](gog-classroom-guardians.md) - Guardians
+      - [gog classroom guardians delete](gog-classroom-guardians-delete.md) - Delete a guardian
+      - [gog classroom guardians get](gog-classroom-guardians-get.md) - Get a guardian
+      - [gog classroom guardians list](gog-classroom-guardians-list.md) - List guardians
+    - [gog classroom invitations](gog-classroom-invitations.md) - Invitations
+      - [gog classroom invitations accept](gog-classroom-invitations-accept.md) - Accept an invitation
+      - [gog classroom invitations create](gog-classroom-invitations-create.md) - Create an invitation
+      - [gog classroom invitations delete](gog-classroom-invitations-delete.md) - Delete an invitation
+      - [gog classroom invitations get](gog-classroom-invitations-get.md) - Get an invitation
+      - [gog classroom invitations list](gog-classroom-invitations-list.md) - List invitations
+    - [gog classroom materials](gog-classroom-materials.md) - Coursework materials
+      - [gog classroom materials create](gog-classroom-materials-create.md) - Create coursework material
+      - [gog classroom materials delete](gog-classroom-materials-delete.md) - Delete coursework material
+      - [gog classroom materials get](gog-classroom-materials-get.md) - Get coursework material
+      - [gog classroom materials list](gog-classroom-materials-list.md) - List coursework materials
+      - [gog classroom materials update](gog-classroom-materials-update.md) - Update coursework material
+    - [gog classroom profile](gog-classroom-profile.md) - User profiles
+      - [gog classroom profile get](gog-classroom-profile-get.md) - Get a user profile
+    - [gog classroom roster](gog-classroom-roster.md) - Course roster (students + teachers)
+    - [gog classroom students](gog-classroom-students.md) - Course students
+      - [gog classroom students add](gog-classroom-students-add.md) - Add a student
+      - [gog classroom students get](gog-classroom-students-get.md) - Get a student
+      - [gog classroom students list](gog-classroom-students-list.md) - List students
+      - [gog classroom students remove](gog-classroom-students-remove.md) - Remove a student
+    - [gog classroom submissions](gog-classroom-submissions.md) - Student submissions
+      - [gog classroom submissions get](gog-classroom-submissions-get.md) - Get a student submission
+      - [gog classroom submissions grade](gog-classroom-submissions-grade.md) - Set draft/assigned grades
+      - [gog classroom submissions list](gog-classroom-submissions-list.md) - List student submissions
+      - [gog classroom submissions reclaim](gog-classroom-submissions-reclaim.md) - Reclaim a submission
+      - [gog classroom submissions return](gog-classroom-submissions-return.md) - Return a submission
+      - [gog classroom submissions turn-in](gog-classroom-submissions-turn-in.md) - Turn in a submission
+    - [gog classroom teachers](gog-classroom-teachers.md) - Course teachers
+      - [gog classroom teachers add](gog-classroom-teachers-add.md) - Add a teacher
+      - [gog classroom teachers get](gog-classroom-teachers-get.md) - Get a teacher
+      - [gog classroom teachers list](gog-classroom-teachers-list.md) - List teachers
+      - [gog classroom teachers remove](gog-classroom-teachers-remove.md) - Remove a teacher
+    - [gog classroom topics](gog-classroom-topics.md) - Topics
+      - [gog classroom topics create](gog-classroom-topics-create.md) - Create a topic
+      - [gog classroom topics delete](gog-classroom-topics-delete.md) - Delete a topic
+      - [gog classroom topics get](gog-classroom-topics-get.md) - Get a topic
+      - [gog classroom topics list](gog-classroom-topics-list.md) - List topics
+      - [gog classroom topics update](gog-classroom-topics-update.md) - Update a topic
+  - [gog completion](gog-completion.md) - Generate shell completion scripts
+  - [gog config](gog-config.md) - Manage configuration
+    - [gog config get](gog-config-get.md) - Get a config value
+    - [gog config keys](gog-config-keys.md) - List available config keys
+    - [gog config list](gog-config-list.md) - List all config values
+    - [gog config no-send](gog-config-no-send.md) - Manage per-account Gmail no-send guards
+      - [gog config no-send list](gog-config-no-send-list.md) - List accounts with no-send guards
+      - [gog config no-send remove](gog-config-no-send-remove.md) - Remove an account no-send guard
+      - [gog config no-send set](gog-config-no-send-set.md) - Block Gmail send operations for an account
+    - [gog config path](gog-config-path.md) - Print config file path
+    - [gog config set](gog-config-set.md) - Set a config value
+    - [gog config unset](gog-config-unset.md) - Unset a config value
+  - [gog contacts](gog-contacts.md) - Google Contacts
+    - [gog contacts create](gog-contacts-create.md) - Create a contact
+    - [gog contacts delete](gog-contacts-delete.md) - Delete a contact
+    - [gog contacts directory](gog-contacts-directory.md) - Directory contacts
+      - [gog contacts directory list](gog-contacts-directory-list.md) - List people from the Workspace directory
+      - [gog contacts directory search](gog-contacts-directory-search.md) - Search people in the Workspace directory
+    - [gog contacts export](gog-contacts-export.md) - Export contacts as vCard (.vcf)
+    - [gog contacts get](gog-contacts-get.md) - Get a contact
+    - [gog contacts list](gog-contacts-list.md) - List contacts
+    - [gog contacts other](gog-contacts-other.md) - Other contacts
+      - [gog contacts other delete](gog-contacts-other-delete.md) - Delete an other contact
+      - [gog contacts other list](gog-contacts-other-list.md) - List other contacts
+      - [gog contacts other search](gog-contacts-other-search.md) - Search other contacts
+    - [gog contacts search](gog-contacts-search.md) - Search contacts by name/email/phone
+    - [gog contacts update](gog-contacts-update.md) - Update a contact
+  - [gog docs](gog-docs.md) - Google Docs (export via Drive)
+    - [gog docs add-tab](gog-docs-add-tab.md) - Add a tab to a Google Doc
+    - [gog docs cat](gog-docs-cat.md) - Print a Google Doc as plain text
+    - [gog docs clear](gog-docs-clear.md) - Clear all content from a Google Doc
+    - [gog docs comments](gog-docs-comments.md) - Manage comments on files
+      - [gog docs comments add](gog-docs-comments-add.md) - Add a comment to a Google Doc
+      - [gog docs comments delete](gog-docs-comments-delete.md) - Delete a comment
+      - [gog docs comments get](gog-docs-comments-get.md) - Get a comment by ID
+      - [gog docs comments list](gog-docs-comments-list.md) - List comments on a Google Doc
+      - [gog docs comments reply](gog-docs-comments-reply.md) - Reply to a comment
+      - [gog docs comments resolve](gog-docs-comments-resolve.md) - Resolve a comment (mark as done)
+    - [gog docs copy](gog-docs-copy.md) - Copy a Google Doc
+    - [gog docs create](gog-docs-create.md) - Create a Google Doc
+    - [gog docs delete](gog-docs-delete.md) - Delete text range from document
+    - [gog docs delete-tab](gog-docs-delete-tab.md) - Delete a tab from a Google Doc
+    - [gog docs edit](gog-docs-edit.md) - Find and replace text in a Google Doc
+    - [gog docs export](gog-docs-export.md) - Export a Google Doc (pdf|docx|txt|md|html)
+    - [gog docs find-replace](gog-docs-find-replace.md) - Find and replace text. Supports plain text or markdown with images; use --first for a single occurrence.
+    - [gog docs info](gog-docs-info.md) - Get Google Doc metadata
+    - [gog docs insert](gog-docs-insert.md) - Insert text at a specific position
+    - [gog docs list-tabs](gog-docs-list-tabs.md) - List all tabs in a Google Doc
+    - [gog docs rename-tab](gog-docs-rename-tab.md) - Rename a tab in a Google Doc
+    - [gog docs sed](gog-docs-sed.md) - Regex find/replace (sed-style: s/pattern/replacement/g)
+    - [gog docs structure](gog-docs-structure.md) - Show document structure with numbered paragraphs
+    - [gog docs update](gog-docs-update.md) - Insert text at a specific index in a Google Doc
+    - [gog docs write](gog-docs-write.md) - Write content to a Google Doc
+  - [gog download](gog-download.md) - Download a Drive file (alias for 'drive download')
+  - [gog drive](gog-drive.md) - Google Drive
+    - [gog drive comments](gog-drive-comments.md) - Manage comments on files
+      - [gog drive comments create](gog-drive-comments-create.md) - Create a comment on a file
+      - [gog drive comments delete](gog-drive-comments-delete.md) - Delete a comment
+      - [gog drive comments get](gog-drive-comments-get.md) - Get a comment by ID
+      - [gog drive comments list](gog-drive-comments-list.md) - List comments on a file
+      - [gog drive comments reply](gog-drive-comments-reply.md) - Reply to a comment
+      - [gog drive comments update](gog-drive-comments-update.md) - Update a comment
+    - [gog drive copy](gog-drive-copy.md) - Copy a file
+    - [gog drive delete](gog-drive-delete.md) - Move a file to trash (use --permanent to delete forever)
+    - [gog drive download](gog-drive-download.md) - Download a file (exports Google Docs formats)
+    - [gog drive drives](gog-drive-drives.md) - List shared drives (Team Drives)
+    - [gog drive get](gog-drive-get.md) - Get file metadata
+    - [gog drive ls](gog-drive-ls.md) - List files in a folder (default: root)
+    - [gog drive mkdir](gog-drive-mkdir.md) - Create a folder
+    - [gog drive move](gog-drive-move.md) - Move a file to a different folder
+    - [gog drive permissions](gog-drive-permissions.md) - List permissions on a file
+    - [gog drive rename](gog-drive-rename.md) - Rename a file or folder
+    - [gog drive search](gog-drive-search.md) - Full-text search across Drive
+    - [gog drive share](gog-drive-share.md) - Share a file or folder
+    - [gog drive unshare](gog-drive-unshare.md) - Remove a permission from a file
+    - [gog drive upload](gog-drive-upload.md) - Upload a file
+    - [gog drive url](gog-drive-url.md) - Print web URLs for files
+  - [gog exit-codes](gog-exit-codes.md) - Print stable exit codes (alias for 'agent exit-codes')
+  - [gog forms](gog-forms.md) - Google Forms
+    - [gog forms add-question](gog-forms-add-question.md) - Add a question to a form
+    - [gog forms create](gog-forms-create.md) - Create a form
+    - [gog forms delete-question](gog-forms-delete-question.md) - Delete a question by index
+    - [gog forms get](gog-forms-get.md) - Get a form
+    - [gog forms move-question](gog-forms-move-question.md) - Move a question to a new position
+    - [gog forms responses](gog-forms-responses.md) - Form responses
+      - [gog forms responses get](gog-forms-responses-get.md) - Get a form response
+      - [gog forms responses list](gog-forms-responses-list.md) - List form responses
+    - [gog forms update](gog-forms-update.md) - Update form title, description, or settings
+    - [gog forms watch](gog-forms-watch.md) - Response watches (push notifications)
+      - [gog forms watch create](gog-forms-watch-create.md) - Create a watch for new responses
+      - [gog forms watch delete](gog-forms-watch-delete.md) - Delete a watch
+      - [gog forms watch list](gog-forms-watch-list.md) - List active watches
+      - [gog forms watch renew](gog-forms-watch-renew.md) - Renew a watch (extends 7 days)
+  - [gog gmail](gog-gmail.md) - Gmail
+    - [gog gmail archive](gog-gmail-archive.md) - Archive messages (remove from inbox)
+    - [gog gmail attachment](gog-gmail-attachment.md) - Download a single attachment
+    - [gog gmail autoreply](gog-gmail-autoreply.md) - Reply once to matching messages
+    - [gog gmail batch](gog-gmail-batch.md) - Batch operations (permanent delete requires broader Gmail scope; use gmail trash for normal trashing)
+      - [gog gmail batch delete](gog-gmail-batch-delete.md) - Permanently delete multiple messages; use 'gmail trash' to move messages to trash with the default gmail.modify scope
+      - [gog gmail batch modify](gog-gmail-batch-modify.md) - Modify labels on multiple messages
+    - [gog gmail drafts](gog-gmail-drafts.md) - Draft operations
+      - [gog gmail drafts create](gog-gmail-drafts-create.md) - Create a draft
+      - [gog gmail drafts delete](gog-gmail-drafts-delete.md) - Delete a draft
+      - [gog gmail drafts get](gog-gmail-drafts-get.md) - Get draft details
+      - [gog gmail drafts list](gog-gmail-drafts-list.md) - List drafts
+      - [gog gmail drafts send](gog-gmail-drafts-send.md) - Send a draft
+      - [gog gmail drafts update](gog-gmail-drafts-update.md) - Update a draft
+    - [gog gmail forward](gog-gmail-forward.md) - Forward a message to new recipients
+    - [gog gmail get](gog-gmail-get.md) - Get a message (full|metadata|raw)
+    - [gog gmail history](gog-gmail-history.md) - Gmail history
+    - [gog gmail labels](gog-gmail-labels.md) - Label operations
+      - [gog gmail labels create](gog-gmail-labels-create.md) - Create a new label
+      - [gog gmail labels delete](gog-gmail-labels-delete.md) - Delete a label
+      - [gog gmail labels get](gog-gmail-labels-get.md) - Get label details (including counts)
+      - [gog gmail labels list](gog-gmail-labels-list.md) - List labels
+      - [gog gmail labels modify](gog-gmail-labels-modify.md) - Modify labels on threads
+      - [gog gmail labels rename](gog-gmail-labels-rename.md) - Rename a label
+      - [gog gmail labels style](gog-gmail-labels-style.md) - Change a user label color or visibility
+    - [gog gmail mark-read](gog-gmail-mark-read.md) - Mark messages as read
+    - [gog gmail messages](gog-gmail-messages.md) - Message operations
+      - [gog gmail messages modify](gog-gmail-messages-modify.md) - Modify labels on a single message
+      - [gog gmail messages search](gog-gmail-messages-search.md) - Search messages using Gmail query syntax
+    - [gog gmail search](gog-gmail-search.md) - Search threads using Gmail query syntax
+    - [gog gmail send](gog-gmail-send.md) - Send an email
+    - [gog gmail settings](gog-gmail-settings.md) - Settings and admin
+      - [gog gmail settings autoforward](gog-gmail-settings-autoforward.md) - Auto-forwarding settings
+        - [gog gmail settings autoforward get](gog-gmail-settings-autoforward-get.md) - Get current auto-forwarding settings
+        - [gog gmail settings autoforward update](gog-gmail-settings-autoforward-update.md) - Update auto-forwarding settings
+      - [gog gmail settings delegates](gog-gmail-settings-delegates.md) - Delegate operations
+        - [gog gmail settings delegates add](gog-gmail-settings-delegates-add.md) - Add a delegate
+        - [gog gmail settings delegates get](gog-gmail-settings-delegates-get.md) - Get a specific delegate's information
+        - [gog gmail settings delegates list](gog-gmail-settings-delegates-list.md) - List all delegates
+        - [gog gmail settings delegates remove](gog-gmail-settings-delegates-remove.md) - Remove a delegate
+      - [gog gmail settings filters](gog-gmail-settings-filters.md) - Filter operations
+        - [gog gmail settings filters create](gog-gmail-settings-filters-create.md) - Create a new email filter
+        - [gog gmail settings filters delete](gog-gmail-settings-filters-delete.md) - Delete a filter
+        - [gog gmail settings filters export](gog-gmail-settings-filters-export.md) - Export filters as JSON
+        - [gog gmail settings filters get](gog-gmail-settings-filters-get.md) - Get a specific filter
+        - [gog gmail settings filters list](gog-gmail-settings-filters-list.md) - List all email filters
+      - [gog gmail settings forwarding](gog-gmail-settings-forwarding.md) - Forwarding addresses
+        - [gog gmail settings forwarding create](gog-gmail-settings-forwarding-create.md) - Create/add a forwarding address
+        - [gog gmail settings forwarding delete](gog-gmail-settings-forwarding-delete.md) - Delete a forwarding address
+        - [gog gmail settings forwarding get](gog-gmail-settings-forwarding-get.md) - Get a specific forwarding address
+        - [gog gmail settings forwarding list](gog-gmail-settings-forwarding-list.md) - List all forwarding addresses
+      - [gog gmail settings sendas](gog-gmail-settings-sendas.md) - Send-as settings
+        - [gog gmail settings sendas create](gog-gmail-settings-sendas-create.md) - Create a new send-as alias
+        - [gog gmail settings sendas delete](gog-gmail-settings-sendas-delete.md) - Delete a send-as alias
+        - [gog gmail settings sendas get](gog-gmail-settings-sendas-get.md) - Get details of a send-as alias
+        - [gog gmail settings sendas list](gog-gmail-settings-sendas-list.md) - List send-as aliases
+        - [gog gmail settings sendas update](gog-gmail-settings-sendas-update.md) - Update a send-as alias
+        - [gog gmail settings sendas verify](gog-gmail-settings-sendas-verify.md) - Resend verification email for a send-as alias
+      - [gog gmail settings vacation](gog-gmail-settings-vacation.md) - Vacation responder
+        - [gog gmail settings vacation get](gog-gmail-settings-vacation-get.md) - Get current vacation responder settings
+        - [gog gmail settings vacation update](gog-gmail-settings-vacation-update.md) - Update vacation responder settings
+      - [gog gmail settings watch](gog-gmail-settings-watch.md) - Manage Gmail watch
+        - [gog gmail settings watch renew](gog-gmail-settings-watch-renew.md) - Renew Gmail watch using stored config
+        - [gog gmail settings watch serve](gog-gmail-settings-watch-serve.md) - Run Pub/Sub push handler
+        - [gog gmail settings watch start](gog-gmail-settings-watch-start.md) - Start Gmail watch for Pub/Sub
+        - [gog gmail settings watch status](gog-gmail-settings-watch-status.md) - Show stored watch state
+        - [gog gmail settings watch stop](gog-gmail-settings-watch-stop.md) - Stop Gmail watch and clear stored state
+    - [gog gmail thread](gog-gmail-thread.md) - Thread operations (get, modify)
+      - [gog gmail thread attachments](gog-gmail-thread-attachments.md) - List all attachments in a thread
+      - [gog gmail thread get](gog-gmail-thread-get.md) - Get a thread with all messages (optionally download attachments)
+      - [gog gmail thread modify](gog-gmail-thread-modify.md) - Modify labels on all messages in a thread
+    - [gog gmail track](gog-gmail-track.md) - Email open tracking
+      - [gog gmail track key](gog-gmail-track-key.md) - Manage tracking encryption keys
+        - [gog gmail track key rotate](gog-gmail-track-key-rotate.md) - Rotate tracking encryption key
+      - [gog gmail track opens](gog-gmail-track-opens.md) - Query email opens
+      - [gog gmail track setup](gog-gmail-track-setup.md) - Set up email tracking (deploy Cloudflare Worker)
+      - [gog gmail track status](gog-gmail-track-status.md) - Show tracking configuration status
+    - [gog gmail trash](gog-gmail-trash.md) - Move messages to trash
+    - [gog gmail unread](gog-gmail-unread.md) - Mark messages as unread
+    - [gog gmail url](gog-gmail-url.md) - Print Gmail web URLs for threads
+  - [gog groups](gog-groups.md) - Google Groups
+    - [gog groups list](gog-groups-list.md) - List groups you belong to
+    - [gog groups members](gog-groups-members.md) - List members of a group
+  - [gog keep](gog-keep.md) - Google Keep (Workspace only)
+    - [gog keep attachment](gog-keep-attachment.md) - Download an attachment
+    - [gog keep create](gog-keep-create.md) - Create a new note
+    - [gog keep delete](gog-keep-delete.md) - Delete a note
+    - [gog keep get](gog-keep-get.md) - Get a note
+    - [gog keep list](gog-keep-list.md) - List notes
+    - [gog keep search](gog-keep-search.md) - Search notes by text (client-side)
+  - [gog login](gog-login.md) - Authorize and store a refresh token (alias for 'auth add')
+  - [gog logout](gog-logout.md) - Remove a stored refresh token (alias for 'auth remove')
+  - [gog ls](gog-ls.md) - List Drive files (alias for 'drive ls')
+  - [gog me](gog-me.md) - Show your profile (alias for 'people me')
+  - [gog open](gog-open.md) - Print a best-effort web URL for a Google URL/ID (offline)
+  - [gog people](gog-people.md) - Google People
+    - [gog people get](gog-people-get.md) - Get a user profile by ID
+    - [gog people me](gog-people-me.md) - Show your profile (people/me)
+    - [gog people relations](gog-people-relations.md) - Get user relations
+    - [gog people search](gog-people-search.md) - Search the Workspace directory
+  - [gog schema](gog-schema.md) - Machine-readable command/flag schema
+  - [gog search](gog-search.md) - Search Drive files (alias for 'drive search')
+  - [gog send](gog-send.md) - Send an email (alias for 'gmail send')
+  - [gog sheets](gog-sheets.md) - Google Sheets
+    - [gog sheets add-tab](gog-sheets-add-tab.md) - Add a new tab/sheet to a spreadsheet
+    - [gog sheets append](gog-sheets-append.md) - Append values to a range
+    - [gog sheets chart](gog-sheets-chart.md) - Manage spreadsheet charts
+      - [gog sheets chart create](gog-sheets-chart-create.md) - Create a chart from a JSON spec
+      - [gog sheets chart delete](gog-sheets-chart-delete.md) - Delete a chart
+      - [gog sheets chart get](gog-sheets-chart-get.md) - Get full chart definition (spec + position)
+      - [gog sheets chart list](gog-sheets-chart-list.md) - List charts in a spreadsheet
+      - [gog sheets chart update](gog-sheets-chart-update.md) - Update a chart spec
+    - [gog sheets clear](gog-sheets-clear.md) - Clear values in a range
+    - [gog sheets copy](gog-sheets-copy.md) - Copy a Google Sheet
+    - [gog sheets create](gog-sheets-create.md) - Create a new spreadsheet
+    - [gog sheets delete-tab](gog-sheets-delete-tab.md) - Delete a tab/sheet from a spreadsheet (use --force to skip confirmation)
+    - [gog sheets export](gog-sheets-export.md) - Export a Google Sheet (pdf|xlsx|csv) via Drive
+    - [gog sheets find-replace](gog-sheets-find-replace.md) - Find and replace text across a spreadsheet
+    - [gog sheets format](gog-sheets-format.md) - Apply cell formatting to a range
+    - [gog sheets freeze](gog-sheets-freeze.md) - Freeze rows and columns on a sheet
+    - [gog sheets get](gog-sheets-get.md) - Get values from a range
+    - [gog sheets insert](gog-sheets-insert.md) - Insert empty rows or columns into a sheet
+    - [gog sheets links](gog-sheets-links.md) - Get cell hyperlinks from a range
+    - [gog sheets merge](gog-sheets-merge.md) - Merge cells in a range
+    - [gog sheets metadata](gog-sheets-metadata.md) - Get spreadsheet metadata
+    - [gog sheets named-ranges](gog-sheets-named-ranges.md) - Manage named ranges
+      - [gog sheets named-ranges add](gog-sheets-named-ranges-add.md) - Add a named range
+      - [gog sheets named-ranges delete](gog-sheets-named-ranges-delete.md) - Delete a named range
+      - [gog sheets named-ranges get](gog-sheets-named-ranges-get.md) - Get a named range
+      - [gog sheets named-ranges list](gog-sheets-named-ranges-list.md) - List named ranges
+      - [gog sheets named-ranges update](gog-sheets-named-ranges-update.md) - Update a named range
+    - [gog sheets notes](gog-sheets-notes.md) - Get cell notes from a range
+    - [gog sheets number-format](gog-sheets-number-format.md) - Apply number format to a range
+    - [gog sheets read-format](gog-sheets-read-format.md) - Read cell formatting from a range
+    - [gog sheets rename-tab](gog-sheets-rename-tab.md) - Rename a tab/sheet in a spreadsheet
+    - [gog sheets resize-columns](gog-sheets-resize-columns.md) - Resize sheet columns
+    - [gog sheets resize-rows](gog-sheets-resize-rows.md) - Resize sheet rows
+    - [gog sheets unmerge](gog-sheets-unmerge.md) - Unmerge cells in a range
+    - [gog sheets update](gog-sheets-update.md) - Update values in a range
+    - [gog sheets update-note](gog-sheets-update-note.md) - Set or clear a cell note
+  - [gog slides](gog-slides.md) - Google Slides
+    - [gog slides add-slide](gog-slides-add-slide.md) - Add a slide with a full-bleed image and optional speaker notes
+    - [gog slides copy](gog-slides-copy.md) - Copy a Google Slides presentation
+    - [gog slides create](gog-slides-create.md) - Create a Google Slides presentation
+    - [gog slides create-from-markdown](gog-slides-create-from-markdown.md) - Create a Google Slides presentation from markdown
+    - [gog slides create-from-template](gog-slides-create-from-template.md) - Create a presentation from template with text replacements
+    - [gog slides delete-slide](gog-slides-delete-slide.md) - Delete a slide by object ID
+    - [gog slides export](gog-slides-export.md) - Export a Google Slides deck (pdf|pptx)
+    - [gog slides info](gog-slides-info.md) - Get Google Slides presentation metadata
+    - [gog slides insert-text](gog-slides-insert-text.md) - Insert text into an existing page element (shape or table) by objectId
+    - [gog slides list-slides](gog-slides-list-slides.md) - List all slides with their object IDs
+    - [gog slides read-slide](gog-slides-read-slide.md) - Read slide content: speaker notes, text elements, and images
+    - [gog slides replace-slide](gog-slides-replace-slide.md) - Replace the image on an existing slide in-place
+    - [gog slides replace-text](gog-slides-replace-text.md) - Find-and-replace text across a presentation
+    - [gog slides thumbnail](gog-slides-thumbnail.md) - Get or download a rendered thumbnail for a slide
+    - [gog slides update-notes](gog-slides-update-notes.md) - Update speaker notes on an existing slide
+  - [gog status](gog-status.md) - Show auth/config status (alias for 'auth status')
+  - [gog tasks](gog-tasks.md) - Google Tasks
+    - [gog tasks add](gog-tasks-add.md) - Add a task
+    - [gog tasks clear](gog-tasks-clear.md) - Clear completed tasks
+    - [gog tasks delete](gog-tasks-delete.md) - Delete a task
+    - [gog tasks done](gog-tasks-done.md) - Mark task completed
+    - [gog tasks get](gog-tasks-get.md) - Get a task
+    - [gog tasks list](gog-tasks-list.md) - List tasks
+    - [gog tasks lists](gog-tasks-lists.md) - List task lists
+      - [gog tasks lists create](gog-tasks-lists-create.md) - Create a task list
+      - [gog tasks lists list](gog-tasks-lists-list.md) - List task lists
+    - [gog tasks undo](gog-tasks-undo.md) - Mark task needs action
+    - [gog tasks update](gog-tasks-update.md) - Update a task
+  - [gog time](gog-time.md) - Local time utilities
+    - [gog time now](gog-time-now.md) - Show current time
+  - [gog upload](gog-upload.md) - Upload a file to Drive (alias for 'drive upload')
+  - [gog version](gog-version.md) - Print version
+  - [gog whoami](gog-whoami.md) - Show your profile (alias for 'people me')

docs/commands/gog-admin-groups-list.md

@@ -0,0 +1,47 @@
+# `gog admin groups list`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+List groups in a domain
+
+## Usage
+
+```bash
+gog admin groups list (ls) [flags]
+```
+
+## Parent
+
+- [gog admin groups](gog-admin-groups.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--all`<br>`--all-pages`<br>`--allpages` | `bool` |  | Fetch all pages |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `--domain` | `string` |  | Domain to list groups from (e.g., example.com) |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `--fail-empty`<br>`--non-empty`<br>`--require-results` | `bool` |  | Exit with code 3 if no results |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--max`<br>`--limit` | `int64` | 100 | Max results |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--page`<br>`--cursor` | `string` |  | Page token |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog admin groups](gog-admin-groups.md)
+- [Command index](README.md)

docs/commands/gog-admin-groups-members-add.md

@@ -0,0 +1,43 @@
+# `gog admin groups members add`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Add a member to a group
+
+## Usage
+
+```bash
+gog admin groups members add (invite) <groupEmail> <memberEmail> [flags]
+```
+
+## Parent
+
+- [gog admin groups members](gog-admin-groups-members.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--role` | `string` | MEMBER | Member role (MEMBER, MANAGER, OWNER) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog admin groups members](gog-admin-groups-members.md)
+- [Command index](README.md)

docs/commands/gog-admin-groups-members-list.md

@@ -0,0 +1,46 @@
+# `gog admin groups members list`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+List group members
+
+## Usage
+
+```bash
+gog admin groups members list (ls) <groupEmail> [flags]
+```
+
+## Parent
+
+- [gog admin groups members](gog-admin-groups-members.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--all`<br>`--all-pages`<br>`--allpages` | `bool` |  | Fetch all pages |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `--fail-empty`<br>`--non-empty`<br>`--require-results` | `bool` |  | Exit with code 3 if no results |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--max`<br>`--limit` | `int64` | 100 | Max results |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--page`<br>`--cursor` | `string` |  | Page token |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog admin groups members](gog-admin-groups-members.md)
+- [Command index](README.md)

docs/commands/gog-admin-groups-members-remove.md

@@ -0,0 +1,42 @@
+# `gog admin groups members remove`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Remove a member from a group
+
+## Usage
+
+```bash
+gog admin groups members remove (rm,del,delete) <groupEmail> <memberEmail>
+```
+
+## Parent
+
+- [gog admin groups members](gog-admin-groups-members.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog admin groups members](gog-admin-groups-members.md)
+- [Command index](README.md)

docs/commands/gog-admin-groups-members.md

@@ -0,0 +1,48 @@
+# `gog admin groups members`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Manage group members
+
+## Usage
+
+```bash
+gog admin groups members <command>
+```
+
+## Parent
+
+- [gog admin groups](gog-admin-groups.md)
+
+## Subcommands
+
+- [gog admin groups members add](gog-admin-groups-members-add.md) - Add a member to a group
+- [gog admin groups members list](gog-admin-groups-members-list.md) - List group members
+- [gog admin groups members remove](gog-admin-groups-members-remove.md) - Remove a member from a group
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog admin groups](gog-admin-groups.md)
+- [Command index](README.md)

docs/commands/gog-admin-groups.md

@@ -0,0 +1,47 @@
+# `gog admin groups`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Manage Workspace groups
+
+## Usage
+
+```bash
+gog admin groups <command>
+```
+
+## Parent
+
+- [gog admin](gog-admin.md)
+
+## Subcommands
+
+- [gog admin groups list](gog-admin-groups-list.md) - List groups in a domain
+- [gog admin groups members](gog-admin-groups-members.md) - Manage group members
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog admin](gog-admin.md)
+- [Command index](README.md)

docs/commands/gog-admin-users-create.md

@@ -0,0 +1,48 @@
+# `gog admin users create`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Create a new user
+
+## Usage
+
+```bash
+gog admin users create (add,new) <email> [flags]
+```
+
+## Parent
+
+- [gog admin users](gog-admin-users.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--admin` | `bool` |  | Not supported; assign admin roles separately after user creation |
+| `--change-password` | `bool` |  | Require password change on first login |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `--family` | `string` |  | Family (last) name |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--given` | `string` |  | Given (first) name |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--org-unit` | `string` |  | Organization unit path |
+| `--password` | `string` |  | Initial password |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog admin users](gog-admin-users.md)
+- [Command index](README.md)

docs/commands/gog-admin-users-get.md

@@ -0,0 +1,42 @@
+# `gog admin users get`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Get user details
+
+## Usage
+
+```bash
+gog admin users get (info,show) <userEmail>
+```
+
+## Parent
+
+- [gog admin users](gog-admin-users.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog admin users](gog-admin-users.md)
+- [Command index](README.md)

docs/commands/gog-admin-users-list.md

@@ -0,0 +1,47 @@
+# `gog admin users list`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+List users in a domain
+
+## Usage
+
+```bash
+gog admin users list (ls) [flags]
+```
+
+## Parent
+
+- [gog admin users](gog-admin-users.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--all`<br>`--all-pages`<br>`--allpages` | `bool` |  | Fetch all pages |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `--domain` | `string` |  | Domain to list users from (e.g., example.com) |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `--fail-empty`<br>`--non-empty`<br>`--require-results` | `bool` |  | Exit with code 3 if no results |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--max`<br>`--limit` | `int64` | 100 | Max results |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--page`<br>`--cursor` | `string` |  | Page token |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog admin users](gog-admin-users.md)
+- [Command index](README.md)

docs/commands/gog-admin-users-suspend.md

@@ -0,0 +1,42 @@
+# `gog admin users suspend`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Suspend a user account
+
+## Usage
+
+```bash
+gog admin users suspend <userEmail>
+```
+
+## Parent
+
+- [gog admin users](gog-admin-users.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog admin users](gog-admin-users.md)
+- [Command index](README.md)

docs/commands/gog-admin-users.md

@@ -0,0 +1,49 @@
+# `gog admin users`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Manage Workspace users
+
+## Usage
+
+```bash
+gog admin users <command>
+```
+
+## Parent
+
+- [gog admin](gog-admin.md)
+
+## Subcommands
+
+- [gog admin users create](gog-admin-users-create.md) - Create a new user
+- [gog admin users get](gog-admin-users-get.md) - Get user details
+- [gog admin users list](gog-admin-users-list.md) - List users in a domain
+- [gog admin users suspend](gog-admin-users-suspend.md) - Suspend a user account
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog admin](gog-admin.md)
+- [Command index](README.md)

docs/commands/gog-admin.md

@@ -0,0 +1,47 @@
+# `gog admin`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Google Workspace Admin (Directory API) - requires domain-wide delegation
+
+## Usage
+
+```bash
+gog admin <command> [flags]
+```
+
+## Parent
+
+- [gog](gog.md)
+
+## Subcommands
+
+- [gog admin groups](gog-admin-groups.md) - Manage Workspace groups
+- [gog admin users](gog-admin-users.md) - Manage Workspace users
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog](gog.md)
+- [Command index](README.md)

docs/commands/gog-agent-exit-codes.md

@@ -0,0 +1,42 @@
+# `gog agent exit-codes`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Print stable exit codes for automation
+
+## Usage
+
+```bash
+gog agent exit-codes (exitcodes,exit-code)
+```
+
+## Parent
+
+- [gog agent](gog-agent.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog agent](gog-agent.md)
+- [Command index](README.md)

docs/commands/gog-agent.md

@@ -0,0 +1,46 @@
+# `gog agent`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Agent-friendly helpers
+
+## Usage
+
+```bash
+gog agent <command> [flags]
+```
+
+## Parent
+
+- [gog](gog.md)
+
+## Subcommands
+
+- [gog agent exit-codes](gog-agent-exit-codes.md) - Print stable exit codes for automation
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog](gog.md)
+- [Command index](README.md)

docs/commands/gog-appscript-content.md

@@ -0,0 +1,42 @@
+# `gog appscript content`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Get Apps Script project content
+
+## Usage
+
+```bash
+gog appscript (script,apps-script) content (cat) <scriptId>
+```
+
+## Parent
+
+- [gog appscript](gog-appscript.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog appscript](gog-appscript.md)
+- [Command index](README.md)

docs/commands/gog-appscript-create.md

@@ -0,0 +1,44 @@
+# `gog appscript create`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Create an Apps Script project
+
+## Usage
+
+```bash
+gog appscript (script,apps-script) create (new) --title=STRING [flags]
+```
+
+## Parent
+
+- [gog appscript](gog-appscript.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--parent-id` | `string` |  | Optional Drive file ID to bind to |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--title` | `string` |  | Project title |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog appscript](gog-appscript.md)
+- [Command index](README.md)

docs/commands/gog-appscript-get.md

@@ -0,0 +1,42 @@
+# `gog appscript get`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Get Apps Script project metadata
+
+## Usage
+
+```bash
+gog appscript (script,apps-script) get (info,show) <scriptId>
+```
+
+## Parent
+
+- [gog appscript](gog-appscript.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog appscript](gog-appscript.md)
+- [Command index](README.md)

docs/commands/gog-appscript-run.md

@@ -0,0 +1,44 @@
+# `gog appscript run`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Run a deployed Apps Script function
+
+## Usage
+
+```bash
+gog appscript (script,apps-script) run <scriptId> <function> [flags]
+```
+
+## Parent
+
+- [gog appscript](gog-appscript.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--dev-mode` | `bool` |  | Run latest saved code if you own the script |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--params` | `string` | [] | JSON array of function parameters |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog appscript](gog-appscript.md)
+- [Command index](README.md)

docs/commands/gog-appscript.md

@@ -0,0 +1,49 @@
+# `gog appscript`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Google Apps Script
+
+## Usage
+
+```bash
+gog appscript (script,apps-script) <command> [flags]
+```
+
+## Parent
+
+- [gog](gog.md)
+
+## Subcommands
+
+- [gog appscript content](gog-appscript-content.md) - Get Apps Script project content
+- [gog appscript create](gog-appscript-create.md) - Create an Apps Script project
+- [gog appscript get](gog-appscript-get.md) - Get Apps Script project metadata
+- [gog appscript run](gog-appscript-run.md) - Run a deployed Apps Script function
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog](gog.md)
+- [Command index](README.md)

docs/commands/gog-auth-add.md

@@ -0,0 +1,56 @@
+# `gog auth add`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Authorize and store a refresh token
+
+## Usage
+
+```bash
+gog auth add <email> [flags]
+```
+
+## Parent
+
+- [gog auth](gog-auth.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--auth-url` | `string` |  | Redirect URL from browser (manual flow; required for --remote --step 2) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `--drive-scope` | `string` | full | Drive scope mode: full\|readonly\|file |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `--extra-scopes` | `string` |  | Comma-separated list of additional OAuth scope URIs to request (appended after service scopes) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--force-consent` | `bool` |  | Force consent screen to obtain a refresh token |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `--gmail-scope` | `string` | full | Gmail scope mode: full\|readonly |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--listen-addr` | `string` |  | Address to listen on for OAuth callback (for example 0.0.0.0 or 0.0.0.0:8080) |
+| `--manual` | `bool` |  | Browserless auth flow (paste redirect URL) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--readonly` | `bool` |  | Use read-only scopes where available (still includes OIDC identity scopes) |
+| `--redirect-host` | `string` |  | Hostname for OAuth callback in browser flows; builds https://{host}/oauth2/callback |
+| `--redirect-uri` | `string` |  | Override OAuth redirect URI for manual/remote flows (for example https://host.example/oauth2/callback) |
+| `--remote` | `bool` |  | Remote/server-friendly manual flow (print URL, then exchange code) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--services` | `string` | user | Services to authorize: user\|all or comma-separated gmail,calendar,chat,classroom,drive,docs,slides,contacts,tasks,sheets,people,forms,appscript,ads (Keep uses service account: gog auth service-account set) |
+| `--step` | `int` |  | Remote auth step: 1=print URL, 2=exchange code |
+| `--timeout` | `time.Duration` |  | Authorization timeout (manual flows default to 5m) |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth](gog-auth.md)
+- [Command index](README.md)

docs/commands/gog-auth-alias-list.md

@@ -0,0 +1,42 @@
+# `gog auth alias list`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+List account aliases
+
+## Usage
+
+```bash
+gog auth alias list
+```
+
+## Parent
+
+- [gog auth alias](gog-auth-alias.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth alias](gog-auth-alias.md)
+- [Command index](README.md)

docs/commands/gog-auth-alias-set.md

@@ -0,0 +1,42 @@
+# `gog auth alias set`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Set an account alias
+
+## Usage
+
+```bash
+gog auth alias set <alias> <email>
+```
+
+## Parent
+
+- [gog auth alias](gog-auth-alias.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth alias](gog-auth-alias.md)
+- [Command index](README.md)

docs/commands/gog-auth-alias-unset.md

@@ -0,0 +1,42 @@
+# `gog auth alias unset`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Remove an account alias
+
+## Usage
+
+```bash
+gog auth alias unset <alias>
+```
+
+## Parent
+
+- [gog auth alias](gog-auth-alias.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth alias](gog-auth-alias.md)
+- [Command index](README.md)

docs/commands/gog-auth-alias.md

@@ -0,0 +1,48 @@
+# `gog auth alias`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Manage account aliases
+
+## Usage
+
+```bash
+gog auth alias <command>
+```
+
+## Parent
+
+- [gog auth](gog-auth.md)
+
+## Subcommands
+
+- [gog auth alias list](gog-auth-alias-list.md) - List account aliases
+- [gog auth alias set](gog-auth-alias-set.md) - Set an account alias
+- [gog auth alias unset](gog-auth-alias-unset.md) - Remove an account alias
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth](gog-auth.md)
+- [Command index](README.md)

docs/commands/gog-auth-credentials-list.md

@@ -0,0 +1,42 @@
+# `gog auth credentials list`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+List stored OAuth client credentials
+
+## Usage
+
+```bash
+gog auth credentials list
+```
+
+## Parent
+
+- [gog auth credentials](gog-auth-credentials.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth credentials](gog-auth-credentials.md)
+- [Command index](README.md)

docs/commands/gog-auth-credentials-remove.md

@@ -0,0 +1,42 @@
+# `gog auth credentials remove`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Remove stored OAuth client credentials
+
+## Usage
+
+```bash
+gog auth credentials remove [<client>]
+```
+
+## Parent
+
+- [gog auth credentials](gog-auth-credentials.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth credentials](gog-auth-credentials.md)
+- [Command index](README.md)

docs/commands/gog-auth-credentials-set.md

@@ -0,0 +1,43 @@
+# `gog auth credentials set`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Store OAuth client credentials
+
+## Usage
+
+```bash
+gog auth credentials set <credentials> [flags]
+```
+
+## Parent
+
+- [gog auth credentials](gog-auth-credentials.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `--domain` | `string` |  | Comma-separated domains to map to this client (e.g. example.com) |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth credentials](gog-auth-credentials.md)
+- [Command index](README.md)

docs/commands/gog-auth-credentials.md

@@ -0,0 +1,48 @@
+# `gog auth credentials`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Manage OAuth client credentials
+
+## Usage
+
+```bash
+gog auth credentials <command>
+```
+
+## Parent
+
+- [gog auth](gog-auth.md)
+
+## Subcommands
+
+- [gog auth credentials list](gog-auth-credentials-list.md) - List stored OAuth client credentials
+- [gog auth credentials remove](gog-auth-credentials-remove.md) - Remove stored OAuth client credentials
+- [gog auth credentials set](gog-auth-credentials-set.md) - Store OAuth client credentials
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth](gog-auth.md)
+- [Command index](README.md)

docs/commands/gog-auth-doctor.md

@@ -0,0 +1,44 @@
+# `gog auth doctor`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Diagnose auth, keyring, and refresh-token issues
+
+## Usage
+
+```bash
+gog auth doctor [flags]
+```
+
+## Parent
+
+- [gog auth](gog-auth.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--check` | `bool` |  | Verify refresh tokens by exchanging for access tokens |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--timeout` | `time.Duration` | 15s | Per-token check timeout |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth](gog-auth.md)
+- [Command index](README.md)

docs/commands/gog-auth-keep.md

@@ -0,0 +1,43 @@
+# `gog auth keep`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Configure service account for Google Keep (Workspace only)
+
+## Usage
+
+```bash
+gog auth keep --key=STRING <email>
+```
+
+## Parent
+
+- [gog auth](gog-auth.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--key` | `string` |  | Path to service account JSON key file |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth](gog-auth.md)
+- [Command index](README.md)

docs/commands/gog-auth-keyring.md

@@ -0,0 +1,42 @@
+# `gog auth keyring`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Configure keyring backend
+
+## Usage
+
+```bash
+gog auth keyring [<backend> [<backend2>]]
+```
+
+## Parent
+
+- [gog auth](gog-auth.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth](gog-auth.md)
+- [Command index](README.md)

docs/commands/gog-auth-list.md

@@ -0,0 +1,44 @@
+# `gog auth list`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+List stored accounts
+
+## Usage
+
+```bash
+gog auth list [flags]
+```
+
+## Parent
+
+- [gog auth](gog-auth.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--check` | `bool` |  | Verify refresh tokens by exchanging for an access token (requires credentials.json) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--timeout` | `time.Duration` | 15s | Per-token check timeout |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth](gog-auth.md)
+- [Command index](README.md)

docs/commands/gog-auth-manage.md

@@ -0,0 +1,47 @@
+# `gog auth manage`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Open accounts manager in browser
+
+## Usage
+
+```bash
+gog auth manage (login) [flags]
+```
+
+## Parent
+
+- [gog auth](gog-auth.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--force-consent` | `bool` |  | Force consent screen when adding accounts |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--listen-addr` | `string` |  | Address to listen on for OAuth callback (for example 0.0.0.0 or 0.0.0.0:8080) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--redirect-host` | `string` |  | Hostname for OAuth callback; builds https://{host}/oauth2/callback |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--services` | `string` | user | Services to authorize: user\|all or comma-separated gmail,calendar,chat,classroom,drive,docs,slides,contacts,tasks,sheets,people,forms,appscript,ads (Keep uses service account: gog auth service-account set) |
+| `--timeout` | `time.Duration` | 10m | Server timeout duration |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth](gog-auth.md)
+- [Command index](README.md)

docs/commands/gog-auth-remove.md

@@ -0,0 +1,42 @@
+# `gog auth remove`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Remove a stored refresh token
+
+## Usage
+
+```bash
+gog auth remove <email>
+```
+
+## Parent
+
+- [gog auth](gog-auth.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth](gog-auth.md)
+- [Command index](README.md)

docs/commands/gog-auth-service-account-set.md

@@ -0,0 +1,43 @@
+# `gog auth service-account set`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Store a service account key for impersonation
+
+## Usage
+
+```bash
+gog auth service-account set --key=STRING <email>
+```
+
+## Parent
+
+- [gog auth service-account](gog-auth-service-account.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--key` | `string` |  | Path to service account JSON key file |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth service-account](gog-auth-service-account.md)
+- [Command index](README.md)

docs/commands/gog-auth-service-account-status.md

@@ -0,0 +1,42 @@
+# `gog auth service-account status`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Show stored service account key status
+
+## Usage
+
+```bash
+gog auth service-account status <email>
+```
+
+## Parent
+
+- [gog auth service-account](gog-auth-service-account.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth service-account](gog-auth-service-account.md)
+- [Command index](README.md)

docs/commands/gog-auth-service-account-unset.md

@@ -0,0 +1,42 @@
+# `gog auth service-account unset`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Remove stored service account key
+
+## Usage
+
+```bash
+gog auth service-account unset <email>
+```
+
+## Parent
+
+- [gog auth service-account](gog-auth-service-account.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth service-account](gog-auth-service-account.md)
+- [Command index](README.md)

docs/commands/gog-auth-service-account.md

@@ -0,0 +1,48 @@
+# `gog auth service-account`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Configure service account (Workspace only; domain-wide delegation)
+
+## Usage
+
+```bash
+gog auth service-account <command>
+```
+
+## Parent
+
+- [gog auth](gog-auth.md)
+
+## Subcommands
+
+- [gog auth service-account set](gog-auth-service-account-set.md) - Store a service account key for impersonation
+- [gog auth service-account status](gog-auth-service-account-status.md) - Show stored service account key status
+- [gog auth service-account unset](gog-auth-service-account-unset.md) - Remove stored service account key
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth](gog-auth.md)
+- [Command index](README.md)

docs/commands/gog-auth-services.md

@@ -0,0 +1,43 @@
+# `gog auth services`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+List supported auth services and scopes
+
+## Usage
+
+```bash
+gog auth services [flags]
+```
+
+## Parent
+
+- [gog auth](gog-auth.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--markdown` | `bool` |  | Output Markdown table |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth](gog-auth.md)
+- [Command index](README.md)

docs/commands/gog-auth-status.md

@@ -0,0 +1,42 @@
+# `gog auth status`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Show auth configuration and keyring backend
+
+## Usage
+
+```bash
+gog auth status
+```
+
+## Parent
+
+- [gog auth](gog-auth.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth](gog-auth.md)
+- [Command index](README.md)

docs/commands/gog-auth-tokens-delete.md

@@ -0,0 +1,42 @@
+# `gog auth tokens delete`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Delete a stored refresh token
+
+## Usage
+
+```bash
+gog auth tokens delete <email>
+```
+
+## Parent
+
+- [gog auth tokens](gog-auth-tokens.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth tokens](gog-auth-tokens.md)
+- [Command index](README.md)

docs/commands/gog-auth-tokens-export.md

@@ -0,0 +1,44 @@
+# `gog auth tokens export`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Export a refresh token to a file (contains secrets)
+
+## Usage
+
+```bash
+gog auth tokens export <email> [flags]
+```
+
+## Parent
+
+- [gog auth tokens](gog-auth-tokens.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--out`<br>`--output` | `string` |  | Output file path (required) |
+| `--overwrite` | `bool` |  | Overwrite output file if it exists |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth tokens](gog-auth-tokens.md)
+- [Command index](README.md)

docs/commands/gog-auth-tokens-import.md

@@ -0,0 +1,42 @@
+# `gog auth tokens import`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Import a refresh token file into keyring (contains secrets)
+
+## Usage
+
+```bash
+gog auth tokens import <inPath>
+```
+
+## Parent
+
+- [gog auth tokens](gog-auth-tokens.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth tokens](gog-auth-tokens.md)
+- [Command index](README.md)

docs/commands/gog-auth-tokens-list.md

@@ -0,0 +1,42 @@
+# `gog auth tokens list`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+List stored tokens (by key only)
+
+## Usage
+
+```bash
+gog auth tokens list
+```
+
+## Parent
+
+- [gog auth tokens](gog-auth-tokens.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth tokens](gog-auth-tokens.md)
+- [Command index](README.md)

docs/commands/gog-auth-tokens.md

@@ -0,0 +1,49 @@
+# `gog auth tokens`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Manage stored refresh tokens
+
+## Usage
+
+```bash
+gog auth tokens <command>
+```
+
+## Parent
+
+- [gog auth](gog-auth.md)
+
+## Subcommands
+
+- [gog auth tokens delete](gog-auth-tokens-delete.md) - Delete a stored refresh token
+- [gog auth tokens export](gog-auth-tokens-export.md) - Export a refresh token to a file (contains secrets)
+- [gog auth tokens import](gog-auth-tokens-import.md) - Import a refresh token file into keyring (contains secrets)
+- [gog auth tokens list](gog-auth-tokens-list.md) - List stored tokens (by key only)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog auth](gog-auth.md)
+- [Command index](README.md)

docs/commands/gog-auth.md

@@ -0,0 +1,58 @@
+# `gog auth`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Auth and credentials
+
+## Usage
+
+```bash
+gog auth <command> [flags]
+```
+
+## Parent
+
+- [gog](gog.md)
+
+## Subcommands
+
+- [gog auth add](gog-auth-add.md) - Authorize and store a refresh token
+- [gog auth alias](gog-auth-alias.md) - Manage account aliases
+- [gog auth credentials](gog-auth-credentials.md) - Manage OAuth client credentials
+- [gog auth doctor](gog-auth-doctor.md) - Diagnose auth, keyring, and refresh-token issues
+- [gog auth keep](gog-auth-keep.md) - Configure service account for Google Keep (Workspace only)
+- [gog auth keyring](gog-auth-keyring.md) - Configure keyring backend
+- [gog auth list](gog-auth-list.md) - List stored accounts
+- [gog auth manage](gog-auth-manage.md) - Open accounts manager in browser
+- [gog auth remove](gog-auth-remove.md) - Remove a stored refresh token
+- [gog auth service-account](gog-auth-service-account.md) - Configure service account (Workspace only; domain-wide delegation)
+- [gog auth services](gog-auth-services.md) - List supported auth services and scopes
+- [gog auth status](gog-auth-status.md) - Show auth configuration and keyring backend
+- [gog auth tokens](gog-auth-tokens.md) - Manage stored refresh tokens
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog](gog.md)
+- [Command index](README.md)

docs/commands/gog-backup-cat.md

@@ -0,0 +1,49 @@
+# `gog backup cat`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Decrypt one backup shard to stdout
+
+## Usage
+
+```bash
+gog backup cat <shard> [flags]
+```
+
+## Parent
+
+- [gog backup](gog-backup.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--config` | `string` |  | Backup config path |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `--identity` | `string` |  | Local age identity path |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--no-pull` | `bool` |  | Use local backup repository state without pulling first |
+| `--out` | `string` |  | Write decrypted JSONL to this file instead of stdout |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--pretty` | `bool` |  | Pretty-print each JSONL row |
+| `--remote` | `string` |  | Backup Git remote URL |
+| `--repo` | `string` |  | Local backup repository path |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog backup](gog-backup.md)
+- [Command index](README.md)

docs/commands/gog-backup-export.md

@@ -0,0 +1,50 @@
+# `gog backup export`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Write a local plaintext export
+
+## Usage
+
+```bash
+gog backup export [flags]
+```
+
+## Parent
+
+- [gog backup](gog-backup.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--config` | `string` |  | Backup config path |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-attachments` | `string` | extract | Gmail attachment export mode for markdown/both: extract or none |
+| `--gmail-format` | `string` | eml | Gmail message export format: eml, markdown, or both |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `--identity` | `string` |  | Local age identity path |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--no-pull` | `bool` |  | Use local backup repository state without pulling first |
+| `--out` | `string` | ~/Documents/gog-backup-export | Plaintext export directory |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--remote` | `string` |  | Backup Git remote URL |
+| `--repo` | `string` |  | Local backup repository path |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog backup](gog-backup.md)
+- [Command index](README.md)

docs/commands/gog-backup-gmail-push.md

@@ -0,0 +1,57 @@
+# `gog backup gmail push`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Export Gmail into encrypted backup shards
+
+## Usage
+
+```bash
+gog backup gmail push [flags]
+```
+
+## Parent
+
+- [gog backup gmail](gog-backup-gmail.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--checkpoint-interval` | `time.Duration` | 30m | Max time between checkpoint pushes during fetch; 0 disables time-triggered checkpoints |
+| `--checkpoint-rows` | `int` | 10000 | Gmail messages per encrypted checkpoint chunk; 0 disables row-triggered checkpoints |
+| `--checkpoints` | `bool` | true | Commit and push incomplete encrypted checkpoints during long cached fetches |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--config` | `string` |  | Backup config path |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-cache` | `bool` | true | Cache fetched raw messages locally so interrupted full backups can resume |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `--gmail-refresh-cache` | `bool` |  | Refetch messages even when a local backup cache entry exists |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `--identity` | `string` |  | Local age identity path |
+| `--include-spam-trash` | `bool` | true | Include spam and trash |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--max`<br>`--limit` | `int64` | 0 | Max Gmail messages to export; 0 means all |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--no-push` | `bool` |  | Commit locally but do not push to the remote |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--query` | `string` |  | Gmail query for bounded/test backups |
+| `--recipient` | `[]string` |  | Public age recipient (repeatable) |
+| `--remote` | `string` |  | Backup Git remote URL |
+| `--repo` | `string` |  | Local backup repository path |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--shard-max-rows` | `int` | 1000 | Max messages per encrypted shard |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog backup gmail](gog-backup-gmail.md)
+- [Command index](README.md)

docs/commands/gog-backup-gmail.md

@@ -0,0 +1,46 @@
+# `gog backup gmail`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Gmail backup operations
+
+## Usage
+
+```bash
+gog backup gmail <command>
+```
+
+## Parent
+
+- [gog backup](gog-backup.md)
+
+## Subcommands
+
+- [gog backup gmail push](gog-backup-gmail-push.md) - Export Gmail into encrypted backup shards
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog backup](gog-backup.md)
+- [Command index](README.md)

docs/commands/gog-backup-init.md

@@ -0,0 +1,48 @@
+# `gog backup init`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Initialize encrypted backup config and repository
+
+## Usage
+
+```bash
+gog backup init [flags]
+```
+
+## Parent
+
+- [gog backup](gog-backup.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--config` | `string` |  | Backup config path |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `--identity` | `string` |  | Local age identity path |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--no-push` | `bool` |  | Commit locally but do not push to the remote |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--recipient` | `[]string` |  | Public age recipient (repeatable) |
+| `--remote` | `string` |  | Backup Git remote URL |
+| `--repo` | `string` |  | Local backup repository path |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog backup](gog-backup.md)
+- [Command index](README.md)

docs/commands/gog-backup-push.md

@@ -0,0 +1,66 @@
+# `gog backup push`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Export services into encrypted backup shards
+
+## Usage
+
+```bash
+gog backup push [flags]
+```
+
+## Parent
+
+- [gog backup](gog-backup.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--best-effort` | `bool` | true | Record optional service errors as backup rows and continue |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--config` | `string` |  | Backup config path |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `--drive-binary-contents` | `bool` |  | Include non-Google Drive binary file bytes in encrypted shards |
+| `--drive-collaboration` | `bool` | true | Back up Drive permissions, comments, and revision metadata |
+| `--drive-content-max-bytes` | `int64` | 0 | Skip individual Drive content exports larger than this many bytes; 0 means unlimited |
+| `--drive-content-timeout` | `time.Duration` | 2m | Per-file Drive content export/download timeout |
+| `--drive-contents` | `bool` | true | Download/export Drive file contents into encrypted shards |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-cache` | `bool` | true | Cache fetched Gmail raw messages locally so interrupted full backups can resume |
+| `--gmail-checkpoint-interval` | `time.Duration` | 30m | Max time between Gmail checkpoint pushes during fetch; 0 disables time-triggered checkpoints |
+| `--gmail-checkpoint-rows` | `int` | 10000 | Gmail messages per encrypted checkpoint chunk; 0 disables row-triggered checkpoints |
+| `--gmail-checkpoints` | `bool` | true | Commit and push incomplete encrypted Gmail checkpoints during long cached fetches |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `--gmail-refresh-cache` | `bool` |  | Refetch Gmail messages even when a local backup cache entry exists |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `--identity` | `string` |  | Local age identity path |
+| `--include-spam-trash` | `bool` | true | Include Gmail spam and trash |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--max`<br>`--limit` | `int64` | 0 | Max Gmail messages to export; 0 means all |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--no-push` | `bool` |  | Commit locally but do not push to the remote |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--query` | `string` |  | Gmail query for bounded/test backups |
+| `--recipient` | `[]string` |  | Public age recipient (repeatable) |
+| `--remote` | `string` |  | Backup Git remote URL |
+| `--repo` | `string` |  | Local backup repository path |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--services` | `string` | gmail | Comma-separated services to back up |
+| `--shard-max-rows` | `int` | 1000 | Max rows per encrypted shard |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+| `--workspace-max-files` | `int` | 0 | Max Docs/Sheets/Slides files per type for native Workspace metadata; 0 means all |
+| `--workspace-native` | `bool` |  | Fetch full native Docs/Sheets/Slides API JSON in addition to Drive exports |
+
+## See Also
+
+- [gog backup](gog-backup.md)
+- [Command index](README.md)

docs/commands/gog-backup-status.md

@@ -0,0 +1,48 @@
+# `gog backup status`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Inspect backup manifest without decrypting shards
+
+## Usage
+
+```bash
+gog backup status [flags]
+```
+
+## Parent
+
+- [gog backup](gog-backup.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--config` | `string` |  | Backup config path |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `--identity` | `string` |  | Local age identity path |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--no-push` | `bool` |  | Commit locally but do not push to the remote |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--recipient` | `[]string` |  | Public age recipient (repeatable) |
+| `--remote` | `string` |  | Backup Git remote URL |
+| `--repo` | `string` |  | Local backup repository path |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog backup](gog-backup.md)
+- [Command index](README.md)

docs/commands/gog-backup-verify.md

@@ -0,0 +1,48 @@
+# `gog backup verify`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Decrypt and verify all backup shards
+
+## Usage
+
+```bash
+gog backup verify [flags]
+```
+
+## Parent
+
+- [gog backup](gog-backup.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--config` | `string` |  | Backup config path |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `--identity` | `string` |  | Local age identity path |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--no-push` | `bool` |  | Commit locally but do not push to the remote |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--recipient` | `[]string` |  | Public age recipient (repeatable) |
+| `--remote` | `string` |  | Backup Git remote URL |
+| `--repo` | `string` |  | Local backup repository path |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog backup](gog-backup.md)
+- [Command index](README.md)

docs/commands/gog-backup.md

@@ -0,0 +1,52 @@
+# `gog backup`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Encrypted Google account backups
+
+## Usage
+
+```bash
+gog backup <command> [flags]
+```
+
+## Parent
+
+- [gog](gog.md)
+
+## Subcommands
+
+- [gog backup cat](gog-backup-cat.md) - Decrypt one backup shard to stdout
+- [gog backup export](gog-backup-export.md) - Write a local plaintext export
+- [gog backup gmail](gog-backup-gmail.md) - Gmail backup operations
+- [gog backup init](gog-backup-init.md) - Initialize encrypted backup config and repository
+- [gog backup push](gog-backup-push.md) - Export services into encrypted backup shards
+- [gog backup status](gog-backup-status.md) - Inspect backup manifest without decrypting shards
+- [gog backup verify](gog-backup-verify.md) - Decrypt and verify all backup shards
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog](gog.md)
+- [Command index](README.md)

docs/commands/gog-calendar-acl.md

@@ -0,0 +1,46 @@
+# `gog calendar acl`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+List calendar ACL
+
+## Usage
+
+```bash
+gog calendar (cal) acl (permissions,perms) <calendarId> [flags]
+```
+
+## Parent
+
+- [gog calendar](gog-calendar.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--all`<br>`--all-pages`<br>`--allpages` | `bool` |  | Fetch all pages |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `--fail-empty`<br>`--non-empty`<br>`--require-results` | `bool` |  | Exit with code 3 if no results |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--max`<br>`--limit` | `int64` | 100 | Max results |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--page`<br>`--cursor` | `string` |  | Page token |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog calendar](gog-calendar.md)
+- [Command index](README.md)

docs/commands/gog-calendar-alias-list.md

@@ -0,0 +1,42 @@
+# `gog calendar alias list`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+List calendar aliases
+
+## Usage
+
+```bash
+gog calendar (cal) alias list
+```
+
+## Parent
+
+- [gog calendar alias](gog-calendar-alias.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog calendar alias](gog-calendar-alias.md)
+- [Command index](README.md)

docs/commands/gog-calendar-alias-set.md

@@ -0,0 +1,42 @@
+# `gog calendar alias set`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Set a calendar alias
+
+## Usage
+
+```bash
+gog calendar (cal) alias set <alias> <calendarId>
+```
+
+## Parent
+
+- [gog calendar alias](gog-calendar-alias.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog calendar alias](gog-calendar-alias.md)
+- [Command index](README.md)

docs/commands/gog-calendar-alias-unset.md

@@ -0,0 +1,42 @@
+# `gog calendar alias unset`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Remove a calendar alias
+
+## Usage
+
+```bash
+gog calendar (cal) alias unset <alias>
+```
+
+## Parent
+
+- [gog calendar alias](gog-calendar-alias.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog calendar alias](gog-calendar-alias.md)
+- [Command index](README.md)

docs/commands/gog-calendar-alias.md

@@ -0,0 +1,48 @@
+# `gog calendar alias`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Manage calendar aliases
+
+## Usage
+
+```bash
+gog calendar (cal) alias <command>
+```
+
+## Parent
+
+- [gog calendar](gog-calendar.md)
+
+## Subcommands
+
+- [gog calendar alias list](gog-calendar-alias-list.md) - List calendar aliases
+- [gog calendar alias set](gog-calendar-alias-set.md) - Set a calendar alias
+- [gog calendar alias unset](gog-calendar-alias-unset.md) - Remove a calendar alias
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog calendar](gog-calendar.md)
+- [Command index](README.md)

docs/commands/gog-calendar-calendars.md

@@ -0,0 +1,46 @@
+# `gog calendar calendars`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+List calendars
+
+## Usage
+
+```bash
+gog calendar (cal) calendars [flags]
+```
+
+## Parent
+
+- [gog calendar](gog-calendar.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--all`<br>`--all-pages`<br>`--allpages` | `bool` |  | Fetch all pages |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `--fail-empty`<br>`--non-empty`<br>`--require-results` | `bool` |  | Exit with code 3 if no results |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--max`<br>`--limit` | `int64` | 100 | Max results |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--page`<br>`--cursor` | `string` |  | Page token |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog calendar](gog-calendar.md)
+- [Command index](README.md)

docs/commands/gog-calendar-colors.md

@@ -0,0 +1,42 @@
+# `gog calendar colors`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Show calendar colors
+
+## Usage
+
+```bash
+gog calendar (cal) colors
+```
+
+## Parent
+
+- [gog calendar](gog-calendar.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog calendar](gog-calendar.md)
+- [Command index](README.md)

docs/commands/gog-calendar-conflicts.md

@@ -0,0 +1,51 @@
+# `gog calendar conflicts`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Find conflicts
+
+## Usage
+
+```bash
+gog calendar (cal) conflicts [flags]
+```
+
+## Parent
+
+- [gog calendar](gog-calendar.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--all` | `bool` |  | Query all calendars |
+| `--cal` | `[]string` |  | Calendar ID, name, or index (can be repeated) |
+| `--calendars` | `string` |  | Comma-separated calendar IDs, names, or indices from 'calendar calendars' |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--days` | `int` | 0 | Next N days (timezone-aware) |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--from` | `string` |  | Start time (RFC3339, date, or relative: today, tomorrow, monday) |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--to` | `string` |  | End time (RFC3339, date, or relative) |
+| `--today` | `bool` |  | Today only (timezone-aware) |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+| `--week` | `bool` |  | This week (uses --week-start, default Mon) |
+| `--week-start` | `string` |  | Week start day for --week (sun, mon, ...) |
+
+## See Also
+
+- [gog calendar](gog-calendar.md)
+- [Command index](README.md)

docs/commands/gog-calendar-create-calendar.md

@@ -0,0 +1,45 @@
+# `gog calendar create-calendar`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Create a new secondary calendar
+
+## Usage
+
+```bash
+gog calendar (cal) create-calendar (new-calendar) <summary> [flags]
+```
+
+## Parent
+
+- [gog calendar](gog-calendar.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--description` | `string` |  | Calendar description |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--location` | `string` |  | Calendar location |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--timezone`<br>`--tz` | `string` |  | IANA timezone (e.g., America/New_York) |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog calendar](gog-calendar.md)
+- [Command index](README.md)

docs/commands/gog-calendar-create.md

@@ -0,0 +1,78 @@
+# `gog calendar create`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Create an event
+
+## Usage
+
+```bash
+gog calendar (cal) create (add,new) <calendarId> [flags]
+```
+
+## Parent
+
+- [gog calendar](gog-calendar.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--all-day` | `bool` |  | All-day event (use date-only in --from/--to) |
+| `--attachment` | `[]string` |  | File attachment URL (can be repeated) |
+| `--attendees` | `string` |  | Comma-separated attendee emails |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--description` | `string` |  | Description |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `--end-timezone`<br>`--to-timezone` | `string` |  | IANA timezone metadata for --to (e.g., America/New_York) |
+| `--event-color` | `string` |  | Event color ID (1-11). Use 'gog calendar colors' to see available colors. |
+| `--event-type` | `string` |  | Event type: default, focus-time, out-of-office, working-location |
+| `--focus-auto-decline` | `string` |  | Focus Time auto-decline mode: none, all, new |
+| `--focus-chat-status` | `string` |  | Focus Time chat status: available, doNotDisturb |
+| `--focus-decline-message` | `string` |  | Focus Time decline message |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--from` | `string` |  | Start time (RFC3339) |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `--guests-can-invite` | `*bool` |  | Allow guests to invite others |
+| `--guests-can-modify` | `*bool` |  | Allow guests to modify event |
+| `--guests-can-see-others` | `*bool` |  | Allow guests to see other guests |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--location` | `string` |  | Location |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--ooo-auto-decline` | `string` |  | Out of Office auto-decline mode: none, all, new |
+| `--ooo-decline-message` | `string` |  | Out of Office decline message |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--private-prop` | `[]string` |  | Private extended property (key=value, can be repeated) |
+| `--reminder` | `[]string` |  | Custom reminders as method:duration (e.g., popup:30m, email:1d). Can be repeated (max 5). |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--rrule` | `[]string` |  | Recurrence rules (e.g., 'RRULE:FREQ=MONTHLY;BYMONTHDAY=11'). Can be repeated. |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--send-updates` | `string` |  | Notification mode: all, externalOnly, none (default: none) |
+| `--shared-prop` | `[]string` |  | Shared extended property (key=value, can be repeated) |
+| `--source-title` | `string` |  | Title of the source |
+| `--source-url` | `string` |  | URL where event was created/imported from |
+| `--start-timezone`<br>`--from-timezone` | `string` |  | IANA timezone metadata for --from (e.g., Europe/Rome) |
+| `--summary` | `string` |  | Event summary/title |
+| `--to` | `string` |  | End time (RFC3339) |
+| `--transparency` | `string` |  | Show as busy (opaque) or free (transparent). Aliases: busy, free |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+| `--visibility` | `string` |  | Event visibility: default, public, private, confidential |
+| `--with-meet` | `bool` |  | Create a Google Meet video conference for this event |
+| `--working-building-id` | `string` |  | Working location building ID |
+| `--working-custom-label` | `string` |  | Working location custom label |
+| `--working-desk-id` | `string` |  | Working location desk ID |
+| `--working-floor-id` | `string` |  | Working location floor ID |
+| `--working-location-type` | `string` |  | Working location type: home, office, custom |
+| `--working-office-label` | `string` |  | Working location office name/label |
+
+## See Also
+
+- [gog calendar](gog-calendar.md)
+- [Command index](README.md)

docs/commands/gog-calendar-delete.md

@@ -0,0 +1,45 @@
+# `gog calendar delete`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Delete an event
+
+## Usage
+
+```bash
+gog calendar (cal) delete (rm,del,remove) <calendarId> <eventId> [flags]
+```
+
+## Parent
+
+- [gog calendar](gog-calendar.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--original-start` | `string` |  | Original start time of instance (required for scope=single,future) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--scope` | `string` | all | For recurring events: single, future, all |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--send-updates` | `string` |  | Notification mode: all, externalOnly, none (default: none) |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog calendar](gog-calendar.md)
+- [Command index](README.md)

docs/commands/gog-calendar-event.md

@@ -0,0 +1,42 @@
+# `gog calendar event`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Get event
+
+## Usage
+
+```bash
+gog calendar (cal) event (get,info,show) <calendarId> <eventId>
+```
+
+## Parent
+
+- [gog calendar](gog-calendar.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog calendar](gog-calendar.md)
+- [Command index](README.md)

docs/commands/gog-calendar-events.md

@@ -0,0 +1,61 @@
+# `gog calendar events`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+List events from a calendar or all calendars
+
+## Usage
+
+```bash
+gog calendar (cal) events (list,ls) [<calendarId> ...] [flags]
+```
+
+## Parent
+
+- [gog calendar](gog-calendar.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--all` | `bool` |  | Fetch events from all calendars |
+| `--all-pages`<br>`--allpages` | `bool` |  | Fetch all pages |
+| `--cal` | `[]string` |  | Calendar ID or name (can be repeated) |
+| `--calendars` | `string` |  | Comma-separated calendar IDs, names, or indices from 'calendar calendars' |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--days` | `int` | 0 | Next N days (timezone-aware) |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `--fail-empty`<br>`--non-empty`<br>`--require-results` | `bool` |  | Exit with code 3 if no results |
+| `--fields` | `string` |  | Comma-separated fields to return |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--from` | `string` |  | Start time (RFC3339 with timezone, date, or relative: today, tomorrow, monday) |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--max`<br>`--limit` | `int64` | 10 | Max results |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--page`<br>`--cursor` | `string` |  | Page token |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--private-prop-filter` | `string` |  | Filter by private extended property (key=value) |
+| `--query` | `string` |  | Free text search |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--shared-prop-filter` | `string` |  | Filter by shared extended property (key=value) |
+| `--to` | `string` |  | End time (RFC3339 with timezone, date, or relative) |
+| `--today` | `bool` |  | Today only (timezone-aware) |
+| `--tomorrow` | `bool` |  | Tomorrow only (timezone-aware) |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+| `--week` | `bool` |  | This week (uses --week-start, default Mon) |
+| `--week-start` | `string` |  | Week start day for --week (sun, mon, ...) |
+| `--weekday` | `bool` | false | Include start/end day-of-week columns |
+
+## See Also
+
+- [gog calendar](gog-calendar.md)
+- [Command index](README.md)

docs/commands/gog-calendar-focus-time.md

@@ -0,0 +1,49 @@
+# `gog calendar focus-time`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Create a Focus Time block
+
+## Usage
+
+```bash
+gog calendar (cal) focus-time (focus) --from=STRING --to=STRING [<calendarId>] [flags]
+```
+
+## Parent
+
+- [gog calendar](gog-calendar.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--auto-decline` | `string` | all | Auto-decline mode: none, all, new |
+| `--chat-status` | `string` | doNotDisturb | Chat status: available, doNotDisturb |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--decline-message` | `string` |  | Message for declined invitations |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--from` | `string` |  | Start time (RFC3339) |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--rrule` | `[]string` |  | Recurrence rules. Can be repeated. |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--summary` | `string` | Focus Time | Focus time title |
+| `--to` | `string` |  | End time (RFC3339) |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog calendar](gog-calendar.md)
+- [Command index](README.md)

docs/commands/gog-calendar-freebusy.md

@@ -0,0 +1,46 @@
+# `gog calendar freebusy`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Get free/busy
+
+## Usage
+
+```bash
+gog calendar (cal) freebusy [<calendarIds>] [flags]
+```
+
+## Parent
+
+- [gog calendar](gog-calendar.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--all` | `bool` |  | Query all calendars |
+| `--cal` | `[]string` |  | Calendar ID, name, or index (can be repeated) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--from` | `string` |  | Start time (RFC3339, required) |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--to` | `string` |  | End time (RFC3339, required) |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog calendar](gog-calendar.md)
+- [Command index](README.md)

docs/commands/gog-calendar-move.md

@@ -0,0 +1,43 @@
+# `gog calendar move`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Move an event to another calendar
+
+## Usage
+
+```bash
+gog calendar (cal) move (transfer) <calendarId> <eventId> <destinationCalendarId> [flags]
+```
+
+## Parent
+
+- [gog calendar](gog-calendar.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--send-updates` | `string` |  | Notification mode: all, externalOnly, none (default: none) |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog calendar](gog-calendar.md)
+- [Command index](README.md)

docs/commands/gog-calendar-out-of-office.md

@@ -0,0 +1,48 @@
+# `gog calendar out-of-office`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Create an Out of Office event
+
+## Usage
+
+```bash
+gog calendar (cal) out-of-office (ooo) --from=STRING --to=STRING [<calendarId>] [flags]
+```
+
+## Parent
+
+- [gog calendar](gog-calendar.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--all-day` | `bool` |  | Create as all-day event |
+| `--auto-decline` | `string` | all | Auto-decline mode: none, all, new |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--decline-message` | `string` | I am out of office and will respond when I return. | Message for declined invitations |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--from` | `string` |  | Start date or datetime (RFC3339 or YYYY-MM-DD) |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--summary` | `string` | Out of office | Out of office title |
+| `--to` | `string` |  | End date or datetime (RFC3339 or YYYY-MM-DD) |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog calendar](gog-calendar.md)
+- [Command index](README.md)

docs/commands/gog-calendar-propose-time.md

@@ -0,0 +1,45 @@
+# `gog calendar propose-time`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Generate URL to propose a new meeting time (browser-only feature)
+
+## Usage
+
+```bash
+gog calendar (cal) propose-time <calendarId> <eventId> [flags]
+```
+
+## Parent
+
+- [gog calendar](gog-calendar.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--comment` | `string` |  | Comment to include with decline (implies --decline) |
+| `--decline` | `bool` |  | Also decline the event (notifies organizer) |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--open` | `bool` |  | Open the URL in browser automatically |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog calendar](gog-calendar.md)
+- [Command index](README.md)

docs/commands/gog-calendar-respond.md

@@ -0,0 +1,44 @@
+# `gog calendar respond`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Respond to an event invitation
+
+## Usage
+
+```bash
+gog calendar (cal) respond (rsvp,reply) <calendarId> <eventId> [flags]
+```
+
+## Parent
+
+- [gog calendar](gog-calendar.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--comment` | `string` |  | Optional comment/note to include with response |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--status` | `string` |  | Response status (accepted, declined, tentative, needsAction) |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog calendar](gog-calendar.md)
+- [Command index](README.md)

docs/commands/gog-calendar-search.md

@@ -0,0 +1,51 @@
+# `gog calendar search`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Search events
+
+## Usage
+
+```bash
+gog calendar (cal) search (find,query) <query> [flags]
+```
+
+## Parent
+
+- [gog calendar](gog-calendar.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--calendar` | `string` | primary | Calendar ID |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--days` | `int` | 0 | Next N days |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--from` | `string` |  | Start time (RFC3339, date, or relative: today, tomorrow, monday) |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--max`<br>`--limit` | `int64` | 25 | Max results |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--to` | `string` |  | End time (RFC3339, date, or relative) |
+| `--today` | `bool` |  | Today only |
+| `--tomorrow` | `bool` |  | Tomorrow only |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+| `--week` | `bool` |  | This week (uses --week-start, default Mon) |
+| `--week-start` | `string` |  | Week start day for --week (sun, mon, ...) |
+
+## See Also
+
+- [gog calendar](gog-calendar.md)
+- [Command index](README.md)

docs/commands/gog-calendar-subscribe.md

@@ -0,0 +1,45 @@
+# `gog calendar subscribe`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Add a calendar to your calendar list
+
+## Usage
+
+```bash
+gog calendar (cal) subscribe (sub,add-calendar) <calendarId> [flags]
+```
+
+## Parent
+
+- [gog calendar](gog-calendar.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--color-id` | `string` |  | Color ID (1-24, see 'calendar colors') |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `--hidden` | `bool` |  | Hide from the calendar list UI |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--selected` | `bool` | true | Show events in the calendar UI |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog calendar](gog-calendar.md)
+- [Command index](README.md)

docs/commands/gog-calendar-team.md

@@ -0,0 +1,53 @@
+# `gog calendar team`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Show events for all members of a Google Group
+
+## Usage
+
+```bash
+gog calendar (cal) team <group-email> [flags]
+```
+
+## Parent
+
+- [gog calendar](gog-calendar.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--days` | `int` | 0 | Next N days |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--freebusy` | `bool` |  | Show only busy/free blocks (faster, single API call) |
+| `--from` | `string` |  | Start time (RFC3339, date, or relative: today, tomorrow, monday) |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--max`<br>`--limit` | `int64` | 100 | Max events per calendar |
+| `--no-dedup` | `bool` |  | Show each person's view without deduplication |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `-q`<br>`--query` | `string` |  | Filter events by title (case-insensitive) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--to` | `string` |  | End time (RFC3339, date, or relative) |
+| `--today` | `bool` |  | Today only |
+| `--tomorrow` | `bool` |  | Tomorrow only |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+| `--week` | `bool` |  | This week (uses --week-start, default Mon) |
+| `--week-start` | `string` |  | Week start day for --week (sun, mon, ...) |
+
+## See Also
+
+- [gog calendar](gog-calendar.md)
+- [Command index](README.md)

docs/commands/gog-calendar-time.md

@@ -0,0 +1,44 @@
+# `gog calendar time`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Show server time
+
+## Usage
+
+```bash
+gog calendar (cal) time [flags]
+```
+
+## Parent
+
+- [gog calendar](gog-calendar.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--calendar` | `string` | primary | Calendar ID to get timezone from |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--timezone` | `string` |  | Override timezone (e.g., America/New_York, UTC) |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog calendar](gog-calendar.md)
+- [Command index](README.md)

docs/commands/gog-calendar-update.md

@@ -0,0 +1,78 @@
+# `gog calendar update`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Update an event
+
+## Usage
+
+```bash
+gog calendar (cal) update (edit,set) <calendarId> <eventId> [flags]
+```
+
+## Parent
+
+- [gog calendar](gog-calendar.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--add-attendee` | `string` |  | Comma-separated attendee emails to add (preserves existing attendees) |
+| `--all-day` | `bool` |  | All-day event (use date-only in --from/--to) |
+| `--attendees` | `string` |  | Comma-separated attendee emails (replaces all; set empty to clear) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--description` | `string` |  | New description (set empty to clear) |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `--end-timezone`<br>`--to-timezone` | `string` |  | IANA timezone metadata for --to (e.g., America/New_York) |
+| `--event-color` | `string` |  | Event color ID (1-11, or empty to clear) |
+| `--event-type` | `string` |  | Event type: default, focus-time, out-of-office, working-location |
+| `--focus-auto-decline` | `string` |  | Focus Time auto-decline mode: none, all, new |
+| `--focus-chat-status` | `string` |  | Focus Time chat status: available, doNotDisturb |
+| `--focus-decline-message` | `string` |  | Focus Time decline message (set empty to clear) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--from` | `string` |  | New start time (RFC3339; set empty to clear) |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `--guests-can-invite` | `*bool` |  | Allow guests to invite others |
+| `--guests-can-modify` | `*bool` |  | Allow guests to modify event |
+| `--guests-can-see-others` | `*bool` |  | Allow guests to see other guests |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--location` | `string` |  | New location (set empty to clear) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--ooo-auto-decline` | `string` |  | Out of Office auto-decline mode: none, all, new |
+| `--ooo-decline-message` | `string` |  | Out of Office decline message (set empty to clear) |
+| `--original-start` | `string` |  | Original start time of instance (required for scope=single,future) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--private-prop` | `[]string` |  | Private extended property (key=value, can be repeated) |
+| `--reminder` | `[]string` |  | Custom reminders as method:duration (e.g., popup:30m, email:1d). Can be repeated (max 5). Set empty to clear. |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--rrule` | `[]string` |  | Recurrence rules (e.g., 'RRULE:FREQ=MONTHLY;BYMONTHDAY=11'). Can be repeated. Set empty to clear. |
+| `--scope` | `string` | all | For recurring events: single, future, all |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--send-updates` | `string` |  | Notification mode: all, externalOnly, none (default: none) |
+| `--shared-prop` | `[]string` |  | Shared extended property (key=value, can be repeated) |
+| `--start-timezone`<br>`--from-timezone` | `string` |  | IANA timezone metadata for --from (e.g., Europe/Rome) |
+| `--summary` | `string` |  | New summary/title (set empty to clear) |
+| `--to` | `string` |  | New end time (RFC3339; set empty to clear) |
+| `--transparency` | `string` |  | Show as busy (opaque) or free (transparent). Aliases: busy, free |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+| `--visibility` | `string` |  | Event visibility: default, public, private, confidential |
+| `--with-meet` | `bool` |  | Create a Google Meet video conference for this event |
+| `--working-building-id` | `string` |  | Working location building ID |
+| `--working-custom-label` | `string` |  | Working location custom label |
+| `--working-desk-id` | `string` |  | Working location desk ID |
+| `--working-floor-id` | `string` |  | Working location floor ID |
+| `--working-location-type` | `string` |  | Working location type: home, office, custom |
+| `--working-office-label` | `string` |  | Working location office name/label |
+
+## See Also
+
+- [gog calendar](gog-calendar.md)
+- [Command index](README.md)

docs/commands/gog-calendar-users.md

@@ -0,0 +1,46 @@
+# `gog calendar users`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+List workspace users (use their email as calendar ID)
+
+## Usage
+
+```bash
+gog calendar (cal) users [flags]
+```
+
+## Parent
+
+- [gog calendar](gog-calendar.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--all`<br>`--all-pages`<br>`--allpages` | `bool` |  | Fetch all pages |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `--fail-empty`<br>`--non-empty`<br>`--require-results` | `bool` |  | Exit with code 3 if no results |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--max`<br>`--limit` | `int64` | 100 | Max results |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--page`<br>`--cursor` | `string` |  | Page token |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog calendar](gog-calendar.md)
+- [Command index](README.md)

docs/commands/gog-calendar-working-location.md

@@ -0,0 +1,50 @@
+# `gog calendar working-location`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Set working location (home/office/custom)
+
+## Usage
+
+```bash
+gog calendar (cal) working-location (wl) --from=STRING --to=STRING --type=STRING [<calendarId>] [flags]
+```
+
+## Parent
+
+- [gog calendar](gog-calendar.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--building-id` | `string` |  | Building ID |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--custom-label` | `string` |  | Custom location label |
+| `--desk-id` | `string` |  | Desk ID |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `--floor-id` | `string` |  | Floor ID |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--from` | `string` |  | Start date (YYYY-MM-DD) |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--office-label` | `string` |  | Office name/label |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--to` | `string` |  | End date (YYYY-MM-DD) |
+| `--type` | `string` |  | Location type: home, office, custom |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog calendar](gog-calendar.md)
+- [Command index](README.md)

docs/commands/gog-calendar.md

@@ -0,0 +1,68 @@
+# `gog calendar`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Google Calendar
+
+## Usage
+
+```bash
+gog calendar (cal) <command> [flags]
+```
+
+## Parent
+
+- [gog](gog.md)
+
+## Subcommands
+
+- [gog calendar acl](gog-calendar-acl.md) - List calendar ACL
+- [gog calendar alias](gog-calendar-alias.md) - Manage calendar aliases
+- [gog calendar calendars](gog-calendar-calendars.md) - List calendars
+- [gog calendar colors](gog-calendar-colors.md) - Show calendar colors
+- [gog calendar conflicts](gog-calendar-conflicts.md) - Find conflicts
+- [gog calendar create](gog-calendar-create.md) - Create an event
+- [gog calendar create-calendar](gog-calendar-create-calendar.md) - Create a new secondary calendar
+- [gog calendar delete](gog-calendar-delete.md) - Delete an event
+- [gog calendar event](gog-calendar-event.md) - Get event
+- [gog calendar events](gog-calendar-events.md) - List events from a calendar or all calendars
+- [gog calendar focus-time](gog-calendar-focus-time.md) - Create a Focus Time block
+- [gog calendar freebusy](gog-calendar-freebusy.md) - Get free/busy
+- [gog calendar move](gog-calendar-move.md) - Move an event to another calendar
+- [gog calendar out-of-office](gog-calendar-out-of-office.md) - Create an Out of Office event
+- [gog calendar propose-time](gog-calendar-propose-time.md) - Generate URL to propose a new meeting time (browser-only feature)
+- [gog calendar respond](gog-calendar-respond.md) - Respond to an event invitation
+- [gog calendar search](gog-calendar-search.md) - Search events
+- [gog calendar subscribe](gog-calendar-subscribe.md) - Add a calendar to your calendar list
+- [gog calendar team](gog-calendar-team.md) - Show events for all members of a Google Group
+- [gog calendar time](gog-calendar-time.md) - Show server time
+- [gog calendar update](gog-calendar-update.md) - Update an event
+- [gog calendar users](gog-calendar-users.md) - List workspace users (use their email as calendar ID)
+- [gog calendar working-location](gog-calendar-working-location.md) - Set working location (home/office/custom)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog](gog.md)
+- [Command index](README.md)

docs/commands/gog-chat-dm-send.md

@@ -0,0 +1,44 @@
+# `gog chat dm send`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Send a direct message
+
+## Usage
+
+```bash
+gog chat dm send (create,post) <email> [flags]
+```
+
+## Parent
+
+- [gog chat dm](gog-chat-dm.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--text` | `string` |  | Message text (required) |
+| `--thread` | `string` |  | Reply to thread (spaces/.../threads/...) |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog chat dm](gog-chat-dm.md)
+- [Command index](README.md)

docs/commands/gog-chat-dm-space.md

@@ -0,0 +1,42 @@
+# `gog chat dm space`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Find or create a DM space
+
+## Usage
+
+```bash
+gog chat dm space (find,setup) <email>
+```
+
+## Parent
+
+- [gog chat dm](gog-chat-dm.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog chat dm](gog-chat-dm.md)
+- [Command index](README.md)

docs/commands/gog-chat-dm.md

@@ -0,0 +1,47 @@
+# `gog chat dm`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Direct messages
+
+## Usage
+
+```bash
+gog chat dm <command>
+```
+
+## Parent
+
+- [gog chat](gog-chat.md)
+
+## Subcommands
+
+- [gog chat dm send](gog-chat-dm-send.md) - Send a direct message
+- [gog chat dm space](gog-chat-dm-space.md) - Find or create a DM space
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog chat](gog-chat.md)
+- [Command index](README.md)

docs/commands/gog-chat-messages-list.md

@@ -0,0 +1,49 @@
+# `gog chat messages list`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+List messages
+
+## Usage
+
+```bash
+gog chat messages list (ls) <space> [flags]
+```
+
+## Parent
+
+- [gog chat messages](gog-chat-messages.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--all`<br>`--all-pages`<br>`--allpages` | `bool` |  | Fetch all pages |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `--fail-empty`<br>`--non-empty`<br>`--require-results` | `bool` |  | Exit with code 3 if no results |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--max`<br>`--limit` | `int64` | 50 | Max results |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--order` | `string` |  | Order by (e.g. createTime desc) |
+| `--page`<br>`--cursor` | `string` |  | Page token |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--thread` | `string` |  | Filter by thread (spaces/.../threads/...) |
+| `--unread` | `bool` |  | Only messages after last read time |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog chat messages](gog-chat-messages.md)
+- [Command index](README.md)

docs/commands/gog-chat-messages-react.md

@@ -0,0 +1,43 @@
+# `gog chat messages react`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Add an emoji reaction to a message
+
+## Usage
+
+```bash
+gog chat messages react <message> <emoji> [flags]
+```
+
+## Parent
+
+- [gog chat messages](gog-chat-messages.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--space` | `string` |  | Space name (required when message is a bare ID) |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog chat messages](gog-chat-messages.md)
+- [Command index](README.md)

docs/commands/gog-chat-messages-reactions-create.md

@@ -0,0 +1,43 @@
+# `gog chat messages reactions create`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Add an emoji reaction to a message
+
+## Usage
+
+```bash
+gog chat messages reactions (reaction) create (add) <message> <emoji> [flags]
+```
+
+## Parent
+
+- [gog chat messages reactions](gog-chat-messages-reactions.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--space` | `string` |  | Space name (required when message is a bare ID) |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog chat messages reactions](gog-chat-messages-reactions.md)
+- [Command index](README.md)

docs/commands/gog-chat-messages-reactions-delete.md

@@ -0,0 +1,42 @@
+# `gog chat messages reactions delete`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Delete a reaction
+
+## Usage
+
+```bash
+gog chat messages reactions (reaction) delete (remove,rm) <reaction>
+```
+
+## Parent
+
+- [gog chat messages reactions](gog-chat-messages-reactions.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog chat messages reactions](gog-chat-messages-reactions.md)
+- [Command index](README.md)

docs/commands/gog-chat-messages-reactions-list.md

@@ -0,0 +1,46 @@
+# `gog chat messages reactions list`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+List reactions on a message
+
+## Usage
+
+```bash
+gog chat messages reactions (reaction) list (ls) <message> [flags]
+```
+
+## Parent
+
+- [gog chat messages reactions](gog-chat-messages-reactions.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--all` | `bool` |  | Fetch all pages |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--max`<br>`--limit` | `int64` | 50 | Max results |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--page`<br>`--cursor` | `string` |  | Page token |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--space` | `string` |  | Space name (required when message is a bare ID) |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog chat messages reactions](gog-chat-messages-reactions.md)
+- [Command index](README.md)

docs/commands/gog-chat-messages-reactions.md

@@ -0,0 +1,48 @@
+# `gog chat messages reactions`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Manage emoji reactions on a message
+
+## Usage
+
+```bash
+gog chat messages reactions (reaction) <command>
+```
+
+## Parent
+
+- [gog chat messages](gog-chat-messages.md)
+
+## Subcommands
+
+- [gog chat messages reactions create](gog-chat-messages-reactions-create.md) - Add an emoji reaction to a message
+- [gog chat messages reactions delete](gog-chat-messages-reactions-delete.md) - Delete a reaction
+- [gog chat messages reactions list](gog-chat-messages-reactions-list.md) - List reactions on a message
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog chat messages](gog-chat-messages.md)
+- [Command index](README.md)

docs/commands/gog-chat-messages-send.md

@@ -0,0 +1,44 @@
+# `gog chat messages send`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Send a message
+
+## Usage
+
+```bash
+gog chat messages send (create,post) <space> [flags]
+```
+
+## Parent
+
+- [gog chat messages](gog-chat-messages.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--text` | `string` |  | Message text (required) |
+| `--thread` | `string` |  | Reply to thread (spaces/.../threads/...) |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog chat messages](gog-chat-messages.md)
+- [Command index](README.md)

docs/commands/gog-chat-messages.md

@@ -0,0 +1,49 @@
+# `gog chat messages`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Chat messages
+
+## Usage
+
+```bash
+gog chat messages <command>
+```
+
+## Parent
+
+- [gog chat](gog-chat.md)
+
+## Subcommands
+
+- [gog chat messages list](gog-chat-messages-list.md) - List messages
+- [gog chat messages react](gog-chat-messages-react.md) - Add an emoji reaction to a message
+- [gog chat messages reactions](gog-chat-messages-reactions.md) - Manage emoji reactions on a message
+- [gog chat messages send](gog-chat-messages-send.md) - Send a message
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+
+## See Also
+
+- [gog chat](gog-chat.md)
+- [Command index](README.md)