ci: update homebrew tap on release

Adds a read-only contacts dedupe preview command with JSON/table output, generated command docs, README/spec docs, and changelog credit for the extracted idea from #116.\n\nCo-authored-by: Rohan Patnaik <rohan-patnaik@users.noreply.github.com>

.agents/skills/gog/SKILL.md

@@ -1,58 +1,125 @@
 ---
 name: gog
-description: Use when gog should fill Google connector gaps for Gmail, Calendar, Drive, Docs, Sheets, Chat, or Contacts.
+description: Use when working with the gog CLI for Google Workspace automation, especially when an agent needs JSON output, auth preflight, command guards, scoped accounts, or safe Google API reads/writes across Gmail, Calendar, Drive, Docs, Sheets, Slides, Forms, Apps Script, Contacts, Tasks, People, Groups, Keep, or Admin.
 ---
 
 # gog
 
-Use `gog` as a local Google services CLI when built-in connectors are missing a feature, need shell-friendly JSON, or need account/auth inspection.
+Use `gog` when built-in Google connectors are missing a feature, when shell
+automation needs stable JSON, or when you need to inspect local Google auth
+state before acting.
 
-## Sources
+## Fast Path
-
-- Repo: `~/Projects/gogcli`
-- CLI: `gog`
-- Config: `~/Library/Application Support/gogcli/config.json`
-- OAuth/keyring: `~/Library/Application Support/gogcli`
-
-## Auth
-
-Inspect accounts before assuming auth is blocked:
-
-```bash
-gog auth list
-gog auth status
-```
-
-Use `--json` for scriptable output and `--dry-run` for write planning where supported.
-
-## Common Surfaces
-
-```bash
-gog gmail search "from:example@example.com"
-gog calendar events list --json
-gog drive search "name contains 'deck'" --json
-gog contacts search "Name" --json
-gog sheets --help
-```
-
-Prefer native Gmail/Calendar/Drive/Slack connectors first when they cover the task. Use `gog` for gaps, local automation, or auth/debug state.
-
-## Safety
-
-Do not send email, create/update/delete files, change calendar events, or alter contacts unless the user explicitly asks. For writes, summarize the target account and intended mutation first unless the user already gave a concrete command.
-
-## Verification
-
-For repo edits:
-
-```bash
-make test
-make
-```
-
-Smoke:
 
 ```bash
 gog --version
-gog auth status --json
+gog auth list --check --json --no-input
+gog auth doctor --check --json --no-input
+gog schema --json
 ```
+
+Pick the account explicitly for API work:
+
+```bash
+gog --account user@example.com gmail search 'newer_than:7d' --json
+```
+
+Prefer `--json` or `--plain` for agent parsing. Human hints and progress should
+stay on stderr; stdout is for data.
+
+## Safety Rules
+
+- Do not print access tokens, refresh tokens, OAuth client secrets, or keyring
+  passwords.
+- Do not store `GOG_KEYRING_PASSWORD` in a shell profile or plaintext project
+  file. If the file keyring cannot unlock non-interactively, stop and ask for a
+  safer setup.
+- Use `--no-input` in automation so auth/keyring prompts fail clearly.
+- Use `--dry-run` first where commands support it.
+- Destructive commands require `--force`; do not add it unless the user asked
+  for that exact mutation.
+- Use `--gmail-no-send` or `GOG_GMAIL_NO_SEND=1` unless sending mail is the
+  requested task.
+- For shared agent environments, prefer a baked readonly or agent-safe binary
+  from `docs/safety-profiles.md`.
+
+Runtime command guards:
+
+```bash
+gog --enable-commands gmail.search,gmail.get --gmail-no-send \
+  --account user@example.com gmail search 'from:example@example.com' --json
+
+gog --enable-commands drive.ls,docs.cat --disable-commands drive.delete \
+  --account user@example.com drive ls --max 10 --json
+```
+
+## Auth
+
+OAuth setup is partly interactive. An agent can inspect and diagnose it, but a
+human normally completes browser consent:
+
+```bash
+gog auth credentials list
+gog auth add user@example.com --services gmail,calendar,drive --readonly
+gog auth add user@example.com --services docs,sheets,slides
+gog auth remove user@example.com
+```
+
+Use narrow services and `--readonly` when the task only reads. Service accounts
+are Workspace-only and mainly fit Admin, Groups, Keep, and domain-wide
+delegation flows; they do not solve consumer `@gmail.com` OAuth.
+
+## Common Reads
+
+```bash
+gog --account user@example.com gmail search 'newer_than:3d' --max 10 --json
+gog --account user@example.com gmail get <messageId> --sanitize-content --json
+gog --account user@example.com gmail thread get <threadId> --sanitize-content --json
+
+gog --account user@example.com calendar events --today --json
+gog --account user@example.com drive ls --max 20 --json
+gog --account user@example.com docs cat <documentId> --json
+gog --account user@example.com sheets get <spreadsheetId> Sheet1!A1:D20 --json
+gog --account user@example.com contacts list --max 20 --json
+```
+
+For Gmail body inspection, prefer `--sanitize-content` unless the user
+explicitly needs raw payloads.
+
+## Writes
+
+Before writes, identify the account, object id, and exact mutation. Prefer
+commands that support `--dry-run`, and clean up disposable live-test objects.
+
+```bash
+gog --account user@example.com docs write <documentId> --append --text '...'
+gog --account user@example.com sheets update <spreadsheetId> Sheet1!A1 --values-json '[["hello"]]'
+gog --account user@example.com drive upload ./file.txt --parent <folderId> --json
+```
+
+When testing creation commands, name artifacts with a clear temporary prefix and
+delete or trash them after verification.
+
+## Discovery
+
+Use generated command docs and schema instead of guessing flags:
+
+```bash
+gog <service> --help
+gog <service> <command> --help
+gog schema <service> <command> --json
+```
+
+Docs:
+
+- `docs/README.md`
+- `docs/commands/README.md`
+- `docs/safety-profiles.md`
+- `README.md#security`
+
+Repo paths:
+
+- CLI entrypoint: `cmd/gog/`
+- Command implementations: `internal/cmd/`
+- OAuth/keyring: `internal/auth/`, `internal/secrets/`
+- Generated command docs: `docs/commands/`

.dockerignore

@@ -0,0 +1,11 @@
+.git
+.github
+.tools
+**/node_modules
+bin
+dist
+gog
+gog.exe
+*.test
+coverage*
+.DS_Store

.github/workflows/docker.yml

