gog

Use gog for Gmail/Calendar/Drive/Contacts/Sheets/Docs. Requires OAuth setup.

Seeded setup

• The deployment harness invokes scripts/setup.sh after install and on credential rotation.
• Setup imports OAuth client credentials from MAVERICK_GOG_CREDENTIALS_JSON_B64.
• Setup imports the refresh-token payload from MAVERICK_GOG_TOKEN_IMPORT_JSON_B64.
• Use GOG_KEYRING_BACKEND=file with GOG_KEYRING_PASSWORD for headless runtimes.
• After setup, normal gog commands refresh short-lived Google access tokens on demand from the stored refresh token.
• Setup writes the supplied credential state unconditionally. Only rerun it with the freshest token payload.

Setup (once)

• gog auth credentials /path/to/client_secret.json
• gog auth add [email protected] --services gmail,calendar,drive,contacts,sheets,docs
• gog auth list

Common commands

• Gmail search: gog gmail search 'newer_than:7d' --max 10
• Gmail send: gog gmail send --to [email protected] --subject "Hi" --body "Hello"
• Calendar: gog calendar events \x3CcalendarId> --from \x3Ciso> --to \x3Ciso>
• Drive search: gog drive search "query" --max 10
• Contacts: gog contacts list --max 20
• Sheets get: gog sheets get \x3CsheetId> "Tab!A1:D10" --json
• Sheets update: gog sheets update \x3CsheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED
• Sheets append: gog sheets append \x3CsheetId> "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS
• Sheets clear: gog sheets clear \x3CsheetId> "Tab!A2:Z"
• Sheets metadata: gog sheets metadata \x3CsheetId> --json
• Docs export: gog docs export \x3CdocId> --format txt --out /tmp/doc.txt
• Docs cat: gog docs cat \x3CdocId>

Notes

• Set [email protected] to avoid repeating --account.
• For scripting, prefer --json plus --no-input.
• Sheets values can be passed via --values-json (recommended) or as inline rows.
• Docs supports export/cat/copy. In-place edits require a Docs API client (not in gog).
• Confirm before sending mail or creating events.