@@ -0,0 +1,96 @@
+name: docker
+
+on:
+  pull_request:
+    paths:
+      - ".dockerignore"
+      - ".github/workflows/docker.yml"
+      - "Dockerfile"
+      - "cmd/**"
+      - "go.mod"
+      - "go.sum"
+      - "internal/**"
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Optional release tag to publish (e.g. v0.14.0)"
+        required: false
+        type: string
+
+permissions:
+  contents: read
+  packages: write
+
+jobs:
+  image:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Validate manual tag
+        if: ${{ github.event_name == 'workflow_dispatch' && inputs.tag != '' }}
+        env:
+          RELEASE_TAG: ${{ inputs.tag }}
+        run: |
+          if ! echo "$RELEASE_TAG" | grep -qE '^v[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9.]+)?$'; then
+            echo "::error::Invalid tag format: $RELEASE_TAG"
+            exit 1
+          fi
+
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          fetch-depth: 0
+          ref: ${{ github.event_name == 'workflow_dispatch' && inputs.tag || github.ref }}
+
+      - name: Docker metadata
+        id: meta
+        uses: docker/metadata-action@c299e40c65443455700f0fdfc63efafe5b349051 # v5.10.0
+        with:
+          images: ghcr.io/steipete/gogcli
+          tags: |
+            type=ref,event=pr
+            type=ref,event=tag
+            type=raw,value=${{ inputs.tag }},enable=${{ github.event_name == 'workflow_dispatch' && inputs.tag != '' }}
+            type=raw,value=latest,enable=${{ (startsWith(github.ref, 'refs/tags/v') && !contains(github.ref_name, '-')) || (github.event_name == 'workflow_dispatch' && inputs.tag != '' && !contains(inputs.tag, '-')) }}
+
+      - name: Build metadata
+        id: build-meta
+        env:
+          RELEASE_TAG: ${{ inputs.tag }}
+        run: |
+          version="dev"
+          if [[ -n "$RELEASE_TAG" ]]; then
+            version="$RELEASE_TAG"
+          elif [[ "$GITHUB_REF_TYPE" == "tag" ]]; then
+            version="$GITHUB_REF_NAME"
+          fi
+          {
+            echo "version=$version"
+            echo "commit=${GITHUB_SHA::12}"
+            echo "date=$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@e468171a9de216ec08956ac3ada2f0791b6bd435 # v3.11.1
+
+      - name: Login to GHCR
+        if: ${{ startsWith(github.ref, 'refs/tags/v') || (github.event_name == 'workflow_dispatch' && inputs.tag != '') }}
+        uses: docker/login-action@c94ce9fb468520275223c153574b00df6fe4bcc9 # v3.7.0
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build image
+        uses: docker/build-push-action@ee4ca427a2f43b6a16632044ca514c076267da23 # v6.19.0
+        with:
+          context: .
+          push: ${{ startsWith(github.ref, 'refs/tags/v') || (github.event_name == 'workflow_dispatch' && inputs.tag != '') }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          build-args: |
+            VERSION=${{ steps.build-meta.outputs.version }}
+            COMMIT=${{ steps.build-meta.outputs.commit }}
+            DATE=${{ steps.build-meta.outputs.date }}

.github/workflows/pages.yml

@@ -0,0 +1,61 @@
+name: pages
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "docs/**"
+      - "scripts/gen-command-reference.sh"
+      - "scripts/build-docs-site.mjs"
+      - "scripts/docs-site-assets.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

.github/workflows/release.yml

@@ -48,6 +48,31 @@ jobs:
           RELEASE_TAG: ${{ inputs.tag }}
         run: git checkout "$RELEASE_TAG"
 
+      - name: Import macOS signing certificate
+        env:
+          MACOS_SIGNING_CERT_BASE64: ${{ secrets.MACOS_SIGNING_CERT_BASE64 }}
+          MACOS_SIGNING_CERT_PASSWORD: ${{ secrets.MACOS_SIGNING_CERT_PASSWORD }}
+        run: |
+          set -euo pipefail
+          if [ -z "$MACOS_SIGNING_CERT_BASE64" ]; then
+            echo "No macOS signing certificate configured; skipping import."
+            exit 0
+          fi
+
+          KEYCHAIN="build.keychain"
+          KEYCHAIN_PASSWORD="$(uuidgen)"
+
+          echo "$MACOS_SIGNING_CERT_BASE64" | base64 --decode > /tmp/codesign.p12
+
+          security create-keychain -p "$KEYCHAIN_PASSWORD" "$KEYCHAIN"
+          security set-keychain-settings -lut 21600 "$KEYCHAIN"
+          security unlock-keychain -p "$KEYCHAIN_PASSWORD" "$KEYCHAIN"
+          security default-keychain -s "$KEYCHAIN"
+          security list-keychains -d user -s "$KEYCHAIN"
+
+          security import /tmp/codesign.p12 -k "$KEYCHAIN" -P "$MACOS_SIGNING_CERT_PASSWORD" -T /usr/bin/codesign -T /usr/bin/security
+          security set-key-partition-list -S apple-tool:,apple:,codesign: -s -k "$KEYCHAIN_PASSWORD" "$KEYCHAIN"
+
       - name: GoReleaser
         uses: goreleaser/goreleaser-action@1a80836c5c9d9e5755a25cb59ec6f45a3b5f41a8 # v7.2.1
         with:
@@ -56,3 +81,63 @@ jobs:
           args: release --clean --config /tmp/.goreleaser.yaml
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GOG_CODESIGN_IDENTITY: ${{ secrets.MACOS_CODESIGN_IDENTITY }}
+
+  update-homebrew-tap:
+    runs-on: ubuntu-latest
+    needs: goreleaser
+    steps:
+      - name: Resolve release tag
+        run: |
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+            echo "RELEASE_TAG=${{ inputs.tag }}" >> "$GITHUB_ENV"
+          else
+            echo "RELEASE_TAG=${{ github.ref_name }}" >> "$GITHUB_ENV"
+          fi
+
+      - name: Dispatch tap formula update
+        env:
+          GH_TOKEN: ${{ secrets.HOMEBREW_TAP_TOKEN }}
+        run: |
+          if [ -z "$GH_TOKEN" ]; then
+            echo "::error::Set HOMEBREW_TAP_TOKEN with workflow access to steipete/homebrew-tap"
+            exit 1
+          fi
+
+          request_id="gogcli-${RELEASE_TAG}-${GITHUB_RUN_ID}-${GITHUB_RUN_ATTEMPT}"
+          expected_title="Update gogcli for ${RELEASE_TAG} (${request_id})"
+
+          gh workflow run update-formula.yml \
+            --repo steipete/homebrew-tap \
+            --ref main \
+            -f formula=gogcli \
+            -f tag="$RELEASE_TAG" \
+            -f repository=steipete/gogcli \
+            -f artifact_template="{formula}_{version}_{target}.tar.gz" \
+            -f request_id="$request_id"
+
+          run_id=""
+          for _ in {1..30}; do
+            run_id=$(gh run list \
+              --repo steipete/homebrew-tap \
+              --workflow update-formula.yml \
+              --branch main \
+              --event workflow_dispatch \
+              --limit 20 \
+              --json databaseId,displayTitle \
+              --jq ".[] | select(.displayTitle == \"$expected_title\") | .databaseId" | head -n1)
+            if [ -n "$run_id" ]; then
+              break
+            fi
+            sleep 5
+          done
+
+          if [ -z "$run_id" ]; then
+            echo "::error::Could not find tap workflow run with title: $expected_title"
+            exit 1
+          fi
+
+          gh run watch "$run_id" \
+            --repo steipete/homebrew-tap \
+            --exit-status \
+            --interval 10

.gitignore

@@ -37,6 +37,8 @@ go.work.sum
 # Local build output
 bin/
 /gog
+internal/cmd/safety_profile_baked_gen.go
 
 # Node (optional dev scripts)
 node_modules/
+dist/

.golangci.yml

@@ -120,6 +120,11 @@ linters:
           - dupl
           - wsl_v5
           - tagliatelle
+      - path: internal/safetyprofile/.*\.go
+        linters:
+          - err113
+          - wrapcheck
+          - wsl_v5
       - path: internal/googleauth/.*\.go
         linters:
           - tagliatelle

.goreleaser.yaml

@@ -34,16 +34,21 @@ builds:
     targets:
       - darwin_amd64
       - darwin_arm64
+    hooks:
+      post:
+        - ./scripts/codesign-macos.sh "{{ .Path }}"
 
 archives:
-  - builds:
+  - ids:
       - gog
       - gog_darwin
-    format: tar.gz
+    formats:
+      - tar.gz
     name_template: "{{ .ProjectName }}_{{ .Version }}_{{ .Os }}_{{ .Arch }}"
     format_overrides:
       - goos: windows
-        format: zip
+        formats:
+          - zip
 
 checksum:
   name_template: checksums.txt

CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## 0.16.0 - Unreleased
+
+## 0.15.0 - 2026-05-05
+
+### Added
+- Export exact Google API JSON when the normal CLI view is too lossy: `docs raw`, `sheets raw`, `slides raw`, `drive raw`, `gmail raw`, `calendar raw`, `people raw`, `contacts raw`, `tasks raw`, and `forms raw`, with `--pretty`, safer Drive defaults, Sheets grid-data warnings, and a raw-output security audit. (#495, #496) — thanks @karbassi.
+- Audit Drive storage without changing files: `drive tree`, `drive du`, and `drive inventory` now report folder contents, sizes, and inventory data for cleanup/review workflows. (#116) — thanks @rohan-patnaik.
+- Find duplicate contacts safely: `contacts dedupe` is preview-only, matches by email/phone by default, supports opt-in name matching, and emits JSON/table merge plans without applying changes. (#116) — thanks @rohan-patnaik.
+- Read Gmail messages in agent-safe form: `gmail get --sanitize-content` / `--safe` and `gmail thread get --sanitize-content` return sanitized content without exposing raw Gmail payloads in JSON. (#238, #220) — thanks @urasmutlu.
+- Ship official container images: release tags now publish a non-root GHCR Docker image, with file-keyring docs for container automation. (#539, #444) — thanks @HuckOps and @rdehuyss.
+- Request custom Drive fields: `drive ls --fields` and `drive get --fields` pass Drive API field masks for data beyond the default JSON set. (#495) — thanks @karbassi.
+- Format Google Docs from the CLI: `docs format` and plain-text `docs write` formatting flags cover fonts, colors, bold/italic/underline/strikethrough, alignment, and line spacing. (#479) — thanks @mmaghsoodnia.
+- Manage Google Docs tabs: `docs add-tab`, `docs rename-tab`, `docs delete-tab`, plus tab-scoped Markdown append and find-replace flows. (#547, #541) — thanks @chopenhauer and @donbowman.
+- Work with structured Google Sheets tables: `sheets table` list/get/create/delete, `sheets table append`, and header-safe `sheets table clear`. (#470) — thanks @Pedrohgv.
+- Format Sheets visually: `sheets conditional-format` and `sheets banding` add rule-based formatting and alternating color banded ranges. (#378) — thanks @codBang.
+- Add Meet links to existing calendar events with `calendar update --with-meet`. (#538) — thanks @alexisperumal.
+- Move calendar events between calendars with `calendar move` / `calendar transfer`, including organizer changes. (#448) — thanks @markusbkoch.
+- Export Gmail filters as Gmail WebUI-importable Atom XML, while keeping API JSON export via `--format json`. (#174) — thanks @gwpl.
+- Build safer agent binaries with baked `agent-safe`, `readonly`, and `full` safety profiles, fail-closed command filtering, filtered help/schema output, docs, and build tooling. (#366, #239) — thanks @drewburchfield.
+- Use gog from coding agents more safely with the bundled `gog` skill for JSON-first Google Workspace automation. (#353, #451) — thanks @TimPietrusky and @sluramod.
+
+### Fixed
+- Make full-mailbox backups survive large Gmail exports by promoting completed checkpoint shards into the final manifest and byte-splitting fallback message shards before GitHub rejects oversized blobs.
+- Make backup exports more resumable and fault-tolerant by streaming decrypted shards, preserving Gmail Markdown mirrors, handling very large JSONL rows, and writing Markdown fallbacks for malformed MIME messages instead of aborting.
+- Keep agent safety profiles harder to patch by compiling baked policies into generated hash switches instead of embedding raw allow/deny YAML strings. (#540) — thanks @drewburchfield.
+- Show correct versions for `go install ...@tag` binaries by inferring module versions from Go build info when linker metadata is absent. (#545, #544) — thanks @joshavant.
+- Accept the documented `calendar events list` / `ls` selector forms, including positional calendar IDs, `--cal`, `--calendars`, and `--all`. (#546) — thanks @BCudeOpenClaw.
+- Keep `docs find-replace --dry-run` read-only while still reporting match counts, and allow empty replacement strings to delete matches safely. (#542) — thanks @chrismdp.
+
 ## 0.14.0 - 2026-04-28
 
 ### Added

Dockerfile

@@ -0,0 +1,40 @@
+# syntax=docker/dockerfile:1.7
+
+ARG GO_VERSION=1.26.2
+ARG ALPINE_VERSION=3.22
+
+FROM golang:${GO_VERSION}-alpine AS build
+
+RUN apk add --no-cache ca-certificates git tzdata
+
+WORKDIR /src
+COPY go.mod go.sum ./
+RUN go mod download
+
+COPY . .
+
+ARG VERSION=dev
+ARG COMMIT=unknown
+ARG DATE=unknown
+
+RUN CGO_ENABLED=0 GOOS=linux go build -trimpath \
+    -ldflags="-s -w -X github.com/steipete/gogcli/internal/cmd.version=${VERSION} -X github.com/steipete/gogcli/internal/cmd.commit=${COMMIT} -X github.com/steipete/gogcli/internal/cmd.date=${DATE}" \
+    -o /out/gog ./cmd/gog
+
+FROM alpine:${ALPINE_VERSION}
+
+LABEL org.opencontainers.image.source="https://github.com/steipete/gogcli"
+LABEL org.opencontainers.image.description="Google services CLI for terminal automation"
+LABEL org.opencontainers.image.licenses="MIT"
+
+RUN apk add --no-cache ca-certificates tzdata \
+    && adduser -D -u 10001 -h /home/gog gog
+
+ENV HOME=/home/gog
+WORKDIR /home/gog
+
+COPY --from=build /out/gog /usr/local/bin/gog
+
+USER gog
+ENTRYPOINT ["gog"]
+CMD ["--help"]

Makefile

@@ -3,7 +3,7 @@ SHELL := /bin/bash
 # `make` should build the binary by default.
 .DEFAULT_GOAL := build
 
-.PHONY: build 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
@@ -38,6 +38,9 @@ build:
 	@mkdir -p $(BIN_DIR)
 	@go build -ldflags "$(LDFLAGS)" -o $(BIN) $(CMD)
 
+build-safe:
+	@./build-safe.sh $${PROFILE:-safety-profiles/agent-safe.yaml} -o $${OUTPUT:-$(BIN_DIR)/gog-safe}
+
 gog: build
 	@if [ -n "$(RUN_ARGS)" ]; then \
 		$(BIN) $(RUN_ARGS); \
@@ -67,6 +70,12 @@ 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
+	@node scripts/check-docs-coverage.mjs
+
 tools:
 	@mkdir -p $(TOOLS_DIR)
 	@if [ -x "$(GOFUMPT)" ] && [ -x "$(GOIMPORTS)" ] && [ -x "$(GOLANGCI_LINT)" ] && [ "$$(cat $(TOOLS_STAMP) 2>/dev/null)" = "$(TOOLS_VERSION)" ]; then \

build-safe.sh

@@ -0,0 +1,79 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+cd "$(dirname "$0")"
+
+usage() {
+  cat >&2 <<'USAGE'
+Usage: ./build-safe.sh <profile.yaml> [-o output]
+
+Examples:
+  ./build-safe.sh safety-profiles/readonly.yaml
+  ./build-safe.sh safety-profiles/agent-safe.yaml -o /usr/local/bin/gog-safe
+USAGE
+}
+
+if [[ "${1:-}" == "-h" || "${1:-}" == "--help" ]]; then
+  usage
+  exit 0
+fi
+
+if [[ -z "${1:-}" || "${1:-}" == -* ]]; then
+  usage
+  exit 2
+fi
+
+PROFILE="$1"
+shift
+
+OUTPUT="bin/gog-safe"
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -o|--output)
+      if [[ -z "${2:-}" ]]; then
+        echo "error: $1 requires a path" >&2
+        exit 2
+      fi
+      OUTPUT="$2"
+      shift 2
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "error: unknown flag: $1" >&2
+      usage
+      exit 2
+      ;;
+  esac
+done
+
+if [[ ! -f "$PROFILE" ]]; then
+  echo "error: profile not found: $PROFILE" >&2
+  exit 1
+fi
+
+GEN_FILE="internal/cmd/safety_profile_baked_gen.go"
+cleanup() {
+  rm -f "$GEN_FILE"
+}
+trap cleanup EXIT
+
+cleanup
+go run ./cmd/bake-safety-profile "$PROFILE" "$GEN_FILE"
+
+VERSION=$(git describe --tags --always --dirty 2>/dev/null || echo dev)
+COMMIT=$(git rev-parse --short=12 HEAD 2>/dev/null || echo "")
+DATE=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+LDFLAGS="-X github.com/steipete/gogcli/internal/cmd.version=${VERSION}-safe -X github.com/steipete/gogcli/internal/cmd.commit=${COMMIT} -X github.com/steipete/gogcli/internal/cmd.date=${DATE}"
+
+mkdir -p "$(dirname "$OUTPUT")"
+go build -tags safety_profile -ldflags "$LDFLAGS" -o "$OUTPUT" ./cmd/gog
+RUN_OUTPUT="$OUTPUT"
+if [[ "$RUN_OUTPUT" != */* ]]; then
+  RUN_OUTPUT="./$RUN_OUTPUT"
+fi
+"$RUN_OUTPUT" --version
+
+echo "built $OUTPUT with baked safety profile $PROFILE"

cmd/bake-safety-profile/main.go

@@ -0,0 +1,115 @@
+package main
+
+import (
+	"bytes"
+	"fmt"
+	"os"
+	"strconv"
+	"strings"
+
+	"github.com/steipete/gogcli/internal/safetyprofile"
+)
+
+const usage = `Usage: bake-safety-profile <profile.yaml> <output.go>` + "\n"
+
+func main() {
+	args := os.Args[1:]
+	if len(args) != 2 {
+		_, _ = fmt.Fprint(os.Stderr, usage)
+		os.Exit(2)
+	}
+
+	raw, err := os.ReadFile(args[0]) // #nosec G304 G703 -- build helper intentionally reads the requested profile path.
+	if err != nil {
+		_, _ = fmt.Fprintf(os.Stderr, "read profile: %v\n", err)
+		os.Exit(1)
+	}
+
+	profile, err := safetyprofile.Parse(string(raw))
+	if err != nil {
+		_, _ = fmt.Fprintf(os.Stderr, "parse profile: %v\n", err)
+		os.Exit(1)
+	}
+
+	out := generate(profile)
+	if err := os.WriteFile(args[1], out, 0o600); err != nil { // #nosec G306 G703 -- build helper intentionally writes the requested generated Go path.
+		_, _ = fmt.Fprintf(os.Stderr, "write output: %v\n", err)
+		os.Exit(1)
+	}
+}
+
+// generate emits a Go file that resolves the bakedSafety* package-level
+// functions for safety_profile builds. Allow and deny rules are encoded as
+// FNV-64a hashes in switch statements so that the rule set itself is no
+// longer a contiguous, patchable string in the binary.
+func generate(profile *safetyprofile.Profile) []byte {
+	var out bytes.Buffer
+	hasAllowRules := profile.AllowAll || len(profile.AllowRules) > 0
+
+	out.WriteString("// Code generated by cmd/bake-safety-profile; DO NOT EDIT.\n")
+	commentName := strings.ReplaceAll(strings.ReplaceAll(profile.Name, "\n", " "), "\r", " ")
+	fmt.Fprintf(&out, "// Profile: %s (%d allow, %d deny, allow-all=%t)\n", commentName, len(profile.AllowRules), len(profile.DenyRules), profile.AllowAll)
+	out.WriteString("// Hash: FNV-64a over dotted command paths.\n")
+	out.WriteString("//go:build safety_profile\n\n")
+	out.WriteString("package cmd\n\n")
+
+	out.WriteString("const bakedSafetyProfileNameConst = ")
+	out.WriteString(strconv.Quote(profile.Name))
+	out.WriteString("\n\n")
+
+	out.WriteString("func bakedSafetyEnabled() bool       { return true }\n")
+	out.WriteString("func bakedSafetyProfileName() string { return bakedSafetyProfileNameConst }\n")
+	fmt.Fprintf(&out, "func bakedSafetyHasAllowRules() bool { return %t }\n\n", hasAllowRules)
+
+	writeMatcher(&out, "bakedSafetyAllowMatch", profile.AllowRules, profile.AllowAll)
+	out.WriteString("\n")
+	writeMatcher(&out, "bakedSafetyDenyMatch", profile.DenyRules, false)
+
+	return out.Bytes()
+}
+
+func writeMatcher(out *bytes.Buffer, name string, rules []string, matchAll bool) {
+	fmt.Fprintf(out, "func %s(path []string) bool {\n", name)
+	if matchAll {
+		out.WriteString("\treturn true\n}\n")
+		return
+	}
+	if len(rules) == 0 {
+		out.WriteString("\treturn false\n}\n")
+		return
+	}
+
+	out.WriteString("\tif len(path) == 0 {\n\t\treturn false\n\t}\n")
+	out.WriteString("\tfor i := 1; i <= len(path); i++ {\n")
+	out.WriteString("\t\tswitch bakedSafetyHashPath(path[:i]) {\n")
+	out.WriteString("\t\tcase ")
+
+	cases := make([]string, 0, len(rules))
+	seen := make(map[uint64]string, len(rules))
+	for _, rule := range rules {
+		h := safetyprofile.HashRule(rule)
+		if existing, dup := seen[h]; dup {
+			fmt.Fprintf(os.Stderr, "bake-safety-profile: hash collision between %q and %q (FNV-64a=%#x); pick a different name or extend the hash\n", existing, rule, h)
+			os.Exit(1)
+		}
+		seen[h] = rule
+		cases = append(cases, fmt.Sprintf("0x%016x", h))
+	}
+
+	const perLine = 4
+	for i, c := range cases {
+		out.WriteString(c)
+		if i == len(cases)-1 {
+			break
+		}
+		out.WriteString(",")
+		if (i+1)%perLine == 0 {
+			out.WriteString("\n\t\t\t")
+		} else {
+			out.WriteString(" ")
+		}
+	}
+	out.WriteString(":\n\t\t\treturn true\n")
+	out.WriteString("\t\t}\n\t}\n")
+	out.WriteString("\treturn false\n}\n")
+}

cmd/bake-safety-profile/main_test.go

@@ -0,0 +1,138 @@
+package main
+
+import (
+	"bytes"
+	"fmt"
+	"go/parser"
+	"go/token"
+	"strings"
+	"testing"
+
+	"github.com/steipete/gogcli/internal/safetyprofile"
+)
+
+func TestGenerateProducesParseableGoWithExpectedHashes(t *testing.T) {
+	profile := &safetyprofile.Profile{
+		Name:       "test",
+		AllowAll:   false,
+		AllowRules: []string{"version", "gmail.search", "gmail.drafts.create"},
+		DenyRules:  []string{"gmail.send", "gmail.drafts.send"},
+	}
+
+	out := generate(profile)
+
+	if _, err := parser.ParseFile(token.NewFileSet(), "gen.go", out, parser.AllErrors); err != nil {
+		t.Fatalf("generated code does not parse as Go:\n%s\n\nerror: %v", out, err)
+	}
+
+	want := []string{
+		`//go:build safety_profile`,
+		`package cmd`,
+		`const bakedSafetyProfileNameConst = "test"`,
+		`func bakedSafetyEnabled() bool       { return true }`,
+		`func bakedSafetyHasAllowRules() bool { return true }`,
+	}
+	for _, line := range want {
+		if !bytes.Contains(out, []byte(line)) {
+			t.Fatalf("generated output missing %q\n\nfull output:\n%s", line, out)
+		}
+	}
+
+	for _, rule := range profile.AllowRules {
+		hex := fmt.Sprintf("0x%016x", safetyprofile.HashRule(rule))
+		if !bytes.Contains(out, []byte(hex)) {
+			t.Fatalf("expected allow hash %s for rule %q in output", hex, rule)
+		}
+	}
+	for _, rule := range profile.DenyRules {
+		hex := fmt.Sprintf("0x%016x", safetyprofile.HashRule(rule))
+		if !bytes.Contains(out, []byte(hex)) {
+			t.Fatalf("expected deny hash %s for rule %q in output", hex, rule)
+		}
+	}
+
+	for _, rule := range profile.AllowRules {
+		if bytes.Contains(out, []byte(fmt.Sprintf("%q", rule))) {
+			t.Fatalf("rule string %q must not appear in generated output", rule)
+		}
+	}
+	for _, rule := range profile.DenyRules {
+		if bytes.Contains(out, []byte(fmt.Sprintf("%q", rule))) {
+			t.Fatalf("rule string %q must not appear in generated output", rule)
+		}
+	}
+}
+
+func TestGenerateSanitizesProfileNameInComment(t *testing.T) {
+	profile := &safetyprofile.Profile{
+		Name:      "bad\nname\rwith-controls",
+		AllowAll:  true,
+		DenyRules: []string{},
+	}
+	out := generate(profile)
+
+	if _, err := parser.ParseFile(token.NewFileSet(), "gen.go", out, parser.AllErrors); err != nil {
+		t.Fatalf("generated code with control chars in name does not parse:\n%s\n\nerror: %v", out, err)
+	}
+	if bytes.Contains(out, []byte("\nname\r")) || bytes.Contains(out, []byte("\nname\n")) {
+		t.Fatalf("comment header leaked control chars from profile name:\n%s", out)
+	}
+}
+
+func TestGenerateAllowAllEmitsConstantTrue(t *testing.T) {
+	profile := &safetyprofile.Profile{
+		Name:      "full",
+		AllowAll:  true,
+		DenyRules: []string{},
+	}
+	out := string(generate(profile))
+
+	allowFn := extractFunc(t, out, "bakedSafetyAllowMatch")
+	if !strings.Contains(allowFn, "return true") || strings.Contains(allowFn, "switch ") {
+		t.Fatalf("AllowAll allow matcher should be `return true` only, got:\n%s", allowFn)
+	}
+
+	denyFn := extractFunc(t, out, "bakedSafetyDenyMatch")
+	if !strings.Contains(denyFn, "return false") {
+		t.Fatalf("empty deny matcher should `return false`, got:\n%s", denyFn)
+	}
+}
+
+func TestGenerateEmptyAllowEmitsConstantFalse(t *testing.T) {
+	profile := &safetyprofile.Profile{
+		Name:      "deny-only",
+		AllowAll:  false,
+		DenyRules: []string{"gmail.send"},
+	}
+	out := string(generate(profile))
+
+	if !strings.Contains(out, "func bakedSafetyHasAllowRules() bool { return false }") {
+		t.Fatalf("expected hasAllowRules=false for deny-only profile, got:\n%s", out)
+	}
+	allowFn := extractFunc(t, out, "bakedSafetyAllowMatch")
+	if !strings.Contains(allowFn, "return false") || strings.Contains(allowFn, "switch ") {
+		t.Fatalf("empty allow matcher should be `return false` only, got:\n%s", allowFn)
+	}
+}
+
+func extractFunc(t *testing.T, src, name string) string {
+	t.Helper()
+	start := strings.Index(src, "func "+name+"(")
+	if start < 0 {
+		t.Fatalf("function %s not found in:\n%s", name, src)
+	}
+	depth := 0
+	for i := start; i < len(src); i++ {
+		switch src[i] {
+		case '{':
+			depth++
+		case '}':
+			depth--
+			if depth == 0 {
+				return src[start : i+1]
+			}
+		}
+	}
+	t.Fatalf("function %s has unbalanced braces", name)
+	return ""
+}

docs/RELEASING.md

@@ -24,6 +24,10 @@ Assumptions:
 - Go toolchain installed (Go version comes from `go.mod`).
 - `make` works locally.
 - Access to the tap repo (e.g. `steipete/homebrew-tap`).
+- For signed macOS release binaries (recommended): GitHub Actions secrets set:
+  - `MACOS_SIGNING_CERT_BASE64` (base64-encoded `.p12`)
+  - `MACOS_SIGNING_CERT_PASSWORD`
+  - `MACOS_CODESIGN_IDENTITY` (e.g. `Developer ID Application: …`)
 
 ## 1) Verify build is green
 ```sh
@@ -71,7 +75,14 @@ gh workflow run release.yml -f tag=vX.Y.Z
 ## 5) Update (or add) the Homebrew formula
 In the tap repo (assumed sibling at `../homebrew-tap`), create/update `Formula/gogcli.rb`.
 
-Recommended formula shape (build-from-source, no binary assets needed):
+Recommended formula shape (download GitHub release assets; preserves macOS code signature):
+- `version "X.Y.Z"`
+- `url "https://github.com/steipete/gogcli/releases/download/vX.Y.Z/gogcli_X.Y.Z_darwin_arm64.tar.gz"` (or `darwin_amd64`)
+- `sha256 "<sha256>"`
+- Install:
+  - `bin.install "gog"`
+
+Alternative (build-from-source; macOS binary will be ad-hoc signed, which can trigger repeated Keychain prompts with `KeychainTrustApplication`):
 - `version "X.Y.Z"`
 - `url "https://github.com/steipete/gogcli/archive/refs/tags/vX.Y.Z.tar.gz"`
 - `sha256 "<sha256>"`

docs/assets/site.css

@@ -1,489 +0,0 @@
-:root {
-  --bg0: #07070b;
-  --bg1: #0b0b11;
-  --bg2: #11111a;
-  --card: rgba(17, 17, 26, 0.72);
-  --card2: rgba(12, 12, 18, 0.64);
-  --stroke: rgba(255, 255, 255, 0.08);
-  --stroke2: rgba(255, 255, 255, 0.05);
-  --text: #f3f4f6;
-  --muted: rgba(243, 244, 246, 0.7);
-  --dim: rgba(243, 244, 246, 0.46);
-
-  --b: #4285f4;
-  --r: #ea4335;
-  --y: #fbbc05;
-  --g: #34a853;
-
-  --shadow: 0 24px 60px rgba(0, 0, 0, 0.55);
-  --shadow2: 0 16px 40px rgba(0, 0, 0, 0.45);
-
-  --radius: 16px;
-  --radius2: 22px;
-
-  --serif: "Fraunces", ui-serif, Georgia, serif;
-  --sans: "DM Sans", -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
-  --mono: "JetBrains Mono", ui-monospace, SFMono-Regular, Menlo, monospace;
-}
-
-* {
-  box-sizing: border-box;
-}
-
-html,
-body {
-  height: 100%;
-}
-
-body {
-  margin: 0;
-  background: radial-gradient(1200px 800px at 50% -20%, rgba(66, 133, 244, 0.18), transparent 60%),
-    radial-gradient(900px 700px at 80% 18%, rgba(234, 67, 53, 0.14), transparent 55%),
-    radial-gradient(1000px 900px at 18% 62%, rgba(52, 168, 83, 0.14), transparent 55%),
-    radial-gradient(900px 900px at 65% 88%, rgba(251, 188, 5, 0.12), transparent 55%),
-    linear-gradient(180deg, var(--bg0), var(--bg1) 40%, var(--bg0));
-  color: var(--text);
-  font-family: var(--sans);
-  -webkit-font-smoothing: antialiased;
-  line-height: 1.55;
-  overflow-x: hidden;
-}
-
-a {
-  color: inherit;
-  text-decoration: none;
-}
-
-a:hover {
-  text-decoration: underline;
-}
-
-code {
-  font-family: var(--mono);
-  font-size: 0.95em;
-}
-
-.skip {
-  position: absolute;
-  left: -999px;
-  top: 10px;
-  background: var(--bg2);
-  border: 1px solid var(--stroke);
-  color: var(--text);
-  padding: 10px 12px;
-  border-radius: 10px;
-  z-index: 20;
-}
-.skip:focus {
-  left: 12px;
-}
-
-.bg {
-  position: fixed;
-  inset: 0;
-  pointer-events: none;
-  z-index: 0;
-}
-
-.bg__mesh {
-  position: absolute;
-  inset: 0;
-  background: radial-gradient(1200px 800px at 20% 20%, rgba(66, 133, 244, 0.18), transparent 60%),
-    radial-gradient(1000px 800px at 82% 30%, rgba(234, 67, 53, 0.12), transparent 55%),
-    radial-gradient(1000px 900px at 40% 85%, rgba(52, 168, 83, 0.12), transparent 55%);
-  filter: blur(4px) saturate(1.12);
-  opacity: 0.95;
-}
-
-.bg__grid {
-  position: absolute;
-  inset: -2px;
-  background-image: linear-gradient(rgba(255, 255, 255, 0.04) 1px, transparent 1px),
-    linear-gradient(90deg, rgba(255, 255, 255, 0.04) 1px, transparent 1px);
-  background-size: 72px 72px;
-  opacity: 0.055;
-  transform: perspective(900px) rotateX(58deg) translateY(-18%);
-  transform-origin: top;
-  mask-image: radial-gradient(60% 60% at 50% 30%, rgba(0, 0, 0, 1), transparent 72%);
-}
-
-.bg__grain {
-  position: absolute;
-  inset: 0;
-  opacity: 0.2;
-  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='240' height='240'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='.8' numOctaves='3' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='240' height='240' filter='url(%23n)' opacity='.45'/%3E%3C/svg%3E");
-  mix-blend-mode: overlay;
-}
-
-.wrap {
-  width: min(1100px, calc(100% - 48px));
-  margin: 0 auto;
-  position: relative;
-  z-index: 1;
-}
-
-.top {
-  position: sticky;
-  top: 0;
-  z-index: 10;
-  backdrop-filter: blur(12px);
-  -webkit-backdrop-filter: blur(12px);
-  background: rgba(7, 7, 11, 0.58);
-  border-bottom: 1px solid rgba(255, 255, 255, 0.06);
-}
-
-.top__row {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  padding: 14px 0;
-}
-
-.brand {
-  display: flex;
-  align-items: center;
-  gap: 10px;
-  text-decoration: none !important;
-}
-
-.brand__mark {
-  width: 26px;
-  height: 26px;
-  border-radius: 10px;
-  background: conic-gradient(from 200deg, var(--b), var(--g), var(--y), var(--r), var(--b));
-  box-shadow: 0 10px 24px rgba(66, 133, 244, 0.15), 0 10px 24px rgba(52, 168, 83, 0.12);
-}
-
-.brand__mark--small {
-  width: 18px;
-  height: 18px;
-  border-radius: 7px;
-}
-
-.brand__name {
-  font-family: var(--mono);
-  font-weight: 500;
-  letter-spacing: -0.02em;
-}
-
-.brand__tag {
-  font-size: 12px;
-  color: var(--dim);
-  border: 1px solid var(--stroke2);
-  background: rgba(17, 17, 26, 0.55);
-  padding: 3px 8px;
-  border-radius: 999px;
-}
-
-.nav {
-  display: flex;
-  align-items: center;
-  gap: 18px;
-  font-size: 14px;
-  color: var(--muted);
-}
-
-.nav a {
-  text-decoration: none;
-}
-
-.nav a:hover {
-  color: var(--text);
-  text-decoration: none;
-}
-
-.nav__cta {
-  color: var(--text) !important;
-  background: rgba(255, 255, 255, 0.06);
-  border: 1px solid rgba(255, 255, 255, 0.08);
-  padding: 8px 12px;
-  border-radius: 999px;
-}
-
-.main {
-  padding-bottom: 70px;
-}
-
-.hero {
-  padding: 56px 0 26px;
-}
-
-.hero__grid {
-  display: grid;
-  grid-template-columns: 1.05fr 0.95fr;
-  gap: 28px;
-  align-items: start;
-}
-
-.kicker {
-  display: inline-flex;
-  gap: 10px;
-  align-items: center;
-  font-size: 12px;
-  letter-spacing: 0.12em;
-  text-transform: uppercase;
-  color: rgba(243, 244, 246, 0.58);
-  margin: 0 0 14px;
-}
-
-.kicker::before {
-  content: "";
-  width: 10px;
-  height: 10px;
-  border-radius: 3px;
-  background: linear-gradient(135deg, rgba(66, 133, 244, 0.9), rgba(52, 168, 83, 0.85));
-  box-shadow: 0 0 0 4px rgba(66, 133, 244, 0.08);
-}
-
-h1 {
-  font-family: var(--serif);
-  font-weight: 700;
-  letter-spacing: -0.03em;
-  line-height: 0.95;
-  margin: 0 0 14px;
-  font-size: clamp(44px, 5.5vw, 68px);
-}
-
-.hero__word {
-  display: block;
-  opacity: 0;
-  transform: translateY(10px);
-  animation: rise 700ms cubic-bezier(0.2, 1, 0.2, 1) forwards;
-}
-
-.hero__word:nth-child(1) {
-  animation-delay: 80ms;
-}
-.hero__word:nth-child(2) {
-  animation-delay: 160ms;
-}
-.hero__word:nth-child(3) {
-  animation-delay: 260ms;
-}
-
-.hero__word--mono {
-  font-family: var(--mono);
-  font-weight: 500;
-  letter-spacing: -0.04em;
-  color: rgba(243, 244, 246, 0.92);
-}
-
-@keyframes rise {
-  to {
-    opacity: 1;
-    transform: translateY(0);
-  }
-}
-
-.lede {
-  margin: 0 0 18px;
-  font-size: 16.5px;
-  color: var(--muted);
-  max-width: 52ch;
-  opacity: 0;
-  transform: translateY(10px);
-  animation: rise 700ms cubic-bezier(0.2, 1, 0.2, 1) 320ms forwards;
-}
-
-.lede strong {
-  color: var(--text);
-  font-weight: 600;
-}
-
-.pills {
-  display: flex;
-  flex-wrap: wrap;
-  gap: 8px;
-  margin: 0 0 20px;
-  opacity: 0;
-  transform: translateY(10px);
-  animation: rise 700ms cubic-bezier(0.2, 1, 0.2, 1) 380ms forwards;
-}
-
-.pill {
-  font-size: 12px;
-  border-radius: 999px;
-  padding: 6px 10px;
-  border: 1px solid var(--stroke2);
-  background: rgba(17, 17, 26, 0.55);
-  color: rgba(243, 244, 246, 0.76);
-}
-
-.pill--b {
-  box-shadow: inset 0 0 0 1px rgba(66, 133, 244, 0.25);
-}
-.pill--r {
-  box-shadow: inset 0 0 0 1px rgba(234, 67, 53, 0.22);
-}
-.pill--y {
-  box-shadow: inset 0 0 0 1px rgba(251, 188, 5, 0.22);
-}
-.pill--g {
-  box-shadow: inset 0 0 0 1px rgba(52, 168, 83, 0.22);
-}
-
-.hero__actions {
-  display: flex;
-  gap: 12px;
-  margin: 0 0 12px;
-  opacity: 0;
-  transform: translateY(10px);
-  animation: rise 700ms cubic-bezier(0.2, 1, 0.2, 1) 440ms forwards;
-}
-
-.btn {
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-  gap: 10px;
-  padding: 10px 14px;
-  border-radius: 999px;
-  border: 1px solid rgba(255, 255, 255, 0.08);
-  text-decoration: none !important;
-  font-weight: 600;
-  font-size: 14px;
-  box-shadow: 0 10px 24px rgba(0, 0, 0, 0.22);
-}
-
-.btn--primary {
-  background: linear-gradient(135deg, rgba(66, 133, 244, 0.92), rgba(52, 168, 83, 0.86));
-  color: #091018;
-  border-color: rgba(255, 255, 255, 0.12);
-  box-shadow: 0 18px 44px rgba(66, 133, 244, 0.18), 0 18px 44px rgba(52, 168, 83, 0.14);
-}
-
-.btn--ghost {
-  background: rgba(255, 255, 255, 0.06);
-  color: var(--text);
-}
-
-.btn:hover {
-  transform: translateY(-1px);
-}
-
-.note {
-  margin: 0;
-  color: rgba(243, 244, 246, 0.56);
-  font-size: 13px;
-  opacity: 0;
-  transform: translateY(10px);
-  animation: rise 700ms cubic-bezier(0.2, 1, 0.2, 1) 520ms forwards;
-}
-
-.note code {
-  background: rgba(255, 255, 255, 0.06);
-  border: 1px solid rgba(255, 255, 255, 0.07);
-  padding: 2px 6px;
-  border-radius: 8px;
-  color: rgba(243, 244, 246, 0.84);
-}
-
-.hero__panel {
-  display: grid;
-  gap: 14px;
-  opacity: 0;
-  transform: translateY(10px);
-  animation: rise 700ms cubic-bezier(0.2, 1, 0.2, 1) 260ms forwards;
-}
-
-.card {
-  border: 1px solid var(--stroke);
-  background: var(--card);
-  border-radius: var(--radius2);
-  box-shadow: var(--shadow);
-  overflow: hidden;
-}
-
-.term__bar {
-  display: flex;
-  align-items: center;
-  gap: 12px;
-  padding: 12px 14px;
-  background: rgba(12, 12, 18, 0.58);
-  border-bottom: 1px solid rgba(255, 255, 255, 0.06);
-}
-
-.dots {
-  display: inline-flex;
-  gap: 6px;
-}
-
-.dot {
-  width: 11px;
-  height: 11px;
-  border-radius: 999px;
-}
-
-.dot--r {
-  background: #ff5f57;
-}
-.dot--y {
-  background: #febc2e;
-}
-.dot--g {
-  background: #28c840;
-}
-
-.term__title {
-  margin-left: auto;
-  margin-right: auto;
-  font-family: var(--mono);
-  font-size: 12px;
-  color: rgba(243, 244, 246, 0.55);
-}
-
-.term__body {
-  padding: 14px 14px 16px;
-  background: rgba(11, 11, 17, 0.6);
-}
-
-.term__pre {
-  margin: 0;
-  font-family: var(--mono);
-  font-size: 12.5px;
-  color: rgba(243, 244, 246, 0.86);
-  line-height: 1.6;
-  white-space: pre-wrap;
-}
-
-.term__pre code {
-  display: block;
-}
-
-.meta {
-  padding: 14px 14px;
-  background: var(--card2);
-  border: 1px solid rgba(255, 255, 255, 0.06);
-  box-shadow: var(--shadow2);
-}
-
-.meta__item {
-  display: grid;
-  grid-template-columns: 90px 1fr;
-  gap: 12px;
-  padding: 10px 0;
-}
-
-.meta__item + .meta__item {
-  border-top: 1px solid rgba(255, 255, 255, 0.06);
-}
-
-.meta__k {
-  color: rgba(243, 244, 246, 0.55);
-  font-size: 12px;
-  letter-spacing: 0.06em;
-  text-transform: uppercase;
-}
-
-.meta__v {
-  color: rgba(243, 244, 246, 0.86);
-  font-size: 13px;
-}
-
-.meta__v code {
-  background: rgba(255, 255, 255, 0.06);
-  border: 1px solid rgba(255, 255, 255, 0.07);
-  padding: 2px 6px;
-  border-radius: 8px;
-  color: rgba(243, 244, 246, 0.9);
-}

docs/assets/site.js

@@ -1,34 +0,0 @@
-(() => {
-  const el = document.getElementById("demo");
-  if (!el) return;
-
-  const original = el.textContent || "";
-  const prefersReduced = window.matchMedia?.("(prefers-reduced-motion: reduce)")?.matches;
-  if (prefersReduced) return;
-
-  el.textContent = "";
-
-  const lines = original.split("\n");
-  const chunkDelay = 16;
-  const lineDelay = 140;
-  let i = 0;
-  let j = 0;
-
-  const tick = () => {
-    if (i >= lines.length) return;
-    const line = lines[i];
-    if (j <= line.length) {
-      el.textContent += line.slice(j, j + 1);
-      j += 1;
-      window.setTimeout(tick, chunkDelay);
-      return;
-    }
-    el.textContent += "\n";
-    i += 1;
-    j = 0;
-    window.setTimeout(tick, lineDelay);
-  };
-
-  window.setTimeout(tick, 260);
-})();
-

docs/assets/site.more.css

@@ -1,239 +0,0 @@
-.section {
-  padding: 52px 0;
-}
-
-.section__grid {
-  display: grid;
-  grid-template-columns: 0.36fr 0.64fr;
-  gap: 28px;
-  align-items: start;
-}
-
-h2 {
-  font-family: var(--serif);
-  font-weight: 700;
-  letter-spacing: -0.02em;
-  margin: 0 0 6px;
-  font-size: 28px;
-}
-
-h3 {
-  margin: 0 0 8px;
-  font-size: 16px;
-  font-weight: 700;
-}
-
-.muted {
-  margin: 0;
-  color: var(--muted);
-}
-
-.cols {
-  display: grid;
-  grid-template-columns: 1fr 1fr;
-  gap: 14px;
-}
-
-.block {
-  padding: 16px 16px;
-}
-
-.code {
-  margin: 0;
-  padding: 12px 12px;
-  border-radius: 14px;
-  background: rgba(0, 0, 0, 0.22);
-  border: 1px solid rgba(255, 255, 255, 0.08);
-  overflow: auto;
-}
-
-.code code {
-  font-family: var(--mono);
-  font-size: 12.5px;
-  color: rgba(243, 244, 246, 0.88);
-}
-
-.steps {
-  display: grid;
-  gap: 14px;
-}
-
-.step {
-  display: grid;
-  grid-template-columns: 46px 1fr;
-  gap: 14px;
-  padding: 16px;
-  border-radius: var(--radius2);
-  border: 1px solid rgba(255, 255, 255, 0.08);
-  background: rgba(12, 12, 18, 0.46);
-  box-shadow: var(--shadow2);
-}
-
-.step__n {
-  width: 40px;
-  height: 40px;
-  border-radius: 14px;
-  display: grid;
-  place-items: center;
-  font-family: var(--mono);
-  font-weight: 500;
-  color: rgba(243, 244, 246, 0.92);
-  background: linear-gradient(135deg, rgba(66, 133, 244, 0.22), rgba(52, 168, 83, 0.18));
-  border: 1px solid rgba(255, 255, 255, 0.08);
-}
-
-.step p {
-  margin: 0 0 10px;
-  color: var(--muted);
-}
-
-.callout {
-  margin-top: 14px;
-  display: grid;
-  grid-template-columns: 44px 1fr;
-  gap: 14px;
-  padding: 16px;
-  border-radius: var(--radius2);
-  border: 1px solid rgba(255, 255, 255, 0.08);
-  background: linear-gradient(135deg, rgba(66, 133, 244, 0.14), rgba(234, 67, 53, 0.08));
-  box-shadow: var(--shadow2);
-}
-
-.callout__icon {
-  width: 44px;
-  height: 44px;
-  border-radius: 16px;
-  background: rgba(0, 0, 0, 0.18);
-  border: 1px solid rgba(255, 255, 255, 0.1);
-  box-shadow: inset 0 0 0 1px rgba(66, 133, 244, 0.18);
-}
-
-.callout__body p {
-  margin: 0 0 10px;
-  color: var(--muted);
-}
-
-.callout__body code {
-  background: rgba(255, 255, 255, 0.06);
-  border: 1px solid rgba(255, 255, 255, 0.07);
-  padding: 2px 6px;
-  border-radius: 8px;
-  color: rgba(243, 244, 246, 0.92);
-}
-
-.grid {
-  display: grid;
-  grid-template-columns: repeat(3, 1fr);
-  gap: 14px;
-}
-
-.feat {
-  padding: 16px;
-  background: rgba(12, 12, 18, 0.46);
-  box-shadow: var(--shadow2);
-}
-
-.feat p {
-  margin: 0;
-  color: var(--muted);
-}
-
-.footerline {
-  display: flex;
-  gap: 12px;
-  margin-top: 18px;
-}
-
-.sitefoot {
-  padding: 36px 0 26px;
-  border-top: 1px solid rgba(255, 255, 255, 0.08);
-  background: rgba(7, 7, 11, 0.35);
-  backdrop-filter: blur(10px);
-  -webkit-backdrop-filter: blur(10px);
-}
-
-.sitefoot__row {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: 14px;
-}
-
-.sitefoot__brand {
-  display: inline-flex;
-  align-items: center;
-  gap: 10px;
-  font-family: var(--mono);
-}
-
-.sitefoot__small {
-  margin-top: 8px;
-  color: rgba(243, 244, 246, 0.6);
-  font-size: 13px;
-}
-
-.sitefoot__small a {
-  color: rgba(243, 244, 246, 0.75);
-}
-
-.sep {
-  margin: 0 8px;
-  color: rgba(243, 244, 246, 0.28);
-}
-
-.sitefoot__right {
-  display: flex;
-  gap: 14px;
-  color: rgba(243, 244, 246, 0.7);
-  font-size: 14px;
-}
-
-.sitefoot__fineprint {
-  margin-top: 18px;
-  color: rgba(243, 244, 246, 0.46);
-  font-size: 12px;
-}
-
-@media (max-width: 980px) {
-  .hero__grid {
-    grid-template-columns: 1fr;
-  }
-  .section__grid {
-    grid-template-columns: 1fr;
-  }
-  .grid {
-    grid-template-columns: 1fr 1fr;
-  }
-}
-
-@media (max-width: 640px) {
-  .wrap {
-    width: min(1100px, calc(100% - 28px));
-  }
-  .nav {
-    display: none;
-  }
-  .cols {
-    grid-template-columns: 1fr;
-  }
-  .grid {
-    grid-template-columns: 1fr;
-  }
-  .footerline {
-    flex-direction: column;
-    align-items: flex-start;
-  }
-  .sitefoot__row {
-    flex-direction: column;
-    align-items: flex-start;
-  }
-}
-
-@media (prefers-reduced-motion: reduce) {
-  * {
-    animation: none !important;
-    transition: none !important;
-    scroll-behavior: auto !important;
-  }
-}
-

docs/backup.md

@@ -295,8 +295,12 @@ single ordered background queue: `gog` records the exact commit SHA, continues
 cached Gmail fetching, and pushes queued SHAs to the current branch one at a
 time. Transient push failures are retried; GitHub hard rejections stop later
 checkpoints because descendants would inherit the rejected object. The final
-completed backup waits for the queue to drain before writing and pushing the
+completed backup waits for the queue to drain, then promotes the completed
-root manifest. Tune the commit cadence with `--gmail-checkpoint-rows` /
+checkpoint message shards into the root manifest instead of re-encrypting the
+same mailbox into a second multi-GB final push. If no complete matching
+checkpoint exists, final Gmail message shards still split by row count and the
+same conservative plaintext byte ceiling. Tune the commit cadence with
+`--gmail-checkpoint-rows` /
 `--gmail-checkpoint-interval` on `gog backup push`, or `--checkpoint-rows` /
 `--checkpoint-interval` on `gog backup gmail push`; set the interval or rows to
 `0` to disable that trigger, or use `--no-gmail-checkpoints` /

docs/commands.generated.md

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

@@ -0,0 +1,43 @@
+# `gog calendar raw`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Dump raw Google Calendar API response as JSON (Events.Get; lossless; for scripting and LLM consumption)
+
+## Usage
+
+```bash
+gog calendar (cal) raw <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) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--pretty` | `bool` |  | Pretty-print JSON (default: compact single-line) |
+| `--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)