diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml new file mode 100644 index 0000000..97ce8d1 --- /dev/null +++ b/.github/workflows/pages.yml @@ -0,0 +1,60 @@ +name: pages + +on: + push: + branches: + - main + paths: + - "docs/**" + - "scripts/gen-command-reference.sh" + - "scripts/build-docs-site.mjs" + - "Makefile" + - ".github/workflows/pages.yml" + workflow_dispatch: + +permissions: + contents: read + pages: write + id-token: write + +concurrency: + group: pages + cancel-in-progress: false + +jobs: + deploy: + name: Deploy docs + runs-on: ubuntu-latest + timeout-minutes: 10 + environment: + name: github-pages + url: ${{ steps.deployment.outputs.page_url }} + steps: + - name: Check out + uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2 + + - name: Set up Go + uses: actions/setup-go@4a3601121dd01d1626a1e23e37211e3254c1c06c # v6.4.0 + with: + go-version-file: go.mod + cache: true + + - name: Set up Node + uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0 + with: + node-version: "24" + + - name: Build docs site + run: make docs-site + + - name: Configure Pages + uses: actions/configure-pages@45bfe0192ca1faeb007ade9deae92b16b8254a0d # v6.0.0 + + - name: Upload artifact + uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5.0.0 + with: + path: dist/docs-site + + - name: Deploy + id: deployment + uses: actions/deploy-pages@cd2ce8fcbc39b97be8ca5fce6e763baed58fa128 # v5.0.0 diff --git a/.gitignore b/.gitignore index f2157e2..a64ce7a 100644 --- a/.gitignore +++ b/.gitignore @@ -41,3 +41,4 @@ internal/cmd/safety_profile_baked_gen.go # Node (optional dev scripts) node_modules/ +dist/ diff --git a/Makefile b/Makefile index 233aa48..42ef803 100644 --- a/Makefile +++ b/Makefile @@ -3,7 +3,7 @@ SHELL := /bin/bash # `make` should build the binary by default. .DEFAULT_GOAL := build -.PHONY: build build-safe gog gogcli gog-help gogcli-help help fmt fmt-check lint test ci tools docs-commands +.PHONY: build build-safe gog gogcli gog-help gogcli-help help fmt fmt-check lint test ci tools docs-commands docs-site docs-check .PHONY: worker-ci BIN_DIR := $(CURDIR)/bin @@ -70,6 +70,11 @@ help: gog-help docs-commands: build @scripts/gen-command-reference.sh docs/commands.generated.md +docs-site: docs-commands + @node scripts/build-docs-site.mjs + +docs-check: docs-site + tools: @mkdir -p $(TOOLS_DIR) @if [ -x "$(GOFUMPT)" ] && [ -x "$(GOIMPORTS)" ] && [ -x "$(GOLANGCI_LINT)" ] && [ "$$(cat $(TOOLS_STAMP) 2>/dev/null)" = "$(TOOLS_VERSION)" ]; then \ diff --git a/README.md b/README.md index 6777c64..7e67643 100644 --- a/README.md +++ b/README.md @@ -1960,12 +1960,25 @@ Pinned tools (installed into `.tools/`): CI runs format checks, tests, and lint on push/PR. -Regenerate the expanded command reference from the live schema when CLI surface changes: +Documentation is split between hand-written topic pages in `docs/` and generated +per-command pages in `docs/commands/`. Every CLI command should have a docs page; +do not hand-edit generated command pages. Regenerate them from the live schema +whenever command names, flags, aliases, arguments, or help text change: ```bash make docs-commands ``` +Build the GitHub Pages site locally: + +```bash +make docs-site +open dist/docs-site/index.html +``` + +The Pages workflow rebuilds the command pages and publishes the static site from +`dist/docs-site` using the custom domain in `docs/CNAME`. + ### Integration Tests (Live Google APIs) Opt-in tests that hit real Google APIs using your stored `gog` credentials/tokens. diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 0000000..4f9185a --- /dev/null +++ b/docs/README.md @@ -0,0 +1,46 @@ +# gog Docs + +`gog` is a single CLI for Google Workspace automation: Gmail, Calendar, Drive, +Docs, Sheets, Slides, Contacts, Tasks, People, Forms, Apps Script, Groups, Admin, +Keep, and related agent workflows. + +## Start Here + +- Install and authenticate from the repository + [README](https://github.com/steipete/gogcli#readme). +- Read [Auth Clients](auth-clients.md) when setting up OAuth clients, service + accounts, or Workspace domain-wide delegation. +- Read [Command Guards and Baked Safety Profiles](safety-profiles.md) when + running `gog` from agents or automation. +- Open the [Command Index](commands/README.md) for generated docs for every CLI + command. + +## Common Paths + +```bash +gog auth add you@gmail.com --services gmail,calendar,drive +gog gmail search 'newer_than:7d' --max 10 +gog gmail get --sanitize-content --json +gog calendar events --today +gog drive ls --max 20 +``` + +## Command Docs + +Every command page under `docs/commands/` is generated from +`gog schema --json`. Do not hand-edit generated command pages. After changing +commands, flags, aliases, arguments, or help text, run: + +```bash +make docs-commands +``` + +Then build the GitHub Pages site locally: + +```bash +make docs-site +open dist/docs-site/index.html +``` + +The site is intentionally static: no framework, no package install, and no +client-side dependency beyond a small navigation script embedded by the builder. diff --git a/docs/commands.generated.md b/docs/commands.generated.md index 96822a5..244e2ad 100644 --- a/docs/commands.generated.md +++ b/docs/commands.generated.md @@ -2,443 +2,443 @@ Generated from `gog schema --json`. -- `gog [flags]` - Google CLI for Gmail/Calendar/Chat/Classroom/Drive/Contacts/Tasks/Sheets/Docs/Slides/People/Forms/App Script/Ads/Groups/Admin/Keep -- `gog admin [flags]` - Google Workspace Admin (Directory API) - requires domain-wide delegation -- `gog admin groups ` - Manage Workspace groups -- `gog admin groups list (ls) [flags]` - List groups in a domain -- `gog admin groups members ` - Manage group members -- `gog admin groups members add (invite) [flags]` - Add a member to a group -- `gog admin groups members list (ls) [flags]` - List group members -- `gog admin groups members remove (rm,del,delete) ` - Remove a member from a group -- `gog admin users ` - Manage Workspace users -- `gog admin users create (add,new) [flags]` - Create a new user -- `gog admin users get (info,show) ` - Get user details -- `gog admin users list (ls) [flags]` - List users in a domain -- `gog admin users suspend ` - Suspend a user account -- `gog agent [flags]` - Agent-friendly helpers -- `gog agent exit-codes (exitcodes,exit-code)` - Print stable exit codes for automation -- `gog appscript (script,apps-script) [flags]` - Google Apps Script -- `gog appscript (script,apps-script) content (cat) ` - Get Apps Script project content -- `gog appscript (script,apps-script) create (new) --title=STRING [flags]` - Create an Apps Script project -- `gog appscript (script,apps-script) get (info,show) ` - Get Apps Script project metadata -- `gog appscript (script,apps-script) run [flags]` - Run a deployed Apps Script function -- `gog auth [flags]` - Auth and credentials -- `gog auth add [flags]` - Authorize and store a refresh token -- `gog auth alias ` - Manage account aliases -- `gog auth alias list` - List account aliases -- `gog auth alias set ` - Set an account alias -- `gog auth alias unset ` - Remove an account alias -- `gog auth credentials ` - Manage OAuth client credentials -- `gog auth credentials list` - List stored OAuth client credentials -- `gog auth credentials remove []` - Remove stored OAuth client credentials -- `gog auth credentials set [flags]` - Store OAuth client credentials -- `gog auth doctor [flags]` - Diagnose auth, keyring, and refresh-token issues -- `gog auth keep --key=STRING ` - Configure service account for Google Keep (Workspace only) -- `gog auth keyring [ []]` - Configure keyring backend -- `gog auth list [flags]` - List stored accounts -- `gog auth manage (login) [flags]` - Open accounts manager in browser -- `gog auth remove ` - Remove a stored refresh token -- `gog auth service-account ` - Configure service account (Workspace only; domain-wide delegation) -- `gog auth service-account set --key=STRING ` - Store a service account key for impersonation -- `gog auth service-account status ` - Show stored service account key status -- `gog auth service-account unset ` - Remove stored service account key -- `gog auth services [flags]` - List supported auth services and scopes -- `gog auth status` - Show auth configuration and keyring backend -- `gog auth tokens ` - Manage stored refresh tokens -- `gog auth tokens delete ` - Delete a stored refresh token -- `gog auth tokens export [flags]` - Export a refresh token to a file (contains secrets) -- `gog auth tokens import ` - Import a refresh token file into keyring (contains secrets) -- `gog auth tokens list` - List stored tokens (by key only) -- `gog backup [flags]` - Encrypted Google account backups -- `gog backup cat [flags]` - Decrypt one backup shard to stdout -- `gog backup export [flags]` - Write a local plaintext export -- `gog backup gmail ` - Gmail backup operations -- `gog backup gmail push [flags]` - Export Gmail into encrypted backup shards -- `gog backup init [flags]` - Initialize encrypted backup config and repository -- `gog backup push [flags]` - Export services into encrypted backup shards -- `gog backup status [flags]` - Inspect backup manifest without decrypting shards -- `gog backup verify [flags]` - Decrypt and verify all backup shards -- `gog calendar (cal) [flags]` - Google Calendar -- `gog calendar (cal) acl (permissions,perms) [flags]` - List calendar ACL -- `gog calendar (cal) alias ` - Manage calendar aliases -- `gog calendar (cal) alias list` - List calendar aliases -- `gog calendar (cal) alias set ` - Set a calendar alias -- `gog calendar (cal) alias unset ` - Remove a calendar alias -- `gog calendar (cal) calendars [flags]` - List calendars -- `gog calendar (cal) colors` - Show calendar colors -- `gog calendar (cal) conflicts [flags]` - Find conflicts -- `gog calendar (cal) create (add,new) [flags]` - Create an event -- `gog calendar (cal) create-calendar (new-calendar) [flags]` - Create a new secondary calendar -- `gog calendar (cal) delete (rm,del,remove) [flags]` - Delete an event -- `gog calendar (cal) event (get,info,show) ` - Get event -- `gog calendar (cal) events (list,ls) [ ...] [flags]` - List events from a calendar or all calendars -- `gog calendar (cal) focus-time (focus) --from=STRING --to=STRING [] [flags]` - Create a Focus Time block -- `gog calendar (cal) freebusy [] [flags]` - Get free/busy -- `gog calendar (cal) move (transfer) [flags]` - Move an event to another calendar -- `gog calendar (cal) out-of-office (ooo) --from=STRING --to=STRING [] [flags]` - Create an Out of Office event -- `gog calendar (cal) propose-time [flags]` - Generate URL to propose a new meeting time (browser-only feature) -- `gog calendar (cal) respond (rsvp,reply) [flags]` - Respond to an event invitation -- `gog calendar (cal) search (find,query) [flags]` - Search events -- `gog calendar (cal) subscribe (sub,add-calendar) [flags]` - Add a calendar to your calendar list -- `gog calendar (cal) team [flags]` - Show events for all members of a Google Group -- `gog calendar (cal) time [flags]` - Show server time -- `gog calendar (cal) update (edit,set) [flags]` - Update an event -- `gog calendar (cal) users [flags]` - List workspace users (use their email as calendar ID) -- `gog calendar (cal) working-location (wl) --from=STRING --to=STRING --type=STRING [] [flags]` - Set working location (home/office/custom) -- `gog chat [flags]` - Google Chat -- `gog chat dm ` - Direct messages -- `gog chat dm send (create,post) [flags]` - Send a direct message -- `gog chat dm space (find,setup) ` - Find or create a DM space -- `gog chat messages ` - Chat messages -- `gog chat messages list (ls) [flags]` - List messages -- `gog chat messages react [flags]` - Add an emoji reaction to a message -- `gog chat messages reactions (reaction) ` - Manage emoji reactions on a message -- `gog chat messages reactions (reaction) create (add) [flags]` - Add an emoji reaction to a message -- `gog chat messages reactions (reaction) delete (remove,rm) ` - Delete a reaction -- `gog chat messages reactions (reaction) list (ls) [flags]` - List reactions on a message -- `gog chat messages send (create,post) [flags]` - Send a message -- `gog chat spaces ` - Chat spaces -- `gog chat spaces create (add,new) [flags]` - Create a space -- `gog chat spaces find (search,query) [flags]` - Find spaces by display name -- `gog chat spaces list (ls) [flags]` - List spaces -- `gog chat threads ` - Chat threads -- `gog chat threads list [flags]` - List threads in a space -- `gog classroom (class) [flags]` - Google Classroom -- `gog classroom (class) announcements (announcement,ann) ` - Announcements -- `gog classroom (class) announcements (announcement,ann) assignees (assign) [flags]` - Modify announcement assignees -- `gog classroom (class) announcements (announcement,ann) create (add,new) --text=STRING [flags]` - Create an announcement -- `gog classroom (class) announcements (announcement,ann) delete (rm,del,remove) ` - Delete an announcement -- `gog classroom (class) announcements (announcement,ann) get (info,show) ` - Get an announcement -- `gog classroom (class) announcements (announcement,ann) list (ls) [flags]` - List announcements -- `gog classroom (class) announcements (announcement,ann) update (edit,set) [flags]` - Update an announcement -- `gog classroom (class) courses (course) ` - Courses -- `gog classroom (class) courses (course) archive (arch) ` - Archive a course -- `gog classroom (class) courses (course) create (add,new) --name=STRING [flags]` - Create a course -- `gog classroom (class) courses (course) delete (rm,del,remove) ` - Delete a course -- `gog classroom (class) courses (course) get (info,show) ` - Get a course -- `gog classroom (class) courses (course) join (enroll) [flags]` - Join a course -- `gog classroom (class) courses (course) leave (unenroll) [flags]` - Leave a course -- `gog classroom (class) courses (course) list (ls) [flags]` - List courses -- `gog classroom (class) courses (course) unarchive (unarch,restore) ` - Unarchive a course -- `gog classroom (class) courses (course) update (edit,set) [flags]` - Update a course -- `gog classroom (class) courses (course) url (link) ...` - Print Classroom web URLs for courses -- `gog classroom (class) coursework (work) ` - Coursework -- `gog classroom (class) coursework (work) assignees (assign) [flags]` - Modify coursework assignees -- `gog classroom (class) coursework (work) create (add,new) --title=STRING [flags]` - Create coursework -- `gog classroom (class) coursework (work) delete (rm,del,remove) ` - Delete coursework -- `gog classroom (class) coursework (work) get (info,show) ` - Get coursework -- `gog classroom (class) coursework (work) list (ls) [flags]` - List coursework -- `gog classroom (class) coursework (work) update (edit,set) [flags]` - Update coursework -- `gog classroom (class) guardian-invitations (guardian-invites) ` - Guardian invitations -- `gog classroom (class) guardian-invitations (guardian-invites) create (add,new) --email=STRING ` - Create a guardian invitation -- `gog classroom (class) guardian-invitations (guardian-invites) get (info,show) ` - Get a guardian invitation -- `gog classroom (class) guardian-invitations (guardian-invites) list (ls) [flags]` - List guardian invitations -- `gog classroom (class) guardians (guardian) ` - Guardians -- `gog classroom (class) guardians (guardian) delete (rm,del,remove) ` - Delete a guardian -- `gog classroom (class) guardians (guardian) get (info,show) ` - Get a guardian -- `gog classroom (class) guardians (guardian) list (ls) [flags]` - List guardians -- `gog classroom (class) invitations (invitation,invites) ` - Invitations -- `gog classroom (class) invitations (invitation,invites) accept (join) ` - Accept an invitation -- `gog classroom (class) invitations (invitation,invites) create (add,new) --role=STRING ` - Create an invitation -- `gog classroom (class) invitations (invitation,invites) delete (rm,del,remove) ` - Delete an invitation -- `gog classroom (class) invitations (invitation,invites) get (info,show) ` - Get an invitation -- `gog classroom (class) invitations (invitation,invites) list (ls) [flags]` - List invitations -- `gog classroom (class) materials (material) ` - Coursework materials -- `gog classroom (class) materials (material) create (add,new) --title=STRING [flags]` - Create coursework material -- `gog classroom (class) materials (material) delete (rm,del,remove) ` - Delete coursework material -- `gog classroom (class) materials (material) get (info,show) ` - Get coursework material -- `gog classroom (class) materials (material) list (ls) [flags]` - List coursework materials -- `gog classroom (class) materials (material) update (edit,set) [flags]` - Update coursework material -- `gog classroom (class) profile (me) ` - User profiles -- `gog classroom (class) profile (me) get []` - Get a user profile -- `gog classroom (class) roster (members) [flags]` - Course roster (students + teachers) -- `gog classroom (class) students (student) ` - Course students -- `gog classroom (class) students (student) add (create,new) [flags]` - Add a student -- `gog classroom (class) students (student) get (info,show) ` - Get a student -- `gog classroom (class) students (student) list (ls) [flags]` - List students -- `gog classroom (class) students (student) remove (delete,rm,del,remove) ` - Remove a student -- `gog classroom (class) submissions (submission) ` - Student submissions -- `gog classroom (class) submissions (submission) get (info,show) ` - Get a student submission -- `gog classroom (class) submissions (submission) grade (set,edit) [flags]` - Set draft/assigned grades -- `gog classroom (class) submissions (submission) list (ls) [flags]` - List student submissions -- `gog classroom (class) submissions (submission) reclaim (undo) ` - Reclaim a submission -- `gog classroom (class) submissions (submission) return (send) ` - Return a submission -- `gog classroom (class) submissions (submission) turn-in (turnin) ` - Turn in a submission -- `gog classroom (class) teachers (teacher) ` - Course teachers -- `gog classroom (class) teachers (teacher) add (create,new) ` - Add a teacher -- `gog classroom (class) teachers (teacher) get (info,show) ` - Get a teacher -- `gog classroom (class) teachers (teacher) list (ls) [flags]` - List teachers -- `gog classroom (class) teachers (teacher) remove (delete,rm,del,remove) ` - Remove a teacher -- `gog classroom (class) topics (topic) ` - Topics -- `gog classroom (class) topics (topic) create (add,new) --name=STRING ` - Create a topic -- `gog classroom (class) topics (topic) delete (rm,del,remove) ` - Delete a topic -- `gog classroom (class) topics (topic) get (info,show) ` - Get a topic -- `gog classroom (class) topics (topic) list (ls) [flags]` - List topics -- `gog classroom (class) topics (topic) update (edit,set) --name=STRING ` - Update a topic -- `gog completion [flags]` - Generate shell completion scripts -- `gog config [flags]` - Manage configuration -- `gog config get (show) ` - Get a config value -- `gog config keys (list-keys,names)` - List available config keys -- `gog config list (ls,all)` - List all config values -- `gog config no-send (nosend) ` - Manage per-account Gmail no-send guards -- `gog config no-send (nosend) list (ls)` - List accounts with no-send guards -- `gog config no-send (nosend) remove (rm,del,delete,unset,disable) ` - Remove an account no-send guard -- `gog config no-send (nosend) set (add,enable) ` - Block Gmail send operations for an account -- `gog config path (where)` - Print config file path -- `gog config set (add,update) ` - Set a config value -- `gog config unset (rm,del,remove) ` - Unset a config value -- `gog contacts (contact) [flags]` - Google Contacts -- `gog contacts (contact) create (add,new) [flags]` - Create a contact -- `gog contacts (contact) delete (rm,del,remove) ` - Delete a contact -- `gog contacts (contact) directory ` - Directory contacts -- `gog contacts (contact) directory list [flags]` - List people from the Workspace directory -- `gog contacts (contact) directory search ... [flags]` - Search people in the Workspace directory -- `gog contacts (contact) export [] [flags]` - Export contacts as vCard (.vcf) -- `gog contacts (contact) get (info,show) ` - Get a contact -- `gog contacts (contact) list (ls) [flags]` - List contacts -- `gog contacts (contact) other ` - Other contacts -- `gog contacts (contact) other delete ` - Delete an other contact -- `gog contacts (contact) other list [flags]` - List other contacts -- `gog contacts (contact) other search ... [flags]` - Search other contacts -- `gog contacts (contact) search ... [flags]` - Search contacts by name/email/phone -- `gog contacts (contact) update (edit,set) [flags]` - Update a contact -- `gog docs (doc) [flags]` - Google Docs (export via Drive) -- `gog docs (doc) add-tab [flags]` - Add a tab to a Google Doc -- `gog docs (doc) cat (text,read) [flags]` - Print a Google Doc as plain text -- `gog docs (doc) clear ` - Clear all content from a Google Doc -- `gog docs (doc) comments ` - Manage comments on files -- `gog docs (doc) comments add (create,new) [flags]` - Add a comment to a Google Doc -- `gog docs (doc) comments delete (rm,del,remove) ` - Delete a comment -- `gog docs (doc) comments get (info,show) ` - Get a comment by ID -- `gog docs (doc) comments list (ls) [flags]` - List comments on a Google Doc -- `gog docs (doc) comments reply (respond) ` - Reply to a comment -- `gog docs (doc) comments resolve [flags]` - Resolve a comment (mark as done) -- `gog docs (doc) copy (cp,duplicate) [flags]` - Copy a Google Doc -- `gog docs (doc) create (add,new) <title> [flags]` - Create a Google Doc -- `gog docs (doc) delete --start=INT-64 --end=INT-64 <docId> [flags]` - Delete text range from document -- `gog docs (doc) delete-tab <docId> [flags]` - Delete a tab from a Google Doc -- `gog docs (doc) edit <docId> <find> <replace> [flags]` - Find and replace text in a Google Doc -- `gog docs (doc) export (download,dl) <docId> [flags]` - Export a Google Doc (pdf|docx|txt|md|html) -- `gog docs (doc) find-replace <docId> <find> [<replace>] [flags]` - Find and replace text. Supports plain text or markdown with images; use --first for a single occurrence. -- `gog docs (doc) info (get,show) <docId>` - Get Google Doc metadata -- `gog docs (doc) insert <docId> [<content>] [flags]` - Insert text at a specific position -- `gog docs (doc) list-tabs <docId>` - List all tabs in a Google Doc -- `gog docs (doc) rename-tab <docId> [flags]` - Rename a tab in a Google Doc -- `gog docs (doc) sed <docId> [<expression>] [flags]` - Regex find/replace (sed-style: s/pattern/replacement/g) -- `gog docs (doc) structure (struct) <docId> [flags]` - Show document structure with numbered paragraphs -- `gog docs (doc) update <docId> [flags]` - Insert text at a specific index in a Google Doc -- `gog docs (doc) write <docId> [flags]` - Write content to a Google Doc -- `gog download (dl) <fileId> [flags]` - Download a Drive file (alias for 'drive download') -- `gog drive (drv) <command> [flags]` - Google Drive -- `gog drive (drv) comments <command>` - Manage comments on files -- `gog drive (drv) comments create (add,new) <fileId> <content> [flags]` - Create a comment on a file -- `gog drive (drv) comments delete (rm,del,remove) <fileId> <commentId>` - Delete a comment -- `gog drive (drv) comments get (info,show) <fileId> <commentId>` - Get a comment by ID -- `gog drive (drv) comments list (ls) <fileId> [flags]` - List comments on a file -- `gog drive (drv) comments reply (respond) <fileId> <commentId> <content>` - Reply to a comment -- `gog drive (drv) comments update (edit,set) <fileId> <commentId> <content>` - Update a comment -- `gog drive (drv) copy <fileId> <name> [flags]` - Copy a file -- `gog drive (drv) delete (rm,del) <fileId> [flags]` - Move a file to trash (use --permanent to delete forever) -- `gog drive (drv) download <fileId> [flags]` - Download a file (exports Google Docs formats) -- `gog drive (drv) drives [flags]` - List shared drives (Team Drives) -- `gog drive (drv) get <fileId>` - Get file metadata -- `gog drive (drv) ls [flags]` - List files in a folder (default: root) -- `gog drive (drv) mkdir <name> [flags]` - Create a folder -- `gog drive (drv) move <fileId> [flags]` - Move a file to a different folder -- `gog drive (drv) permissions <fileId> [flags]` - List permissions on a file -- `gog drive (drv) rename <fileId> <newName>` - Rename a file or folder -- `gog drive (drv) search <query> ... [flags]` - Full-text search across Drive -- `gog drive (drv) share <fileId> [flags]` - Share a file or folder -- `gog drive (drv) unshare <fileId> <permissionId>` - Remove a permission from a file -- `gog drive (drv) upload <localPath> [flags]` - Upload a file -- `gog drive (drv) url <fileId> ...` - Print web URLs for files -- `gog exit-codes (exitcodes) [flags]` - Print stable exit codes (alias for 'agent exit-codes') -- `gog forms (form) <command> [flags]` - Google Forms -- `gog forms (form) add-question (add-q,aq) --title=STRING <formId> [flags]` - Add a question to a form -- `gog forms (form) create (new) --title=STRING [flags]` - Create a form -- `gog forms (form) delete-question (delete-q,dq,rm-q) <formId> <index>` - Delete a question by index -- `gog forms (form) get (info,show) <formId>` - Get a form -- `gog forms (form) move-question (move-q,mq) <formId> <oldIndex> <newIndex>` - Move a question to a new position -- `gog forms (form) responses <command>` - Form responses -- `gog forms (form) responses get (info,show) <formId> <responseId>` - Get a form response -- `gog forms (form) responses list (ls) <formId> [flags]` - List form responses -- `gog forms (form) update (edit) <formId> [flags]` - Update form title, description, or settings -- `gog forms (form) watch (watches) <command>` - Response watches (push notifications) -- `gog forms (form) watch (watches) create (new,add) --topic=STRING <formId> [flags]` - Create a watch for new responses -- `gog forms (form) watch (watches) delete (rm,remove) <formId> <watchId>` - Delete a watch -- `gog forms (form) watch (watches) list (ls) <formId>` - List active watches -- `gog forms (form) watch (watches) renew (refresh) <formId> <watchId>` - Renew a watch (extends 7 days) -- `gog gmail (mail,email) <command> [flags]` - Gmail -- `gog gmail (mail,email) archive [<messageId> ...] [flags]` - Archive messages (remove from inbox) -- `gog gmail (mail,email) attachment <messageId> <attachmentId> [flags]` - Download a single attachment -- `gog gmail (mail,email) autoreply <query> ... [flags]` - Reply once to matching messages -- `gog gmail (mail,email) batch <command>` - Batch operations (permanent delete requires broader Gmail scope; use gmail trash for normal trashing) -- `gog gmail (mail,email) batch delete (rm,del,remove) <messageId> ...` - Permanently delete multiple messages; use 'gmail trash' to move messages to trash with the default gmail.modify scope -- `gog gmail (mail,email) batch modify (update,edit,set) <messageId> ... [flags]` - Modify labels on multiple messages -- `gog gmail (mail,email) drafts (draft) <command>` - Draft operations -- `gog gmail (mail,email) drafts (draft) create (add,new) [flags]` - Create a draft -- `gog gmail (mail,email) drafts (draft) delete (rm,del,remove) <draftId>` - Delete a draft -- `gog gmail (mail,email) drafts (draft) get (info,show) <draftId> [flags]` - Get draft details -- `gog gmail (mail,email) drafts (draft) list (ls) [flags]` - List drafts -- `gog gmail (mail,email) drafts (draft) send (post) <draftId>` - Send a draft -- `gog gmail (mail,email) drafts (draft) update (edit,set) <draftId> [flags]` - Update a draft -- `gog gmail (mail,email) forward (fwd) --to=STRING <messageId> [flags]` - Forward a message to new recipients -- `gog gmail (mail,email) get (info,show) <messageId> [flags]` - Get a message (full|metadata|raw) -- `gog gmail (mail,email) history [flags]` - Gmail history -- `gog gmail (mail,email) labels (label) <command>` - Label operations -- `gog gmail (mail,email) labels (label) create (add,new) <name>` - Create a new label -- `gog gmail (mail,email) labels (label) delete (rm,del) <labelIdOrName>` - Delete a label -- `gog gmail (mail,email) labels (label) get (info,show) <labelIdOrName>` - Get label details (including counts) -- `gog gmail (mail,email) labels (label) list (ls)` - List labels -- `gog gmail (mail,email) labels (label) modify (update,edit,set) <threadId> ... [flags]` - Modify labels on threads -- `gog gmail (mail,email) labels (label) rename (mv) <labelIdOrName> <newName>` - Rename a label -- `gog gmail (mail,email) labels (label) style (color,colour) <labelIdOrName> [flags]` - Change a user label color or visibility -- `gog gmail (mail,email) mark-read (read-messages) [<messageId> ...] [flags]` - Mark messages as read -- `gog gmail (mail,email) messages (message,msg,msgs) <command>` - Message operations -- `gog gmail (mail,email) messages (message,msg,msgs) modify (update,edit,set) <messageId> [flags]` - Modify labels on a single message -- `gog gmail (mail,email) messages (message,msg,msgs) search (find,query,ls,list) <query> ... [flags]` - Search messages using Gmail query syntax -- `gog gmail (mail,email) search (find,query,ls,list) <query> ... [flags]` - Search threads using Gmail query syntax -- `gog gmail (mail,email) send [flags]` - Send an email -- `gog gmail (mail,email) settings <command>` - Settings and admin -- `gog gmail (mail,email) settings autoforward <command>` - Auto-forwarding settings -- `gog gmail (mail,email) settings autoforward get (info,show)` - Get current auto-forwarding settings -- `gog gmail (mail,email) settings autoforward update (edit,set) [flags]` - Update auto-forwarding settings -- `gog gmail (mail,email) settings delegates <command>` - Delegate operations -- `gog gmail (mail,email) settings delegates add (create,new) <delegateEmail>` - Add a delegate -- `gog gmail (mail,email) settings delegates get (info,show) <delegateEmail>` - Get a specific delegate's information -- `gog gmail (mail,email) settings delegates list (ls)` - List all delegates -- `gog gmail (mail,email) settings delegates remove (delete,rm,del) <delegateEmail>` - Remove a delegate -- `gog gmail (mail,email) settings filters <command>` - Filter operations -- `gog gmail (mail,email) settings filters create (add,new) [flags]` - Create a new email filter -- `gog gmail (mail,email) settings filters delete (rm,del,remove) <filterId>` - Delete a filter -- `gog gmail (mail,email) settings filters export [flags]` - Export filters as JSON -- `gog gmail (mail,email) settings filters get (info,show) <filterId>` - Get a specific filter -- `gog gmail (mail,email) settings filters list (ls)` - List all email filters -- `gog gmail (mail,email) settings forwarding <command>` - Forwarding addresses -- `gog gmail (mail,email) settings forwarding create (add,new) <forwardingEmail>` - Create/add a forwarding address -- `gog gmail (mail,email) settings forwarding delete (rm,del,remove) <forwardingEmail>` - Delete a forwarding address -- `gog gmail (mail,email) settings forwarding get (info,show) <forwardingEmail>` - Get a specific forwarding address -- `gog gmail (mail,email) settings forwarding list (ls)` - List all forwarding addresses -- `gog gmail (mail,email) settings sendas <command>` - Send-as settings -- `gog gmail (mail,email) settings sendas create (add,new) <email> [flags]` - Create a new send-as alias -- `gog gmail (mail,email) settings sendas delete (rm,del,remove) <email>` - Delete a send-as alias -- `gog gmail (mail,email) settings sendas get (info,show) <email>` - Get details of a send-as alias -- `gog gmail (mail,email) settings sendas list (ls)` - List send-as aliases -- `gog gmail (mail,email) settings sendas update (edit,set) <email> [flags]` - Update a send-as alias -- `gog gmail (mail,email) settings sendas verify (resend) <email>` - Resend verification email for a send-as alias -- `gog gmail (mail,email) settings vacation <command>` - Vacation responder -- `gog gmail (mail,email) settings vacation get (info,show)` - Get current vacation responder settings -- `gog gmail (mail,email) settings vacation update (edit,set) [flags]` - Update vacation responder settings -- `gog gmail (mail,email) settings watch <command>` - Manage Gmail watch -- `gog gmail (mail,email) settings watch renew (update) [flags]` - Renew Gmail watch using stored config -- `gog gmail (mail,email) settings watch serve [flags]` - Run Pub/Sub push handler -- `gog gmail (mail,email) settings watch start (begin) [flags]` - Start Gmail watch for Pub/Sub -- `gog gmail (mail,email) settings watch status (ls) [flags]` - Show stored watch state -- `gog gmail (mail,email) settings watch stop (rm,delete)` - Stop Gmail watch and clear stored state -- `gog gmail (mail,email) thread (threads,read) <command>` - Thread operations (get, modify) -- `gog gmail (mail,email) thread (threads,read) attachments (files) <threadId> [flags]` - List all attachments in a thread -- `gog gmail (mail,email) thread (threads,read) get (info,show) <threadId> [flags]` - Get a thread with all messages (optionally download attachments) -- `gog gmail (mail,email) thread (threads,read) modify (update,edit,set) <threadId> [flags]` - Modify labels on all messages in a thread -- `gog gmail (mail,email) track <command>` - Email open tracking -- `gog gmail (mail,email) track key <command>` - Manage tracking encryption keys -- `gog gmail (mail,email) track key rotate [flags]` - Rotate tracking encryption key -- `gog gmail (mail,email) track opens [<tracking-id>] [flags]` - Query email opens -- `gog gmail (mail,email) track setup [flags]` - Set up email tracking (deploy Cloudflare Worker) -- `gog gmail (mail,email) track status` - Show tracking configuration status -- `gog gmail (mail,email) trash [<messageId> ...] [flags]` - Move messages to trash -- `gog gmail (mail,email) unread (mark-unread) [<messageId> ...] [flags]` - Mark messages as unread -- `gog gmail (mail,email) url <threadId> ...` - Print Gmail web URLs for threads -- `gog groups (group) <command> [flags]` - Google Groups -- `gog groups (group) list (ls) [flags]` - List groups you belong to -- `gog groups (group) members <groupEmail> [flags]` - List members of a group -- `gog keep <command> [flags]` - Google Keep (Workspace only) -- `gog keep attachment <attachmentName> [flags]` - Download an attachment -- `gog keep create [flags]` - Create a new note -- `gog keep delete <noteId> [flags]` - Delete a note -- `gog keep get <noteId> [flags]` - Get a note -- `gog keep list [flags]` - List notes -- `gog keep search <query> [flags]` - Search notes by text (client-side) -- `gog login <email> [flags]` - Authorize and store a refresh token (alias for 'auth add') -- `gog logout <email> [flags]` - Remove a stored refresh token (alias for 'auth remove') -- `gog ls (list) [flags]` - List Drive files (alias for 'drive ls') -- `gog me [flags]` - Show your profile (alias for 'people me') -- `gog open (browse) <target> [flags]` - Print a best-effort web URL for a Google URL/ID (offline) -- `gog people (person) <command> [flags]` - Google People -- `gog people (person) get (info,show) <userId>` - Get a user profile by ID -- `gog people (person) me` - Show your profile (people/me) -- `gog people (person) relations [<userId>] [flags]` - Get user relations -- `gog people (person) search (find,query) <query> ... [flags]` - Search the Workspace directory -- `gog schema (help-json,helpjson) [<command> ...] [flags]` - Machine-readable command/flag schema -- `gog search (find) <query> ... [flags]` - Search Drive files (alias for 'drive search') -- `gog send [flags]` - Send an email (alias for 'gmail send') -- `gog sheets (sheet) <command> [flags]` - Google Sheets -- `gog sheets (sheet) add-tab (add-sheet) <spreadsheetId> <tabName> [flags]` - Add a new tab/sheet to a spreadsheet -- `gog sheets (sheet) append (add) <spreadsheetId> <range> [<values> ...] [flags]` - Append values to a range -- `gog sheets (sheet) chart (charts) <command>` - Manage spreadsheet charts -- `gog sheets (sheet) chart (charts) create (add,new) --spec-json=STRING <spreadsheetId> [flags]` - Create a chart from a JSON spec -- `gog sheets (sheet) chart (charts) delete (rm,remove,del) <spreadsheetId> <chartId>` - Delete a chart -- `gog sheets (sheet) chart (charts) get (show,info) <spreadsheetId> <chartId>` - Get full chart definition (spec + position) -- `gog sheets (sheet) chart (charts) list <spreadsheetId>` - List charts in a spreadsheet -- `gog sheets (sheet) chart (charts) update (edit,set) --spec-json=STRING <spreadsheetId> <chartId>` - Update a chart spec -- `gog sheets (sheet) clear <spreadsheetId> <range>` - Clear values in a range -- `gog sheets (sheet) copy (cp,duplicate) <spreadsheetId> <title> [flags]` - Copy a Google Sheet -- `gog sheets (sheet) create (new) <title> [flags]` - Create a new spreadsheet -- `gog sheets (sheet) delete-tab (delete-sheet) <spreadsheetId> <tabName>` - Delete a tab/sheet from a spreadsheet (use --force to skip confirmation) -- `gog sheets (sheet) export (download,dl) <spreadsheetId> [flags]` - Export a Google Sheet (pdf|xlsx|csv) via Drive -- `gog sheets (sheet) find-replace <spreadsheetId> <find> <replace> [flags]` - Find and replace text across a spreadsheet -- `gog sheets (sheet) format <spreadsheetId> <range> [flags]` - Apply cell formatting to a range -- `gog sheets (sheet) freeze <spreadsheetId> [flags]` - Freeze rows and columns on a sheet -- `gog sheets (sheet) get (read,show) <spreadsheetId> <range> [flags]` - Get values from a range -- `gog sheets (sheet) insert <spreadsheetId> <sheet> <dimension> <start> [flags]` - Insert empty rows or columns into a sheet -- `gog sheets (sheet) links (hyperlinks) <spreadsheetId> <range>` - Get cell hyperlinks from a range -- `gog sheets (sheet) merge <spreadsheetId> <range> [flags]` - Merge cells in a range -- `gog sheets (sheet) metadata (info) <spreadsheetId>` - Get spreadsheet metadata -- `gog sheets (sheet) named-ranges (namedranges,nr) <command>` - Manage named ranges -- `gog sheets (sheet) named-ranges (namedranges,nr) add (create,new) <spreadsheetId> <name> <range>` - Add a named range -- `gog sheets (sheet) named-ranges (namedranges,nr) delete (rm,remove,del) <spreadsheetId> <nameOrId>` - Delete a named range -- `gog sheets (sheet) named-ranges (namedranges,nr) get (show,info) <spreadsheetId> <nameOrId>` - Get a named range -- `gog sheets (sheet) named-ranges (namedranges,nr) list <spreadsheetId>` - List named ranges -- `gog sheets (sheet) named-ranges (namedranges,nr) update (edit,set) <spreadsheetId> <nameOrId> [flags]` - Update a named range -- `gog sheets (sheet) notes <spreadsheetId> <range>` - Get cell notes from a range -- `gog sheets (sheet) number-format <spreadsheetId> <range> [flags]` - Apply number format to a range -- `gog sheets (sheet) read-format (get-format,format-read) <spreadsheetId> <range> [flags]` - Read cell formatting from a range -- `gog sheets (sheet) rename-tab (rename-sheet) <spreadsheetId> <oldName> <newName>` - Rename a tab/sheet in a spreadsheet -- `gog sheets (sheet) resize-columns <spreadsheetId> <columns> [flags]` - Resize sheet columns -- `gog sheets (sheet) resize-rows <spreadsheetId> <rows> [flags]` - Resize sheet rows -- `gog sheets (sheet) unmerge <spreadsheetId> <range>` - Unmerge cells in a range -- `gog sheets (sheet) update (edit,set) <spreadsheetId> <range> [<values> ...] [flags]` - Update values in a range -- `gog sheets (sheet) update-note (set-note) <spreadsheetId> <range> [flags]` - Set or clear a cell note -- `gog slides (slide) <command> [flags]` - Google Slides -- `gog slides (slide) add-slide <presentationId> <image> [flags]` - Add a slide with a full-bleed image and optional speaker notes -- `gog slides (slide) copy (cp,duplicate) <presentationId> <title> [flags]` - Copy a Google Slides presentation -- `gog slides (slide) create (add,new) <title> [flags]` - Create a Google Slides presentation -- `gog slides (slide) create-from-markdown <title> [flags]` - Create a Google Slides presentation from markdown -- `gog slides (slide) create-from-template <templateId> <title> [flags]` - Create a presentation from template with text replacements -- `gog slides (slide) delete-slide <presentationId> <slideId>` - Delete a slide by object ID -- `gog slides (slide) export (download,dl) <presentationId> [flags]` - Export a Google Slides deck (pdf|pptx) -- `gog slides (slide) info (get,show) <presentationId>` - Get Google Slides presentation metadata -- `gog slides (slide) insert-text <presentationId> <objectId> <text> [flags]` - Insert text into an existing page element (shape or table) by objectId -- `gog slides (slide) list-slides <presentationId>` - List all slides with their object IDs -- `gog slides (slide) read-slide <presentationId> <slideId>` - Read slide content: speaker notes, text elements, and images -- `gog slides (slide) replace-slide <presentationId> <slideId> <image> [flags]` - Replace the image on an existing slide in-place -- `gog slides (slide) replace-text <presentationId> <find> <replacement> [flags]` - Find-and-replace text across a presentation -- `gog slides (slide) thumbnail (thumb) <presentationId> <slideId> [flags]` - Get or download a rendered thumbnail for a slide -- `gog slides (slide) update-notes <presentationId> <slideId> [flags]` - Update speaker notes on an existing slide -- `gog status (st) [flags]` - Show auth/config status (alias for 'auth status') -- `gog tasks (task) <command> [flags]` - Google Tasks -- `gog tasks (task) add (create) <tasklistId> [flags]` - Add a task -- `gog tasks (task) clear <tasklistId>` - Clear completed tasks -- `gog tasks (task) delete (rm,del,remove) <tasklistId> <taskId>` - Delete a task -- `gog tasks (task) done (complete) <tasklistId> <taskId>` - Mark task completed -- `gog tasks (task) get (info,show) <tasklistId> <taskId>` - Get a task -- `gog tasks (task) list (ls) <tasklistId> [flags]` - List tasks -- `gog tasks (task) lists <command>` - List task lists -- `gog tasks (task) lists create (add,new) <title> ...` - Create a task list -- `gog tasks (task) lists list [flags]` - List task lists -- `gog tasks (task) undo (uncomplete,undone) <tasklistId> <taskId>` - Mark task needs action -- `gog tasks (task) update (edit,set) <tasklistId> <taskId> [flags]` - Update a task -- `gog time <command> [flags]` - Local time utilities -- `gog time now [flags]` - Show current time -- `gog upload (up,put) <localPath> [flags]` - Upload a file to Drive (alias for 'drive upload') -- `gog version [flags]` - Print version -- `gog whoami (who-am-i) [flags]` - Show your profile (alias for 'people me') +- [`gog <command> [flags]`](commands/gog.md) - Google CLI for Gmail/Calendar/Chat/Classroom/Drive/Contacts/Tasks/Sheets/Docs/Slides/People/Forms/App Script/Ads/Groups/Admin/Keep + - [`gog admin <command> [flags]`](commands/gog-admin.md) - Google Workspace Admin (Directory API) - requires domain-wide delegation + - [`gog admin groups <command>`](commands/gog-admin-groups.md) - Manage Workspace groups + - [`gog admin groups list (ls) [flags]`](commands/gog-admin-groups-list.md) - List groups in a domain + - [`gog admin groups members <command>`](commands/gog-admin-groups-members.md) - Manage group members + - [`gog admin groups members add (invite) <groupEmail> <memberEmail> [flags]`](commands/gog-admin-groups-members-add.md) - Add a member to a group + - [`gog admin groups members list (ls) <groupEmail> [flags]`](commands/gog-admin-groups-members-list.md) - List group members + - [`gog admin groups members remove (rm,del,delete) <groupEmail> <memberEmail>`](commands/gog-admin-groups-members-remove.md) - Remove a member from a group + - [`gog admin users <command>`](commands/gog-admin-users.md) - Manage Workspace users + - [`gog admin users create (add,new) <email> [flags]`](commands/gog-admin-users-create.md) - Create a new user + - [`gog admin users get (info,show) <userEmail>`](commands/gog-admin-users-get.md) - Get user details + - [`gog admin users list (ls) [flags]`](commands/gog-admin-users-list.md) - List users in a domain + - [`gog admin users suspend <userEmail>`](commands/gog-admin-users-suspend.md) - Suspend a user account + - [`gog agent <command> [flags]`](commands/gog-agent.md) - Agent-friendly helpers + - [`gog agent exit-codes (exitcodes,exit-code)`](commands/gog-agent-exit-codes.md) - Print stable exit codes for automation + - [`gog appscript (script,apps-script) <command> [flags]`](commands/gog-appscript.md) - Google Apps Script + - [`gog appscript (script,apps-script) content (cat) <scriptId>`](commands/gog-appscript-content.md) - Get Apps Script project content + - [`gog appscript (script,apps-script) create (new) --title=STRING [flags]`](commands/gog-appscript-create.md) - Create an Apps Script project + - [`gog appscript (script,apps-script) get (info,show) <scriptId>`](commands/gog-appscript-get.md) - Get Apps Script project metadata + - [`gog appscript (script,apps-script) run <scriptId> <function> [flags]`](commands/gog-appscript-run.md) - Run a deployed Apps Script function + - [`gog auth <command> [flags]`](commands/gog-auth.md) - Auth and credentials + - [`gog auth add <email> [flags]`](commands/gog-auth-add.md) - Authorize and store a refresh token + - [`gog auth alias <command>`](commands/gog-auth-alias.md) - Manage account aliases + - [`gog auth alias list`](commands/gog-auth-alias-list.md) - List account aliases + - [`gog auth alias set <alias> <email>`](commands/gog-auth-alias-set.md) - Set an account alias + - [`gog auth alias unset <alias>`](commands/gog-auth-alias-unset.md) - Remove an account alias + - [`gog auth credentials <command>`](commands/gog-auth-credentials.md) - Manage OAuth client credentials + - [`gog auth credentials list`](commands/gog-auth-credentials-list.md) - List stored OAuth client credentials + - [`gog auth credentials remove [<client>]`](commands/gog-auth-credentials-remove.md) - Remove stored OAuth client credentials + - [`gog auth credentials set <credentials> [flags]`](commands/gog-auth-credentials-set.md) - Store OAuth client credentials + - [`gog auth doctor [flags]`](commands/gog-auth-doctor.md) - Diagnose auth, keyring, and refresh-token issues + - [`gog auth keep --key=STRING <email>`](commands/gog-auth-keep.md) - Configure service account for Google Keep (Workspace only) + - [`gog auth keyring [<backend> [<backend2>]]`](commands/gog-auth-keyring.md) - Configure keyring backend + - [`gog auth list [flags]`](commands/gog-auth-list.md) - List stored accounts + - [`gog auth manage (login) [flags]`](commands/gog-auth-manage.md) - Open accounts manager in browser + - [`gog auth remove <email>`](commands/gog-auth-remove.md) - Remove a stored refresh token + - [`gog auth service-account <command>`](commands/gog-auth-service-account.md) - Configure service account (Workspace only; domain-wide delegation) + - [`gog auth service-account set --key=STRING <email>`](commands/gog-auth-service-account-set.md) - Store a service account key for impersonation + - [`gog auth service-account status <email>`](commands/gog-auth-service-account-status.md) - Show stored service account key status + - [`gog auth service-account unset <email>`](commands/gog-auth-service-account-unset.md) - Remove stored service account key + - [`gog auth services [flags]`](commands/gog-auth-services.md) - List supported auth services and scopes + - [`gog auth status`](commands/gog-auth-status.md) - Show auth configuration and keyring backend + - [`gog auth tokens <command>`](commands/gog-auth-tokens.md) - Manage stored refresh tokens + - [`gog auth tokens delete <email>`](commands/gog-auth-tokens-delete.md) - Delete a stored refresh token + - [`gog auth tokens export <email> [flags]`](commands/gog-auth-tokens-export.md) - Export a refresh token to a file (contains secrets) + - [`gog auth tokens import <inPath>`](commands/gog-auth-tokens-import.md) - Import a refresh token file into keyring (contains secrets) + - [`gog auth tokens list`](commands/gog-auth-tokens-list.md) - List stored tokens (by key only) + - [`gog backup <command> [flags]`](commands/gog-backup.md) - Encrypted Google account backups + - [`gog backup cat <shard> [flags]`](commands/gog-backup-cat.md) - Decrypt one backup shard to stdout + - [`gog backup export [flags]`](commands/gog-backup-export.md) - Write a local plaintext export + - [`gog backup gmail <command>`](commands/gog-backup-gmail.md) - Gmail backup operations + - [`gog backup gmail push [flags]`](commands/gog-backup-gmail-push.md) - Export Gmail into encrypted backup shards + - [`gog backup init [flags]`](commands/gog-backup-init.md) - Initialize encrypted backup config and repository + - [`gog backup push [flags]`](commands/gog-backup-push.md) - Export services into encrypted backup shards + - [`gog backup status [flags]`](commands/gog-backup-status.md) - Inspect backup manifest without decrypting shards + - [`gog backup verify [flags]`](commands/gog-backup-verify.md) - Decrypt and verify all backup shards + - [`gog calendar (cal) <command> [flags]`](commands/gog-calendar.md) - Google Calendar + - [`gog calendar (cal) acl (permissions,perms) <calendarId> [flags]`](commands/gog-calendar-acl.md) - List calendar ACL + - [`gog calendar (cal) alias <command>`](commands/gog-calendar-alias.md) - Manage calendar aliases + - [`gog calendar (cal) alias list`](commands/gog-calendar-alias-list.md) - List calendar aliases + - [`gog calendar (cal) alias set <alias> <calendarId>`](commands/gog-calendar-alias-set.md) - Set a calendar alias + - [`gog calendar (cal) alias unset <alias>`](commands/gog-calendar-alias-unset.md) - Remove a calendar alias + - [`gog calendar (cal) calendars [flags]`](commands/gog-calendar-calendars.md) - List calendars + - [`gog calendar (cal) colors`](commands/gog-calendar-colors.md) - Show calendar colors + - [`gog calendar (cal) conflicts [flags]`](commands/gog-calendar-conflicts.md) - Find conflicts + - [`gog calendar (cal) create (add,new) <calendarId> [flags]`](commands/gog-calendar-create.md) - Create an event + - [`gog calendar (cal) create-calendar (new-calendar) <summary> [flags]`](commands/gog-calendar-create-calendar.md) - Create a new secondary calendar + - [`gog calendar (cal) delete (rm,del,remove) <calendarId> <eventId> [flags]`](commands/gog-calendar-delete.md) - Delete an event + - [`gog calendar (cal) event (get,info,show) <calendarId> <eventId>`](commands/gog-calendar-event.md) - Get event + - [`gog calendar (cal) events (list,ls) [<calendarId> ...] [flags]`](commands/gog-calendar-events.md) - List events from a calendar or all calendars + - [`gog calendar (cal) focus-time (focus) --from=STRING --to=STRING [<calendarId>] [flags]`](commands/gog-calendar-focus-time.md) - Create a Focus Time block + - [`gog calendar (cal) freebusy [<calendarIds>] [flags]`](commands/gog-calendar-freebusy.md) - Get free/busy + - [`gog calendar (cal) move (transfer) <calendarId> <eventId> <destinationCalendarId> [flags]`](commands/gog-calendar-move.md) - Move an event to another calendar + - [`gog calendar (cal) out-of-office (ooo) --from=STRING --to=STRING [<calendarId>] [flags]`](commands/gog-calendar-out-of-office.md) - Create an Out of Office event + - [`gog calendar (cal) propose-time <calendarId> <eventId> [flags]`](commands/gog-calendar-propose-time.md) - Generate URL to propose a new meeting time (browser-only feature) + - [`gog calendar (cal) respond (rsvp,reply) <calendarId> <eventId> [flags]`](commands/gog-calendar-respond.md) - Respond to an event invitation + - [`gog calendar (cal) search (find,query) <query> [flags]`](commands/gog-calendar-search.md) - Search events + - [`gog calendar (cal) subscribe (sub,add-calendar) <calendarId> [flags]`](commands/gog-calendar-subscribe.md) - Add a calendar to your calendar list + - [`gog calendar (cal) team <group-email> [flags]`](commands/gog-calendar-team.md) - Show events for all members of a Google Group + - [`gog calendar (cal) time [flags]`](commands/gog-calendar-time.md) - Show server time + - [`gog calendar (cal) update (edit,set) <calendarId> <eventId> [flags]`](commands/gog-calendar-update.md) - Update an event + - [`gog calendar (cal) users [flags]`](commands/gog-calendar-users.md) - List workspace users (use their email as calendar ID) + - [`gog calendar (cal) working-location (wl) --from=STRING --to=STRING --type=STRING [<calendarId>] [flags]`](commands/gog-calendar-working-location.md) - Set working location (home/office/custom) + - [`gog chat <command> [flags]`](commands/gog-chat.md) - Google Chat + - [`gog chat dm <command>`](commands/gog-chat-dm.md) - Direct messages + - [`gog chat dm send (create,post) <email> [flags]`](commands/gog-chat-dm-send.md) - Send a direct message + - [`gog chat dm space (find,setup) <email>`](commands/gog-chat-dm-space.md) - Find or create a DM space + - [`gog chat messages <command>`](commands/gog-chat-messages.md) - Chat messages + - [`gog chat messages list (ls) <space> [flags]`](commands/gog-chat-messages-list.md) - List messages + - [`gog chat messages react <message> <emoji> [flags]`](commands/gog-chat-messages-react.md) - Add an emoji reaction to a message + - [`gog chat messages reactions (reaction) <command>`](commands/gog-chat-messages-reactions.md) - Manage emoji reactions on a message + - [`gog chat messages reactions (reaction) create (add) <message> <emoji> [flags]`](commands/gog-chat-messages-reactions-create.md) - Add an emoji reaction to a message + - [`gog chat messages reactions (reaction) delete (remove,rm) <reaction>`](commands/gog-chat-messages-reactions-delete.md) - Delete a reaction + - [`gog chat messages reactions (reaction) list (ls) <message> [flags]`](commands/gog-chat-messages-reactions-list.md) - List reactions on a message + - [`gog chat messages send (create,post) <space> [flags]`](commands/gog-chat-messages-send.md) - Send a message + - [`gog chat spaces <command>`](commands/gog-chat-spaces.md) - Chat spaces + - [`gog chat spaces create (add,new) <displayName> [flags]`](commands/gog-chat-spaces-create.md) - Create a space + - [`gog chat spaces find (search,query) <displayName> [flags]`](commands/gog-chat-spaces-find.md) - Find spaces by display name + - [`gog chat spaces list (ls) [flags]`](commands/gog-chat-spaces-list.md) - List spaces + - [`gog chat threads <command>`](commands/gog-chat-threads.md) - Chat threads + - [`gog chat threads list <space> [flags]`](commands/gog-chat-threads-list.md) - List threads in a space + - [`gog classroom (class) <command> [flags]`](commands/gog-classroom.md) - Google Classroom + - [`gog classroom (class) announcements (announcement,ann) <command>`](commands/gog-classroom-announcements.md) - Announcements + - [`gog classroom (class) announcements (announcement,ann) assignees (assign) <courseId> <announcementId> [flags]`](commands/gog-classroom-announcements-assignees.md) - Modify announcement assignees + - [`gog classroom (class) announcements (announcement,ann) create (add,new) --text=STRING <courseId> [flags]`](commands/gog-classroom-announcements-create.md) - Create an announcement + - [`gog classroom (class) announcements (announcement,ann) delete (rm,del,remove) <courseId> <announcementId>`](commands/gog-classroom-announcements-delete.md) - Delete an announcement + - [`gog classroom (class) announcements (announcement,ann) get (info,show) <courseId> <announcementId>`](commands/gog-classroom-announcements-get.md) - Get an announcement + - [`gog classroom (class) announcements (announcement,ann) list (ls) <courseId> [flags]`](commands/gog-classroom-announcements-list.md) - List announcements + - [`gog classroom (class) announcements (announcement,ann) update (edit,set) <courseId> <announcementId> [flags]`](commands/gog-classroom-announcements-update.md) - Update an announcement + - [`gog classroom (class) courses (course) <command>`](commands/gog-classroom-courses.md) - Courses + - [`gog classroom (class) courses (course) archive (arch) <courseId>`](commands/gog-classroom-courses-archive.md) - Archive a course + - [`gog classroom (class) courses (course) create (add,new) --name=STRING [flags]`](commands/gog-classroom-courses-create.md) - Create a course + - [`gog classroom (class) courses (course) delete (rm,del,remove) <courseId>`](commands/gog-classroom-courses-delete.md) - Delete a course + - [`gog classroom (class) courses (course) get (info,show) <courseId>`](commands/gog-classroom-courses-get.md) - Get a course + - [`gog classroom (class) courses (course) join (enroll) <courseId> [flags]`](commands/gog-classroom-courses-join.md) - Join a course + - [`gog classroom (class) courses (course) leave (unenroll) <courseId> [flags]`](commands/gog-classroom-courses-leave.md) - Leave a course + - [`gog classroom (class) courses (course) list (ls) [flags]`](commands/gog-classroom-courses-list.md) - List courses + - [`gog classroom (class) courses (course) unarchive (unarch,restore) <courseId>`](commands/gog-classroom-courses-unarchive.md) - Unarchive a course + - [`gog classroom (class) courses (course) update (edit,set) <courseId> [flags]`](commands/gog-classroom-courses-update.md) - Update a course + - [`gog classroom (class) courses (course) url (link) <courseId> ...`](commands/gog-classroom-courses-url.md) - Print Classroom web URLs for courses + - [`gog classroom (class) coursework (work) <command>`](commands/gog-classroom-coursework.md) - Coursework + - [`gog classroom (class) coursework (work) assignees (assign) <courseId> <courseworkId> [flags]`](commands/gog-classroom-coursework-assignees.md) - Modify coursework assignees + - [`gog classroom (class) coursework (work) create (add,new) --title=STRING <courseId> [flags]`](commands/gog-classroom-coursework-create.md) - Create coursework + - [`gog classroom (class) coursework (work) delete (rm,del,remove) <courseId> <courseworkId>`](commands/gog-classroom-coursework-delete.md) - Delete coursework + - [`gog classroom (class) coursework (work) get (info,show) <courseId> <courseworkId>`](commands/gog-classroom-coursework-get.md) - Get coursework + - [`gog classroom (class) coursework (work) list (ls) <courseId> [flags]`](commands/gog-classroom-coursework-list.md) - List coursework + - [`gog classroom (class) coursework (work) update (edit,set) <courseId> <courseworkId> [flags]`](commands/gog-classroom-coursework-update.md) - Update coursework + - [`gog classroom (class) guardian-invitations (guardian-invites) <command>`](commands/gog-classroom-guardian-invitations.md) - Guardian invitations + - [`gog classroom (class) guardian-invitations (guardian-invites) create (add,new) --email=STRING <studentId>`](commands/gog-classroom-guardian-invitations-create.md) - Create a guardian invitation + - [`gog classroom (class) guardian-invitations (guardian-invites) get (info,show) <studentId> <invitationId>`](commands/gog-classroom-guardian-invitations-get.md) - Get a guardian invitation + - [`gog classroom (class) guardian-invitations (guardian-invites) list (ls) <studentId> [flags]`](commands/gog-classroom-guardian-invitations-list.md) - List guardian invitations + - [`gog classroom (class) guardians (guardian) <command>`](commands/gog-classroom-guardians.md) - Guardians + - [`gog classroom (class) guardians (guardian) delete (rm,del,remove) <studentId> <guardianId>`](commands/gog-classroom-guardians-delete.md) - Delete a guardian + - [`gog classroom (class) guardians (guardian) get (info,show) <studentId> <guardianId>`](commands/gog-classroom-guardians-get.md) - Get a guardian + - [`gog classroom (class) guardians (guardian) list (ls) <studentId> [flags]`](commands/gog-classroom-guardians-list.md) - List guardians + - [`gog classroom (class) invitations (invitation,invites) <command>`](commands/gog-classroom-invitations.md) - Invitations + - [`gog classroom (class) invitations (invitation,invites) accept (join) <invitationId>`](commands/gog-classroom-invitations-accept.md) - Accept an invitation + - [`gog classroom (class) invitations (invitation,invites) create (add,new) --role=STRING <courseId> <userId>`](commands/gog-classroom-invitations-create.md) - Create an invitation + - [`gog classroom (class) invitations (invitation,invites) delete (rm,del,remove) <invitationId>`](commands/gog-classroom-invitations-delete.md) - Delete an invitation + - [`gog classroom (class) invitations (invitation,invites) get (info,show) <invitationId>`](commands/gog-classroom-invitations-get.md) - Get an invitation + - [`gog classroom (class) invitations (invitation,invites) list (ls) [flags]`](commands/gog-classroom-invitations-list.md) - List invitations + - [`gog classroom (class) materials (material) <command>`](commands/gog-classroom-materials.md) - Coursework materials + - [`gog classroom (class) materials (material) create (add,new) --title=STRING <courseId> [flags]`](commands/gog-classroom-materials-create.md) - Create coursework material + - [`gog classroom (class) materials (material) delete (rm,del,remove) <courseId> <materialId>`](commands/gog-classroom-materials-delete.md) - Delete coursework material + - [`gog classroom (class) materials (material) get (info,show) <courseId> <materialId>`](commands/gog-classroom-materials-get.md) - Get coursework material + - [`gog classroom (class) materials (material) list (ls) <courseId> [flags]`](commands/gog-classroom-materials-list.md) - List coursework materials + - [`gog classroom (class) materials (material) update (edit,set) <courseId> <materialId> [flags]`](commands/gog-classroom-materials-update.md) - Update coursework material + - [`gog classroom (class) profile (me) <command>`](commands/gog-classroom-profile.md) - User profiles + - [`gog classroom (class) profile (me) get [<userId>]`](commands/gog-classroom-profile-get.md) - Get a user profile + - [`gog classroom (class) roster (members) <courseId> [flags]`](commands/gog-classroom-roster.md) - Course roster (students + teachers) + - [`gog classroom (class) students (student) <command>`](commands/gog-classroom-students.md) - Course students + - [`gog classroom (class) students (student) add (create,new) <courseId> <userId> [flags]`](commands/gog-classroom-students-add.md) - Add a student + - [`gog classroom (class) students (student) get (info,show) <courseId> <userId>`](commands/gog-classroom-students-get.md) - Get a student + - [`gog classroom (class) students (student) list (ls) <courseId> [flags]`](commands/gog-classroom-students-list.md) - List students + - [`gog classroom (class) students (student) remove (delete,rm,del,remove) <courseId> <userId>`](commands/gog-classroom-students-remove.md) - Remove a student + - [`gog classroom (class) submissions (submission) <command>`](commands/gog-classroom-submissions.md) - Student submissions + - [`gog classroom (class) submissions (submission) get (info,show) <courseId> <courseworkId> <submissionId>`](commands/gog-classroom-submissions-get.md) - Get a student submission + - [`gog classroom (class) submissions (submission) grade (set,edit) <courseId> <courseworkId> <submissionId> [flags]`](commands/gog-classroom-submissions-grade.md) - Set draft/assigned grades + - [`gog classroom (class) submissions (submission) list (ls) <courseId> <courseworkId> [flags]`](commands/gog-classroom-submissions-list.md) - List student submissions + - [`gog classroom (class) submissions (submission) reclaim (undo) <courseId> <courseworkId> <submissionId>`](commands/gog-classroom-submissions-reclaim.md) - Reclaim a submission + - [`gog classroom (class) submissions (submission) return (send) <courseId> <courseworkId> <submissionId>`](commands/gog-classroom-submissions-return.md) - Return a submission + - [`gog classroom (class) submissions (submission) turn-in (turnin) <courseId> <courseworkId> <submissionId>`](commands/gog-classroom-submissions-turn-in.md) - Turn in a submission + - [`gog classroom (class) teachers (teacher) <command>`](commands/gog-classroom-teachers.md) - Course teachers + - [`gog classroom (class) teachers (teacher) add (create,new) <courseId> <userId>`](commands/gog-classroom-teachers-add.md) - Add a teacher + - [`gog classroom (class) teachers (teacher) get (info,show) <courseId> <userId>`](commands/gog-classroom-teachers-get.md) - Get a teacher + - [`gog classroom (class) teachers (teacher) list (ls) <courseId> [flags]`](commands/gog-classroom-teachers-list.md) - List teachers + - [`gog classroom (class) teachers (teacher) remove (delete,rm,del,remove) <courseId> <userId>`](commands/gog-classroom-teachers-remove.md) - Remove a teacher + - [`gog classroom (class) topics (topic) <command>`](commands/gog-classroom-topics.md) - Topics + - [`gog classroom (class) topics (topic) create (add,new) --name=STRING <courseId>`](commands/gog-classroom-topics-create.md) - Create a topic + - [`gog classroom (class) topics (topic) delete (rm,del,remove) <courseId> <topicId>`](commands/gog-classroom-topics-delete.md) - Delete a topic + - [`gog classroom (class) topics (topic) get (info,show) <courseId> <topicId>`](commands/gog-classroom-topics-get.md) - Get a topic + - [`gog classroom (class) topics (topic) list (ls) <courseId> [flags]`](commands/gog-classroom-topics-list.md) - List topics + - [`gog classroom (class) topics (topic) update (edit,set) --name=STRING <courseId> <topicId>`](commands/gog-classroom-topics-update.md) - Update a topic + - [`gog completion <shell> [flags]`](commands/gog-completion.md) - Generate shell completion scripts + - [`gog config <command> [flags]`](commands/gog-config.md) - Manage configuration + - [`gog config get (show) <key>`](commands/gog-config-get.md) - Get a config value + - [`gog config keys (list-keys,names)`](commands/gog-config-keys.md) - List available config keys + - [`gog config list (ls,all)`](commands/gog-config-list.md) - List all config values + - [`gog config no-send (nosend) <command>`](commands/gog-config-no-send.md) - Manage per-account Gmail no-send guards + - [`gog config no-send (nosend) list (ls)`](commands/gog-config-no-send-list.md) - List accounts with no-send guards + - [`gog config no-send (nosend) remove (rm,del,delete,unset,disable) <account>`](commands/gog-config-no-send-remove.md) - Remove an account no-send guard + - [`gog config no-send (nosend) set (add,enable) <account>`](commands/gog-config-no-send-set.md) - Block Gmail send operations for an account + - [`gog config path (where)`](commands/gog-config-path.md) - Print config file path + - [`gog config set (add,update) <key> <value>`](commands/gog-config-set.md) - Set a config value + - [`gog config unset (rm,del,remove) <key>`](commands/gog-config-unset.md) - Unset a config value + - [`gog contacts (contact) <command> [flags]`](commands/gog-contacts.md) - Google Contacts + - [`gog contacts (contact) create (add,new) [flags]`](commands/gog-contacts-create.md) - Create a contact + - [`gog contacts (contact) delete (rm,del,remove) <resourceName>`](commands/gog-contacts-delete.md) - Delete a contact + - [`gog contacts (contact) directory <command>`](commands/gog-contacts-directory.md) - Directory contacts + - [`gog contacts (contact) directory list [flags]`](commands/gog-contacts-directory-list.md) - List people from the Workspace directory + - [`gog contacts (contact) directory search <query> ... [flags]`](commands/gog-contacts-directory-search.md) - Search people in the Workspace directory + - [`gog contacts (contact) export [<selector>] [flags]`](commands/gog-contacts-export.md) - Export contacts as vCard (.vcf) + - [`gog contacts (contact) get (info,show) <resourceName>`](commands/gog-contacts-get.md) - Get a contact + - [`gog contacts (contact) list (ls) [flags]`](commands/gog-contacts-list.md) - List contacts + - [`gog contacts (contact) other <command>`](commands/gog-contacts-other.md) - Other contacts + - [`gog contacts (contact) other delete <resourceName>`](commands/gog-contacts-other-delete.md) - Delete an other contact + - [`gog contacts (contact) other list [flags]`](commands/gog-contacts-other-list.md) - List other contacts + - [`gog contacts (contact) other search <query> ... [flags]`](commands/gog-contacts-other-search.md) - Search other contacts + - [`gog contacts (contact) search <query> ... [flags]`](commands/gog-contacts-search.md) - Search contacts by name/email/phone + - [`gog contacts (contact) update (edit,set) <resourceName> [flags]`](commands/gog-contacts-update.md) - Update a contact + - [`gog docs (doc) <command> [flags]`](commands/gog-docs.md) - Google Docs (export via Drive) + - [`gog docs (doc) add-tab <docId> [flags]`](commands/gog-docs-add-tab.md) - Add a tab to a Google Doc + - [`gog docs (doc) cat (text,read) <docId> [flags]`](commands/gog-docs-cat.md) - Print a Google Doc as plain text + - [`gog docs (doc) clear <docId>`](commands/gog-docs-clear.md) - Clear all content from a Google Doc + - [`gog docs (doc) comments <command>`](commands/gog-docs-comments.md) - Manage comments on files + - [`gog docs (doc) comments add (create,new) <docId> <content> [flags]`](commands/gog-docs-comments-add.md) - Add a comment to a Google Doc + - [`gog docs (doc) comments delete (rm,del,remove) <docId> <commentId>`](commands/gog-docs-comments-delete.md) - Delete a comment + - [`gog docs (doc) comments get (info,show) <docId> <commentId>`](commands/gog-docs-comments-get.md) - Get a comment by ID + - [`gog docs (doc) comments list (ls) <docId> [flags]`](commands/gog-docs-comments-list.md) - List comments on a Google Doc + - [`gog docs (doc) comments reply (respond) <docId> <commentId> <content>`](commands/gog-docs-comments-reply.md) - Reply to a comment + - [`gog docs (doc) comments resolve <docId> <commentId> [flags]`](commands/gog-docs-comments-resolve.md) - Resolve a comment (mark as done) + - [`gog docs (doc) copy (cp,duplicate) <docId> <title> [flags]`](commands/gog-docs-copy.md) - Copy a Google Doc + - [`gog docs (doc) create (add,new) <title> [flags]`](commands/gog-docs-create.md) - Create a Google Doc + - [`gog docs (doc) delete --start=INT-64 --end=INT-64 <docId> [flags]`](commands/gog-docs-delete.md) - Delete text range from document + - [`gog docs (doc) delete-tab <docId> [flags]`](commands/gog-docs-delete-tab.md) - Delete a tab from a Google Doc + - [`gog docs (doc) edit <docId> <find> <replace> [flags]`](commands/gog-docs-edit.md) - Find and replace text in a Google Doc + - [`gog docs (doc) export (download,dl) <docId> [flags]`](commands/gog-docs-export.md) - Export a Google Doc (pdf|docx|txt|md|html) + - [`gog docs (doc) find-replace <docId> <find> [<replace>] [flags]`](commands/gog-docs-find-replace.md) - Find and replace text. Supports plain text or markdown with images; use --first for a single occurrence. + - [`gog docs (doc) info (get,show) <docId>`](commands/gog-docs-info.md) - Get Google Doc metadata + - [`gog docs (doc) insert <docId> [<content>] [flags]`](commands/gog-docs-insert.md) - Insert text at a specific position + - [`gog docs (doc) list-tabs <docId>`](commands/gog-docs-list-tabs.md) - List all tabs in a Google Doc + - [`gog docs (doc) rename-tab <docId> [flags]`](commands/gog-docs-rename-tab.md) - Rename a tab in a Google Doc + - [`gog docs (doc) sed <docId> [<expression>] [flags]`](commands/gog-docs-sed.md) - Regex find/replace (sed-style: s/pattern/replacement/g) + - [`gog docs (doc) structure (struct) <docId> [flags]`](commands/gog-docs-structure.md) - Show document structure with numbered paragraphs + - [`gog docs (doc) update <docId> [flags]`](commands/gog-docs-update.md) - Insert text at a specific index in a Google Doc + - [`gog docs (doc) write <docId> [flags]`](commands/gog-docs-write.md) - Write content to a Google Doc + - [`gog download (dl) <fileId> [flags]`](commands/gog-download.md) - Download a Drive file (alias for 'drive download') + - [`gog drive (drv) <command> [flags]`](commands/gog-drive.md) - Google Drive + - [`gog drive (drv) comments <command>`](commands/gog-drive-comments.md) - Manage comments on files + - [`gog drive (drv) comments create (add,new) <fileId> <content> [flags]`](commands/gog-drive-comments-create.md) - Create a comment on a file + - [`gog drive (drv) comments delete (rm,del,remove) <fileId> <commentId>`](commands/gog-drive-comments-delete.md) - Delete a comment + - [`gog drive (drv) comments get (info,show) <fileId> <commentId>`](commands/gog-drive-comments-get.md) - Get a comment by ID + - [`gog drive (drv) comments list (ls) <fileId> [flags]`](commands/gog-drive-comments-list.md) - List comments on a file + - [`gog drive (drv) comments reply (respond) <fileId> <commentId> <content>`](commands/gog-drive-comments-reply.md) - Reply to a comment + - [`gog drive (drv) comments update (edit,set) <fileId> <commentId> <content>`](commands/gog-drive-comments-update.md) - Update a comment + - [`gog drive (drv) copy <fileId> <name> [flags]`](commands/gog-drive-copy.md) - Copy a file + - [`gog drive (drv) delete (rm,del) <fileId> [flags]`](commands/gog-drive-delete.md) - Move a file to trash (use --permanent to delete forever) + - [`gog drive (drv) download <fileId> [flags]`](commands/gog-drive-download.md) - Download a file (exports Google Docs formats) + - [`gog drive (drv) drives [flags]`](commands/gog-drive-drives.md) - List shared drives (Team Drives) + - [`gog drive (drv) get <fileId>`](commands/gog-drive-get.md) - Get file metadata + - [`gog drive (drv) ls [flags]`](commands/gog-drive-ls.md) - List files in a folder (default: root) + - [`gog drive (drv) mkdir <name> [flags]`](commands/gog-drive-mkdir.md) - Create a folder + - [`gog drive (drv) move <fileId> [flags]`](commands/gog-drive-move.md) - Move a file to a different folder + - [`gog drive (drv) permissions <fileId> [flags]`](commands/gog-drive-permissions.md) - List permissions on a file + - [`gog drive (drv) rename <fileId> <newName>`](commands/gog-drive-rename.md) - Rename a file or folder + - [`gog drive (drv) search <query> ... [flags]`](commands/gog-drive-search.md) - Full-text search across Drive + - [`gog drive (drv) share <fileId> [flags]`](commands/gog-drive-share.md) - Share a file or folder + - [`gog drive (drv) unshare <fileId> <permissionId>`](commands/gog-drive-unshare.md) - Remove a permission from a file + - [`gog drive (drv) upload <localPath> [flags]`](commands/gog-drive-upload.md) - Upload a file + - [`gog drive (drv) url <fileId> ...`](commands/gog-drive-url.md) - Print web URLs for files + - [`gog exit-codes (exitcodes) [flags]`](commands/gog-exit-codes.md) - Print stable exit codes (alias for 'agent exit-codes') + - [`gog forms (form) <command> [flags]`](commands/gog-forms.md) - Google Forms + - [`gog forms (form) add-question (add-q,aq) --title=STRING <formId> [flags]`](commands/gog-forms-add-question.md) - Add a question to a form + - [`gog forms (form) create (new) --title=STRING [flags]`](commands/gog-forms-create.md) - Create a form + - [`gog forms (form) delete-question (delete-q,dq,rm-q) <formId> <index>`](commands/gog-forms-delete-question.md) - Delete a question by index + - [`gog forms (form) get (info,show) <formId>`](commands/gog-forms-get.md) - Get a form + - [`gog forms (form) move-question (move-q,mq) <formId> <oldIndex> <newIndex>`](commands/gog-forms-move-question.md) - Move a question to a new position + - [`gog forms (form) responses <command>`](commands/gog-forms-responses.md) - Form responses + - [`gog forms (form) responses get (info,show) <formId> <responseId>`](commands/gog-forms-responses-get.md) - Get a form response + - [`gog forms (form) responses list (ls) <formId> [flags]`](commands/gog-forms-responses-list.md) - List form responses + - [`gog forms (form) update (edit) <formId> [flags]`](commands/gog-forms-update.md) - Update form title, description, or settings + - [`gog forms (form) watch (watches) <command>`](commands/gog-forms-watch.md) - Response watches (push notifications) + - [`gog forms (form) watch (watches) create (new,add) --topic=STRING <formId> [flags]`](commands/gog-forms-watch-create.md) - Create a watch for new responses + - [`gog forms (form) watch (watches) delete (rm,remove) <formId> <watchId>`](commands/gog-forms-watch-delete.md) - Delete a watch + - [`gog forms (form) watch (watches) list (ls) <formId>`](commands/gog-forms-watch-list.md) - List active watches + - [`gog forms (form) watch (watches) renew (refresh) <formId> <watchId>`](commands/gog-forms-watch-renew.md) - Renew a watch (extends 7 days) + - [`gog gmail (mail,email) <command> [flags]`](commands/gog-gmail.md) - Gmail + - [`gog gmail (mail,email) archive [<messageId> ...] [flags]`](commands/gog-gmail-archive.md) - Archive messages (remove from inbox) + - [`gog gmail (mail,email) attachment <messageId> <attachmentId> [flags]`](commands/gog-gmail-attachment.md) - Download a single attachment + - [`gog gmail (mail,email) autoreply <query> ... [flags]`](commands/gog-gmail-autoreply.md) - Reply once to matching messages + - [`gog gmail (mail,email) batch <command>`](commands/gog-gmail-batch.md) - Batch operations (permanent delete requires broader Gmail scope; use gmail trash for normal trashing) + - [`gog gmail (mail,email) batch delete (rm,del,remove) <messageId> ...`](commands/gog-gmail-batch-delete.md) - Permanently delete multiple messages; use 'gmail trash' to move messages to trash with the default gmail.modify scope + - [`gog gmail (mail,email) batch modify (update,edit,set) <messageId> ... [flags]`](commands/gog-gmail-batch-modify.md) - Modify labels on multiple messages + - [`gog gmail (mail,email) drafts (draft) <command>`](commands/gog-gmail-drafts.md) - Draft operations + - [`gog gmail (mail,email) drafts (draft) create (add,new) [flags]`](commands/gog-gmail-drafts-create.md) - Create a draft + - [`gog gmail (mail,email) drafts (draft) delete (rm,del,remove) <draftId>`](commands/gog-gmail-drafts-delete.md) - Delete a draft + - [`gog gmail (mail,email) drafts (draft) get (info,show) <draftId> [flags]`](commands/gog-gmail-drafts-get.md) - Get draft details + - [`gog gmail (mail,email) drafts (draft) list (ls) [flags]`](commands/gog-gmail-drafts-list.md) - List drafts + - [`gog gmail (mail,email) drafts (draft) send (post) <draftId>`](commands/gog-gmail-drafts-send.md) - Send a draft + - [`gog gmail (mail,email) drafts (draft) update (edit,set) <draftId> [flags]`](commands/gog-gmail-drafts-update.md) - Update a draft + - [`gog gmail (mail,email) forward (fwd) --to=STRING <messageId> [flags]`](commands/gog-gmail-forward.md) - Forward a message to new recipients + - [`gog gmail (mail,email) get (info,show) <messageId> [flags]`](commands/gog-gmail-get.md) - Get a message (full|metadata|raw) + - [`gog gmail (mail,email) history [flags]`](commands/gog-gmail-history.md) - Gmail history + - [`gog gmail (mail,email) labels (label) <command>`](commands/gog-gmail-labels.md) - Label operations + - [`gog gmail (mail,email) labels (label) create (add,new) <name>`](commands/gog-gmail-labels-create.md) - Create a new label + - [`gog gmail (mail,email) labels (label) delete (rm,del) <labelIdOrName>`](commands/gog-gmail-labels-delete.md) - Delete a label + - [`gog gmail (mail,email) labels (label) get (info,show) <labelIdOrName>`](commands/gog-gmail-labels-get.md) - Get label details (including counts) + - [`gog gmail (mail,email) labels (label) list (ls)`](commands/gog-gmail-labels-list.md) - List labels + - [`gog gmail (mail,email) labels (label) modify (update,edit,set) <threadId> ... [flags]`](commands/gog-gmail-labels-modify.md) - Modify labels on threads + - [`gog gmail (mail,email) labels (label) rename (mv) <labelIdOrName> <newName>`](commands/gog-gmail-labels-rename.md) - Rename a label + - [`gog gmail (mail,email) labels (label) style (color,colour) <labelIdOrName> [flags]`](commands/gog-gmail-labels-style.md) - Change a user label color or visibility + - [`gog gmail (mail,email) mark-read (read-messages) [<messageId> ...] [flags]`](commands/gog-gmail-mark-read.md) - Mark messages as read + - [`gog gmail (mail,email) messages (message,msg,msgs) <command>`](commands/gog-gmail-messages.md) - Message operations + - [`gog gmail (mail,email) messages (message,msg,msgs) modify (update,edit,set) <messageId> [flags]`](commands/gog-gmail-messages-modify.md) - Modify labels on a single message + - [`gog gmail (mail,email) messages (message,msg,msgs) search (find,query,ls,list) <query> ... [flags]`](commands/gog-gmail-messages-search.md) - Search messages using Gmail query syntax + - [`gog gmail (mail,email) search (find,query,ls,list) <query> ... [flags]`](commands/gog-gmail-search.md) - Search threads using Gmail query syntax + - [`gog gmail (mail,email) send [flags]`](commands/gog-gmail-send.md) - Send an email + - [`gog gmail (mail,email) settings <command>`](commands/gog-gmail-settings.md) - Settings and admin + - [`gog gmail (mail,email) settings autoforward <command>`](commands/gog-gmail-settings-autoforward.md) - Auto-forwarding settings + - [`gog gmail (mail,email) settings autoforward get (info,show)`](commands/gog-gmail-settings-autoforward-get.md) - Get current auto-forwarding settings + - [`gog gmail (mail,email) settings autoforward update (edit,set) [flags]`](commands/gog-gmail-settings-autoforward-update.md) - Update auto-forwarding settings + - [`gog gmail (mail,email) settings delegates <command>`](commands/gog-gmail-settings-delegates.md) - Delegate operations + - [`gog gmail (mail,email) settings delegates add (create,new) <delegateEmail>`](commands/gog-gmail-settings-delegates-add.md) - Add a delegate + - [`gog gmail (mail,email) settings delegates get (info,show) <delegateEmail>`](commands/gog-gmail-settings-delegates-get.md) - Get a specific delegate's information + - [`gog gmail (mail,email) settings delegates list (ls)`](commands/gog-gmail-settings-delegates-list.md) - List all delegates + - [`gog gmail (mail,email) settings delegates remove (delete,rm,del) <delegateEmail>`](commands/gog-gmail-settings-delegates-remove.md) - Remove a delegate + - [`gog gmail (mail,email) settings filters <command>`](commands/gog-gmail-settings-filters.md) - Filter operations + - [`gog gmail (mail,email) settings filters create (add,new) [flags]`](commands/gog-gmail-settings-filters-create.md) - Create a new email filter + - [`gog gmail (mail,email) settings filters delete (rm,del,remove) <filterId>`](commands/gog-gmail-settings-filters-delete.md) - Delete a filter + - [`gog gmail (mail,email) settings filters export [flags]`](commands/gog-gmail-settings-filters-export.md) - Export filters as JSON + - [`gog gmail (mail,email) settings filters get (info,show) <filterId>`](commands/gog-gmail-settings-filters-get.md) - Get a specific filter + - [`gog gmail (mail,email) settings filters list (ls)`](commands/gog-gmail-settings-filters-list.md) - List all email filters + - [`gog gmail (mail,email) settings forwarding <command>`](commands/gog-gmail-settings-forwarding.md) - Forwarding addresses + - [`gog gmail (mail,email) settings forwarding create (add,new) <forwardingEmail>`](commands/gog-gmail-settings-forwarding-create.md) - Create/add a forwarding address + - [`gog gmail (mail,email) settings forwarding delete (rm,del,remove) <forwardingEmail>`](commands/gog-gmail-settings-forwarding-delete.md) - Delete a forwarding address + - [`gog gmail (mail,email) settings forwarding get (info,show) <forwardingEmail>`](commands/gog-gmail-settings-forwarding-get.md) - Get a specific forwarding address + - [`gog gmail (mail,email) settings forwarding list (ls)`](commands/gog-gmail-settings-forwarding-list.md) - List all forwarding addresses + - [`gog gmail (mail,email) settings sendas <command>`](commands/gog-gmail-settings-sendas.md) - Send-as settings + - [`gog gmail (mail,email) settings sendas create (add,new) <email> [flags]`](commands/gog-gmail-settings-sendas-create.md) - Create a new send-as alias + - [`gog gmail (mail,email) settings sendas delete (rm,del,remove) <email>`](commands/gog-gmail-settings-sendas-delete.md) - Delete a send-as alias + - [`gog gmail (mail,email) settings sendas get (info,show) <email>`](commands/gog-gmail-settings-sendas-get.md) - Get details of a send-as alias + - [`gog gmail (mail,email) settings sendas list (ls)`](commands/gog-gmail-settings-sendas-list.md) - List send-as aliases + - [`gog gmail (mail,email) settings sendas update (edit,set) <email> [flags]`](commands/gog-gmail-settings-sendas-update.md) - Update a send-as alias + - [`gog gmail (mail,email) settings sendas verify (resend) <email>`](commands/gog-gmail-settings-sendas-verify.md) - Resend verification email for a send-as alias + - [`gog gmail (mail,email) settings vacation <command>`](commands/gog-gmail-settings-vacation.md) - Vacation responder + - [`gog gmail (mail,email) settings vacation get (info,show)`](commands/gog-gmail-settings-vacation-get.md) - Get current vacation responder settings + - [`gog gmail (mail,email) settings vacation update (edit,set) [flags]`](commands/gog-gmail-settings-vacation-update.md) - Update vacation responder settings + - [`gog gmail (mail,email) settings watch <command>`](commands/gog-gmail-settings-watch.md) - Manage Gmail watch + - [`gog gmail (mail,email) settings watch renew (update) [flags]`](commands/gog-gmail-settings-watch-renew.md) - Renew Gmail watch using stored config + - [`gog gmail (mail,email) settings watch serve [flags]`](commands/gog-gmail-settings-watch-serve.md) - Run Pub/Sub push handler + - [`gog gmail (mail,email) settings watch start (begin) [flags]`](commands/gog-gmail-settings-watch-start.md) - Start Gmail watch for Pub/Sub + - [`gog gmail (mail,email) settings watch status (ls) [flags]`](commands/gog-gmail-settings-watch-status.md) - Show stored watch state + - [`gog gmail (mail,email) settings watch stop (rm,delete)`](commands/gog-gmail-settings-watch-stop.md) - Stop Gmail watch and clear stored state + - [`gog gmail (mail,email) thread (threads,read) <command>`](commands/gog-gmail-thread.md) - Thread operations (get, modify) + - [`gog gmail (mail,email) thread (threads,read) attachments (files) <threadId> [flags]`](commands/gog-gmail-thread-attachments.md) - List all attachments in a thread + - [`gog gmail (mail,email) thread (threads,read) get (info,show) <threadId> [flags]`](commands/gog-gmail-thread-get.md) - Get a thread with all messages (optionally download attachments) + - [`gog gmail (mail,email) thread (threads,read) modify (update,edit,set) <threadId> [flags]`](commands/gog-gmail-thread-modify.md) - Modify labels on all messages in a thread + - [`gog gmail (mail,email) track <command>`](commands/gog-gmail-track.md) - Email open tracking + - [`gog gmail (mail,email) track key <command>`](commands/gog-gmail-track-key.md) - Manage tracking encryption keys + - [`gog gmail (mail,email) track key rotate [flags]`](commands/gog-gmail-track-key-rotate.md) - Rotate tracking encryption key + - [`gog gmail (mail,email) track opens [<tracking-id>] [flags]`](commands/gog-gmail-track-opens.md) - Query email opens + - [`gog gmail (mail,email) track setup [flags]`](commands/gog-gmail-track-setup.md) - Set up email tracking (deploy Cloudflare Worker) + - [`gog gmail (mail,email) track status`](commands/gog-gmail-track-status.md) - Show tracking configuration status + - [`gog gmail (mail,email) trash [<messageId> ...] [flags]`](commands/gog-gmail-trash.md) - Move messages to trash + - [`gog gmail (mail,email) unread (mark-unread) [<messageId> ...] [flags]`](commands/gog-gmail-unread.md) - Mark messages as unread + - [`gog gmail (mail,email) url <threadId> ...`](commands/gog-gmail-url.md) - Print Gmail web URLs for threads + - [`gog groups (group) <command> [flags]`](commands/gog-groups.md) - Google Groups + - [`gog groups (group) list (ls) [flags]`](commands/gog-groups-list.md) - List groups you belong to + - [`gog groups (group) members <groupEmail> [flags]`](commands/gog-groups-members.md) - List members of a group + - [`gog keep <command> [flags]`](commands/gog-keep.md) - Google Keep (Workspace only) + - [`gog keep attachment <attachmentName> [flags]`](commands/gog-keep-attachment.md) - Download an attachment + - [`gog keep create [flags]`](commands/gog-keep-create.md) - Create a new note + - [`gog keep delete <noteId> [flags]`](commands/gog-keep-delete.md) - Delete a note + - [`gog keep get <noteId> [flags]`](commands/gog-keep-get.md) - Get a note + - [`gog keep list [flags]`](commands/gog-keep-list.md) - List notes + - [`gog keep search <query> [flags]`](commands/gog-keep-search.md) - Search notes by text (client-side) + - [`gog login <email> [flags]`](commands/gog-login.md) - Authorize and store a refresh token (alias for 'auth add') + - [`gog logout <email> [flags]`](commands/gog-logout.md) - Remove a stored refresh token (alias for 'auth remove') + - [`gog ls (list) [flags]`](commands/gog-ls.md) - List Drive files (alias for 'drive ls') + - [`gog me [flags]`](commands/gog-me.md) - Show your profile (alias for 'people me') + - [`gog open (browse) <target> [flags]`](commands/gog-open.md) - Print a best-effort web URL for a Google URL/ID (offline) + - [`gog people (person) <command> [flags]`](commands/gog-people.md) - Google People + - [`gog people (person) get (info,show) <userId>`](commands/gog-people-get.md) - Get a user profile by ID + - [`gog people (person) me`](commands/gog-people-me.md) - Show your profile (people/me) + - [`gog people (person) relations [<userId>] [flags]`](commands/gog-people-relations.md) - Get user relations + - [`gog people (person) search (find,query) <query> ... [flags]`](commands/gog-people-search.md) - Search the Workspace directory + - [`gog schema (help-json,helpjson) [<command> ...] [flags]`](commands/gog-schema.md) - Machine-readable command/flag schema + - [`gog search (find) <query> ... [flags]`](commands/gog-search.md) - Search Drive files (alias for 'drive search') + - [`gog send [flags]`](commands/gog-send.md) - Send an email (alias for 'gmail send') + - [`gog sheets (sheet) <command> [flags]`](commands/gog-sheets.md) - Google Sheets + - [`gog sheets (sheet) add-tab (add-sheet) <spreadsheetId> <tabName> [flags]`](commands/gog-sheets-add-tab.md) - Add a new tab/sheet to a spreadsheet + - [`gog sheets (sheet) append (add) <spreadsheetId> <range> [<values> ...] [flags]`](commands/gog-sheets-append.md) - Append values to a range + - [`gog sheets (sheet) chart (charts) <command>`](commands/gog-sheets-chart.md) - Manage spreadsheet charts + - [`gog sheets (sheet) chart (charts) create (add,new) --spec-json=STRING <spreadsheetId> [flags]`](commands/gog-sheets-chart-create.md) - Create a chart from a JSON spec + - [`gog sheets (sheet) chart (charts) delete (rm,remove,del) <spreadsheetId> <chartId>`](commands/gog-sheets-chart-delete.md) - Delete a chart + - [`gog sheets (sheet) chart (charts) get (show,info) <spreadsheetId> <chartId>`](commands/gog-sheets-chart-get.md) - Get full chart definition (spec + position) + - [`gog sheets (sheet) chart (charts) list <spreadsheetId>`](commands/gog-sheets-chart-list.md) - List charts in a spreadsheet + - [`gog sheets (sheet) chart (charts) update (edit,set) --spec-json=STRING <spreadsheetId> <chartId>`](commands/gog-sheets-chart-update.md) - Update a chart spec + - [`gog sheets (sheet) clear <spreadsheetId> <range>`](commands/gog-sheets-clear.md) - Clear values in a range + - [`gog sheets (sheet) copy (cp,duplicate) <spreadsheetId> <title> [flags]`](commands/gog-sheets-copy.md) - Copy a Google Sheet + - [`gog sheets (sheet) create (new) <title> [flags]`](commands/gog-sheets-create.md) - Create a new spreadsheet + - [`gog sheets (sheet) delete-tab (delete-sheet) <spreadsheetId> <tabName>`](commands/gog-sheets-delete-tab.md) - Delete a tab/sheet from a spreadsheet (use --force to skip confirmation) + - [`gog sheets (sheet) export (download,dl) <spreadsheetId> [flags]`](commands/gog-sheets-export.md) - Export a Google Sheet (pdf|xlsx|csv) via Drive + - [`gog sheets (sheet) find-replace <spreadsheetId> <find> <replace> [flags]`](commands/gog-sheets-find-replace.md) - Find and replace text across a spreadsheet + - [`gog sheets (sheet) format <spreadsheetId> <range> [flags]`](commands/gog-sheets-format.md) - Apply cell formatting to a range + - [`gog sheets (sheet) freeze <spreadsheetId> [flags]`](commands/gog-sheets-freeze.md) - Freeze rows and columns on a sheet + - [`gog sheets (sheet) get (read,show) <spreadsheetId> <range> [flags]`](commands/gog-sheets-get.md) - Get values from a range + - [`gog sheets (sheet) insert <spreadsheetId> <sheet> <dimension> <start> [flags]`](commands/gog-sheets-insert.md) - Insert empty rows or columns into a sheet + - [`gog sheets (sheet) links (hyperlinks) <spreadsheetId> <range>`](commands/gog-sheets-links.md) - Get cell hyperlinks from a range + - [`gog sheets (sheet) merge <spreadsheetId> <range> [flags]`](commands/gog-sheets-merge.md) - Merge cells in a range + - [`gog sheets (sheet) metadata (info) <spreadsheetId>`](commands/gog-sheets-metadata.md) - Get spreadsheet metadata + - [`gog sheets (sheet) named-ranges (namedranges,nr) <command>`](commands/gog-sheets-named-ranges.md) - Manage named ranges + - [`gog sheets (sheet) named-ranges (namedranges,nr) add (create,new) <spreadsheetId> <name> <range>`](commands/gog-sheets-named-ranges-add.md) - Add a named range + - [`gog sheets (sheet) named-ranges (namedranges,nr) delete (rm,remove,del) <spreadsheetId> <nameOrId>`](commands/gog-sheets-named-ranges-delete.md) - Delete a named range + - [`gog sheets (sheet) named-ranges (namedranges,nr) get (show,info) <spreadsheetId> <nameOrId>`](commands/gog-sheets-named-ranges-get.md) - Get a named range + - [`gog sheets (sheet) named-ranges (namedranges,nr) list <spreadsheetId>`](commands/gog-sheets-named-ranges-list.md) - List named ranges + - [`gog sheets (sheet) named-ranges (namedranges,nr) update (edit,set) <spreadsheetId> <nameOrId> [flags]`](commands/gog-sheets-named-ranges-update.md) - Update a named range + - [`gog sheets (sheet) notes <spreadsheetId> <range>`](commands/gog-sheets-notes.md) - Get cell notes from a range + - [`gog sheets (sheet) number-format <spreadsheetId> <range> [flags]`](commands/gog-sheets-number-format.md) - Apply number format to a range + - [`gog sheets (sheet) read-format (get-format,format-read) <spreadsheetId> <range> [flags]`](commands/gog-sheets-read-format.md) - Read cell formatting from a range + - [`gog sheets (sheet) rename-tab (rename-sheet) <spreadsheetId> <oldName> <newName>`](commands/gog-sheets-rename-tab.md) - Rename a tab/sheet in a spreadsheet + - [`gog sheets (sheet) resize-columns <spreadsheetId> <columns> [flags]`](commands/gog-sheets-resize-columns.md) - Resize sheet columns + - [`gog sheets (sheet) resize-rows <spreadsheetId> <rows> [flags]`](commands/gog-sheets-resize-rows.md) - Resize sheet rows + - [`gog sheets (sheet) unmerge <spreadsheetId> <range>`](commands/gog-sheets-unmerge.md) - Unmerge cells in a range + - [`gog sheets (sheet) update (edit,set) <spreadsheetId> <range> [<values> ...] [flags]`](commands/gog-sheets-update.md) - Update values in a range + - [`gog sheets (sheet) update-note (set-note) <spreadsheetId> <range> [flags]`](commands/gog-sheets-update-note.md) - Set or clear a cell note + - [`gog slides (slide) <command> [flags]`](commands/gog-slides.md) - Google Slides + - [`gog slides (slide) add-slide <presentationId> <image> [flags]`](commands/gog-slides-add-slide.md) - Add a slide with a full-bleed image and optional speaker notes + - [`gog slides (slide) copy (cp,duplicate) <presentationId> <title> [flags]`](commands/gog-slides-copy.md) - Copy a Google Slides presentation + - [`gog slides (slide) create (add,new) <title> [flags]`](commands/gog-slides-create.md) - Create a Google Slides presentation + - [`gog slides (slide) create-from-markdown <title> [flags]`](commands/gog-slides-create-from-markdown.md) - Create a Google Slides presentation from markdown + - [`gog slides (slide) create-from-template <templateId> <title> [flags]`](commands/gog-slides-create-from-template.md) - Create a presentation from template with text replacements + - [`gog slides (slide) delete-slide <presentationId> <slideId>`](commands/gog-slides-delete-slide.md) - Delete a slide by object ID + - [`gog slides (slide) export (download,dl) <presentationId> [flags]`](commands/gog-slides-export.md) - Export a Google Slides deck (pdf|pptx) + - [`gog slides (slide) info (get,show) <presentationId>`](commands/gog-slides-info.md) - Get Google Slides presentation metadata + - [`gog slides (slide) insert-text <presentationId> <objectId> <text> [flags]`](commands/gog-slides-insert-text.md) - Insert text into an existing page element (shape or table) by objectId + - [`gog slides (slide) list-slides <presentationId>`](commands/gog-slides-list-slides.md) - List all slides with their object IDs + - [`gog slides (slide) read-slide <presentationId> <slideId>`](commands/gog-slides-read-slide.md) - Read slide content: speaker notes, text elements, and images + - [`gog slides (slide) replace-slide <presentationId> <slideId> <image> [flags]`](commands/gog-slides-replace-slide.md) - Replace the image on an existing slide in-place + - [`gog slides (slide) replace-text <presentationId> <find> <replacement> [flags]`](commands/gog-slides-replace-text.md) - Find-and-replace text across a presentation + - [`gog slides (slide) thumbnail (thumb) <presentationId> <slideId> [flags]`](commands/gog-slides-thumbnail.md) - Get or download a rendered thumbnail for a slide + - [`gog slides (slide) update-notes <presentationId> <slideId> [flags]`](commands/gog-slides-update-notes.md) - Update speaker notes on an existing slide + - [`gog status (st) [flags]`](commands/gog-status.md) - Show auth/config status (alias for 'auth status') + - [`gog tasks (task) <command> [flags]`](commands/gog-tasks.md) - Google Tasks + - [`gog tasks (task) add (create) <tasklistId> [flags]`](commands/gog-tasks-add.md) - Add a task + - [`gog tasks (task) clear <tasklistId>`](commands/gog-tasks-clear.md) - Clear completed tasks + - [`gog tasks (task) delete (rm,del,remove) <tasklistId> <taskId>`](commands/gog-tasks-delete.md) - Delete a task + - [`gog tasks (task) done (complete) <tasklistId> <taskId>`](commands/gog-tasks-done.md) - Mark task completed + - [`gog tasks (task) get (info,show) <tasklistId> <taskId>`](commands/gog-tasks-get.md) - Get a task + - [`gog tasks (task) list (ls) <tasklistId> [flags]`](commands/gog-tasks-list.md) - List tasks + - [`gog tasks (task) lists <command>`](commands/gog-tasks-lists.md) - List task lists + - [`gog tasks (task) lists create (add,new) <title> ...`](commands/gog-tasks-lists-create.md) - Create a task list + - [`gog tasks (task) lists list [flags]`](commands/gog-tasks-lists-list.md) - List task lists + - [`gog tasks (task) undo (uncomplete,undone) <tasklistId> <taskId>`](commands/gog-tasks-undo.md) - Mark task needs action + - [`gog tasks (task) update (edit,set) <tasklistId> <taskId> [flags]`](commands/gog-tasks-update.md) - Update a task + - [`gog time <command> [flags]`](commands/gog-time.md) - Local time utilities + - [`gog time now [flags]`](commands/gog-time-now.md) - Show current time + - [`gog upload (up,put) <localPath> [flags]`](commands/gog-upload.md) - Upload a file to Drive (alias for 'drive upload') + - [`gog version [flags]`](commands/gog-version.md) - Print version + - [`gog whoami (who-am-i) [flags]`](commands/gog-whoami.md) - Show your profile (alias for 'people me') diff --git a/docs/commands/README.md b/docs/commands/README.md new file mode 100644 index 0000000..685b9e7 --- /dev/null +++ b/docs/commands/README.md @@ -0,0 +1,487 @@ +# Commands + +Every `gog` command has a generated docs page. The source of truth is the live CLI schema; run `make docs-commands` after changing command names, flags, help text, aliases, or arguments. + +Generated pages: 440. + +## Top-level Commands + +- [gog admin](gog-admin.md) - Google Workspace Admin (Directory API) - requires domain-wide delegation +- [gog agent](gog-agent.md) - Agent-friendly helpers +- [gog appscript](gog-appscript.md) - Google Apps Script +- [gog auth](gog-auth.md) - Auth and credentials +- [gog backup](gog-backup.md) - Encrypted Google account backups +- [gog calendar](gog-calendar.md) - Google Calendar +- [gog chat](gog-chat.md) - Google Chat +- [gog classroom](gog-classroom.md) - Google Classroom +- [gog completion](gog-completion.md) - Generate shell completion scripts +- [gog config](gog-config.md) - Manage configuration +- [gog contacts](gog-contacts.md) - Google Contacts +- [gog docs](gog-docs.md) - Google Docs (export via Drive) +- [gog download](gog-download.md) - Download a Drive file (alias for 'drive download') +- [gog drive](gog-drive.md) - Google Drive +- [gog exit-codes](gog-exit-codes.md) - Print stable exit codes (alias for 'agent exit-codes') +- [gog forms](gog-forms.md) - Google Forms +- [gog gmail](gog-gmail.md) - Gmail +- [gog groups](gog-groups.md) - Google Groups +- [gog keep](gog-keep.md) - Google Keep (Workspace only) +- [gog login](gog-login.md) - Authorize and store a refresh token (alias for 'auth add') +- [gog logout](gog-logout.md) - Remove a stored refresh token (alias for 'auth remove') +- [gog ls](gog-ls.md) - List Drive files (alias for 'drive ls') +- [gog me](gog-me.md) - Show your profile (alias for 'people me') +- [gog open](gog-open.md) - Print a best-effort web URL for a Google URL/ID (offline) +- [gog people](gog-people.md) - Google People +- [gog schema](gog-schema.md) - Machine-readable command/flag schema +- [gog search](gog-search.md) - Search Drive files (alias for 'drive search') +- [gog send](gog-send.md) - Send an email (alias for 'gmail send') +- [gog sheets](gog-sheets.md) - Google Sheets +- [gog slides](gog-slides.md) - Google Slides +- [gog status](gog-status.md) - Show auth/config status (alias for 'auth status') +- [gog tasks](gog-tasks.md) - Google Tasks +- [gog time](gog-time.md) - Local time utilities +- [gog upload](gog-upload.md) - Upload a file to Drive (alias for 'drive upload') +- [gog version](gog-version.md) - Print version +- [gog whoami](gog-whoami.md) - Show your profile (alias for 'people me') + +## All Commands + +- [gog](gog.md) - Google CLI for Gmail/Calendar/Chat/Classroom/Drive/Contacts/Tasks/Sheets/Docs/Slides/People/Forms/App Script/Ads/Groups/Admin/Keep + - [gog admin](gog-admin.md) - Google Workspace Admin (Directory API) - requires domain-wide delegation + - [gog admin groups](gog-admin-groups.md) - Manage Workspace groups + - [gog admin groups list](gog-admin-groups-list.md) - List groups in a domain + - [gog admin groups members](gog-admin-groups-members.md) - Manage group members + - [gog admin groups members add](gog-admin-groups-members-add.md) - Add a member to a group + - [gog admin groups members list](gog-admin-groups-members-list.md) - List group members + - [gog admin groups members remove](gog-admin-groups-members-remove.md) - Remove a member from a group + - [gog admin users](gog-admin-users.md) - Manage Workspace users + - [gog admin users create](gog-admin-users-create.md) - Create a new user + - [gog admin users get](gog-admin-users-get.md) - Get user details + - [gog admin users list](gog-admin-users-list.md) - List users in a domain + - [gog admin users suspend](gog-admin-users-suspend.md) - Suspend a user account + - [gog agent](gog-agent.md) - Agent-friendly helpers + - [gog agent exit-codes](gog-agent-exit-codes.md) - Print stable exit codes for automation + - [gog appscript](gog-appscript.md) - Google Apps Script + - [gog appscript content](gog-appscript-content.md) - Get Apps Script project content + - [gog appscript create](gog-appscript-create.md) - Create an Apps Script project + - [gog appscript get](gog-appscript-get.md) - Get Apps Script project metadata + - [gog appscript run](gog-appscript-run.md) - Run a deployed Apps Script function + - [gog auth](gog-auth.md) - Auth and credentials + - [gog auth add](gog-auth-add.md) - Authorize and store a refresh token + - [gog auth alias](gog-auth-alias.md) - Manage account aliases + - [gog auth alias list](gog-auth-alias-list.md) - List account aliases + - [gog auth alias set](gog-auth-alias-set.md) - Set an account alias + - [gog auth alias unset](gog-auth-alias-unset.md) - Remove an account alias + - [gog auth credentials](gog-auth-credentials.md) - Manage OAuth client credentials + - [gog auth credentials list](gog-auth-credentials-list.md) - List stored OAuth client credentials + - [gog auth credentials remove](gog-auth-credentials-remove.md) - Remove stored OAuth client credentials + - [gog auth credentials set](gog-auth-credentials-set.md) - Store OAuth client credentials + - [gog auth doctor](gog-auth-doctor.md) - Diagnose auth, keyring, and refresh-token issues + - [gog auth keep](gog-auth-keep.md) - Configure service account for Google Keep (Workspace only) + - [gog auth keyring](gog-auth-keyring.md) - Configure keyring backend + - [gog auth list](gog-auth-list.md) - List stored accounts + - [gog auth manage](gog-auth-manage.md) - Open accounts manager in browser + - [gog auth remove](gog-auth-remove.md) - Remove a stored refresh token + - [gog auth service-account](gog-auth-service-account.md) - Configure service account (Workspace only; domain-wide delegation) + - [gog auth service-account set](gog-auth-service-account-set.md) - Store a service account key for impersonation + - [gog auth service-account status](gog-auth-service-account-status.md) - Show stored service account key status + - [gog auth service-account unset](gog-auth-service-account-unset.md) - Remove stored service account key + - [gog auth services](gog-auth-services.md) - List supported auth services and scopes + - [gog auth status](gog-auth-status.md) - Show auth configuration and keyring backend + - [gog auth tokens](gog-auth-tokens.md) - Manage stored refresh tokens + - [gog auth tokens delete](gog-auth-tokens-delete.md) - Delete a stored refresh token + - [gog auth tokens export](gog-auth-tokens-export.md) - Export a refresh token to a file (contains secrets) + - [gog auth tokens import](gog-auth-tokens-import.md) - Import a refresh token file into keyring (contains secrets) + - [gog auth tokens list](gog-auth-tokens-list.md) - List stored tokens (by key only) + - [gog backup](gog-backup.md) - Encrypted Google account backups + - [gog backup cat](gog-backup-cat.md) - Decrypt one backup shard to stdout + - [gog backup export](gog-backup-export.md) - Write a local plaintext export + - [gog backup gmail](gog-backup-gmail.md) - Gmail backup operations + - [gog backup gmail push](gog-backup-gmail-push.md) - Export Gmail into encrypted backup shards + - [gog backup init](gog-backup-init.md) - Initialize encrypted backup config and repository + - [gog backup push](gog-backup-push.md) - Export services into encrypted backup shards + - [gog backup status](gog-backup-status.md) - Inspect backup manifest without decrypting shards + - [gog backup verify](gog-backup-verify.md) - Decrypt and verify all backup shards + - [gog calendar](gog-calendar.md) - Google Calendar + - [gog calendar acl](gog-calendar-acl.md) - List calendar ACL + - [gog calendar alias](gog-calendar-alias.md) - Manage calendar aliases + - [gog calendar alias list](gog-calendar-alias-list.md) - List calendar aliases + - [gog calendar alias set](gog-calendar-alias-set.md) - Set a calendar alias + - [gog calendar alias unset](gog-calendar-alias-unset.md) - Remove a calendar alias + - [gog calendar calendars](gog-calendar-calendars.md) - List calendars + - [gog calendar colors](gog-calendar-colors.md) - Show calendar colors + - [gog calendar conflicts](gog-calendar-conflicts.md) - Find conflicts + - [gog calendar create](gog-calendar-create.md) - Create an event + - [gog calendar create-calendar](gog-calendar-create-calendar.md) - Create a new secondary calendar + - [gog calendar delete](gog-calendar-delete.md) - Delete an event + - [gog calendar event](gog-calendar-event.md) - Get event + - [gog calendar events](gog-calendar-events.md) - List events from a calendar or all calendars + - [gog calendar focus-time](gog-calendar-focus-time.md) - Create a Focus Time block + - [gog calendar freebusy](gog-calendar-freebusy.md) - Get free/busy + - [gog calendar move](gog-calendar-move.md) - Move an event to another calendar + - [gog calendar out-of-office](gog-calendar-out-of-office.md) - Create an Out of Office event + - [gog calendar propose-time](gog-calendar-propose-time.md) - Generate URL to propose a new meeting time (browser-only feature) + - [gog calendar respond](gog-calendar-respond.md) - Respond to an event invitation + - [gog calendar search](gog-calendar-search.md) - Search events + - [gog calendar subscribe](gog-calendar-subscribe.md) - Add a calendar to your calendar list + - [gog calendar team](gog-calendar-team.md) - Show events for all members of a Google Group + - [gog calendar time](gog-calendar-time.md) - Show server time + - [gog calendar update](gog-calendar-update.md) - Update an event + - [gog calendar users](gog-calendar-users.md) - List workspace users (use their email as calendar ID) + - [gog calendar working-location](gog-calendar-working-location.md) - Set working location (home/office/custom) + - [gog chat](gog-chat.md) - Google Chat + - [gog chat dm](gog-chat-dm.md) - Direct messages + - [gog chat dm send](gog-chat-dm-send.md) - Send a direct message + - [gog chat dm space](gog-chat-dm-space.md) - Find or create a DM space + - [gog chat messages](gog-chat-messages.md) - Chat messages + - [gog chat messages list](gog-chat-messages-list.md) - List messages + - [gog chat messages react](gog-chat-messages-react.md) - Add an emoji reaction to a message + - [gog chat messages reactions](gog-chat-messages-reactions.md) - Manage emoji reactions on a message + - [gog chat messages reactions create](gog-chat-messages-reactions-create.md) - Add an emoji reaction to a message + - [gog chat messages reactions delete](gog-chat-messages-reactions-delete.md) - Delete a reaction + - [gog chat messages reactions list](gog-chat-messages-reactions-list.md) - List reactions on a message + - [gog chat messages send](gog-chat-messages-send.md) - Send a message + - [gog chat spaces](gog-chat-spaces.md) - Chat spaces + - [gog chat spaces create](gog-chat-spaces-create.md) - Create a space + - [gog chat spaces find](gog-chat-spaces-find.md) - Find spaces by display name + - [gog chat spaces list](gog-chat-spaces-list.md) - List spaces + - [gog chat threads](gog-chat-threads.md) - Chat threads + - [gog chat threads list](gog-chat-threads-list.md) - List threads in a space + - [gog classroom](gog-classroom.md) - Google Classroom + - [gog classroom announcements](gog-classroom-announcements.md) - Announcements + - [gog classroom announcements assignees](gog-classroom-announcements-assignees.md) - Modify announcement assignees + - [gog classroom announcements create](gog-classroom-announcements-create.md) - Create an announcement + - [gog classroom announcements delete](gog-classroom-announcements-delete.md) - Delete an announcement + - [gog classroom announcements get](gog-classroom-announcements-get.md) - Get an announcement + - [gog classroom announcements list](gog-classroom-announcements-list.md) - List announcements + - [gog classroom announcements update](gog-classroom-announcements-update.md) - Update an announcement + - [gog classroom courses](gog-classroom-courses.md) - Courses + - [gog classroom courses archive](gog-classroom-courses-archive.md) - Archive a course + - [gog classroom courses create](gog-classroom-courses-create.md) - Create a course + - [gog classroom courses delete](gog-classroom-courses-delete.md) - Delete a course + - [gog classroom courses get](gog-classroom-courses-get.md) - Get a course + - [gog classroom courses join](gog-classroom-courses-join.md) - Join a course + - [gog classroom courses leave](gog-classroom-courses-leave.md) - Leave a course + - [gog classroom courses list](gog-classroom-courses-list.md) - List courses + - [gog classroom courses unarchive](gog-classroom-courses-unarchive.md) - Unarchive a course + - [gog classroom courses update](gog-classroom-courses-update.md) - Update a course + - [gog classroom courses url](gog-classroom-courses-url.md) - Print Classroom web URLs for courses + - [gog classroom coursework](gog-classroom-coursework.md) - Coursework + - [gog classroom coursework assignees](gog-classroom-coursework-assignees.md) - Modify coursework assignees + - [gog classroom coursework create](gog-classroom-coursework-create.md) - Create coursework + - [gog classroom coursework delete](gog-classroom-coursework-delete.md) - Delete coursework + - [gog classroom coursework get](gog-classroom-coursework-get.md) - Get coursework + - [gog classroom coursework list](gog-classroom-coursework-list.md) - List coursework + - [gog classroom coursework update](gog-classroom-coursework-update.md) - Update coursework + - [gog classroom guardian-invitations](gog-classroom-guardian-invitations.md) - Guardian invitations + - [gog classroom guardian-invitations create](gog-classroom-guardian-invitations-create.md) - Create a guardian invitation + - [gog classroom guardian-invitations get](gog-classroom-guardian-invitations-get.md) - Get a guardian invitation + - [gog classroom guardian-invitations list](gog-classroom-guardian-invitations-list.md) - List guardian invitations + - [gog classroom guardians](gog-classroom-guardians.md) - Guardians + - [gog classroom guardians delete](gog-classroom-guardians-delete.md) - Delete a guardian + - [gog classroom guardians get](gog-classroom-guardians-get.md) - Get a guardian + - [gog classroom guardians list](gog-classroom-guardians-list.md) - List guardians + - [gog classroom invitations](gog-classroom-invitations.md) - Invitations + - [gog classroom invitations accept](gog-classroom-invitations-accept.md) - Accept an invitation + - [gog classroom invitations create](gog-classroom-invitations-create.md) - Create an invitation + - [gog classroom invitations delete](gog-classroom-invitations-delete.md) - Delete an invitation + - [gog classroom invitations get](gog-classroom-invitations-get.md) - Get an invitation + - [gog classroom invitations list](gog-classroom-invitations-list.md) - List invitations + - [gog classroom materials](gog-classroom-materials.md) - Coursework materials + - [gog classroom materials create](gog-classroom-materials-create.md) - Create coursework material + - [gog classroom materials delete](gog-classroom-materials-delete.md) - Delete coursework material + - [gog classroom materials get](gog-classroom-materials-get.md) - Get coursework material + - [gog classroom materials list](gog-classroom-materials-list.md) - List coursework materials + - [gog classroom materials update](gog-classroom-materials-update.md) - Update coursework material + - [gog classroom profile](gog-classroom-profile.md) - User profiles + - [gog classroom profile get](gog-classroom-profile-get.md) - Get a user profile + - [gog classroom roster](gog-classroom-roster.md) - Course roster (students + teachers) + - [gog classroom students](gog-classroom-students.md) - Course students + - [gog classroom students add](gog-classroom-students-add.md) - Add a student + - [gog classroom students get](gog-classroom-students-get.md) - Get a student + - [gog classroom students list](gog-classroom-students-list.md) - List students + - [gog classroom students remove](gog-classroom-students-remove.md) - Remove a student + - [gog classroom submissions](gog-classroom-submissions.md) - Student submissions + - [gog classroom submissions get](gog-classroom-submissions-get.md) - Get a student submission + - [gog classroom submissions grade](gog-classroom-submissions-grade.md) - Set draft/assigned grades + - [gog classroom submissions list](gog-classroom-submissions-list.md) - List student submissions + - [gog classroom submissions reclaim](gog-classroom-submissions-reclaim.md) - Reclaim a submission + - [gog classroom submissions return](gog-classroom-submissions-return.md) - Return a submission + - [gog classroom submissions turn-in](gog-classroom-submissions-turn-in.md) - Turn in a submission + - [gog classroom teachers](gog-classroom-teachers.md) - Course teachers + - [gog classroom teachers add](gog-classroom-teachers-add.md) - Add a teacher + - [gog classroom teachers get](gog-classroom-teachers-get.md) - Get a teacher + - [gog classroom teachers list](gog-classroom-teachers-list.md) - List teachers + - [gog classroom teachers remove](gog-classroom-teachers-remove.md) - Remove a teacher + - [gog classroom topics](gog-classroom-topics.md) - Topics + - [gog classroom topics create](gog-classroom-topics-create.md) - Create a topic + - [gog classroom topics delete](gog-classroom-topics-delete.md) - Delete a topic + - [gog classroom topics get](gog-classroom-topics-get.md) - Get a topic + - [gog classroom topics list](gog-classroom-topics-list.md) - List topics + - [gog classroom topics update](gog-classroom-topics-update.md) - Update a topic + - [gog completion](gog-completion.md) - Generate shell completion scripts + - [gog config](gog-config.md) - Manage configuration + - [gog config get](gog-config-get.md) - Get a config value + - [gog config keys](gog-config-keys.md) - List available config keys + - [gog config list](gog-config-list.md) - List all config values + - [gog config no-send](gog-config-no-send.md) - Manage per-account Gmail no-send guards + - [gog config no-send list](gog-config-no-send-list.md) - List accounts with no-send guards + - [gog config no-send remove](gog-config-no-send-remove.md) - Remove an account no-send guard + - [gog config no-send set](gog-config-no-send-set.md) - Block Gmail send operations for an account + - [gog config path](gog-config-path.md) - Print config file path + - [gog config set](gog-config-set.md) - Set a config value + - [gog config unset](gog-config-unset.md) - Unset a config value + - [gog contacts](gog-contacts.md) - Google Contacts + - [gog contacts create](gog-contacts-create.md) - Create a contact + - [gog contacts delete](gog-contacts-delete.md) - Delete a contact + - [gog contacts directory](gog-contacts-directory.md) - Directory contacts + - [gog contacts directory list](gog-contacts-directory-list.md) - List people from the Workspace directory + - [gog contacts directory search](gog-contacts-directory-search.md) - Search people in the Workspace directory + - [gog contacts export](gog-contacts-export.md) - Export contacts as vCard (.vcf) + - [gog contacts get](gog-contacts-get.md) - Get a contact + - [gog contacts list](gog-contacts-list.md) - List contacts + - [gog contacts other](gog-contacts-other.md) - Other contacts + - [gog contacts other delete](gog-contacts-other-delete.md) - Delete an other contact + - [gog contacts other list](gog-contacts-other-list.md) - List other contacts + - [gog contacts other search](gog-contacts-other-search.md) - Search other contacts + - [gog contacts search](gog-contacts-search.md) - Search contacts by name/email/phone + - [gog contacts update](gog-contacts-update.md) - Update a contact + - [gog docs](gog-docs.md) - Google Docs (export via Drive) + - [gog docs add-tab](gog-docs-add-tab.md) - Add a tab to a Google Doc + - [gog docs cat](gog-docs-cat.md) - Print a Google Doc as plain text + - [gog docs clear](gog-docs-clear.md) - Clear all content from a Google Doc + - [gog docs comments](gog-docs-comments.md) - Manage comments on files + - [gog docs comments add](gog-docs-comments-add.md) - Add a comment to a Google Doc + - [gog docs comments delete](gog-docs-comments-delete.md) - Delete a comment + - [gog docs comments get](gog-docs-comments-get.md) - Get a comment by ID + - [gog docs comments list](gog-docs-comments-list.md) - List comments on a Google Doc + - [gog docs comments reply](gog-docs-comments-reply.md) - Reply to a comment + - [gog docs comments resolve](gog-docs-comments-resolve.md) - Resolve a comment (mark as done) + - [gog docs copy](gog-docs-copy.md) - Copy a Google Doc + - [gog docs create](gog-docs-create.md) - Create a Google Doc + - [gog docs delete](gog-docs-delete.md) - Delete text range from document + - [gog docs delete-tab](gog-docs-delete-tab.md) - Delete a tab from a Google Doc + - [gog docs edit](gog-docs-edit.md) - Find and replace text in a Google Doc + - [gog docs export](gog-docs-export.md) - Export a Google Doc (pdf|docx|txt|md|html) + - [gog docs find-replace](gog-docs-find-replace.md) - Find and replace text. Supports plain text or markdown with images; use --first for a single occurrence. + - [gog docs info](gog-docs-info.md) - Get Google Doc metadata + - [gog docs insert](gog-docs-insert.md) - Insert text at a specific position + - [gog docs list-tabs](gog-docs-list-tabs.md) - List all tabs in a Google Doc + - [gog docs rename-tab](gog-docs-rename-tab.md) - Rename a tab in a Google Doc + - [gog docs sed](gog-docs-sed.md) - Regex find/replace (sed-style: s/pattern/replacement/g) + - [gog docs structure](gog-docs-structure.md) - Show document structure with numbered paragraphs + - [gog docs update](gog-docs-update.md) - Insert text at a specific index in a Google Doc + - [gog docs write](gog-docs-write.md) - Write content to a Google Doc + - [gog download](gog-download.md) - Download a Drive file (alias for 'drive download') + - [gog drive](gog-drive.md) - Google Drive + - [gog drive comments](gog-drive-comments.md) - Manage comments on files + - [gog drive comments create](gog-drive-comments-create.md) - Create a comment on a file + - [gog drive comments delete](gog-drive-comments-delete.md) - Delete a comment + - [gog drive comments get](gog-drive-comments-get.md) - Get a comment by ID + - [gog drive comments list](gog-drive-comments-list.md) - List comments on a file + - [gog drive comments reply](gog-drive-comments-reply.md) - Reply to a comment + - [gog drive comments update](gog-drive-comments-update.md) - Update a comment + - [gog drive copy](gog-drive-copy.md) - Copy a file + - [gog drive delete](gog-drive-delete.md) - Move a file to trash (use --permanent to delete forever) + - [gog drive download](gog-drive-download.md) - Download a file (exports Google Docs formats) + - [gog drive drives](gog-drive-drives.md) - List shared drives (Team Drives) + - [gog drive get](gog-drive-get.md) - Get file metadata + - [gog drive ls](gog-drive-ls.md) - List files in a folder (default: root) + - [gog drive mkdir](gog-drive-mkdir.md) - Create a folder + - [gog drive move](gog-drive-move.md) - Move a file to a different folder + - [gog drive permissions](gog-drive-permissions.md) - List permissions on a file + - [gog drive rename](gog-drive-rename.md) - Rename a file or folder + - [gog drive search](gog-drive-search.md) - Full-text search across Drive + - [gog drive share](gog-drive-share.md) - Share a file or folder + - [gog drive unshare](gog-drive-unshare.md) - Remove a permission from a file + - [gog drive upload](gog-drive-upload.md) - Upload a file + - [gog drive url](gog-drive-url.md) - Print web URLs for files + - [gog exit-codes](gog-exit-codes.md) - Print stable exit codes (alias for 'agent exit-codes') + - [gog forms](gog-forms.md) - Google Forms + - [gog forms add-question](gog-forms-add-question.md) - Add a question to a form + - [gog forms create](gog-forms-create.md) - Create a form + - [gog forms delete-question](gog-forms-delete-question.md) - Delete a question by index + - [gog forms get](gog-forms-get.md) - Get a form + - [gog forms move-question](gog-forms-move-question.md) - Move a question to a new position + - [gog forms responses](gog-forms-responses.md) - Form responses + - [gog forms responses get](gog-forms-responses-get.md) - Get a form response + - [gog forms responses list](gog-forms-responses-list.md) - List form responses + - [gog forms update](gog-forms-update.md) - Update form title, description, or settings + - [gog forms watch](gog-forms-watch.md) - Response watches (push notifications) + - [gog forms watch create](gog-forms-watch-create.md) - Create a watch for new responses + - [gog forms watch delete](gog-forms-watch-delete.md) - Delete a watch + - [gog forms watch list](gog-forms-watch-list.md) - List active watches + - [gog forms watch renew](gog-forms-watch-renew.md) - Renew a watch (extends 7 days) + - [gog gmail](gog-gmail.md) - Gmail + - [gog gmail archive](gog-gmail-archive.md) - Archive messages (remove from inbox) + - [gog gmail attachment](gog-gmail-attachment.md) - Download a single attachment + - [gog gmail autoreply](gog-gmail-autoreply.md) - Reply once to matching messages + - [gog gmail batch](gog-gmail-batch.md) - Batch operations (permanent delete requires broader Gmail scope; use gmail trash for normal trashing) + - [gog gmail batch delete](gog-gmail-batch-delete.md) - Permanently delete multiple messages; use 'gmail trash' to move messages to trash with the default gmail.modify scope + - [gog gmail batch modify](gog-gmail-batch-modify.md) - Modify labels on multiple messages + - [gog gmail drafts](gog-gmail-drafts.md) - Draft operations + - [gog gmail drafts create](gog-gmail-drafts-create.md) - Create a draft + - [gog gmail drafts delete](gog-gmail-drafts-delete.md) - Delete a draft + - [gog gmail drafts get](gog-gmail-drafts-get.md) - Get draft details + - [gog gmail drafts list](gog-gmail-drafts-list.md) - List drafts + - [gog gmail drafts send](gog-gmail-drafts-send.md) - Send a draft + - [gog gmail drafts update](gog-gmail-drafts-update.md) - Update a draft + - [gog gmail forward](gog-gmail-forward.md) - Forward a message to new recipients + - [gog gmail get](gog-gmail-get.md) - Get a message (full|metadata|raw) + - [gog gmail history](gog-gmail-history.md) - Gmail history + - [gog gmail labels](gog-gmail-labels.md) - Label operations + - [gog gmail labels create](gog-gmail-labels-create.md) - Create a new label + - [gog gmail labels delete](gog-gmail-labels-delete.md) - Delete a label + - [gog gmail labels get](gog-gmail-labels-get.md) - Get label details (including counts) + - [gog gmail labels list](gog-gmail-labels-list.md) - List labels + - [gog gmail labels modify](gog-gmail-labels-modify.md) - Modify labels on threads + - [gog gmail labels rename](gog-gmail-labels-rename.md) - Rename a label + - [gog gmail labels style](gog-gmail-labels-style.md) - Change a user label color or visibility + - [gog gmail mark-read](gog-gmail-mark-read.md) - Mark messages as read + - [gog gmail messages](gog-gmail-messages.md) - Message operations + - [gog gmail messages modify](gog-gmail-messages-modify.md) - Modify labels on a single message + - [gog gmail messages search](gog-gmail-messages-search.md) - Search messages using Gmail query syntax + - [gog gmail search](gog-gmail-search.md) - Search threads using Gmail query syntax + - [gog gmail send](gog-gmail-send.md) - Send an email + - [gog gmail settings](gog-gmail-settings.md) - Settings and admin + - [gog gmail settings autoforward](gog-gmail-settings-autoforward.md) - Auto-forwarding settings + - [gog gmail settings autoforward get](gog-gmail-settings-autoforward-get.md) - Get current auto-forwarding settings + - [gog gmail settings autoforward update](gog-gmail-settings-autoforward-update.md) - Update auto-forwarding settings + - [gog gmail settings delegates](gog-gmail-settings-delegates.md) - Delegate operations + - [gog gmail settings delegates add](gog-gmail-settings-delegates-add.md) - Add a delegate + - [gog gmail settings delegates get](gog-gmail-settings-delegates-get.md) - Get a specific delegate's information + - [gog gmail settings delegates list](gog-gmail-settings-delegates-list.md) - List all delegates + - [gog gmail settings delegates remove](gog-gmail-settings-delegates-remove.md) - Remove a delegate + - [gog gmail settings filters](gog-gmail-settings-filters.md) - Filter operations + - [gog gmail settings filters create](gog-gmail-settings-filters-create.md) - Create a new email filter + - [gog gmail settings filters delete](gog-gmail-settings-filters-delete.md) - Delete a filter + - [gog gmail settings filters export](gog-gmail-settings-filters-export.md) - Export filters as JSON + - [gog gmail settings filters get](gog-gmail-settings-filters-get.md) - Get a specific filter + - [gog gmail settings filters list](gog-gmail-settings-filters-list.md) - List all email filters + - [gog gmail settings forwarding](gog-gmail-settings-forwarding.md) - Forwarding addresses + - [gog gmail settings forwarding create](gog-gmail-settings-forwarding-create.md) - Create/add a forwarding address + - [gog gmail settings forwarding delete](gog-gmail-settings-forwarding-delete.md) - Delete a forwarding address + - [gog gmail settings forwarding get](gog-gmail-settings-forwarding-get.md) - Get a specific forwarding address + - [gog gmail settings forwarding list](gog-gmail-settings-forwarding-list.md) - List all forwarding addresses + - [gog gmail settings sendas](gog-gmail-settings-sendas.md) - Send-as settings + - [gog gmail settings sendas create](gog-gmail-settings-sendas-create.md) - Create a new send-as alias + - [gog gmail settings sendas delete](gog-gmail-settings-sendas-delete.md) - Delete a send-as alias + - [gog gmail settings sendas get](gog-gmail-settings-sendas-get.md) - Get details of a send-as alias + - [gog gmail settings sendas list](gog-gmail-settings-sendas-list.md) - List send-as aliases + - [gog gmail settings sendas update](gog-gmail-settings-sendas-update.md) - Update a send-as alias + - [gog gmail settings sendas verify](gog-gmail-settings-sendas-verify.md) - Resend verification email for a send-as alias + - [gog gmail settings vacation](gog-gmail-settings-vacation.md) - Vacation responder + - [gog gmail settings vacation get](gog-gmail-settings-vacation-get.md) - Get current vacation responder settings + - [gog gmail settings vacation update](gog-gmail-settings-vacation-update.md) - Update vacation responder settings + - [gog gmail settings watch](gog-gmail-settings-watch.md) - Manage Gmail watch + - [gog gmail settings watch renew](gog-gmail-settings-watch-renew.md) - Renew Gmail watch using stored config + - [gog gmail settings watch serve](gog-gmail-settings-watch-serve.md) - Run Pub/Sub push handler + - [gog gmail settings watch start](gog-gmail-settings-watch-start.md) - Start Gmail watch for Pub/Sub + - [gog gmail settings watch status](gog-gmail-settings-watch-status.md) - Show stored watch state + - [gog gmail settings watch stop](gog-gmail-settings-watch-stop.md) - Stop Gmail watch and clear stored state + - [gog gmail thread](gog-gmail-thread.md) - Thread operations (get, modify) + - [gog gmail thread attachments](gog-gmail-thread-attachments.md) - List all attachments in a thread + - [gog gmail thread get](gog-gmail-thread-get.md) - Get a thread with all messages (optionally download attachments) + - [gog gmail thread modify](gog-gmail-thread-modify.md) - Modify labels on all messages in a thread + - [gog gmail track](gog-gmail-track.md) - Email open tracking + - [gog gmail track key](gog-gmail-track-key.md) - Manage tracking encryption keys + - [gog gmail track key rotate](gog-gmail-track-key-rotate.md) - Rotate tracking encryption key + - [gog gmail track opens](gog-gmail-track-opens.md) - Query email opens + - [gog gmail track setup](gog-gmail-track-setup.md) - Set up email tracking (deploy Cloudflare Worker) + - [gog gmail track status](gog-gmail-track-status.md) - Show tracking configuration status + - [gog gmail trash](gog-gmail-trash.md) - Move messages to trash + - [gog gmail unread](gog-gmail-unread.md) - Mark messages as unread + - [gog gmail url](gog-gmail-url.md) - Print Gmail web URLs for threads + - [gog groups](gog-groups.md) - Google Groups + - [gog groups list](gog-groups-list.md) - List groups you belong to + - [gog groups members](gog-groups-members.md) - List members of a group + - [gog keep](gog-keep.md) - Google Keep (Workspace only) + - [gog keep attachment](gog-keep-attachment.md) - Download an attachment + - [gog keep create](gog-keep-create.md) - Create a new note + - [gog keep delete](gog-keep-delete.md) - Delete a note + - [gog keep get](gog-keep-get.md) - Get a note + - [gog keep list](gog-keep-list.md) - List notes + - [gog keep search](gog-keep-search.md) - Search notes by text (client-side) + - [gog login](gog-login.md) - Authorize and store a refresh token (alias for 'auth add') + - [gog logout](gog-logout.md) - Remove a stored refresh token (alias for 'auth remove') + - [gog ls](gog-ls.md) - List Drive files (alias for 'drive ls') + - [gog me](gog-me.md) - Show your profile (alias for 'people me') + - [gog open](gog-open.md) - Print a best-effort web URL for a Google URL/ID (offline) + - [gog people](gog-people.md) - Google People + - [gog people get](gog-people-get.md) - Get a user profile by ID + - [gog people me](gog-people-me.md) - Show your profile (people/me) + - [gog people relations](gog-people-relations.md) - Get user relations + - [gog people search](gog-people-search.md) - Search the Workspace directory + - [gog schema](gog-schema.md) - Machine-readable command/flag schema + - [gog search](gog-search.md) - Search Drive files (alias for 'drive search') + - [gog send](gog-send.md) - Send an email (alias for 'gmail send') + - [gog sheets](gog-sheets.md) - Google Sheets + - [gog sheets add-tab](gog-sheets-add-tab.md) - Add a new tab/sheet to a spreadsheet + - [gog sheets append](gog-sheets-append.md) - Append values to a range + - [gog sheets chart](gog-sheets-chart.md) - Manage spreadsheet charts + - [gog sheets chart create](gog-sheets-chart-create.md) - Create a chart from a JSON spec + - [gog sheets chart delete](gog-sheets-chart-delete.md) - Delete a chart + - [gog sheets chart get](gog-sheets-chart-get.md) - Get full chart definition (spec + position) + - [gog sheets chart list](gog-sheets-chart-list.md) - List charts in a spreadsheet + - [gog sheets chart update](gog-sheets-chart-update.md) - Update a chart spec + - [gog sheets clear](gog-sheets-clear.md) - Clear values in a range + - [gog sheets copy](gog-sheets-copy.md) - Copy a Google Sheet + - [gog sheets create](gog-sheets-create.md) - Create a new spreadsheet + - [gog sheets delete-tab](gog-sheets-delete-tab.md) - Delete a tab/sheet from a spreadsheet (use --force to skip confirmation) + - [gog sheets export](gog-sheets-export.md) - Export a Google Sheet (pdf|xlsx|csv) via Drive + - [gog sheets find-replace](gog-sheets-find-replace.md) - Find and replace text across a spreadsheet + - [gog sheets format](gog-sheets-format.md) - Apply cell formatting to a range + - [gog sheets freeze](gog-sheets-freeze.md) - Freeze rows and columns on a sheet + - [gog sheets get](gog-sheets-get.md) - Get values from a range + - [gog sheets insert](gog-sheets-insert.md) - Insert empty rows or columns into a sheet + - [gog sheets links](gog-sheets-links.md) - Get cell hyperlinks from a range + - [gog sheets merge](gog-sheets-merge.md) - Merge cells in a range + - [gog sheets metadata](gog-sheets-metadata.md) - Get spreadsheet metadata + - [gog sheets named-ranges](gog-sheets-named-ranges.md) - Manage named ranges + - [gog sheets named-ranges add](gog-sheets-named-ranges-add.md) - Add a named range + - [gog sheets named-ranges delete](gog-sheets-named-ranges-delete.md) - Delete a named range + - [gog sheets named-ranges get](gog-sheets-named-ranges-get.md) - Get a named range + - [gog sheets named-ranges list](gog-sheets-named-ranges-list.md) - List named ranges + - [gog sheets named-ranges update](gog-sheets-named-ranges-update.md) - Update a named range + - [gog sheets notes](gog-sheets-notes.md) - Get cell notes from a range + - [gog sheets number-format](gog-sheets-number-format.md) - Apply number format to a range + - [gog sheets read-format](gog-sheets-read-format.md) - Read cell formatting from a range + - [gog sheets rename-tab](gog-sheets-rename-tab.md) - Rename a tab/sheet in a spreadsheet + - [gog sheets resize-columns](gog-sheets-resize-columns.md) - Resize sheet columns + - [gog sheets resize-rows](gog-sheets-resize-rows.md) - Resize sheet rows + - [gog sheets unmerge](gog-sheets-unmerge.md) - Unmerge cells in a range + - [gog sheets update](gog-sheets-update.md) - Update values in a range + - [gog sheets update-note](gog-sheets-update-note.md) - Set or clear a cell note + - [gog slides](gog-slides.md) - Google Slides + - [gog slides add-slide](gog-slides-add-slide.md) - Add a slide with a full-bleed image and optional speaker notes + - [gog slides copy](gog-slides-copy.md) - Copy a Google Slides presentation + - [gog slides create](gog-slides-create.md) - Create a Google Slides presentation + - [gog slides create-from-markdown](gog-slides-create-from-markdown.md) - Create a Google Slides presentation from markdown + - [gog slides create-from-template](gog-slides-create-from-template.md) - Create a presentation from template with text replacements + - [gog slides delete-slide](gog-slides-delete-slide.md) - Delete a slide by object ID + - [gog slides export](gog-slides-export.md) - Export a Google Slides deck (pdf|pptx) + - [gog slides info](gog-slides-info.md) - Get Google Slides presentation metadata + - [gog slides insert-text](gog-slides-insert-text.md) - Insert text into an existing page element (shape or table) by objectId + - [gog slides list-slides](gog-slides-list-slides.md) - List all slides with their object IDs + - [gog slides read-slide](gog-slides-read-slide.md) - Read slide content: speaker notes, text elements, and images + - [gog slides replace-slide](gog-slides-replace-slide.md) - Replace the image on an existing slide in-place + - [gog slides replace-text](gog-slides-replace-text.md) - Find-and-replace text across a presentation + - [gog slides thumbnail](gog-slides-thumbnail.md) - Get or download a rendered thumbnail for a slide + - [gog slides update-notes](gog-slides-update-notes.md) - Update speaker notes on an existing slide + - [gog status](gog-status.md) - Show auth/config status (alias for 'auth status') + - [gog tasks](gog-tasks.md) - Google Tasks + - [gog tasks add](gog-tasks-add.md) - Add a task + - [gog tasks clear](gog-tasks-clear.md) - Clear completed tasks + - [gog tasks delete](gog-tasks-delete.md) - Delete a task + - [gog tasks done](gog-tasks-done.md) - Mark task completed + - [gog tasks get](gog-tasks-get.md) - Get a task + - [gog tasks list](gog-tasks-list.md) - List tasks + - [gog tasks lists](gog-tasks-lists.md) - List task lists + - [gog tasks lists create](gog-tasks-lists-create.md) - Create a task list + - [gog tasks lists list](gog-tasks-lists-list.md) - List task lists + - [gog tasks undo](gog-tasks-undo.md) - Mark task needs action + - [gog tasks update](gog-tasks-update.md) - Update a task + - [gog time](gog-time.md) - Local time utilities + - [gog time now](gog-time-now.md) - Show current time + - [gog upload](gog-upload.md) - Upload a file to Drive (alias for 'drive upload') + - [gog version](gog-version.md) - Print version + - [gog whoami](gog-whoami.md) - Show your profile (alias for 'people me') diff --git a/docs/commands/gog-admin-groups-list.md b/docs/commands/gog-admin-groups-list.md new file mode 100644 index 0000000..bb0e538 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-admin-groups-members-add.md b/docs/commands/gog-admin-groups-members-add.md new file mode 100644 index 0000000..05d10df --- /dev/null +++ b/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) diff --git a/docs/commands/gog-admin-groups-members-list.md b/docs/commands/gog-admin-groups-members-list.md new file mode 100644 index 0000000..d159397 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-admin-groups-members-remove.md b/docs/commands/gog-admin-groups-members-remove.md new file mode 100644 index 0000000..c875e00 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-admin-groups-members.md b/docs/commands/gog-admin-groups-members.md new file mode 100644 index 0000000..e47aaa7 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-admin-groups.md b/docs/commands/gog-admin-groups.md new file mode 100644 index 0000000..ffa95fc --- /dev/null +++ b/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) diff --git a/docs/commands/gog-admin-users-create.md b/docs/commands/gog-admin-users-create.md new file mode 100644 index 0000000..42126a8 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-admin-users-get.md b/docs/commands/gog-admin-users-get.md new file mode 100644 index 0000000..8edf1de --- /dev/null +++ b/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) diff --git a/docs/commands/gog-admin-users-list.md b/docs/commands/gog-admin-users-list.md new file mode 100644 index 0000000..e60435e --- /dev/null +++ b/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) diff --git a/docs/commands/gog-admin-users-suspend.md b/docs/commands/gog-admin-users-suspend.md new file mode 100644 index 0000000..aaeede7 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-admin-users.md b/docs/commands/gog-admin-users.md new file mode 100644 index 0000000..accbd8a --- /dev/null +++ b/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) diff --git a/docs/commands/gog-admin.md b/docs/commands/gog-admin.md new file mode 100644 index 0000000..1395ed9 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-agent-exit-codes.md b/docs/commands/gog-agent-exit-codes.md new file mode 100644 index 0000000..21e19ae --- /dev/null +++ b/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) diff --git a/docs/commands/gog-agent.md b/docs/commands/gog-agent.md new file mode 100644 index 0000000..8e78205 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-appscript-content.md b/docs/commands/gog-appscript-content.md new file mode 100644 index 0000000..e8cbd2d --- /dev/null +++ b/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) diff --git a/docs/commands/gog-appscript-create.md b/docs/commands/gog-appscript-create.md new file mode 100644 index 0000000..f6687d4 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-appscript-get.md b/docs/commands/gog-appscript-get.md new file mode 100644 index 0000000..673ba1d --- /dev/null +++ b/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) diff --git a/docs/commands/gog-appscript-run.md b/docs/commands/gog-appscript-run.md new file mode 100644 index 0000000..ab4ef55 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-appscript.md b/docs/commands/gog-appscript.md new file mode 100644 index 0000000..5c487d6 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-add.md b/docs/commands/gog-auth-add.md new file mode 100644 index 0000000..013b0c0 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-alias-list.md b/docs/commands/gog-auth-alias-list.md new file mode 100644 index 0000000..44bf7a4 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-alias-set.md b/docs/commands/gog-auth-alias-set.md new file mode 100644 index 0000000..f77f83d --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-alias-unset.md b/docs/commands/gog-auth-alias-unset.md new file mode 100644 index 0000000..7f39e3a --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-alias.md b/docs/commands/gog-auth-alias.md new file mode 100644 index 0000000..2f89c22 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-credentials-list.md b/docs/commands/gog-auth-credentials-list.md new file mode 100644 index 0000000..01c6221 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-credentials-remove.md b/docs/commands/gog-auth-credentials-remove.md new file mode 100644 index 0000000..5bde025 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-credentials-set.md b/docs/commands/gog-auth-credentials-set.md new file mode 100644 index 0000000..5bac1ae --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-credentials.md b/docs/commands/gog-auth-credentials.md new file mode 100644 index 0000000..5bb7d58 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-doctor.md b/docs/commands/gog-auth-doctor.md new file mode 100644 index 0000000..efa7fff --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-keep.md b/docs/commands/gog-auth-keep.md new file mode 100644 index 0000000..d5db274 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-keyring.md b/docs/commands/gog-auth-keyring.md new file mode 100644 index 0000000..0f0d7e1 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-list.md b/docs/commands/gog-auth-list.md new file mode 100644 index 0000000..a04d3be --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-manage.md b/docs/commands/gog-auth-manage.md new file mode 100644 index 0000000..e134eac --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-remove.md b/docs/commands/gog-auth-remove.md new file mode 100644 index 0000000..341ef2a --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-service-account-set.md b/docs/commands/gog-auth-service-account-set.md new file mode 100644 index 0000000..e4723e7 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-service-account-status.md b/docs/commands/gog-auth-service-account-status.md new file mode 100644 index 0000000..fb42460 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-service-account-unset.md b/docs/commands/gog-auth-service-account-unset.md new file mode 100644 index 0000000..8dec112 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-service-account.md b/docs/commands/gog-auth-service-account.md new file mode 100644 index 0000000..7da22a7 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-services.md b/docs/commands/gog-auth-services.md new file mode 100644 index 0000000..4affc2e --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-status.md b/docs/commands/gog-auth-status.md new file mode 100644 index 0000000..b396630 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-tokens-delete.md b/docs/commands/gog-auth-tokens-delete.md new file mode 100644 index 0000000..3a505a9 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-tokens-export.md b/docs/commands/gog-auth-tokens-export.md new file mode 100644 index 0000000..ed89e9d --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-tokens-import.md b/docs/commands/gog-auth-tokens-import.md new file mode 100644 index 0000000..699abdb --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-tokens-list.md b/docs/commands/gog-auth-tokens-list.md new file mode 100644 index 0000000..0528e90 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth-tokens.md b/docs/commands/gog-auth-tokens.md new file mode 100644 index 0000000..9230b42 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-auth.md b/docs/commands/gog-auth.md new file mode 100644 index 0000000..b3dace7 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-backup-cat.md b/docs/commands/gog-backup-cat.md new file mode 100644 index 0000000..00ee65d --- /dev/null +++ b/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) diff --git a/docs/commands/gog-backup-export.md b/docs/commands/gog-backup-export.md new file mode 100644 index 0000000..48dc1b8 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-backup-gmail-push.md b/docs/commands/gog-backup-gmail-push.md new file mode 100644 index 0000000..ebb0285 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-backup-gmail.md b/docs/commands/gog-backup-gmail.md new file mode 100644 index 0000000..d6126aa --- /dev/null +++ b/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) diff --git a/docs/commands/gog-backup-init.md b/docs/commands/gog-backup-init.md new file mode 100644 index 0000000..6033741 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-backup-push.md b/docs/commands/gog-backup-push.md new file mode 100644 index 0000000..37356d8 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-backup-status.md b/docs/commands/gog-backup-status.md new file mode 100644 index 0000000..6f88242 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-backup-verify.md b/docs/commands/gog-backup-verify.md new file mode 100644 index 0000000..3cf15b6 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-backup.md b/docs/commands/gog-backup.md new file mode 100644 index 0000000..da553d0 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-calendar-acl.md b/docs/commands/gog-calendar-acl.md new file mode 100644 index 0000000..e59cca1 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-calendar-alias-list.md b/docs/commands/gog-calendar-alias-list.md new file mode 100644 index 0000000..4687400 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-calendar-alias-set.md b/docs/commands/gog-calendar-alias-set.md new file mode 100644 index 0000000..e78a063 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-calendar-alias-unset.md b/docs/commands/gog-calendar-alias-unset.md new file mode 100644 index 0000000..72b3310 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-calendar-alias.md b/docs/commands/gog-calendar-alias.md new file mode 100644 index 0000000..953cfa4 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-calendar-calendars.md b/docs/commands/gog-calendar-calendars.md new file mode 100644 index 0000000..133aa95 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-calendar-colors.md b/docs/commands/gog-calendar-colors.md new file mode 100644 index 0000000..1009b97 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-calendar-conflicts.md b/docs/commands/gog-calendar-conflicts.md new file mode 100644 index 0000000..583d9a3 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-calendar-create-calendar.md b/docs/commands/gog-calendar-create-calendar.md new file mode 100644 index 0000000..bc542b0 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-calendar-create.md b/docs/commands/gog-calendar-create.md new file mode 100644 index 0000000..34da8e9 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-calendar-delete.md b/docs/commands/gog-calendar-delete.md new file mode 100644 index 0000000..d2b1621 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-calendar-event.md b/docs/commands/gog-calendar-event.md new file mode 100644 index 0000000..dce5aee --- /dev/null +++ b/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) diff --git a/docs/commands/gog-calendar-events.md b/docs/commands/gog-calendar-events.md new file mode 100644 index 0000000..4be92f3 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-calendar-focus-time.md b/docs/commands/gog-calendar-focus-time.md new file mode 100644 index 0000000..b6ec6a9 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-calendar-freebusy.md b/docs/commands/gog-calendar-freebusy.md new file mode 100644 index 0000000..510002b --- /dev/null +++ b/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) diff --git a/docs/commands/gog-calendar-move.md b/docs/commands/gog-calendar-move.md new file mode 100644 index 0000000..ab40900 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-calendar-out-of-office.md b/docs/commands/gog-calendar-out-of-office.md new file mode 100644 index 0000000..4f4b4c9 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-calendar-propose-time.md b/docs/commands/gog-calendar-propose-time.md new file mode 100644 index 0000000..0c9fb93 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-calendar-respond.md b/docs/commands/gog-calendar-respond.md new file mode 100644 index 0000000..99e7ba4 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-calendar-search.md b/docs/commands/gog-calendar-search.md new file mode 100644 index 0000000..6d85808 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-calendar-subscribe.md b/docs/commands/gog-calendar-subscribe.md new file mode 100644 index 0000000..22191e3 --- /dev/null +++ b/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) diff --git a/docs/commands/gog-calendar-team.md b/docs/commands/gog-calendar-team.md new file mode 100644 index 0000000..462ee3f --- /dev/null +++ b/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) diff --git a/docs/commands/gog-calendar-time.md b/docs/commands/gog-calendar-time.md new file mode 100644 index 0000000..b2227c6 --- /dev/null +++ b/docs/commands/gog-calendar-time.md @@ -0,0 +1,44 @@ +# `gog calendar time` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Show server time + +## Usage + +```bash +gog calendar (cal) time [flags] +``` + +## Parent + +- [gog calendar](gog-calendar.md) + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--calendar` | `string` | primary | Calendar ID to get timezone from | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--select`<br>`--pick`<br>`--project` | `string` | | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. | +| `--timezone` | `string` | | Override timezone (e.g., America/New_York, UTC) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog calendar](gog-calendar.md) +- [Command index](README.md) diff --git a/docs/commands/gog-calendar-update.md b/docs/commands/gog-calendar-update.md new file mode 100644 index 0000000..77db729 --- /dev/null +++ b/docs/commands/gog-calendar-update.md @@ -0,0 +1,78 @@ +# `gog calendar update` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Update an event + +## Usage + +```bash +gog calendar (cal) update (edit,set) <calendarId> <eventId> [flags] +``` + +## Parent + +- [gog calendar](gog-calendar.md) + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--add-attendee` | `string` | | Comma-separated attendee emails to add (preserves existing attendees) | +| `--all-day` | `bool` | | All-day event (use date-only in --from/--to) | +| `--attendees` | `string` | | Comma-separated attendee emails (replaces all; set empty to clear) | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--description` | `string` | | New description (set empty to clear) | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `--end-timezone`<br>`--to-timezone` | `string` | | IANA timezone metadata for --to (e.g., America/New_York) | +| `--event-color` | `string` | | Event color ID (1-11, or empty to clear) | +| `--event-type` | `string` | | Event type: default, focus-time, out-of-office, working-location | +| `--focus-auto-decline` | `string` | | Focus Time auto-decline mode: none, all, new | +| `--focus-chat-status` | `string` | | Focus Time chat status: available, doNotDisturb | +| `--focus-decline-message` | `string` | | Focus Time decline message (set empty to clear) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--from` | `string` | | New start time (RFC3339; set empty to clear) | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `--guests-can-invite` | `*bool` | | Allow guests to invite others | +| `--guests-can-modify` | `*bool` | | Allow guests to modify event | +| `--guests-can-see-others` | `*bool` | | Allow guests to see other guests | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--location` | `string` | | New location (set empty to clear) | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--ooo-auto-decline` | `string` | | Out of Office auto-decline mode: none, all, new | +| `--ooo-decline-message` | `string` | | Out of Office decline message (set empty to clear) | +| `--original-start` | `string` | | Original start time of instance (required for scope=single,future) | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--private-prop` | `[]string` | | Private extended property (key=value, can be repeated) | +| `--reminder` | `[]string` | | Custom reminders as method:duration (e.g., popup:30m, email:1d). Can be repeated (max 5). Set empty to clear. | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--rrule` | `[]string` | | Recurrence rules (e.g., 'RRULE:FREQ=MONTHLY;BYMONTHDAY=11'). Can be repeated. Set empty to clear. | +| `--scope` | `string` | all | For recurring events: single, future, all | +| `--select`<br>`--pick`<br>`--project` | `string` | | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. | +| `--send-updates` | `string` | | Notification mode: all, externalOnly, none (default: none) | +| `--shared-prop` | `[]string` | | Shared extended property (key=value, can be repeated) | +| `--start-timezone`<br>`--from-timezone` | `string` | | IANA timezone metadata for --from (e.g., Europe/Rome) | +| `--summary` | `string` | | New summary/title (set empty to clear) | +| `--to` | `string` | | New end time (RFC3339; set empty to clear) | +| `--transparency` | `string` | | Show as busy (opaque) or free (transparent). Aliases: busy, free | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | +| `--visibility` | `string` | | Event visibility: default, public, private, confidential | +| `--with-meet` | `bool` | | Create a Google Meet video conference for this event | +| `--working-building-id` | `string` | | Working location building ID | +| `--working-custom-label` | `string` | | Working location custom label | +| `--working-desk-id` | `string` | | Working location desk ID | +| `--working-floor-id` | `string` | | Working location floor ID | +| `--working-location-type` | `string` | | Working location type: home, office, custom | +| `--working-office-label` | `string` | | Working location office name/label | + +## See Also + +- [gog calendar](gog-calendar.md) +- [Command index](README.md) diff --git a/docs/commands/gog-calendar-users.md b/docs/commands/gog-calendar-users.md new file mode 100644 index 0000000..f5c0321 --- /dev/null +++ b/docs/commands/gog-calendar-users.md @@ -0,0 +1,46 @@ +# `gog calendar users` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List workspace users (use their email as calendar ID) + +## Usage + +```bash +gog calendar (cal) users [flags] +``` + +## Parent + +- [gog calendar](gog-calendar.md) + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--all`<br>`--all-pages`<br>`--allpages` | `bool` | | Fetch all pages | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `--fail-empty`<br>`--non-empty`<br>`--require-results` | `bool` | | Exit with code 3 if no results | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--max`<br>`--limit` | `int64` | 100 | Max results | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--page`<br>`--cursor` | `string` | | Page token | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--select`<br>`--pick`<br>`--project` | `string` | | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog calendar](gog-calendar.md) +- [Command index](README.md) diff --git a/docs/commands/gog-calendar-working-location.md b/docs/commands/gog-calendar-working-location.md new file mode 100644 index 0000000..f17f708 --- /dev/null +++ b/docs/commands/gog-calendar-working-location.md @@ -0,0 +1,50 @@ +# `gog calendar working-location` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Set working location (home/office/custom) + +## Usage + +```bash +gog calendar (cal) working-location (wl) --from=STRING --to=STRING --type=STRING [<calendarId>] [flags] +``` + +## Parent + +- [gog calendar](gog-calendar.md) + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--building-id` | `string` | | Building ID | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--custom-label` | `string` | | Custom location label | +| `--desk-id` | `string` | | Desk ID | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `--floor-id` | `string` | | Floor ID | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--from` | `string` | | Start date (YYYY-MM-DD) | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--office-label` | `string` | | Office name/label | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--select`<br>`--pick`<br>`--project` | `string` | | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. | +| `--to` | `string` | | End date (YYYY-MM-DD) | +| `--type` | `string` | | Location type: home, office, custom | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog calendar](gog-calendar.md) +- [Command index](README.md) diff --git a/docs/commands/gog-calendar.md b/docs/commands/gog-calendar.md new file mode 100644 index 0000000..64b8bae --- /dev/null +++ b/docs/commands/gog-calendar.md @@ -0,0 +1,68 @@ +# `gog calendar` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Google Calendar + +## Usage + +```bash +gog calendar (cal) <command> [flags] +``` + +## Parent + +- [gog](gog.md) + +## Subcommands + +- [gog calendar acl](gog-calendar-acl.md) - List calendar ACL +- [gog calendar alias](gog-calendar-alias.md) - Manage calendar aliases +- [gog calendar calendars](gog-calendar-calendars.md) - List calendars +- [gog calendar colors](gog-calendar-colors.md) - Show calendar colors +- [gog calendar conflicts](gog-calendar-conflicts.md) - Find conflicts +- [gog calendar create](gog-calendar-create.md) - Create an event +- [gog calendar create-calendar](gog-calendar-create-calendar.md) - Create a new secondary calendar +- [gog calendar delete](gog-calendar-delete.md) - Delete an event +- [gog calendar event](gog-calendar-event.md) - Get event +- [gog calendar events](gog-calendar-events.md) - List events from a calendar or all calendars +- [gog calendar focus-time](gog-calendar-focus-time.md) - Create a Focus Time block +- [gog calendar freebusy](gog-calendar-freebusy.md) - Get free/busy +- [gog calendar move](gog-calendar-move.md) - Move an event to another calendar +- [gog calendar out-of-office](gog-calendar-out-of-office.md) - Create an Out of Office event +- [gog calendar propose-time](gog-calendar-propose-time.md) - Generate URL to propose a new meeting time (browser-only feature) +- [gog calendar respond](gog-calendar-respond.md) - Respond to an event invitation +- [gog calendar search](gog-calendar-search.md) - Search events +- [gog calendar subscribe](gog-calendar-subscribe.md) - Add a calendar to your calendar list +- [gog calendar team](gog-calendar-team.md) - Show events for all members of a Google Group +- [gog calendar time](gog-calendar-time.md) - Show server time +- [gog calendar update](gog-calendar-update.md) - Update an event +- [gog calendar users](gog-calendar-users.md) - List workspace users (use their email as calendar ID) +- [gog calendar working-location](gog-calendar-working-location.md) - Set working location (home/office/custom) + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--select`<br>`--pick`<br>`--project` | `string` | | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog](gog.md) +- [Command index](README.md) diff --git a/docs/commands/gog-chat-dm-send.md b/docs/commands/gog-chat-dm-send.md new file mode 100644 index 0000000..9d6c8e2 --- /dev/null +++ b/docs/commands/gog-chat-dm-send.md @@ -0,0 +1,44 @@ +# `gog chat dm send` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Send a direct message + +## Usage + +```bash +gog chat dm send (create,post) <email> [flags] +``` + +## Parent + +- [gog chat dm](gog-chat-dm.md) + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--select`<br>`--pick`<br>`--project` | `string` | | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. | +| `--text` | `string` | | Message text (required) | +| `--thread` | `string` | | Reply to thread (spaces/.../threads/...) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog chat dm](gog-chat-dm.md) +- [Command index](README.md) diff --git a/docs/commands/gog-chat-dm-space.md b/docs/commands/gog-chat-dm-space.md new file mode 100644 index 0000000..db4663e --- /dev/null +++ b/docs/commands/gog-chat-dm-space.md @@ -0,0 +1,42 @@ +# `gog chat dm space` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Find or create a DM space + +## Usage + +```bash +gog chat dm space (find,setup) <email> +``` + +## Parent + +- [gog chat dm](gog-chat-dm.md) + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--select`<br>`--pick`<br>`--project` | `string` | | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog chat dm](gog-chat-dm.md) +- [Command index](README.md) diff --git a/docs/commands/gog-chat-dm.md b/docs/commands/gog-chat-dm.md new file mode 100644 index 0000000..d1b0798 --- /dev/null +++ b/docs/commands/gog-chat-dm.md @@ -0,0 +1,47 @@ +# `gog chat dm` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Direct messages + +## Usage + +```bash +gog chat dm <command> +``` + +## Parent + +- [gog chat](gog-chat.md) + +## Subcommands + +- [gog chat dm send](gog-chat-dm-send.md) - Send a direct message +- [gog chat dm space](gog-chat-dm-space.md) - Find or create a DM space + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--select`<br>`--pick`<br>`--project` | `string` | | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog chat](gog-chat.md) +- [Command index](README.md) diff --git a/docs/commands/gog-chat-messages-list.md b/docs/commands/gog-chat-messages-list.md new file mode 100644 index 0000000..0e53894 --- /dev/null +++ b/docs/commands/gog-chat-messages-list.md @@ -0,0 +1,49 @@ +# `gog chat messages list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List messages + +## Usage + +```bash +gog chat messages list (ls) <space> [flags] +``` + +## Parent + +- [gog chat messages](gog-chat-messages.md) + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--all`<br>`--all-pages`<br>`--allpages` | `bool` | | Fetch all pages | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `--fail-empty`<br>`--non-empty`<br>`--require-results` | `bool` | | Exit with code 3 if no results | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--max`<br>`--limit` | `int64` | 50 | Max results | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--order` | `string` | | Order by (e.g. createTime desc) | +| `--page`<br>`--cursor` | `string` | | Page token | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--select`<br>`--pick`<br>`--project` | `string` | | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. | +| `--thread` | `string` | | Filter by thread (spaces/.../threads/...) | +| `--unread` | `bool` | | Only messages after last read time | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog chat messages](gog-chat-messages.md) +- [Command index](README.md) diff --git a/docs/commands/gog-chat-messages-react.md b/docs/commands/gog-chat-messages-react.md new file mode 100644 index 0000000..823b291 --- /dev/null +++ b/docs/commands/gog-chat-messages-react.md @@ -0,0 +1,43 @@ +# `gog chat messages react` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Add an emoji reaction to a message + +## Usage + +```bash +gog chat messages react <message> <emoji> [flags] +``` + +## Parent + +- [gog chat messages](gog-chat-messages.md) + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--select`<br>`--pick`<br>`--project` | `string` | | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. | +| `--space` | `string` | | Space name (required when message is a bare ID) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog chat messages](gog-chat-messages.md) +- [Command index](README.md) diff --git a/docs/commands/gog-chat-messages-reactions-create.md b/docs/commands/gog-chat-messages-reactions-create.md new file mode 100644 index 0000000..1483a9c --- /dev/null +++ b/docs/commands/gog-chat-messages-reactions-create.md @@ -0,0 +1,43 @@ +# `gog chat messages reactions create` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Add an emoji reaction to a message + +## Usage + +```bash +gog chat messages reactions (reaction) create (add) <message> <emoji> [flags] +``` + +## Parent + +- [gog chat messages reactions](gog-chat-messages-reactions.md) + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--select`<br>`--pick`<br>`--project` | `string` | | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. | +| `--space` | `string` | | Space name (required when message is a bare ID) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog chat messages reactions](gog-chat-messages-reactions.md) +- [Command index](README.md) diff --git a/docs/commands/gog-chat-messages-reactions-delete.md b/docs/commands/gog-chat-messages-reactions-delete.md new file mode 100644 index 0000000..94d2cbe --- /dev/null +++ b/docs/commands/gog-chat-messages-reactions-delete.md @@ -0,0 +1,42 @@ +# `gog chat messages reactions delete` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete a reaction + +## Usage + +```bash +gog chat messages reactions (reaction) delete (remove,rm) <reaction> +``` + +## Parent + +- [gog chat messages reactions](gog-chat-messages-reactions.md) + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--select`<br>`--pick`<br>`--project` | `string` | | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog chat messages reactions](gog-chat-messages-reactions.md) +- [Command index](README.md) diff --git a/docs/commands/gog-chat-messages-reactions-list.md b/docs/commands/gog-chat-messages-reactions-list.md new file mode 100644 index 0000000..642d782 --- /dev/null +++ b/docs/commands/gog-chat-messages-reactions-list.md @@ -0,0 +1,46 @@ +# `gog chat messages reactions list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List reactions on a message + +## Usage + +```bash +gog chat messages reactions (reaction) list (ls) <message> [flags] +``` + +## Parent + +- [gog chat messages reactions](gog-chat-messages-reactions.md) + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--all` | `bool` | | Fetch all pages | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--max`<br>`--limit` | `int64` | 50 | Max results | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--page`<br>`--cursor` | `string` | | Page token | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--select`<br>`--pick`<br>`--project` | `string` | | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. | +| `--space` | `string` | | Space name (required when message is a bare ID) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog chat messages reactions](gog-chat-messages-reactions.md) +- [Command index](README.md) diff --git a/docs/commands/gog-chat-messages-reactions.md b/docs/commands/gog-chat-messages-reactions.md new file mode 100644 index 0000000..292727c --- /dev/null +++ b/docs/commands/gog-chat-messages-reactions.md @@ -0,0 +1,48 @@ +# `gog chat messages reactions` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Manage emoji reactions on a message + +## Usage + +```bash +gog chat messages reactions (reaction) <command> +``` + +## Parent + +- [gog chat messages](gog-chat-messages.md) + +## Subcommands + +- [gog chat messages reactions create](gog-chat-messages-reactions-create.md) - Add an emoji reaction to a message +- [gog chat messages reactions delete](gog-chat-messages-reactions-delete.md) - Delete a reaction +- [gog chat messages reactions list](gog-chat-messages-reactions-list.md) - List reactions on a message + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--select`<br>`--pick`<br>`--project` | `string` | | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog chat messages](gog-chat-messages.md) +- [Command index](README.md) diff --git a/docs/commands/gog-chat-messages-send.md b/docs/commands/gog-chat-messages-send.md new file mode 100644 index 0000000..ad5f590 --- /dev/null +++ b/docs/commands/gog-chat-messages-send.md @@ -0,0 +1,44 @@ +# `gog chat messages send` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Send a message + +## Usage + +```bash +gog chat messages send (create,post) <space> [flags] +``` + +## Parent + +- [gog chat messages](gog-chat-messages.md) + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--select`<br>`--pick`<br>`--project` | `string` | | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. | +| `--text` | `string` | | Message text (required) | +| `--thread` | `string` | | Reply to thread (spaces/.../threads/...) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog chat messages](gog-chat-messages.md) +- [Command index](README.md) diff --git a/docs/commands/gog-chat-messages.md b/docs/commands/gog-chat-messages.md new file mode 100644 index 0000000..50441cf --- /dev/null +++ b/docs/commands/gog-chat-messages.md @@ -0,0 +1,49 @@ +# `gog chat messages` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Chat messages + +## Usage + +```bash +gog chat messages <command> +``` + +## Parent + +- [gog chat](gog-chat.md) + +## Subcommands + +- [gog chat messages list](gog-chat-messages-list.md) - List messages +- [gog chat messages react](gog-chat-messages-react.md) - Add an emoji reaction to a message +- [gog chat messages reactions](gog-chat-messages-reactions.md) - Manage emoji reactions on a message +- [gog chat messages send](gog-chat-messages-send.md) - Send a message + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--select`<br>`--pick`<br>`--project` | `string` | | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog chat](gog-chat.md) +- [Command index](README.md) diff --git a/docs/commands/gog-chat-spaces-create.md b/docs/commands/gog-chat-spaces-create.md new file mode 100644 index 0000000..c79270d --- /dev/null +++ b/docs/commands/gog-chat-spaces-create.md @@ -0,0 +1,43 @@ +# `gog chat spaces create` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create a space + +## Usage + +```bash +gog chat spaces create (add,new) <displayName> [flags] +``` + +## Parent + +- [gog chat spaces](gog-chat-spaces.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) | +| `--member` | `[]string` | | Space members (email or users/...; repeatable or comma-separated) | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--select`<br>`--pick`<br>`--project` | `string` | | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog chat spaces](gog-chat-spaces.md) +- [Command index](README.md) diff --git a/docs/commands/gog-chat-spaces-find.md b/docs/commands/gog-chat-spaces-find.md new file mode 100644 index 0000000..07a4afd --- /dev/null +++ b/docs/commands/gog-chat-spaces-find.md @@ -0,0 +1,44 @@ +# `gog chat spaces find` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Find spaces by display name + +## Usage + +```bash +gog chat spaces find (search,query) <displayName> [flags] +``` + +## Parent + +- [gog chat spaces](gog-chat-spaces.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) | +| `--exact` | `bool` | | Require an exact, case-insensitive match on displayName instead of substring match | +| `-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 per page | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--select`<br>`--pick`<br>`--project` | `string` | | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog chat spaces](gog-chat-spaces.md) +- [Command index](README.md) diff --git a/docs/commands/gog-chat-spaces-list.md b/docs/commands/gog-chat-spaces-list.md new file mode 100644 index 0000000..0e3af4a --- /dev/null +++ b/docs/commands/gog-chat-spaces-list.md @@ -0,0 +1,46 @@ +# `gog chat spaces list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List spaces + +## Usage + +```bash +gog chat spaces list (ls) [flags] +``` + +## Parent + +- [gog chat spaces](gog-chat-spaces.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 chat spaces](gog-chat-spaces.md) +- [Command index](README.md) diff --git a/docs/commands/gog-chat-spaces.md b/docs/commands/gog-chat-spaces.md new file mode 100644 index 0000000..53da9a5 --- /dev/null +++ b/docs/commands/gog-chat-spaces.md @@ -0,0 +1,48 @@ +# `gog chat spaces` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Chat spaces + +## Usage + +```bash +gog chat spaces <command> +``` + +## Parent + +- [gog chat](gog-chat.md) + +## Subcommands + +- [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 + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--select`<br>`--pick`<br>`--project` | `string` | | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog chat](gog-chat.md) +- [Command index](README.md) diff --git a/docs/commands/gog-chat-threads-list.md b/docs/commands/gog-chat-threads-list.md new file mode 100644 index 0000000..a8b4d87 --- /dev/null +++ b/docs/commands/gog-chat-threads-list.md @@ -0,0 +1,46 @@ +# `gog chat threads list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List threads in a space + +## Usage + +```bash +gog chat threads list <space> [flags] +``` + +## Parent + +- [gog chat threads](gog-chat-threads.md) + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--all`<br>`--all-pages`<br>`--allpages` | `bool` | | Fetch all pages | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `--fail-empty`<br>`--non-empty`<br>`--require-results` | `bool` | | Exit with code 3 if no results | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--max`<br>`--limit` | `int64` | 50 | Max results | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--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 chat threads](gog-chat-threads.md) +- [Command index](README.md) diff --git a/docs/commands/gog-chat-threads.md b/docs/commands/gog-chat-threads.md new file mode 100644 index 0000000..a1405f8 --- /dev/null +++ b/docs/commands/gog-chat-threads.md @@ -0,0 +1,46 @@ +# `gog chat threads` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Chat threads + +## Usage + +```bash +gog chat threads <command> +``` + +## Parent + +- [gog chat](gog-chat.md) + +## Subcommands + +- [gog chat threads list](gog-chat-threads-list.md) - List threads in a space + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--select`<br>`--pick`<br>`--project` | `string` | | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog chat](gog-chat.md) +- [Command index](README.md) diff --git a/docs/commands/gog-chat.md b/docs/commands/gog-chat.md new file mode 100644 index 0000000..35e5ef0 --- /dev/null +++ b/docs/commands/gog-chat.md @@ -0,0 +1,49 @@ +# `gog chat` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Google Chat + +## Usage + +```bash +gog chat <command> [flags] +``` + +## Parent + +- [gog](gog.md) + +## Subcommands + +- [gog chat dm](gog-chat-dm.md) - Direct messages +- [gog chat messages](gog-chat-messages.md) - Chat messages +- [gog chat spaces](gog-chat-spaces.md) - Chat spaces +- [gog chat threads](gog-chat-threads.md) - Chat threads + +## 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) diff --git a/docs/commands/gog-classroom-announcements-assignees.md b/docs/commands/gog-classroom-announcements-assignees.md new file mode 100644 index 0000000..c37b3e7 --- /dev/null +++ b/docs/commands/gog-classroom-announcements-assignees.md @@ -0,0 +1,45 @@ +# `gog classroom announcements assignees` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Modify announcement assignees + +## Usage + +```bash +gog classroom (class) announcements (announcement,ann) assignees (assign) <courseId> <announcementId> [flags] +``` + +## Parent + +- [gog classroom announcements](gog-classroom-announcements.md) + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--add-student` | `[]string` | | Student IDs to add | +| `--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) | +| `--mode` | `string` | | Assignee mode: ALL_STUDENTS, INDIVIDUAL_STUDENTS | +| `--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) | +| `--remove-student` | `[]string` | | Student IDs to remove | +| `--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 classroom announcements](gog-classroom-announcements.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-announcements-create.md b/docs/commands/gog-classroom-announcements-create.md new file mode 100644 index 0000000..6acc522 --- /dev/null +++ b/docs/commands/gog-classroom-announcements-create.md @@ -0,0 +1,45 @@ +# `gog classroom announcements create` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create an announcement + +## Usage + +```bash +gog classroom (class) announcements (announcement,ann) create (add,new) --text=STRING <courseId> [flags] +``` + +## Parent + +- [gog classroom announcements](gog-classroom-announcements.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) | +| `--scheduled` | `string` | | Scheduled publish time (RFC3339) | +| `--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. | +| `--state` | `string` | | State: PUBLISHED, DRAFT | +| `--text` | `string` | | Announcement text | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog classroom announcements](gog-classroom-announcements.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-announcements-delete.md b/docs/commands/gog-classroom-announcements-delete.md new file mode 100644 index 0000000..4eeaa94 --- /dev/null +++ b/docs/commands/gog-classroom-announcements-delete.md @@ -0,0 +1,42 @@ +# `gog classroom announcements delete` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete an announcement + +## Usage + +```bash +gog classroom (class) announcements (announcement,ann) delete (rm,del,remove) <courseId> <announcementId> +``` + +## Parent + +- [gog classroom announcements](gog-classroom-announcements.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 classroom announcements](gog-classroom-announcements.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-announcements-get.md b/docs/commands/gog-classroom-announcements-get.md new file mode 100644 index 0000000..d81fbf3 --- /dev/null +++ b/docs/commands/gog-classroom-announcements-get.md @@ -0,0 +1,42 @@ +# `gog classroom announcements get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get an announcement + +## Usage + +```bash +gog classroom (class) announcements (announcement,ann) get (info,show) <courseId> <announcementId> +``` + +## Parent + +- [gog classroom announcements](gog-classroom-announcements.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 classroom announcements](gog-classroom-announcements.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-announcements-list.md b/docs/commands/gog-classroom-announcements-list.md new file mode 100644 index 0000000..19e3307 --- /dev/null +++ b/docs/commands/gog-classroom-announcements-list.md @@ -0,0 +1,48 @@ +# `gog classroom announcements list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List announcements + +## Usage + +```bash +gog classroom (class) announcements (announcement,ann) list (ls) <courseId> [flags] +``` + +## Parent + +- [gog classroom announcements](gog-classroom-announcements.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) | +| `--order-by` | `string` | | Order by (e.g., updateTime desc) | +| `--page`<br>`--cursor` | `string` | | Page token | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--select`<br>`--pick`<br>`--project` | `string` | | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. | +| `--state` | `string` | | Announcement states filter (comma-separated: DRAFT,PUBLISHED,DELETED) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog classroom announcements](gog-classroom-announcements.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-announcements-update.md b/docs/commands/gog-classroom-announcements-update.md new file mode 100644 index 0000000..793d827 --- /dev/null +++ b/docs/commands/gog-classroom-announcements-update.md @@ -0,0 +1,45 @@ +# `gog classroom announcements update` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Update an announcement + +## Usage + +```bash +gog classroom (class) announcements (announcement,ann) update (edit,set) <courseId> <announcementId> [flags] +``` + +## Parent + +- [gog classroom announcements](gog-classroom-announcements.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) | +| `--scheduled` | `string` | | Scheduled publish time (RFC3339) | +| `--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. | +| `--state` | `string` | | State: PUBLISHED, DRAFT | +| `--text` | `string` | | Announcement text | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog classroom announcements](gog-classroom-announcements.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-announcements.md b/docs/commands/gog-classroom-announcements.md new file mode 100644 index 0000000..9e888fe --- /dev/null +++ b/docs/commands/gog-classroom-announcements.md @@ -0,0 +1,51 @@ +# `gog classroom announcements` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Announcements + +## Usage + +```bash +gog classroom (class) announcements (announcement,ann) <command> +``` + +## Parent + +- [gog classroom](gog-classroom.md) + +## Subcommands + +- [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 + +## 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 classroom](gog-classroom.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-courses-archive.md b/docs/commands/gog-classroom-courses-archive.md new file mode 100644 index 0000000..4888324 --- /dev/null +++ b/docs/commands/gog-classroom-courses-archive.md @@ -0,0 +1,42 @@ +# `gog classroom courses archive` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Archive a course + +## Usage + +```bash +gog classroom (class) courses (course) archive (arch) <courseId> +``` + +## Parent + +- [gog classroom courses](gog-classroom-courses.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 classroom courses](gog-classroom-courses.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-courses-create.md b/docs/commands/gog-classroom-courses-create.md new file mode 100644 index 0000000..ba12c47 --- /dev/null +++ b/docs/commands/gog-classroom-courses-create.md @@ -0,0 +1,49 @@ +# `gog classroom courses create` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create a course + +## Usage + +```bash +gog classroom (class) courses (course) create (add,new) --name=STRING [flags] +``` + +## Parent + +- [gog classroom courses](gog-classroom-courses.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` | | Description | +| `--description-heading` | `string` | | Description heading | +| `--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) | +| `--name` | `string` | | Course name | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--owner` | `string` | me | Owner user ID or email | +| `-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) | +| `--room` | `string` | | Room | +| `--section` | `string` | | Section | +| `--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. | +| `--state` | `string` | | Course state (ACTIVE, ARCHIVED, PROVISIONED, DECLINED) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog classroom courses](gog-classroom-courses.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-courses-delete.md b/docs/commands/gog-classroom-courses-delete.md new file mode 100644 index 0000000..0125101 --- /dev/null +++ b/docs/commands/gog-classroom-courses-delete.md @@ -0,0 +1,42 @@ +# `gog classroom courses delete` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete a course + +## Usage + +```bash +gog classroom (class) courses (course) delete (rm,del,remove) <courseId> +``` + +## Parent + +- [gog classroom courses](gog-classroom-courses.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 classroom courses](gog-classroom-courses.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-courses-get.md b/docs/commands/gog-classroom-courses-get.md new file mode 100644 index 0000000..f522cde --- /dev/null +++ b/docs/commands/gog-classroom-courses-get.md @@ -0,0 +1,42 @@ +# `gog classroom courses get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get a course + +## Usage + +```bash +gog classroom (class) courses (course) get (info,show) <courseId> +``` + +## Parent + +- [gog classroom courses](gog-classroom-courses.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 classroom courses](gog-classroom-courses.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-courses-join.md b/docs/commands/gog-classroom-courses-join.md new file mode 100644 index 0000000..b584966 --- /dev/null +++ b/docs/commands/gog-classroom-courses-join.md @@ -0,0 +1,45 @@ +# `gog classroom courses join` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Join a course + +## Usage + +```bash +gog classroom (class) courses (course) join (enroll) <courseId> [flags] +``` + +## Parent + +- [gog classroom courses](gog-classroom-courses.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) | +| `--enrollment-code` | `string` | | Enrollment code (student joins only) | +| `-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` | student | Role to join as: student\|teacher | +| `--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. | +| `--user` | `string` | me | User ID or email to join | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog classroom courses](gog-classroom-courses.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-courses-leave.md b/docs/commands/gog-classroom-courses-leave.md new file mode 100644 index 0000000..3805680 --- /dev/null +++ b/docs/commands/gog-classroom-courses-leave.md @@ -0,0 +1,44 @@ +# `gog classroom courses leave` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Leave a course + +## Usage + +```bash +gog classroom (class) courses (course) leave (unenroll) <courseId> [flags] +``` + +## Parent + +- [gog classroom courses](gog-classroom-courses.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` | student | Role to remove: student\|teacher | +| `--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. | +| `--user` | `string` | me | User ID or email to remove | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog classroom courses](gog-classroom-courses.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-courses-list.md b/docs/commands/gog-classroom-courses-list.md new file mode 100644 index 0000000..992baed --- /dev/null +++ b/docs/commands/gog-classroom-courses-list.md @@ -0,0 +1,49 @@ +# `gog classroom courses list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List courses + +## Usage + +```bash +gog classroom (class) courses (course) list (ls) [flags] +``` + +## Parent + +- [gog classroom courses](gog-classroom-courses.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. | +| `--state` | `string` | | Course states filter (comma-separated: ACTIVE,ARCHIVED,PROVISIONED,DECLINED) | +| `--student` | `string` | | Filter by student user ID or email | +| `--teacher` | `string` | | Filter by teacher user ID or email | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog classroom courses](gog-classroom-courses.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-courses-unarchive.md b/docs/commands/gog-classroom-courses-unarchive.md new file mode 100644 index 0000000..97775a6 --- /dev/null +++ b/docs/commands/gog-classroom-courses-unarchive.md @@ -0,0 +1,42 @@ +# `gog classroom courses unarchive` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Unarchive a course + +## Usage + +```bash +gog classroom (class) courses (course) unarchive (unarch,restore) <courseId> +``` + +## Parent + +- [gog classroom courses](gog-classroom-courses.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 classroom courses](gog-classroom-courses.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-courses-update.md b/docs/commands/gog-classroom-courses-update.md new file mode 100644 index 0000000..4e37b77 --- /dev/null +++ b/docs/commands/gog-classroom-courses-update.md @@ -0,0 +1,49 @@ +# `gog classroom courses update` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Update a course + +## Usage + +```bash +gog classroom (class) courses (course) update (edit,set) <courseId> [flags] +``` + +## Parent + +- [gog classroom courses](gog-classroom-courses.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` | | Description | +| `--description-heading` | `string` | | Description heading | +| `--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) | +| `--name` | `string` | | Course name | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--owner` | `string` | | Owner user ID or email | +| `-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) | +| `--room` | `string` | | Room | +| `--section` | `string` | | Section | +| `--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. | +| `--state` | `string` | | Course state (ACTIVE, ARCHIVED, PROVISIONED, DECLINED) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog classroom courses](gog-classroom-courses.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-courses-url.md b/docs/commands/gog-classroom-courses-url.md new file mode 100644 index 0000000..bf9a15f --- /dev/null +++ b/docs/commands/gog-classroom-courses-url.md @@ -0,0 +1,42 @@ +# `gog classroom courses url` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Print Classroom web URLs for courses + +## Usage + +```bash +gog classroom (class) courses (course) url (link) <courseId> ... +``` + +## Parent + +- [gog classroom courses](gog-classroom-courses.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 classroom courses](gog-classroom-courses.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-courses.md b/docs/commands/gog-classroom-courses.md new file mode 100644 index 0000000..b0d4dc9 --- /dev/null +++ b/docs/commands/gog-classroom-courses.md @@ -0,0 +1,55 @@ +# `gog classroom courses` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Courses + +## Usage + +```bash +gog classroom (class) courses (course) <command> +``` + +## Parent + +- [gog classroom](gog-classroom.md) + +## Subcommands + +- [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 + +## 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 classroom](gog-classroom.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-coursework-assignees.md b/docs/commands/gog-classroom-coursework-assignees.md new file mode 100644 index 0000000..b7d608b --- /dev/null +++ b/docs/commands/gog-classroom-coursework-assignees.md @@ -0,0 +1,45 @@ +# `gog classroom coursework assignees` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Modify coursework assignees + +## Usage + +```bash +gog classroom (class) coursework (work) assignees (assign) <courseId> <courseworkId> [flags] +``` + +## Parent + +- [gog classroom coursework](gog-classroom-coursework.md) + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--add-student` | `[]string` | | Student IDs to add | +| `--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) | +| `--mode` | `string` | | Assignee mode: ALL_STUDENTS, INDIVIDUAL_STUDENTS | +| `--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) | +| `--remove-student` | `[]string` | | Student IDs to remove | +| `--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 classroom coursework](gog-classroom-coursework.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-coursework-create.md b/docs/commands/gog-classroom-coursework-create.md new file mode 100644 index 0000000..d32cbcc --- /dev/null +++ b/docs/commands/gog-classroom-coursework-create.md @@ -0,0 +1,52 @@ +# `gog classroom coursework create` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create coursework + +## Usage + +```bash +gog classroom (class) coursework (work) create (add,new) --title=STRING <courseId> [flags] +``` + +## Parent + +- [gog classroom coursework](gog-classroom-coursework.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` | | 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 | +| `--due` | `string` | | Due date/time (RFC3339 or YYYY-MM-DD [HH:MM]) | +| `--due-date` | `string` | | Due date (YYYY-MM-DD) | +| `--due-time` | `string` | | Due time (HH:MM or HH:MM:SS) | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--max-points` | `float64` | | Max points | +| `--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) | +| `--scheduled` | `string` | | Scheduled publish time (RFC3339) | +| `--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. | +| `--state` | `string` | | State: PUBLISHED, DRAFT | +| `--title` | `string` | | Title | +| `--topic` | `string` | | Topic ID | +| `--type` | `string` | ASSIGNMENT | Work type: ASSIGNMENT, SHORT_ANSWER_QUESTION, MULTIPLE_CHOICE_QUESTION | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog classroom coursework](gog-classroom-coursework.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-coursework-delete.md b/docs/commands/gog-classroom-coursework-delete.md new file mode 100644 index 0000000..06519bb --- /dev/null +++ b/docs/commands/gog-classroom-coursework-delete.md @@ -0,0 +1,42 @@ +# `gog classroom coursework delete` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete coursework + +## Usage + +```bash +gog classroom (class) coursework (work) delete (rm,del,remove) <courseId> <courseworkId> +``` + +## Parent + +- [gog classroom coursework](gog-classroom-coursework.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 classroom coursework](gog-classroom-coursework.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-coursework-get.md b/docs/commands/gog-classroom-coursework-get.md new file mode 100644 index 0000000..9813278 --- /dev/null +++ b/docs/commands/gog-classroom-coursework-get.md @@ -0,0 +1,42 @@ +# `gog classroom coursework get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get coursework + +## Usage + +```bash +gog classroom (class) coursework (work) get (info,show) <courseId> <courseworkId> +``` + +## Parent + +- [gog classroom coursework](gog-classroom-coursework.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 classroom coursework](gog-classroom-coursework.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-coursework-list.md b/docs/commands/gog-classroom-coursework-list.md new file mode 100644 index 0000000..1463614 --- /dev/null +++ b/docs/commands/gog-classroom-coursework-list.md @@ -0,0 +1,50 @@ +# `gog classroom coursework list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List coursework + +## Usage + +```bash +gog classroom (class) coursework (work) list (ls) <courseId> [flags] +``` + +## Parent + +- [gog classroom coursework](gog-classroom-coursework.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) | +| `--order-by` | `string` | | Order by (e.g., updateTime desc, dueDate desc) | +| `--page`<br>`--cursor` | `string` | | Page token | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--scan-pages` | `int` | 3 | Pages to scan when filtering by topic | +| `--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. | +| `--state` | `string` | | Coursework states filter (comma-separated: DRAFT,PUBLISHED,DELETED) | +| `--topic` | `string` | | Filter by topic ID | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog classroom coursework](gog-classroom-coursework.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-coursework-update.md b/docs/commands/gog-classroom-coursework-update.md new file mode 100644 index 0000000..bf1107c --- /dev/null +++ b/docs/commands/gog-classroom-coursework-update.md @@ -0,0 +1,51 @@ +# `gog classroom coursework update` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Update coursework + +## Usage + +```bash +gog classroom (class) coursework (work) update (edit,set) <courseId> <courseworkId> [flags] +``` + +## Parent + +- [gog classroom coursework](gog-classroom-coursework.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` | | 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 | +| `--due` | `string` | | Due date/time (RFC3339 or YYYY-MM-DD [HH:MM]) | +| `--due-date` | `string` | | Due date (YYYY-MM-DD) | +| `--due-time` | `string` | | Due time (HH:MM or HH:MM:SS) | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--max-points` | `float64` | | Max points | +| `--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) | +| `--scheduled` | `string` | | Scheduled publish time (RFC3339) | +| `--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. | +| `--state` | `string` | | State: PUBLISHED, DRAFT | +| `--title` | `string` | | Title | +| `--topic` | `string` | | Topic ID | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog classroom coursework](gog-classroom-coursework.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-coursework.md b/docs/commands/gog-classroom-coursework.md new file mode 100644 index 0000000..7f76df6 --- /dev/null +++ b/docs/commands/gog-classroom-coursework.md @@ -0,0 +1,51 @@ +# `gog classroom coursework` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Coursework + +## Usage + +```bash +gog classroom (class) coursework (work) <command> +``` + +## Parent + +- [gog classroom](gog-classroom.md) + +## Subcommands + +- [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 + +## 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 classroom](gog-classroom.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-guardian-invitations-create.md b/docs/commands/gog-classroom-guardian-invitations-create.md new file mode 100644 index 0000000..93795e8 --- /dev/null +++ b/docs/commands/gog-classroom-guardian-invitations-create.md @@ -0,0 +1,43 @@ +# `gog classroom guardian-invitations create` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create a guardian invitation + +## Usage + +```bash +gog classroom (class) guardian-invitations (guardian-invites) create (add,new) --email=STRING <studentId> +``` + +## Parent + +- [gog classroom guardian-invitations](gog-classroom-guardian-invitations.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 | +| `--email` | `string` | | Guardian email address | +| `--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 classroom guardian-invitations](gog-classroom-guardian-invitations.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-guardian-invitations-get.md b/docs/commands/gog-classroom-guardian-invitations-get.md new file mode 100644 index 0000000..4e57734 --- /dev/null +++ b/docs/commands/gog-classroom-guardian-invitations-get.md @@ -0,0 +1,42 @@ +# `gog classroom guardian-invitations get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get a guardian invitation + +## Usage + +```bash +gog classroom (class) guardian-invitations (guardian-invites) get (info,show) <studentId> <invitationId> +``` + +## Parent + +- [gog classroom guardian-invitations](gog-classroom-guardian-invitations.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 classroom guardian-invitations](gog-classroom-guardian-invitations.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-guardian-invitations-list.md b/docs/commands/gog-classroom-guardian-invitations-list.md new file mode 100644 index 0000000..22443fb --- /dev/null +++ b/docs/commands/gog-classroom-guardian-invitations-list.md @@ -0,0 +1,48 @@ +# `gog classroom guardian-invitations list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List guardian invitations + +## Usage + +```bash +gog classroom (class) guardian-invitations (guardian-invites) list (ls) <studentId> [flags] +``` + +## Parent + +- [gog classroom guardian-invitations](gog-classroom-guardian-invitations.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 | +| `--email` | `string` | | Filter by invited email address | +| `--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. | +| `--state` | `string` | | Invitation states filter (comma-separated: PENDING,COMPLETE) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog classroom guardian-invitations](gog-classroom-guardian-invitations.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-guardian-invitations.md b/docs/commands/gog-classroom-guardian-invitations.md new file mode 100644 index 0000000..737ac91 --- /dev/null +++ b/docs/commands/gog-classroom-guardian-invitations.md @@ -0,0 +1,48 @@ +# `gog classroom guardian-invitations` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Guardian invitations + +## Usage + +```bash +gog classroom (class) guardian-invitations (guardian-invites) <command> +``` + +## Parent + +- [gog classroom](gog-classroom.md) + +## Subcommands + +- [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 + +## 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 classroom](gog-classroom.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-guardians-delete.md b/docs/commands/gog-classroom-guardians-delete.md new file mode 100644 index 0000000..d0ae56c --- /dev/null +++ b/docs/commands/gog-classroom-guardians-delete.md @@ -0,0 +1,42 @@ +# `gog classroom guardians delete` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete a guardian + +## Usage + +```bash +gog classroom (class) guardians (guardian) delete (rm,del,remove) <studentId> <guardianId> +``` + +## Parent + +- [gog classroom guardians](gog-classroom-guardians.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 classroom guardians](gog-classroom-guardians.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-guardians-get.md b/docs/commands/gog-classroom-guardians-get.md new file mode 100644 index 0000000..0f7bac9 --- /dev/null +++ b/docs/commands/gog-classroom-guardians-get.md @@ -0,0 +1,42 @@ +# `gog classroom guardians get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get a guardian + +## Usage + +```bash +gog classroom (class) guardians (guardian) get (info,show) <studentId> <guardianId> +``` + +## Parent + +- [gog classroom guardians](gog-classroom-guardians.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 classroom guardians](gog-classroom-guardians.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-guardians-list.md b/docs/commands/gog-classroom-guardians-list.md new file mode 100644 index 0000000..9454ad5 --- /dev/null +++ b/docs/commands/gog-classroom-guardians-list.md @@ -0,0 +1,47 @@ +# `gog classroom guardians list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List guardians + +## Usage + +```bash +gog classroom (class) guardians (guardian) list (ls) <studentId> [flags] +``` + +## Parent + +- [gog classroom guardians](gog-classroom-guardians.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 | +| `--email` | `string` | | Filter by invited email address | +| `--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 classroom guardians](gog-classroom-guardians.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-guardians.md b/docs/commands/gog-classroom-guardians.md new file mode 100644 index 0000000..6ac0320 --- /dev/null +++ b/docs/commands/gog-classroom-guardians.md @@ -0,0 +1,48 @@ +# `gog classroom guardians` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Guardians + +## Usage + +```bash +gog classroom (class) guardians (guardian) <command> +``` + +## Parent + +- [gog classroom](gog-classroom.md) + +## Subcommands + +- [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 + +## 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 classroom](gog-classroom.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-invitations-accept.md b/docs/commands/gog-classroom-invitations-accept.md new file mode 100644 index 0000000..8ce3b4e --- /dev/null +++ b/docs/commands/gog-classroom-invitations-accept.md @@ -0,0 +1,42 @@ +# `gog classroom invitations accept` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Accept an invitation + +## Usage + +```bash +gog classroom (class) invitations (invitation,invites) accept (join) <invitationId> +``` + +## Parent + +- [gog classroom invitations](gog-classroom-invitations.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 classroom invitations](gog-classroom-invitations.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-invitations-create.md b/docs/commands/gog-classroom-invitations-create.md new file mode 100644 index 0000000..d48d079 --- /dev/null +++ b/docs/commands/gog-classroom-invitations-create.md @@ -0,0 +1,43 @@ +# `gog classroom invitations create` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create an invitation + +## Usage + +```bash +gog classroom (class) invitations (invitation,invites) create (add,new) --role=STRING <courseId> <userId> +``` + +## Parent + +- [gog classroom invitations](gog-classroom-invitations.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` | | Role: STUDENT, TEACHER, 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 classroom invitations](gog-classroom-invitations.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-invitations-delete.md b/docs/commands/gog-classroom-invitations-delete.md new file mode 100644 index 0000000..1b34c89 --- /dev/null +++ b/docs/commands/gog-classroom-invitations-delete.md @@ -0,0 +1,42 @@ +# `gog classroom invitations delete` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete an invitation + +## Usage + +```bash +gog classroom (class) invitations (invitation,invites) delete (rm,del,remove) <invitationId> +``` + +## Parent + +- [gog classroom invitations](gog-classroom-invitations.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 classroom invitations](gog-classroom-invitations.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-invitations-get.md b/docs/commands/gog-classroom-invitations-get.md new file mode 100644 index 0000000..aa6c29c --- /dev/null +++ b/docs/commands/gog-classroom-invitations-get.md @@ -0,0 +1,42 @@ +# `gog classroom invitations get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get an invitation + +## Usage + +```bash +gog classroom (class) invitations (invitation,invites) get (info,show) <invitationId> +``` + +## Parent + +- [gog classroom invitations](gog-classroom-invitations.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 classroom invitations](gog-classroom-invitations.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-invitations-list.md b/docs/commands/gog-classroom-invitations-list.md new file mode 100644 index 0000000..c06a859 --- /dev/null +++ b/docs/commands/gog-classroom-invitations-list.md @@ -0,0 +1,48 @@ +# `gog classroom invitations list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List invitations + +## Usage + +```bash +gog classroom (class) invitations (invitation,invites) list (ls) [flags] +``` + +## Parent + +- [gog classroom invitations](gog-classroom-invitations.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 | +| `--course` | `string` | | Filter by course ID | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `--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. | +| `--user` | `string` | | Filter by user ID or email | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog classroom invitations](gog-classroom-invitations.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-invitations.md b/docs/commands/gog-classroom-invitations.md new file mode 100644 index 0000000..deaa599 --- /dev/null +++ b/docs/commands/gog-classroom-invitations.md @@ -0,0 +1,50 @@ +# `gog classroom invitations` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Invitations + +## Usage + +```bash +gog classroom (class) invitations (invitation,invites) <command> +``` + +## Parent + +- [gog classroom](gog-classroom.md) + +## Subcommands + +- [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 + +## 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 classroom](gog-classroom.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-materials-create.md b/docs/commands/gog-classroom-materials-create.md new file mode 100644 index 0000000..f9d2ee1 --- /dev/null +++ b/docs/commands/gog-classroom-materials-create.md @@ -0,0 +1,47 @@ +# `gog classroom materials create` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create coursework material + +## Usage + +```bash +gog classroom (class) materials (material) create (add,new) --title=STRING <courseId> [flags] +``` + +## Parent + +- [gog classroom materials](gog-classroom-materials.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` | | 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) | +| `--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) | +| `--scheduled` | `string` | | Scheduled publish time (RFC3339) | +| `--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. | +| `--state` | `string` | | State: PUBLISHED, DRAFT | +| `--title` | `string` | | Title | +| `--topic` | `string` | | Topic ID | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog classroom materials](gog-classroom-materials.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-materials-delete.md b/docs/commands/gog-classroom-materials-delete.md new file mode 100644 index 0000000..98b171e --- /dev/null +++ b/docs/commands/gog-classroom-materials-delete.md @@ -0,0 +1,42 @@ +# `gog classroom materials delete` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete coursework material + +## Usage + +```bash +gog classroom (class) materials (material) delete (rm,del,remove) <courseId> <materialId> +``` + +## Parent + +- [gog classroom materials](gog-classroom-materials.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 classroom materials](gog-classroom-materials.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-materials-get.md b/docs/commands/gog-classroom-materials-get.md new file mode 100644 index 0000000..f7afb76 --- /dev/null +++ b/docs/commands/gog-classroom-materials-get.md @@ -0,0 +1,42 @@ +# `gog classroom materials get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get coursework material + +## Usage + +```bash +gog classroom (class) materials (material) get (info,show) <courseId> <materialId> +``` + +## Parent + +- [gog classroom materials](gog-classroom-materials.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 classroom materials](gog-classroom-materials.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-materials-list.md b/docs/commands/gog-classroom-materials-list.md new file mode 100644 index 0000000..302265d --- /dev/null +++ b/docs/commands/gog-classroom-materials-list.md @@ -0,0 +1,50 @@ +# `gog classroom materials list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List coursework materials + +## Usage + +```bash +gog classroom (class) materials (material) list (ls) <courseId> [flags] +``` + +## Parent + +- [gog classroom materials](gog-classroom-materials.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) | +| `--order-by` | `string` | | Order by (e.g., updateTime desc) | +| `--page`<br>`--cursor` | `string` | | Page token | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--scan-pages` | `int` | 3 | Pages to scan when filtering by topic | +| `--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. | +| `--state` | `string` | | Material states filter (comma-separated: PUBLISHED,DRAFT,DELETED) | +| `--topic` | `string` | | Filter by topic ID | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog classroom materials](gog-classroom-materials.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-materials-update.md b/docs/commands/gog-classroom-materials-update.md new file mode 100644 index 0000000..24d209f --- /dev/null +++ b/docs/commands/gog-classroom-materials-update.md @@ -0,0 +1,47 @@ +# `gog classroom materials update` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Update coursework material + +## Usage + +```bash +gog classroom (class) materials (material) update (edit,set) <courseId> <materialId> [flags] +``` + +## Parent + +- [gog classroom materials](gog-classroom-materials.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` | | 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) | +| `--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) | +| `--scheduled` | `string` | | Scheduled publish time (RFC3339) | +| `--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. | +| `--state` | `string` | | State: PUBLISHED, DRAFT | +| `--title` | `string` | | Title | +| `--topic` | `string` | | Topic ID | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog classroom materials](gog-classroom-materials.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-materials.md b/docs/commands/gog-classroom-materials.md new file mode 100644 index 0000000..ffb755a --- /dev/null +++ b/docs/commands/gog-classroom-materials.md @@ -0,0 +1,50 @@ +# `gog classroom materials` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Coursework materials + +## Usage + +```bash +gog classroom (class) materials (material) <command> +``` + +## Parent + +- [gog classroom](gog-classroom.md) + +## Subcommands + +- [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 + +## 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 classroom](gog-classroom.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-profile-get.md b/docs/commands/gog-classroom-profile-get.md new file mode 100644 index 0000000..f66b771 --- /dev/null +++ b/docs/commands/gog-classroom-profile-get.md @@ -0,0 +1,42 @@ +# `gog classroom profile get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get a user profile + +## Usage + +```bash +gog classroom (class) profile (me) get [<userId>] +``` + +## Parent + +- [gog classroom profile](gog-classroom-profile.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 classroom profile](gog-classroom-profile.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-profile.md b/docs/commands/gog-classroom-profile.md new file mode 100644 index 0000000..5bd3755 --- /dev/null +++ b/docs/commands/gog-classroom-profile.md @@ -0,0 +1,46 @@ +# `gog classroom profile` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +User profiles + +## Usage + +```bash +gog classroom (class) profile (me) <command> +``` + +## Parent + +- [gog classroom](gog-classroom.md) + +## Subcommands + +- [gog classroom profile get](gog-classroom-profile-get.md) - Get a user profile + +## 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 classroom](gog-classroom.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-roster.md b/docs/commands/gog-classroom-roster.md new file mode 100644 index 0000000..60f5133 --- /dev/null +++ b/docs/commands/gog-classroom-roster.md @@ -0,0 +1,48 @@ +# `gog classroom roster` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Course roster (students + teachers) + +## Usage + +```bash +gog classroom (class) roster (members) <courseId> [flags] +``` + +## Parent + +- [gog classroom](gog-classroom.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 (per role) | +| `--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 (per role) | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--page`<br>`--cursor` | `string` | | Page token (per role) | +| `-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. | +| `--students` | `bool` | | Include students | +| `--teachers` | `bool` | | Include teachers | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog classroom](gog-classroom.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-students-add.md b/docs/commands/gog-classroom-students-add.md new file mode 100644 index 0000000..2fdc556 --- /dev/null +++ b/docs/commands/gog-classroom-students-add.md @@ -0,0 +1,43 @@ +# `gog classroom students add` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Add a student + +## Usage + +```bash +gog classroom (class) students (student) add (create,new) <courseId> <userId> [flags] +``` + +## Parent + +- [gog classroom students](gog-classroom-students.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) | +| `--enrollment-code` | `string` | | Enrollment code | +| `-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 classroom students](gog-classroom-students.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-students-get.md b/docs/commands/gog-classroom-students-get.md new file mode 100644 index 0000000..582ea88 --- /dev/null +++ b/docs/commands/gog-classroom-students-get.md @@ -0,0 +1,42 @@ +# `gog classroom students get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get a student + +## Usage + +```bash +gog classroom (class) students (student) get (info,show) <courseId> <userId> +``` + +## Parent + +- [gog classroom students](gog-classroom-students.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 classroom students](gog-classroom-students.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-students-list.md b/docs/commands/gog-classroom-students-list.md new file mode 100644 index 0000000..824d730 --- /dev/null +++ b/docs/commands/gog-classroom-students-list.md @@ -0,0 +1,46 @@ +# `gog classroom students list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List students + +## Usage + +```bash +gog classroom (class) students (student) list (ls) <courseId> [flags] +``` + +## Parent + +- [gog classroom students](gog-classroom-students.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 classroom students](gog-classroom-students.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-students-remove.md b/docs/commands/gog-classroom-students-remove.md new file mode 100644 index 0000000..08f52d9 --- /dev/null +++ b/docs/commands/gog-classroom-students-remove.md @@ -0,0 +1,42 @@ +# `gog classroom students remove` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Remove a student + +## Usage + +```bash +gog classroom (class) students (student) remove (delete,rm,del,remove) <courseId> <userId> +``` + +## Parent + +- [gog classroom students](gog-classroom-students.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 classroom students](gog-classroom-students.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-students.md b/docs/commands/gog-classroom-students.md new file mode 100644 index 0000000..d5417d6 --- /dev/null +++ b/docs/commands/gog-classroom-students.md @@ -0,0 +1,49 @@ +# `gog classroom students` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Course students + +## Usage + +```bash +gog classroom (class) students (student) <command> +``` + +## Parent + +- [gog classroom](gog-classroom.md) + +## Subcommands + +- [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 + +## 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 classroom](gog-classroom.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-submissions-get.md b/docs/commands/gog-classroom-submissions-get.md new file mode 100644 index 0000000..359f6d2 --- /dev/null +++ b/docs/commands/gog-classroom-submissions-get.md @@ -0,0 +1,42 @@ +# `gog classroom submissions get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get a student submission + +## Usage + +```bash +gog classroom (class) submissions (submission) get (info,show) <courseId> <courseworkId> <submissionId> +``` + +## Parent + +- [gog classroom submissions](gog-classroom-submissions.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 classroom submissions](gog-classroom-submissions.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-submissions-grade.md b/docs/commands/gog-classroom-submissions-grade.md new file mode 100644 index 0000000..291e94b --- /dev/null +++ b/docs/commands/gog-classroom-submissions-grade.md @@ -0,0 +1,44 @@ +# `gog classroom submissions grade` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Set draft/assigned grades + +## Usage + +```bash +gog classroom (class) submissions (submission) grade (set,edit) <courseId> <courseworkId> <submissionId> [flags] +``` + +## Parent + +- [gog classroom submissions](gog-classroom-submissions.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) | +| `--assigned` | `string` | | Assigned grade | +| `--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 | +| `--draft` | `string` | | Draft grade | +| `-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 classroom submissions](gog-classroom-submissions.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-submissions-list.md b/docs/commands/gog-classroom-submissions-list.md new file mode 100644 index 0000000..ec147e4 --- /dev/null +++ b/docs/commands/gog-classroom-submissions-list.md @@ -0,0 +1,49 @@ +# `gog classroom submissions list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List student submissions + +## Usage + +```bash +gog classroom (class) submissions (submission) list (ls) <courseId> <courseworkId> [flags] +``` + +## Parent + +- [gog classroom submissions](gog-classroom-submissions.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) | +| `--late` | `string` | | Late filter: late\|not-late | +| `--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. | +| `--state` | `string` | | Submission states filter (comma-separated: NEW,CREATED,TURNED_IN,RETURNED,RECLAIMED_BY_STUDENT) | +| `--user` | `string` | | Filter by user ID or email | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog classroom submissions](gog-classroom-submissions.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-submissions-reclaim.md b/docs/commands/gog-classroom-submissions-reclaim.md new file mode 100644 index 0000000..018127b --- /dev/null +++ b/docs/commands/gog-classroom-submissions-reclaim.md @@ -0,0 +1,42 @@ +# `gog classroom submissions reclaim` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Reclaim a submission + +## Usage + +```bash +gog classroom (class) submissions (submission) reclaim (undo) <courseId> <courseworkId> <submissionId> +``` + +## Parent + +- [gog classroom submissions](gog-classroom-submissions.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 classroom submissions](gog-classroom-submissions.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-submissions-return.md b/docs/commands/gog-classroom-submissions-return.md new file mode 100644 index 0000000..b5537b9 --- /dev/null +++ b/docs/commands/gog-classroom-submissions-return.md @@ -0,0 +1,42 @@ +# `gog classroom submissions return` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Return a submission + +## Usage + +```bash +gog classroom (class) submissions (submission) return (send) <courseId> <courseworkId> <submissionId> +``` + +## Parent + +- [gog classroom submissions](gog-classroom-submissions.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 classroom submissions](gog-classroom-submissions.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-submissions-turn-in.md b/docs/commands/gog-classroom-submissions-turn-in.md new file mode 100644 index 0000000..1b08a08 --- /dev/null +++ b/docs/commands/gog-classroom-submissions-turn-in.md @@ -0,0 +1,42 @@ +# `gog classroom submissions turn-in` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Turn in a submission + +## Usage + +```bash +gog classroom (class) submissions (submission) turn-in (turnin) <courseId> <courseworkId> <submissionId> +``` + +## Parent + +- [gog classroom submissions](gog-classroom-submissions.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 classroom submissions](gog-classroom-submissions.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-submissions.md b/docs/commands/gog-classroom-submissions.md new file mode 100644 index 0000000..151f042 --- /dev/null +++ b/docs/commands/gog-classroom-submissions.md @@ -0,0 +1,51 @@ +# `gog classroom submissions` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Student submissions + +## Usage + +```bash +gog classroom (class) submissions (submission) <command> +``` + +## Parent + +- [gog classroom](gog-classroom.md) + +## Subcommands + +- [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 + +## 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 classroom](gog-classroom.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-teachers-add.md b/docs/commands/gog-classroom-teachers-add.md new file mode 100644 index 0000000..3bff9c0 --- /dev/null +++ b/docs/commands/gog-classroom-teachers-add.md @@ -0,0 +1,42 @@ +# `gog classroom teachers add` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Add a teacher + +## Usage + +```bash +gog classroom (class) teachers (teacher) add (create,new) <courseId> <userId> +``` + +## Parent + +- [gog classroom teachers](gog-classroom-teachers.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 classroom teachers](gog-classroom-teachers.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-teachers-get.md b/docs/commands/gog-classroom-teachers-get.md new file mode 100644 index 0000000..c80821f --- /dev/null +++ b/docs/commands/gog-classroom-teachers-get.md @@ -0,0 +1,42 @@ +# `gog classroom teachers get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get a teacher + +## Usage + +```bash +gog classroom (class) teachers (teacher) get (info,show) <courseId> <userId> +``` + +## Parent + +- [gog classroom teachers](gog-classroom-teachers.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 classroom teachers](gog-classroom-teachers.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-teachers-list.md b/docs/commands/gog-classroom-teachers-list.md new file mode 100644 index 0000000..4dfb4c0 --- /dev/null +++ b/docs/commands/gog-classroom-teachers-list.md @@ -0,0 +1,46 @@ +# `gog classroom teachers list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List teachers + +## Usage + +```bash +gog classroom (class) teachers (teacher) list (ls) <courseId> [flags] +``` + +## Parent + +- [gog classroom teachers](gog-classroom-teachers.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 classroom teachers](gog-classroom-teachers.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-teachers-remove.md b/docs/commands/gog-classroom-teachers-remove.md new file mode 100644 index 0000000..aaf1e00 --- /dev/null +++ b/docs/commands/gog-classroom-teachers-remove.md @@ -0,0 +1,42 @@ +# `gog classroom teachers remove` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Remove a teacher + +## Usage + +```bash +gog classroom (class) teachers (teacher) remove (delete,rm,del,remove) <courseId> <userId> +``` + +## Parent + +- [gog classroom teachers](gog-classroom-teachers.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 classroom teachers](gog-classroom-teachers.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-teachers.md b/docs/commands/gog-classroom-teachers.md new file mode 100644 index 0000000..adf5f96 --- /dev/null +++ b/docs/commands/gog-classroom-teachers.md @@ -0,0 +1,49 @@ +# `gog classroom teachers` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Course teachers + +## Usage + +```bash +gog classroom (class) teachers (teacher) <command> +``` + +## Parent + +- [gog classroom](gog-classroom.md) + +## Subcommands + +- [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 + +## 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 classroom](gog-classroom.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-topics-create.md b/docs/commands/gog-classroom-topics-create.md new file mode 100644 index 0000000..f267589 --- /dev/null +++ b/docs/commands/gog-classroom-topics-create.md @@ -0,0 +1,43 @@ +# `gog classroom topics create` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create a topic + +## Usage + +```bash +gog classroom (class) topics (topic) create (add,new) --name=STRING <courseId> +``` + +## Parent + +- [gog classroom topics](gog-classroom-topics.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) | +| `--name` | `string` | | Topic name | +| `--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 classroom topics](gog-classroom-topics.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-topics-delete.md b/docs/commands/gog-classroom-topics-delete.md new file mode 100644 index 0000000..9a486f4 --- /dev/null +++ b/docs/commands/gog-classroom-topics-delete.md @@ -0,0 +1,42 @@ +# `gog classroom topics delete` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete a topic + +## Usage + +```bash +gog classroom (class) topics (topic) delete (rm,del,remove) <courseId> <topicId> +``` + +## Parent + +- [gog classroom topics](gog-classroom-topics.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 classroom topics](gog-classroom-topics.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-topics-get.md b/docs/commands/gog-classroom-topics-get.md new file mode 100644 index 0000000..035510f --- /dev/null +++ b/docs/commands/gog-classroom-topics-get.md @@ -0,0 +1,42 @@ +# `gog classroom topics get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get a topic + +## Usage + +```bash +gog classroom (class) topics (topic) get (info,show) <courseId> <topicId> +``` + +## Parent + +- [gog classroom topics](gog-classroom-topics.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 classroom topics](gog-classroom-topics.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-topics-list.md b/docs/commands/gog-classroom-topics-list.md new file mode 100644 index 0000000..68da0c1 --- /dev/null +++ b/docs/commands/gog-classroom-topics-list.md @@ -0,0 +1,46 @@ +# `gog classroom topics list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List topics + +## Usage + +```bash +gog classroom (class) topics (topic) list (ls) <courseId> [flags] +``` + +## Parent + +- [gog classroom topics](gog-classroom-topics.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 classroom topics](gog-classroom-topics.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-topics-update.md b/docs/commands/gog-classroom-topics-update.md new file mode 100644 index 0000000..e2dbd69 --- /dev/null +++ b/docs/commands/gog-classroom-topics-update.md @@ -0,0 +1,43 @@ +# `gog classroom topics update` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Update a topic + +## Usage + +```bash +gog classroom (class) topics (topic) update (edit,set) --name=STRING <courseId> <topicId> +``` + +## Parent + +- [gog classroom topics](gog-classroom-topics.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) | +| `--name` | `string` | | Topic name | +| `--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 classroom topics](gog-classroom-topics.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom-topics.md b/docs/commands/gog-classroom-topics.md new file mode 100644 index 0000000..d750082 --- /dev/null +++ b/docs/commands/gog-classroom-topics.md @@ -0,0 +1,50 @@ +# `gog classroom topics` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Topics + +## Usage + +```bash +gog classroom (class) topics (topic) <command> +``` + +## Parent + +- [gog classroom](gog-classroom.md) + +## Subcommands + +- [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 + +## 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 classroom](gog-classroom.md) +- [Command index](README.md) diff --git a/docs/commands/gog-classroom.md b/docs/commands/gog-classroom.md new file mode 100644 index 0000000..058062c --- /dev/null +++ b/docs/commands/gog-classroom.md @@ -0,0 +1,58 @@ +# `gog classroom` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Google Classroom + +## Usage + +```bash +gog classroom (class) <command> [flags] +``` + +## Parent + +- [gog](gog.md) + +## Subcommands + +- [gog classroom announcements](gog-classroom-announcements.md) - Announcements +- [gog classroom courses](gog-classroom-courses.md) - Courses +- [gog classroom coursework](gog-classroom-coursework.md) - Coursework +- [gog classroom guardian-invitations](gog-classroom-guardian-invitations.md) - Guardian invitations +- [gog classroom guardians](gog-classroom-guardians.md) - Guardians +- [gog classroom invitations](gog-classroom-invitations.md) - Invitations +- [gog classroom materials](gog-classroom-materials.md) - Coursework materials +- [gog classroom profile](gog-classroom-profile.md) - User profiles +- [gog classroom roster](gog-classroom-roster.md) - Course roster (students + teachers) +- [gog classroom students](gog-classroom-students.md) - Course students +- [gog classroom submissions](gog-classroom-submissions.md) - Student submissions +- [gog classroom teachers](gog-classroom-teachers.md) - Course teachers +- [gog classroom topics](gog-classroom-topics.md) - Topics + +## 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) diff --git a/docs/commands/gog-completion.md b/docs/commands/gog-completion.md new file mode 100644 index 0000000..573800a --- /dev/null +++ b/docs/commands/gog-completion.md @@ -0,0 +1,42 @@ +# `gog completion` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Generate shell completion scripts + +## Usage + +```bash +gog completion <shell> [flags] +``` + +## Parent + +- [gog](gog.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](gog.md) +- [Command index](README.md) diff --git a/docs/commands/gog-config-get.md b/docs/commands/gog-config-get.md new file mode 100644 index 0000000..6d5f471 --- /dev/null +++ b/docs/commands/gog-config-get.md @@ -0,0 +1,42 @@ +# `gog config get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get a config value + +## Usage + +```bash +gog config get (show) <key> +``` + +## Parent + +- [gog config](gog-config.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 config](gog-config.md) +- [Command index](README.md) diff --git a/docs/commands/gog-config-keys.md b/docs/commands/gog-config-keys.md new file mode 100644 index 0000000..59c6f8c --- /dev/null +++ b/docs/commands/gog-config-keys.md @@ -0,0 +1,42 @@ +# `gog config keys` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List available config keys + +## Usage + +```bash +gog config keys (list-keys,names) +``` + +## Parent + +- [gog config](gog-config.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 config](gog-config.md) +- [Command index](README.md) diff --git a/docs/commands/gog-config-list.md b/docs/commands/gog-config-list.md new file mode 100644 index 0000000..abbc427 --- /dev/null +++ b/docs/commands/gog-config-list.md @@ -0,0 +1,42 @@ +# `gog config list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List all config values + +## Usage + +```bash +gog config list (ls,all) +``` + +## Parent + +- [gog config](gog-config.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 config](gog-config.md) +- [Command index](README.md) diff --git a/docs/commands/gog-config-no-send-list.md b/docs/commands/gog-config-no-send-list.md new file mode 100644 index 0000000..fa7bf48 --- /dev/null +++ b/docs/commands/gog-config-no-send-list.md @@ -0,0 +1,42 @@ +# `gog config no-send list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List accounts with no-send guards + +## Usage + +```bash +gog config no-send (nosend) list (ls) +``` + +## Parent + +- [gog config no-send](gog-config-no-send.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 config no-send](gog-config-no-send.md) +- [Command index](README.md) diff --git a/docs/commands/gog-config-no-send-remove.md b/docs/commands/gog-config-no-send-remove.md new file mode 100644 index 0000000..edecf59 --- /dev/null +++ b/docs/commands/gog-config-no-send-remove.md @@ -0,0 +1,42 @@ +# `gog config no-send remove` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Remove an account no-send guard + +## Usage + +```bash +gog config no-send (nosend) remove (rm,del,delete,unset,disable) <account> +``` + +## Parent + +- [gog config no-send](gog-config-no-send.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 config no-send](gog-config-no-send.md) +- [Command index](README.md) diff --git a/docs/commands/gog-config-no-send-set.md b/docs/commands/gog-config-no-send-set.md new file mode 100644 index 0000000..51ccf51 --- /dev/null +++ b/docs/commands/gog-config-no-send-set.md @@ -0,0 +1,42 @@ +# `gog config no-send set` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Block Gmail send operations for an account + +## Usage + +```bash +gog config no-send (nosend) set (add,enable) <account> +``` + +## Parent + +- [gog config no-send](gog-config-no-send.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 config no-send](gog-config-no-send.md) +- [Command index](README.md) diff --git a/docs/commands/gog-config-no-send.md b/docs/commands/gog-config-no-send.md new file mode 100644 index 0000000..3ab0501 --- /dev/null +++ b/docs/commands/gog-config-no-send.md @@ -0,0 +1,48 @@ +# `gog config no-send` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Manage per-account Gmail no-send guards + +## Usage + +```bash +gog config no-send (nosend) <command> +``` + +## Parent + +- [gog config](gog-config.md) + +## Subcommands + +- [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 + +## 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 config](gog-config.md) +- [Command index](README.md) diff --git a/docs/commands/gog-config-path.md b/docs/commands/gog-config-path.md new file mode 100644 index 0000000..953c0e2 --- /dev/null +++ b/docs/commands/gog-config-path.md @@ -0,0 +1,42 @@ +# `gog config path` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Print config file path + +## Usage + +```bash +gog config path (where) +``` + +## Parent + +- [gog config](gog-config.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 config](gog-config.md) +- [Command index](README.md) diff --git a/docs/commands/gog-config-set.md b/docs/commands/gog-config-set.md new file mode 100644 index 0000000..3e7fb49 --- /dev/null +++ b/docs/commands/gog-config-set.md @@ -0,0 +1,42 @@ +# `gog config set` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Set a config value + +## Usage + +```bash +gog config set (add,update) <key> <value> +``` + +## Parent + +- [gog config](gog-config.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 config](gog-config.md) +- [Command index](README.md) diff --git a/docs/commands/gog-config-unset.md b/docs/commands/gog-config-unset.md new file mode 100644 index 0000000..c919a0b --- /dev/null +++ b/docs/commands/gog-config-unset.md @@ -0,0 +1,42 @@ +# `gog config unset` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Unset a config value + +## Usage + +```bash +gog config unset (rm,del,remove) <key> +``` + +## Parent + +- [gog config](gog-config.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 config](gog-config.md) +- [Command index](README.md) diff --git a/docs/commands/gog-config.md b/docs/commands/gog-config.md new file mode 100644 index 0000000..fafa5ac --- /dev/null +++ b/docs/commands/gog-config.md @@ -0,0 +1,52 @@ +# `gog config` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Manage configuration + +## Usage + +```bash +gog config <command> [flags] +``` + +## Parent + +- [gog](gog.md) + +## Subcommands + +- [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 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 + +## 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) diff --git a/docs/commands/gog-contacts-create.md b/docs/commands/gog-contacts-create.md new file mode 100644 index 0000000..6d84a19 --- /dev/null +++ b/docs/commands/gog-contacts-create.md @@ -0,0 +1,54 @@ +# `gog contacts create` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create a contact + +## Usage + +```bash +gog contacts (contact) create (add,new) [flags] +``` + +## Parent + +- [gog contacts](gog-contacts.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) | +| `--address` | `[]string` | | Postal address (can be repeated for multiple addresses) | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--custom` | `[]string` | | Custom field as key=value (can be repeated) | +| `--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 | +| `--email` | `string` | | Email address | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `--family` | `string` | | Family name | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gender` | `string` | | Gender value | +| `--given` | `string` | | Given name (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) | +| `--note` | `string` | | Note/biography | +| `--org` | `string` | | Organization/company name | +| `--phone` | `string` | | Phone number | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--relation` | `[]string` | | Relation as type=person (can be repeated) | +| `--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` | | Job title | +| `--url` | `[]string` | | URL (can be repeated for multiple URLs) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog contacts](gog-contacts.md) +- [Command index](README.md) diff --git a/docs/commands/gog-contacts-delete.md b/docs/commands/gog-contacts-delete.md new file mode 100644 index 0000000..6671b69 --- /dev/null +++ b/docs/commands/gog-contacts-delete.md @@ -0,0 +1,42 @@ +# `gog contacts delete` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete a contact + +## Usage + +```bash +gog contacts (contact) delete (rm,del,remove) <resourceName> +``` + +## Parent + +- [gog contacts](gog-contacts.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 contacts](gog-contacts.md) +- [Command index](README.md) diff --git a/docs/commands/gog-contacts-directory-list.md b/docs/commands/gog-contacts-directory-list.md new file mode 100644 index 0000000..6ce2e56 --- /dev/null +++ b/docs/commands/gog-contacts-directory-list.md @@ -0,0 +1,46 @@ +# `gog contacts directory list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List people from the Workspace directory + +## Usage + +```bash +gog contacts (contact) directory list [flags] +``` + +## Parent + +- [gog contacts directory](gog-contacts-directory.md) + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--all`<br>`--all-pages`<br>`--allpages` | `bool` | | Fetch all pages | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `--fail-empty`<br>`--non-empty`<br>`--require-results` | `bool` | | Exit with code 3 if no results | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--max`<br>`--limit` | `int64` | 50 | Max results | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--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 contacts directory](gog-contacts-directory.md) +- [Command index](README.md) diff --git a/docs/commands/gog-contacts-directory-search.md b/docs/commands/gog-contacts-directory-search.md new file mode 100644 index 0000000..51b649e --- /dev/null +++ b/docs/commands/gog-contacts-directory-search.md @@ -0,0 +1,46 @@ +# `gog contacts directory search` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Search people in the Workspace directory + +## Usage + +```bash +gog contacts (contact) directory search <query> ... [flags] +``` + +## Parent + +- [gog contacts directory](gog-contacts-directory.md) + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--all`<br>`--all-pages`<br>`--allpages` | `bool` | | Fetch all pages | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `--fail-empty`<br>`--non-empty`<br>`--require-results` | `bool` | | Exit with code 3 if no results | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--max`<br>`--limit` | `int64` | 50 | Max results | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--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 contacts directory](gog-contacts-directory.md) +- [Command index](README.md) diff --git a/docs/commands/gog-contacts-directory.md b/docs/commands/gog-contacts-directory.md new file mode 100644 index 0000000..340b084 --- /dev/null +++ b/docs/commands/gog-contacts-directory.md @@ -0,0 +1,47 @@ +# `gog contacts directory` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Directory contacts + +## Usage + +```bash +gog contacts (contact) directory <command> +``` + +## Parent + +- [gog contacts](gog-contacts.md) + +## Subcommands + +- [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 + +## 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 contacts](gog-contacts.md) +- [Command index](README.md) diff --git a/docs/commands/gog-contacts-export.md b/docs/commands/gog-contacts-export.md new file mode 100644 index 0000000..dc2ff38 --- /dev/null +++ b/docs/commands/gog-contacts-export.md @@ -0,0 +1,48 @@ +# `gog contacts export` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Export contacts as vCard (.vcf) + +## Usage + +```bash +gog contacts (contact) export [<selector>] [flags] +``` + +## Parent + +- [gog contacts](gog-contacts.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` | | Export all personal contacts | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--max`<br>`--limit` | `int64` | 30 | Max results for --query (1-30) | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `-o`<br>`--out` | `string` | - | Output path (.vcf), or - for stdout | +| `--page` | `string` | | Start page token for --all | +| `--page-size` | `int64` | 1000 | Page size for --all (1-1000) | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--query` | `string` | | Search query to export (max 30 results) | +| `--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 contacts](gog-contacts.md) +- [Command index](README.md) diff --git a/docs/commands/gog-contacts-get.md b/docs/commands/gog-contacts-get.md new file mode 100644 index 0000000..2d4343f --- /dev/null +++ b/docs/commands/gog-contacts-get.md @@ -0,0 +1,42 @@ +# `gog contacts get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get a contact + +## Usage + +```bash +gog contacts (contact) get (info,show) <resourceName> +``` + +## Parent + +- [gog contacts](gog-contacts.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 contacts](gog-contacts.md) +- [Command index](README.md) diff --git a/docs/commands/gog-contacts-list.md b/docs/commands/gog-contacts-list.md new file mode 100644 index 0000000..2db6247 --- /dev/null +++ b/docs/commands/gog-contacts-list.md @@ -0,0 +1,44 @@ +# `gog contacts list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List contacts + +## Usage + +```bash +gog contacts (contact) list (ls) [flags] +``` + +## Parent + +- [gog contacts](gog-contacts.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) | +| `--max`<br>`--limit` | `int64` | 100 | Max results | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--page` | `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 contacts](gog-contacts.md) +- [Command index](README.md) diff --git a/docs/commands/gog-contacts-other-delete.md b/docs/commands/gog-contacts-other-delete.md new file mode 100644 index 0000000..f3e3efe --- /dev/null +++ b/docs/commands/gog-contacts-other-delete.md @@ -0,0 +1,42 @@ +# `gog contacts other delete` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete an other contact + +## Usage + +```bash +gog contacts (contact) other delete <resourceName> +``` + +## Parent + +- [gog contacts other](gog-contacts-other.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 contacts other](gog-contacts-other.md) +- [Command index](README.md) diff --git a/docs/commands/gog-contacts-other-list.md b/docs/commands/gog-contacts-other-list.md new file mode 100644 index 0000000..141e457 --- /dev/null +++ b/docs/commands/gog-contacts-other-list.md @@ -0,0 +1,46 @@ +# `gog contacts other list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List other contacts + +## Usage + +```bash +gog contacts (contact) other list [flags] +``` + +## Parent + +- [gog contacts other](gog-contacts-other.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 contacts other](gog-contacts-other.md) +- [Command index](README.md) diff --git a/docs/commands/gog-contacts-other-search.md b/docs/commands/gog-contacts-other-search.md new file mode 100644 index 0000000..c07fcd4 --- /dev/null +++ b/docs/commands/gog-contacts-other-search.md @@ -0,0 +1,43 @@ +# `gog contacts other search` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Search other contacts + +## Usage + +```bash +gog contacts (contact) other search <query> ... [flags] +``` + +## Parent + +- [gog contacts other](gog-contacts-other.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) | +| `--max`<br>`--limit` | `int64` | 50 | 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. | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog contacts other](gog-contacts-other.md) +- [Command index](README.md) diff --git a/docs/commands/gog-contacts-other.md b/docs/commands/gog-contacts-other.md new file mode 100644 index 0000000..707a3e1 --- /dev/null +++ b/docs/commands/gog-contacts-other.md @@ -0,0 +1,48 @@ +# `gog contacts other` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Other contacts + +## Usage + +```bash +gog contacts (contact) other <command> +``` + +## Parent + +- [gog contacts](gog-contacts.md) + +## Subcommands + +- [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 + +## 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 contacts](gog-contacts.md) +- [Command index](README.md) diff --git a/docs/commands/gog-contacts-search.md b/docs/commands/gog-contacts-search.md new file mode 100644 index 0000000..a73ac69 --- /dev/null +++ b/docs/commands/gog-contacts-search.md @@ -0,0 +1,43 @@ +# `gog contacts search` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Search contacts by name/email/phone + +## Usage + +```bash +gog contacts (contact) search <query> ... [flags] +``` + +## Parent + +- [gog contacts](gog-contacts.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) | +| `--max`<br>`--limit` | `int64` | 50 | 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. | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog contacts](gog-contacts.md) +- [Command index](README.md) diff --git a/docs/commands/gog-contacts-update.md b/docs/commands/gog-contacts-update.md new file mode 100644 index 0000000..fb4e088 --- /dev/null +++ b/docs/commands/gog-contacts-update.md @@ -0,0 +1,58 @@ +# `gog contacts update` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Update a contact + +## Usage + +```bash +gog contacts (contact) update (edit,set) <resourceName> [flags] +``` + +## Parent + +- [gog contacts](gog-contacts.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) | +| `--address` | `[]string` | | Postal address (can be repeated; empty clears all) | +| `--birthday` | `string` | | Birthday in YYYY-MM-DD (empty clears) | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--custom` | `[]string` | | Custom field as key=value (can be repeated; empty clears all) | +| `--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 | +| `--email` | `string` | | Email address (empty clears) | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `--family` | `string` | | Family name | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--from-file` | `string` | | Update from contact JSON file (use - for stdin) | +| `--gender` | `string` | | Gender value (empty clears) | +| `--given` | `string` | | Given name | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `--ignore-etag` | `bool` | | Allow updating even if the JSON etag is stale (may overwrite concurrent changes) | +| `-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) | +| `--note` | `string` | | Note/biography (empty clears) | +| `--notes` | `string` | | Notes (stored as People API biography; empty clears) | +| `--org` | `string` | | Organization/company name (empty clears) | +| `--phone` | `string` | | Phone number (empty clears) | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--relation` | `[]string` | | Relation as type=person (can be repeated; empty clears all) | +| `--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` | | Job title (empty clears) | +| `--url` | `[]string` | | URL (can be repeated; empty clears all) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog contacts](gog-contacts.md) +- [Command index](README.md) diff --git a/docs/commands/gog-contacts.md b/docs/commands/gog-contacts.md new file mode 100644 index 0000000..a3b5397 --- /dev/null +++ b/docs/commands/gog-contacts.md @@ -0,0 +1,54 @@ +# `gog contacts` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Google Contacts + +## Usage + +```bash +gog contacts (contact) <command> [flags] +``` + +## Parent + +- [gog](gog.md) + +## Subcommands + +- [gog contacts create](gog-contacts-create.md) - Create a contact +- [gog contacts delete](gog-contacts-delete.md) - Delete a contact +- [gog contacts directory](gog-contacts-directory.md) - Directory contacts +- [gog contacts 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 search](gog-contacts-search.md) - Search contacts by name/email/phone +- [gog contacts update](gog-contacts-update.md) - Update a contact + +## 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) diff --git a/docs/commands/gog-docs-add-tab.md b/docs/commands/gog-docs-add-tab.md new file mode 100644 index 0000000..9e1e28d --- /dev/null +++ b/docs/commands/gog-docs-add-tab.md @@ -0,0 +1,46 @@ +# `gog docs add-tab` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Add a tab to a Google Doc + +## Usage + +```bash +gog docs (doc) add-tab <docId> [flags] +``` + +## Parent + +- [gog docs](gog-docs.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. | +| `--icon-emoji` | `string` | | Optional tab emoji icon | +| `--index` | `*int64` | | Zero-based tab index within the parent | +| `-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-tab` | `string` | | Optional parent tab title or ID | +| `-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` | | User-visible tab title | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog docs](gog-docs.md) +- [Command index](README.md) diff --git a/docs/commands/gog-docs-cat.md b/docs/commands/gog-docs-cat.md new file mode 100644 index 0000000..771db6e --- /dev/null +++ b/docs/commands/gog-docs-cat.md @@ -0,0 +1,47 @@ +# `gog docs cat` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Print a Google Doc as plain text + +## Usage + +```bash +gog docs (doc) cat (text,read) <docId> [flags] +``` + +## Parent + +- [gog docs](gog-docs.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-tabs` | `bool` | | Show all tabs with headers | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--max-bytes` | `int64` | 2000000 | Max bytes to read (0 = unlimited) | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `-N`<br>`--numbered` | `bool` | | Prefix each paragraph with its number | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--raw` | `bool` | | Output the raw Google Docs API JSON response without modifications | +| `--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. | +| `--tab` | `string` | | Tab title or ID to read (omit for default behavior) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog docs](gog-docs.md) +- [Command index](README.md) diff --git a/docs/commands/gog-docs-clear.md b/docs/commands/gog-docs-clear.md new file mode 100644 index 0000000..8905882 --- /dev/null +++ b/docs/commands/gog-docs-clear.md @@ -0,0 +1,42 @@ +# `gog docs clear` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Clear all content from a Google Doc + +## Usage + +```bash +gog docs (doc) clear <docId> +``` + +## Parent + +- [gog docs](gog-docs.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 docs](gog-docs.md) +- [Command index](README.md) diff --git a/docs/commands/gog-docs-comments-add.md b/docs/commands/gog-docs-comments-add.md new file mode 100644 index 0000000..b2bc84d --- /dev/null +++ b/docs/commands/gog-docs-comments-add.md @@ -0,0 +1,44 @@ +# `gog docs comments add` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Add a comment to a Google Doc + +## Usage + +```bash +gog docs (doc) comments add (create,new) <docId> <content> [flags] +``` + +## Parent + +- [gog docs comments](gog-docs-comments.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) | +| `--anchor` | `string` | | Anchor JSON string (advanced; editor UIs may still treat as unanchored) | +| `--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) | +| `--quoted` | `string` | | Quoted text to attach to the comment (shown in UIs when available) | +| `--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 docs comments](gog-docs-comments.md) +- [Command index](README.md) diff --git a/docs/commands/gog-docs-comments-delete.md b/docs/commands/gog-docs-comments-delete.md new file mode 100644 index 0000000..8ed9b69 --- /dev/null +++ b/docs/commands/gog-docs-comments-delete.md @@ -0,0 +1,42 @@ +# `gog docs comments delete` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete a comment + +## Usage + +```bash +gog docs (doc) comments delete (rm,del,remove) <docId> <commentId> +``` + +## Parent + +- [gog docs comments](gog-docs-comments.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 docs comments](gog-docs-comments.md) +- [Command index](README.md) diff --git a/docs/commands/gog-docs-comments-get.md b/docs/commands/gog-docs-comments-get.md new file mode 100644 index 0000000..5811613 --- /dev/null +++ b/docs/commands/gog-docs-comments-get.md @@ -0,0 +1,42 @@ +# `gog docs comments get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get a comment by ID + +## Usage + +```bash +gog docs (doc) comments get (info,show) <docId> <commentId> +``` + +## Parent + +- [gog docs comments](gog-docs-comments.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 docs comments](gog-docs-comments.md) +- [Command index](README.md) diff --git a/docs/commands/gog-docs-comments-list.md b/docs/commands/gog-docs-comments-list.md new file mode 100644 index 0000000..04b6339 --- /dev/null +++ b/docs/commands/gog-docs-comments-list.md @@ -0,0 +1,47 @@ +# `gog docs comments list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List comments on a Google Doc + +## Usage + +```bash +gog docs (doc) comments list (ls) <docId> [flags] +``` + +## Parent + +- [gog docs comments](gog-docs-comments.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` | `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. | +| `--include-resolved`<br>`--resolved` | `bool` | | Include resolved comments (default: open only) | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--max`<br>`--limit` | `int64` | 100 | Max results per page | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--page`<br>`--cursor` | `string` | | Page token for pagination | +| `-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 docs comments](gog-docs-comments.md) +- [Command index](README.md) diff --git a/docs/commands/gog-docs-comments-reply.md b/docs/commands/gog-docs-comments-reply.md new file mode 100644 index 0000000..106b81a --- /dev/null +++ b/docs/commands/gog-docs-comments-reply.md @@ -0,0 +1,42 @@ +# `gog docs comments reply` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Reply to a comment + +## Usage + +```bash +gog docs (doc) comments reply (respond) <docId> <commentId> <content> +``` + +## Parent + +- [gog docs comments](gog-docs-comments.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 docs comments](gog-docs-comments.md) +- [Command index](README.md) diff --git a/docs/commands/gog-docs-comments-resolve.md b/docs/commands/gog-docs-comments-resolve.md new file mode 100644 index 0000000..bfffad1 --- /dev/null +++ b/docs/commands/gog-docs-comments-resolve.md @@ -0,0 +1,43 @@ +# `gog docs comments resolve` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Resolve a comment (mark as done) + +## Usage + +```bash +gog docs (doc) comments resolve <docId> <commentId> [flags] +``` + +## Parent + +- [gog docs comments](gog-docs-comments.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) | +| `-m`<br>`--message` | `string` | | Optional message to include when resolving | +| `--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 docs comments](gog-docs-comments.md) +- [Command index](README.md) diff --git a/docs/commands/gog-docs-comments.md b/docs/commands/gog-docs-comments.md new file mode 100644 index 0000000..e5e4a4f --- /dev/null +++ b/docs/commands/gog-docs-comments.md @@ -0,0 +1,51 @@ +# `gog docs comments` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Manage comments on files + +## Usage + +```bash +gog docs (doc) comments <command> +``` + +## Parent + +- [gog docs](gog-docs.md) + +## Subcommands + +- [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) + +## 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 docs](gog-docs.md) +- [Command index](README.md) diff --git a/docs/commands/gog-docs-copy.md b/docs/commands/gog-docs-copy.md new file mode 100644 index 0000000..6117340 --- /dev/null +++ b/docs/commands/gog-docs-copy.md @@ -0,0 +1,43 @@ +# `gog docs copy` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Copy a Google Doc + +## Usage + +```bash +gog docs (doc) copy (cp,duplicate) <docId> <title> [flags] +``` + +## Parent + +- [gog docs](gog-docs.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` | `string` | | Destination folder ID | +| `-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 docs](gog-docs.md) +- [Command index](README.md) diff --git a/docs/commands/gog-docs-create.md b/docs/commands/gog-docs-create.md new file mode 100644 index 0000000..ccfe9ca --- /dev/null +++ b/docs/commands/gog-docs-create.md @@ -0,0 +1,45 @@ +# `gog docs create` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create a Google Doc + +## Usage + +```bash +gog docs (doc) create (add,new) <title> [flags] +``` + +## Parent + +- [gog docs](gog-docs.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) | +| `--file` | `string` | | Markdown file to import. Supports inline images from public HTTPS URLs via ![alt](url); append {width=N height=N} to control size in points. | +| `-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) | +| `--pageless` | `bool` | | Set document to pageless mode | +| `--parent` | `string` | | Destination folder ID | +| `-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 docs](gog-docs.md) +- [Command index](README.md) diff --git a/docs/commands/gog-docs-delete-tab.md b/docs/commands/gog-docs-delete-tab.md new file mode 100644 index 0000000..c4202c1 --- /dev/null +++ b/docs/commands/gog-docs-delete-tab.md @@ -0,0 +1,43 @@ +# `gog docs delete-tab` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete a tab from a Google Doc + +## Usage + +```bash +gog docs (doc) delete-tab <docId> [flags] +``` + +## Parent + +- [gog docs](gog-docs.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. | +| `--tab` | `string` | | Existing tab title or ID | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog docs](gog-docs.md) +- [Command index](README.md) diff --git a/docs/commands/gog-docs-delete.md b/docs/commands/gog-docs-delete.md new file mode 100644 index 0000000..d690235 --- /dev/null +++ b/docs/commands/gog-docs-delete.md @@ -0,0 +1,45 @@ +# `gog docs delete` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete text range from document + +## Usage + +```bash +gog docs (doc) delete --start=INT-64 --end=INT-64 <docId> [flags] +``` + +## Parent + +- [gog docs](gog-docs.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) | +| `--end` | `int64` | | End index (> start) | +| `-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. | +| `--start` | `int64` | | Start index (>= 1) | +| `--tab` | `string` | | Target a specific tab by title or ID (see docs list-tabs) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog docs](gog-docs.md) +- [Command index](README.md) diff --git a/docs/commands/gog-docs-edit.md b/docs/commands/gog-docs-edit.md new file mode 100644 index 0000000..f1e68bc --- /dev/null +++ b/docs/commands/gog-docs-edit.md @@ -0,0 +1,43 @@ +# `gog docs edit` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Find and replace text in a Google Doc + +## Usage + +```bash +gog docs (doc) edit <docId> <find> <replace> [flags] +``` + +## Parent + +- [gog docs](gog-docs.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) | +| `--match-case` | `bool` | | Case-sensitive matching | +| `--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 docs](gog-docs.md) +- [Command index](README.md) diff --git a/docs/commands/gog-docs-export.md b/docs/commands/gog-docs-export.md new file mode 100644 index 0000000..aa83b8f --- /dev/null +++ b/docs/commands/gog-docs-export.md @@ -0,0 +1,45 @@ +# `gog docs export` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Export a Google Doc (pdf|docx|txt|md|html) + +## Usage + +```bash +gog docs (doc) export (download,dl) <docId> [flags] +``` + +## Parent + +- [gog docs](gog-docs.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 | +| `--format` | `string` | pdf | Export format: pdf\|docx\|txt\|md\|html | +| `--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 (default: gogcli config dir) | +| `-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. | +| `--tab` | `string` | | (experimental) Export a specific tab by title or ID (see 'gog docs list-tabs') | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog docs](gog-docs.md) +- [Command index](README.md) diff --git a/docs/commands/gog-docs-find-replace.md b/docs/commands/gog-docs-find-replace.md new file mode 100644 index 0000000..1ad5b35 --- /dev/null +++ b/docs/commands/gog-docs-find-replace.md @@ -0,0 +1,47 @@ +# `gog docs find-replace` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Find and replace text. Supports plain text or markdown with images; use --first for a single occurrence. + +## Usage + +```bash +gog docs (doc) find-replace <docId> <find> [<replace>] [flags] +``` + +## Parent + +- [gog docs](gog-docs.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 | +| `--content-file` | `string` | | Read replacement from a file instead of the positional argument. | +| `--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) | +| `--first` | `bool` | | Replace only the first occurrence instead of all. | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--format` | `string` | plain | Replacement format: plain\|markdown. Markdown converts formatting, tables, and inline images from public HTTPS URLs. | +| `--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) | +| `--match-case` | `bool` | | Case-sensitive matching | +| `--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. | +| `--tab` | `string` | | Target a specific tab by title or ID (see docs list-tabs) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog docs](gog-docs.md) +- [Command index](README.md) diff --git a/docs/commands/gog-docs-info.md b/docs/commands/gog-docs-info.md new file mode 100644 index 0000000..0747e22 --- /dev/null +++ b/docs/commands/gog-docs-info.md @@ -0,0 +1,42 @@ +# `gog docs info` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get Google Doc metadata + +## Usage + +```bash +gog docs (doc) info (get,show) <docId> +``` + +## Parent + +- [gog docs](gog-docs.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 docs](gog-docs.md) +- [Command index](README.md) diff --git a/docs/commands/gog-docs-insert.md b/docs/commands/gog-docs-insert.md new file mode 100644 index 0000000..cd400a0 --- /dev/null +++ b/docs/commands/gog-docs-insert.md @@ -0,0 +1,45 @@ +# `gog docs insert` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Insert text at a specific position + +## Usage + +```bash +gog docs (doc) insert <docId> [<content>] [flags] +``` + +## Parent + +- [gog docs](gog-docs.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) | +| `-f`<br>`--file` | `string` | | Read content from file (use - for stdin) | +| `-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. | +| `--index` | `int64` | 1 | Character index to insert at (1 = beginning) | +| `-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. | +| `--tab` | `string` | | Target a specific tab by title or ID (see docs list-tabs) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog docs](gog-docs.md) +- [Command index](README.md) diff --git a/docs/commands/gog-docs-list-tabs.md b/docs/commands/gog-docs-list-tabs.md new file mode 100644 index 0000000..f090236 --- /dev/null +++ b/docs/commands/gog-docs-list-tabs.md @@ -0,0 +1,42 @@ +# `gog docs list-tabs` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List all tabs in a Google Doc + +## Usage + +```bash +gog docs (doc) list-tabs <docId> +``` + +## Parent + +- [gog docs](gog-docs.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 docs](gog-docs.md) +- [Command index](README.md) diff --git a/docs/commands/gog-docs-rename-tab.md b/docs/commands/gog-docs-rename-tab.md new file mode 100644 index 0000000..38f11aa --- /dev/null +++ b/docs/commands/gog-docs-rename-tab.md @@ -0,0 +1,44 @@ +# `gog docs rename-tab` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Rename a tab in a Google Doc + +## Usage + +```bash +gog docs (doc) rename-tab <docId> [flags] +``` + +## Parent + +- [gog docs](gog-docs.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. | +| `--tab` | `string` | | Existing tab title or ID | +| `--title` | `string` | | New user-visible tab title | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog docs](gog-docs.md) +- [Command index](README.md) diff --git a/docs/commands/gog-docs-sed.md b/docs/commands/gog-docs-sed.md new file mode 100644 index 0000000..73da287 --- /dev/null +++ b/docs/commands/gog-docs-sed.md @@ -0,0 +1,45 @@ +# `gog docs sed` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Regex find/replace (sed-style: s/pattern/replacement/g) + +## Usage + +```bash +gog docs (doc) sed <docId> [<expression>] [flags] +``` + +## Parent + +- [gog docs](gog-docs.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) | +| `-e`<br>`--expressions` | `[]string` | | Additional sed expressions (repeatable) | +| `-f`<br>`--file` | `string` | | Read sed expressions from file (one per line, # comments) | +| `-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. | +| `--tab` | `string` | | Tab title or ID for paragraph addressing | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog docs](gog-docs.md) +- [Command index](README.md) diff --git a/docs/commands/gog-docs-structure.md b/docs/commands/gog-docs-structure.md new file mode 100644 index 0000000..87db233 --- /dev/null +++ b/docs/commands/gog-docs-structure.md @@ -0,0 +1,43 @@ +# `gog docs structure` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Show document structure with numbered paragraphs + +## Usage + +```bash +gog docs (doc) structure (struct) <docId> [flags] +``` + +## Parent + +- [gog docs](gog-docs.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. | +| `--tab` | `string` | | Tab title or ID (omit for default) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog docs](gog-docs.md) +- [Command index](README.md) diff --git a/docs/commands/gog-docs-update.md b/docs/commands/gog-docs-update.md new file mode 100644 index 0000000..81f745a --- /dev/null +++ b/docs/commands/gog-docs-update.md @@ -0,0 +1,47 @@ +# `gog docs update` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Insert text at a specific index in a Google Doc + +## Usage + +```bash +gog docs (doc) update <docId> [flags] +``` + +## Parent + +- [gog docs](gog-docs.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) | +| `--file` | `string` | | Text file path ('-' for stdin) | +| `-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. | +| `--index` | `int64` | | Insert index (default: end of document) | +| `-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) | +| `--pageless` | `bool` | | Set document to pageless mode | +| `-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. | +| `--tab` | `string` | | Target a specific tab by title or ID (see docs list-tabs) | +| `--text` | `string` | | Text to insert | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog docs](gog-docs.md) +- [Command index](README.md) diff --git a/docs/commands/gog-docs-write.md b/docs/commands/gog-docs-write.md new file mode 100644 index 0000000..cac774a --- /dev/null +++ b/docs/commands/gog-docs-write.md @@ -0,0 +1,49 @@ +# `gog docs write` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Write content to a Google Doc + +## Usage + +```bash +gog docs (doc) write <docId> [flags] +``` + +## Parent + +- [gog docs](gog-docs.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) | +| `--append` | `bool` | | Append instead of replacing the document body | +| `--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) | +| `--file` | `string` | | Text file path ('-' for stdin) | +| `-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` | | Convert markdown to Google Docs formatting (requires --replace or --append) | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--pageless` | `bool` | | Set document to pageless mode | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--replace` | `bool` | | Replace all content explicitly (required with --markdown unless --append is set) | +| `--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. | +| `--tab` | `string` | | Target a specific tab by title or ID (see docs list-tabs) | +| `--text` | `string` | | Text to write | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog docs](gog-docs.md) +- [Command index](README.md) diff --git a/docs/commands/gog-docs.md b/docs/commands/gog-docs.md new file mode 100644 index 0000000..3c11352 --- /dev/null +++ b/docs/commands/gog-docs.md @@ -0,0 +1,64 @@ +# `gog docs` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Google Docs (export via Drive) + +## Usage + +```bash +gog docs (doc) <command> [flags] +``` + +## Parent + +- [gog](gog.md) + +## Subcommands + +- [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 copy](gog-docs-copy.md) - Copy a Google Doc +- [gog docs create](gog-docs-create.md) - Create a Google Doc +- [gog docs delete](gog-docs-delete.md) - Delete text range from document +- [gog docs delete-tab](gog-docs-delete-tab.md) - Delete a tab from a Google Doc +- [gog docs edit](gog-docs-edit.md) - Find and replace text in a Google Doc +- [gog docs export](gog-docs-export.md) - Export a Google Doc (pdf|docx|txt|md|html) +- [gog docs find-replace](gog-docs-find-replace.md) - Find and replace text. Supports plain text or markdown with images; use --first for a single occurrence. +- [gog docs info](gog-docs-info.md) - Get Google Doc metadata +- [gog docs insert](gog-docs-insert.md) - Insert text at a specific position +- [gog docs list-tabs](gog-docs-list-tabs.md) - List all tabs in a Google Doc +- [gog docs rename-tab](gog-docs-rename-tab.md) - Rename a tab in a Google Doc +- [gog docs sed](gog-docs-sed.md) - Regex find/replace (sed-style: s/pattern/replacement/g) +- [gog docs structure](gog-docs-structure.md) - Show document structure with numbered paragraphs +- [gog docs update](gog-docs-update.md) - Insert text at a specific index in a Google Doc +- [gog docs write](gog-docs-write.md) - Write content to a Google Doc + +## 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) diff --git a/docs/commands/gog-download.md b/docs/commands/gog-download.md new file mode 100644 index 0000000..6314266 --- /dev/null +++ b/docs/commands/gog-download.md @@ -0,0 +1,45 @@ +# `gog download` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Download a Drive file (alias for 'drive download') + +## Usage + +```bash +gog download (dl) <fileId> [flags] +``` + +## Parent + +- [gog](gog.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 | +| `--format` | `string` | | Export format for Google Docs files: pdf\|csv\|xlsx\|pptx\|txt\|png\|docx\|md (default: inferred) | +| `--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 (default: gogcli config dir) | +| `-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. | +| `--tab` | `string` | | (experimental) Export a specific tab by title or ID (Google Docs only; see 'gog docs list-tabs') | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog](gog.md) +- [Command index](README.md) diff --git a/docs/commands/gog-drive-comments-create.md b/docs/commands/gog-drive-comments-create.md new file mode 100644 index 0000000..e3b840d --- /dev/null +++ b/docs/commands/gog-drive-comments-create.md @@ -0,0 +1,43 @@ +# `gog drive comments create` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create a comment on a file + +## Usage + +```bash +gog drive (drv) comments create (add,new) <fileId> <content> [flags] +``` + +## Parent + +- [gog drive comments](gog-drive-comments.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) | +| `--quoted` | `string` | | Text to anchor the comment to (for Google Docs) | +| `--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 drive comments](gog-drive-comments.md) +- [Command index](README.md) diff --git a/docs/commands/gog-drive-comments-delete.md b/docs/commands/gog-drive-comments-delete.md new file mode 100644 index 0000000..4e7aabb --- /dev/null +++ b/docs/commands/gog-drive-comments-delete.md @@ -0,0 +1,42 @@ +# `gog drive comments delete` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete a comment + +## Usage + +```bash +gog drive (drv) comments delete (rm,del,remove) <fileId> <commentId> +``` + +## Parent + +- [gog drive comments](gog-drive-comments.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 drive comments](gog-drive-comments.md) +- [Command index](README.md) diff --git a/docs/commands/gog-drive-comments-get.md b/docs/commands/gog-drive-comments-get.md new file mode 100644 index 0000000..3a94343 --- /dev/null +++ b/docs/commands/gog-drive-comments-get.md @@ -0,0 +1,42 @@ +# `gog drive comments get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get a comment by ID + +## Usage + +```bash +gog drive (drv) comments get (info,show) <fileId> <commentId> +``` + +## Parent + +- [gog drive comments](gog-drive-comments.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 drive comments](gog-drive-comments.md) +- [Command index](README.md) diff --git a/docs/commands/gog-drive-comments-list.md b/docs/commands/gog-drive-comments-list.md new file mode 100644 index 0000000..422f2f8 --- /dev/null +++ b/docs/commands/gog-drive-comments-list.md @@ -0,0 +1,47 @@ +# `gog drive comments list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List comments on a file + +## Usage + +```bash +gog drive (drv) comments list (ls) <fileId> [flags] +``` + +## Parent + +- [gog drive comments](gog-drive-comments.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. | +| `--include-quoted` | `bool` | | Include the quoted content the comment is anchored to | +| `-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 drive comments](gog-drive-comments.md) +- [Command index](README.md) diff --git a/docs/commands/gog-drive-comments-reply.md b/docs/commands/gog-drive-comments-reply.md new file mode 100644 index 0000000..2d5cf01 --- /dev/null +++ b/docs/commands/gog-drive-comments-reply.md @@ -0,0 +1,42 @@ +# `gog drive comments reply` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Reply to a comment + +## Usage + +```bash +gog drive (drv) comments reply (respond) <fileId> <commentId> <content> +``` + +## Parent + +- [gog drive comments](gog-drive-comments.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 drive comments](gog-drive-comments.md) +- [Command index](README.md) diff --git a/docs/commands/gog-drive-comments-update.md b/docs/commands/gog-drive-comments-update.md new file mode 100644 index 0000000..90d9e65 --- /dev/null +++ b/docs/commands/gog-drive-comments-update.md @@ -0,0 +1,42 @@ +# `gog drive comments update` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Update a comment + +## Usage + +```bash +gog drive (drv) comments update (edit,set) <fileId> <commentId> <content> +``` + +## Parent + +- [gog drive comments](gog-drive-comments.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 drive comments](gog-drive-comments.md) +- [Command index](README.md) diff --git a/docs/commands/gog-drive-comments.md b/docs/commands/gog-drive-comments.md new file mode 100644 index 0000000..41373ad --- /dev/null +++ b/docs/commands/gog-drive-comments.md @@ -0,0 +1,51 @@ +# `gog drive comments` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Manage comments on files + +## Usage + +```bash +gog drive (drv) comments <command> +``` + +## Parent + +- [gog drive](gog-drive.md) + +## Subcommands + +- [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 + +## 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 drive](gog-drive.md) +- [Command index](README.md) diff --git a/docs/commands/gog-drive-copy.md b/docs/commands/gog-drive-copy.md new file mode 100644 index 0000000..4703310 --- /dev/null +++ b/docs/commands/gog-drive-copy.md @@ -0,0 +1,43 @@ +# `gog drive copy` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Copy a file + +## Usage + +```bash +gog drive (drv) copy <fileId> <name> [flags] +``` + +## Parent + +- [gog drive](gog-drive.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` | `string` | | Destination folder ID | +| `-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 drive](gog-drive.md) +- [Command index](README.md) diff --git a/docs/commands/gog-drive-delete.md b/docs/commands/gog-drive-delete.md new file mode 100644 index 0000000..3de0d26 --- /dev/null +++ b/docs/commands/gog-drive-delete.md @@ -0,0 +1,43 @@ +# `gog drive delete` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Move a file to trash (use --permanent to delete forever) + +## Usage + +```bash +gog drive (drv) delete (rm,del) <fileId> [flags] +``` + +## Parent + +- [gog drive](gog-drive.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) | +| `--permanent` | `bool` | false | Permanently delete instead of moving to trash | +| `-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 drive](gog-drive.md) +- [Command index](README.md) diff --git a/docs/commands/gog-drive-download.md b/docs/commands/gog-drive-download.md new file mode 100644 index 0000000..8cade55 --- /dev/null +++ b/docs/commands/gog-drive-download.md @@ -0,0 +1,45 @@ +# `gog drive download` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Download a file (exports Google Docs formats) + +## Usage + +```bash +gog drive (drv) download <fileId> [flags] +``` + +## Parent + +- [gog drive](gog-drive.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 | +| `--format` | `string` | | Export format for Google Docs files: pdf\|csv\|xlsx\|pptx\|txt\|png\|docx\|md (default: inferred) | +| `--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 (default: gogcli config dir) | +| `-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. | +| `--tab` | `string` | | (experimental) Export a specific tab by title or ID (Google Docs only; see 'gog docs list-tabs') | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog drive](gog-drive.md) +- [Command index](README.md) diff --git a/docs/commands/gog-drive-drives.md b/docs/commands/gog-drive-drives.md new file mode 100644 index 0000000..68711ff --- /dev/null +++ b/docs/commands/gog-drive-drives.md @@ -0,0 +1,47 @@ +# `gog drive drives` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List shared drives (Team Drives) + +## Usage + +```bash +gog drive (drv) drives [flags] +``` + +## Parent + +- [gog drive](gog-drive.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 (max allowed: 100) | +| `--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) | +| `-q`<br>`--query` | `string` | | Search query for filtering shared drives | +| `--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 drive](gog-drive.md) +- [Command index](README.md) diff --git a/docs/commands/gog-drive-get.md b/docs/commands/gog-drive-get.md new file mode 100644 index 0000000..1c6491d --- /dev/null +++ b/docs/commands/gog-drive-get.md @@ -0,0 +1,42 @@ +# `gog drive get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get file metadata + +## Usage + +```bash +gog drive (drv) get <fileId> +``` + +## Parent + +- [gog drive](gog-drive.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 drive](gog-drive.md) +- [Command index](README.md) diff --git a/docs/commands/gog-drive-ls.md b/docs/commands/gog-drive-ls.md new file mode 100644 index 0000000..4816844 --- /dev/null +++ b/docs/commands/gog-drive-ls.md @@ -0,0 +1,48 @@ +# `gog drive ls` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List files in a folder (default: root) + +## Usage + +```bash +gog drive (drv) ls [flags] +``` + +## Parent + +- [gog drive](gog-drive.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>`--global` | `bool` | | List all accessible files (mutually exclusive with --parent) | +| `--all-drives` | `bool` | true | Include shared drives (default: true; use --no-all-drives for My Drive only) | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--max`<br>`--limit` | `int64` | 20 | Max results | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--page`<br>`--cursor` | `string` | | Page token | +| `--parent` | `string` | | Folder ID to list (default: root) | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--query` | `string` | | Drive query filter | +| `--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 drive](gog-drive.md) +- [Command index](README.md) diff --git a/docs/commands/gog-drive-mkdir.md b/docs/commands/gog-drive-mkdir.md new file mode 100644 index 0000000..e6a0cff --- /dev/null +++ b/docs/commands/gog-drive-mkdir.md @@ -0,0 +1,43 @@ +# `gog drive mkdir` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create a folder + +## Usage + +```bash +gog drive (drv) mkdir <name> [flags] +``` + +## Parent + +- [gog drive](gog-drive.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` | `string` | | Parent folder ID | +| `-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 drive](gog-drive.md) +- [Command index](README.md) diff --git a/docs/commands/gog-drive-move.md b/docs/commands/gog-drive-move.md new file mode 100644 index 0000000..2d328b6 --- /dev/null +++ b/docs/commands/gog-drive-move.md @@ -0,0 +1,43 @@ +# `gog drive move` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Move a file to a different folder + +## Usage + +```bash +gog drive (drv) move <fileId> [flags] +``` + +## Parent + +- [gog drive](gog-drive.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` | `string` | | New parent folder ID (required) | +| `-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 drive](gog-drive.md) +- [Command index](README.md) diff --git a/docs/commands/gog-drive-permissions.md b/docs/commands/gog-drive-permissions.md new file mode 100644 index 0000000..7a0fea4 --- /dev/null +++ b/docs/commands/gog-drive-permissions.md @@ -0,0 +1,44 @@ +# `gog drive permissions` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List permissions on a file + +## Usage + +```bash +gog drive (drv) permissions <fileId> [flags] +``` + +## Parent + +- [gog drive](gog-drive.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) | +| `--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 drive](gog-drive.md) +- [Command index](README.md) diff --git a/docs/commands/gog-drive-rename.md b/docs/commands/gog-drive-rename.md new file mode 100644 index 0000000..7c72cb8 --- /dev/null +++ b/docs/commands/gog-drive-rename.md @@ -0,0 +1,42 @@ +# `gog drive rename` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Rename a file or folder + +## Usage + +```bash +gog drive (drv) rename <fileId> <newName> +``` + +## Parent + +- [gog drive](gog-drive.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 drive](gog-drive.md) +- [Command index](README.md) diff --git a/docs/commands/gog-drive-search.md b/docs/commands/gog-drive-search.md new file mode 100644 index 0000000..13207d9 --- /dev/null +++ b/docs/commands/gog-drive-search.md @@ -0,0 +1,48 @@ +# `gog drive search` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Full-text search across Drive + +## Usage + +```bash +gog drive (drv) search <query> ... [flags] +``` + +## Parent + +- [gog drive](gog-drive.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-drives` | `bool` | true | Include shared drives (default: true; use --no-all-drives for My Drive only) | +| `--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`<br>`--drive-id` | `string` | | Scope search to a specific shared drive (uses corpora=drive with driveId). Mutually exclusive with --no-all-drives. Pass the driveId from 'gog drive drives'. | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--max`<br>`--limit` | `int64` | 20 | Max results | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--page`<br>`--cursor` | `string` | | Page token | +| `--parent` | `string` | | Scope search to direct children of a specific folder or shared drive. Wraps the query with "'<parentId>' in parents". | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--raw-query`<br>`--raw` | `bool` | | Treat query as Drive query language (pass through; may error if invalid) | +| `--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 drive](gog-drive.md) +- [Command index](README.md) diff --git a/docs/commands/gog-drive-share.md b/docs/commands/gog-drive-share.md new file mode 100644 index 0000000..df9be64 --- /dev/null +++ b/docs/commands/gog-drive-share.md @@ -0,0 +1,47 @@ +# `gog drive share` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Share a file or folder + +## Usage + +```bash +gog drive (drv) share <fileId> [flags] +``` + +## Parent + +- [gog drive](gog-drive.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 | +| `--discoverable` | `bool` | | Allow file discovery in search (anyone/domain only) | +| `--domain` | `string` | | Domain (for --to=domain; 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 | +| `--email` | `string` | | User email (for --to=user) | +| `--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` | reader | Permission: reader\|writer\|commenter | +| `--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` | | Share target: anyone\|user\|domain | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog drive](gog-drive.md) +- [Command index](README.md) diff --git a/docs/commands/gog-drive-unshare.md b/docs/commands/gog-drive-unshare.md new file mode 100644 index 0000000..2d73040 --- /dev/null +++ b/docs/commands/gog-drive-unshare.md @@ -0,0 +1,42 @@ +# `gog drive unshare` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Remove a permission from a file + +## Usage + +```bash +gog drive (drv) unshare <fileId> <permissionId> +``` + +## Parent + +- [gog drive](gog-drive.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 drive](gog-drive.md) +- [Command index](README.md) diff --git a/docs/commands/gog-drive-upload.md b/docs/commands/gog-drive-upload.md new file mode 100644 index 0000000..b6e3429 --- /dev/null +++ b/docs/commands/gog-drive-upload.md @@ -0,0 +1,50 @@ +# `gog drive upload` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Upload a file + +## Usage + +```bash +gog drive (drv) upload <localPath> [flags] +``` + +## Parent + +- [gog drive](gog-drive.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 | +| `--convert` | `bool` | | Auto-convert to native Google format based on file extension (create only) | +| `--convert-to` | `string` | | Convert to a specific Google format: doc\|sheet\|slides (create only) | +| `--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) | +| `--keep-frontmatter` | `bool` | | Keep YAML frontmatter (---) in Markdown when converting to a Google Doc (--convert or --convert-to doc; default: strip) | +| `--keep-revision-forever` | `bool` | | Keep the new head revision forever (binary files only) | +| `--mime-type` | `string` | | Override MIME type inference | +| `--name` | `string` | | Override filename (create) or rename target (replace) | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--parent` | `string` | | Destination folder ID (create only) | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--replace` | `string` | | Replace the content of an existing Drive file ID (preserves shared link/permissions) | +| `--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 drive](gog-drive.md) +- [Command index](README.md) diff --git a/docs/commands/gog-drive-url.md b/docs/commands/gog-drive-url.md new file mode 100644 index 0000000..0b2f578 --- /dev/null +++ b/docs/commands/gog-drive-url.md @@ -0,0 +1,42 @@ +# `gog drive url` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Print web URLs for files + +## Usage + +```bash +gog drive (drv) url <fileId> ... +``` + +## Parent + +- [gog drive](gog-drive.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 drive](gog-drive.md) +- [Command index](README.md) diff --git a/docs/commands/gog-drive.md b/docs/commands/gog-drive.md new file mode 100644 index 0000000..3e98a12 --- /dev/null +++ b/docs/commands/gog-drive.md @@ -0,0 +1,61 @@ +# `gog drive` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Google Drive + +## Usage + +```bash +gog drive (drv) <command> [flags] +``` + +## Parent + +- [gog](gog.md) + +## Subcommands + +- [gog drive comments](gog-drive-comments.md) - Manage comments on files +- [gog drive copy](gog-drive-copy.md) - Copy a file +- [gog drive delete](gog-drive-delete.md) - Move a file to trash (use --permanent to delete forever) +- [gog drive download](gog-drive-download.md) - Download a file (exports Google Docs formats) +- [gog drive drives](gog-drive-drives.md) - List shared drives (Team Drives) +- [gog drive get](gog-drive-get.md) - Get file metadata +- [gog drive ls](gog-drive-ls.md) - List files in a folder (default: root) +- [gog drive mkdir](gog-drive-mkdir.md) - Create a folder +- [gog drive move](gog-drive-move.md) - Move a file to a different folder +- [gog drive permissions](gog-drive-permissions.md) - List permissions on a file +- [gog drive rename](gog-drive-rename.md) - Rename a file or folder +- [gog drive search](gog-drive-search.md) - Full-text search across Drive +- [gog drive share](gog-drive-share.md) - Share a file or folder +- [gog drive unshare](gog-drive-unshare.md) - Remove a permission from a file +- [gog drive upload](gog-drive-upload.md) - Upload a file +- [gog drive url](gog-drive-url.md) - Print web URLs for files + +## 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) diff --git a/docs/commands/gog-exit-codes.md b/docs/commands/gog-exit-codes.md new file mode 100644 index 0000000..b2fe8ca --- /dev/null +++ b/docs/commands/gog-exit-codes.md @@ -0,0 +1,42 @@ +# `gog exit-codes` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Print stable exit codes (alias for 'agent exit-codes') + +## Usage + +```bash +gog exit-codes (exitcodes) [flags] +``` + +## Parent + +- [gog](gog.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](gog.md) +- [Command index](README.md) diff --git a/docs/commands/gog-forms-add-question.md b/docs/commands/gog-forms-add-question.md new file mode 100644 index 0000000..05ca1de --- /dev/null +++ b/docs/commands/gog-forms-add-question.md @@ -0,0 +1,55 @@ +# `gog forms add-question` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Add a question to a form + +## Usage + +```bash +gog forms (form) add-question (add-q,aq) --title=STRING <formId> [flags] +``` + +## Parent + +- [gog forms](gog-forms.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` | | Question description/help text | +| `--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 | +| `--duration` | `bool` | | Ask for duration instead of time (for time type) | +| `--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. | +| `--include-time` | `bool` | | Include time picker (for date type) | +| `--include-year` | `bool` | | Include year field (for date type) | +| `--index` | `int` | -1 | Position to insert (0-based, default append) | +| `-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) | +| `-o`<br>`--option` | `[]string` | | Choice options (for radio/checkbox/dropdown, repeat for each) | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--required` | `bool` | | Whether an answer is required | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--scale-high` | `int` | 5 | Scale maximum value | +| `--scale-high-label` | `string` | | Label for high end of scale | +| `--scale-low` | `int` | 1 | Scale minimum value | +| `--scale-low-label` | `string` | | Label for low end of scale | +| `--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` | | Question title/text | +| `--type` | `string` | text | Question type: text\|paragraph\|radio\|checkbox\|dropdown\|scale\|date\|time | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog forms](gog-forms.md) +- [Command index](README.md) diff --git a/docs/commands/gog-forms-create.md b/docs/commands/gog-forms-create.md new file mode 100644 index 0000000..abce099 --- /dev/null +++ b/docs/commands/gog-forms-create.md @@ -0,0 +1,44 @@ +# `gog forms create` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create a form + +## Usage + +```bash +gog forms (form) create (new) --title=STRING [flags] +``` + +## Parent + +- [gog forms](gog-forms.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` | | Form 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) | +| `--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. | +| `--title` | `string` | | Form title | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog forms](gog-forms.md) +- [Command index](README.md) diff --git a/docs/commands/gog-forms-delete-question.md b/docs/commands/gog-forms-delete-question.md new file mode 100644 index 0000000..6731e9a --- /dev/null +++ b/docs/commands/gog-forms-delete-question.md @@ -0,0 +1,42 @@ +# `gog forms delete-question` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete a question by index + +## Usage + +```bash +gog forms (form) delete-question (delete-q,dq,rm-q) <formId> <index> +``` + +## Parent + +- [gog forms](gog-forms.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 forms](gog-forms.md) +- [Command index](README.md) diff --git a/docs/commands/gog-forms-get.md b/docs/commands/gog-forms-get.md new file mode 100644 index 0000000..b2bec64 --- /dev/null +++ b/docs/commands/gog-forms-get.md @@ -0,0 +1,42 @@ +# `gog forms get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get a form + +## Usage + +```bash +gog forms (form) get (info,show) <formId> +``` + +## Parent + +- [gog forms](gog-forms.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 forms](gog-forms.md) +- [Command index](README.md) diff --git a/docs/commands/gog-forms-move-question.md b/docs/commands/gog-forms-move-question.md new file mode 100644 index 0000000..74bc3ae --- /dev/null +++ b/docs/commands/gog-forms-move-question.md @@ -0,0 +1,42 @@ +# `gog forms move-question` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Move a question to a new position + +## Usage + +```bash +gog forms (form) move-question (move-q,mq) <formId> <oldIndex> <newIndex> +``` + +## Parent + +- [gog forms](gog-forms.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 forms](gog-forms.md) +- [Command index](README.md) diff --git a/docs/commands/gog-forms-responses-get.md b/docs/commands/gog-forms-responses-get.md new file mode 100644 index 0000000..b78bf61 --- /dev/null +++ b/docs/commands/gog-forms-responses-get.md @@ -0,0 +1,42 @@ +# `gog forms responses get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get a form response + +## Usage + +```bash +gog forms (form) responses get (info,show) <formId> <responseId> +``` + +## Parent + +- [gog forms responses](gog-forms-responses.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 forms responses](gog-forms-responses.md) +- [Command index](README.md) diff --git a/docs/commands/gog-forms-responses-list.md b/docs/commands/gog-forms-responses-list.md new file mode 100644 index 0000000..9c835d3 --- /dev/null +++ b/docs/commands/gog-forms-responses-list.md @@ -0,0 +1,45 @@ +# `gog forms responses list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List form responses + +## Usage + +```bash +gog forms (form) responses list (ls) <formId> [flags] +``` + +## Parent + +- [gog forms responses](gog-forms-responses.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) | +| `--filter` | `string` | | Filter expression | +| `-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` | `int` | 20 | Maximum responses | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--page` | `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 forms responses](gog-forms-responses.md) +- [Command index](README.md) diff --git a/docs/commands/gog-forms-responses.md b/docs/commands/gog-forms-responses.md new file mode 100644 index 0000000..5211eb2 --- /dev/null +++ b/docs/commands/gog-forms-responses.md @@ -0,0 +1,47 @@ +# `gog forms responses` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Form responses + +## Usage + +```bash +gog forms (form) responses <command> +``` + +## Parent + +- [gog forms](gog-forms.md) + +## Subcommands + +- [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 + +## 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 forms](gog-forms.md) +- [Command index](README.md) diff --git a/docs/commands/gog-forms-update.md b/docs/commands/gog-forms-update.md new file mode 100644 index 0000000..386ef0a --- /dev/null +++ b/docs/commands/gog-forms-update.md @@ -0,0 +1,45 @@ +# `gog forms update` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Update form title, description, or settings + +## Usage + +```bash +gog forms (form) update (edit) <formId> [flags] +``` + +## Parent + +- [gog forms](gog-forms.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` | | New form 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) | +| `--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) | +| `--quiz` | `string` | | Enable quiz mode (true/false) | +| `--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` | | New form title | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog forms](gog-forms.md) +- [Command index](README.md) diff --git a/docs/commands/gog-forms-watch-create.md b/docs/commands/gog-forms-watch-create.md new file mode 100644 index 0000000..931fd39 --- /dev/null +++ b/docs/commands/gog-forms-watch-create.md @@ -0,0 +1,44 @@ +# `gog forms watch create` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create a watch for new responses + +## Usage + +```bash +gog forms (form) watch (watches) create (new,add) --topic=STRING <formId> [flags] +``` + +## Parent + +- [gog forms watch](gog-forms-watch.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) | +| `--event-type` | `string` | RESPONSES | Event type to watch | +| `-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. | +| `--topic` | `string` | | Cloud Pub/Sub topic name (projects/{project}/topics/{topic}) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog forms watch](gog-forms-watch.md) +- [Command index](README.md) diff --git a/docs/commands/gog-forms-watch-delete.md b/docs/commands/gog-forms-watch-delete.md new file mode 100644 index 0000000..2933f54 --- /dev/null +++ b/docs/commands/gog-forms-watch-delete.md @@ -0,0 +1,42 @@ +# `gog forms watch delete` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete a watch + +## Usage + +```bash +gog forms (form) watch (watches) delete (rm,remove) <formId> <watchId> +``` + +## Parent + +- [gog forms watch](gog-forms-watch.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 forms watch](gog-forms-watch.md) +- [Command index](README.md) diff --git a/docs/commands/gog-forms-watch-list.md b/docs/commands/gog-forms-watch-list.md new file mode 100644 index 0000000..616f142 --- /dev/null +++ b/docs/commands/gog-forms-watch-list.md @@ -0,0 +1,42 @@ +# `gog forms watch list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List active watches + +## Usage + +```bash +gog forms (form) watch (watches) list (ls) <formId> +``` + +## Parent + +- [gog forms watch](gog-forms-watch.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 forms watch](gog-forms-watch.md) +- [Command index](README.md) diff --git a/docs/commands/gog-forms-watch-renew.md b/docs/commands/gog-forms-watch-renew.md new file mode 100644 index 0000000..f4c9303 --- /dev/null +++ b/docs/commands/gog-forms-watch-renew.md @@ -0,0 +1,42 @@ +# `gog forms watch renew` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Renew a watch (extends 7 days) + +## Usage + +```bash +gog forms (form) watch (watches) renew (refresh) <formId> <watchId> +``` + +## Parent + +- [gog forms watch](gog-forms-watch.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 forms watch](gog-forms-watch.md) +- [Command index](README.md) diff --git a/docs/commands/gog-forms-watch.md b/docs/commands/gog-forms-watch.md new file mode 100644 index 0000000..0c2b86f --- /dev/null +++ b/docs/commands/gog-forms-watch.md @@ -0,0 +1,49 @@ +# `gog forms watch` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Response watches (push notifications) + +## Usage + +```bash +gog forms (form) watch (watches) <command> +``` + +## Parent + +- [gog forms](gog-forms.md) + +## Subcommands + +- [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) + +## 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 forms](gog-forms.md) +- [Command index](README.md) diff --git a/docs/commands/gog-forms.md b/docs/commands/gog-forms.md new file mode 100644 index 0000000..ad93ae5 --- /dev/null +++ b/docs/commands/gog-forms.md @@ -0,0 +1,53 @@ +# `gog forms` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Google Forms + +## Usage + +```bash +gog forms (form) <command> [flags] +``` + +## Parent + +- [gog](gog.md) + +## Subcommands + +- [gog forms add-question](gog-forms-add-question.md) - Add a question to a form +- [gog forms create](gog-forms-create.md) - Create a form +- [gog forms delete-question](gog-forms-delete-question.md) - Delete a question by index +- [gog forms get](gog-forms-get.md) - Get a form +- [gog forms move-question](gog-forms-move-question.md) - Move a question to a new position +- [gog forms responses](gog-forms-responses.md) - Form responses +- [gog forms update](gog-forms-update.md) - Update form title, description, or settings +- [gog forms watch](gog-forms-watch.md) - Response watches (push notifications) + +## 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) diff --git a/docs/commands/gog-gmail-archive.md b/docs/commands/gog-gmail-archive.md new file mode 100644 index 0000000..78fc9b8 --- /dev/null +++ b/docs/commands/gog-gmail-archive.md @@ -0,0 +1,44 @@ +# `gog gmail archive` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Archive messages (remove from inbox) + +## Usage + +```bash +gog gmail (mail,email) archive [<messageId> ...] [flags] +``` + +## Parent + +- [gog gmail](gog-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) | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--max`<br>`--limit` | `int64` | 100 | Max messages to archive (with --query) | +| `--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` | | Archive all messages matching this Gmail search query | +| `--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 gmail](gog-gmail.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-attachment.md b/docs/commands/gog-gmail-attachment.md new file mode 100644 index 0000000..64fc82d --- /dev/null +++ b/docs/commands/gog-gmail-attachment.md @@ -0,0 +1,44 @@ +# `gog gmail attachment` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Download a single attachment + +## Usage + +```bash +gog gmail (mail,email) attachment <messageId> <attachmentId> [flags] +``` + +## Parent + +- [gog gmail](gog-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) | +| `--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) | +| `--name` | `string` | | Filename (used when --out is empty or points to a directory) | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--out`<br>`--output` | `string` | | Output file path (default: gogcli config dir) | +| `-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 gmail](gog-gmail.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-autoreply.md b/docs/commands/gog-gmail-autoreply.md new file mode 100644 index 0000000..0e7dfe6 --- /dev/null +++ b/docs/commands/gog-gmail-autoreply.md @@ -0,0 +1,54 @@ +# `gog gmail autoreply` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Reply once to matching messages + +## Usage + +```bash +gog gmail (mail,email) autoreply <query> ... [flags] +``` + +## Parent + +- [gog gmail](gog-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) | +| `--allow-self` | `bool` | | Allow replying to messages sent by your own account/alias | +| `--archive` | `bool` | | Archive threads after auto-replying | +| `--body` | `string` | | Reply body (plain text; required unless --body-html is set) | +| `--body-file` | `string` | | Reply body file path (plain text; '-' for stdin) | +| `--body-html` | `string` | | Reply body HTML | +| `--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` | | Send from this email address (must be a verified send-as alias) | +| `--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) | +| `--label` | `string` | AutoReplied | Label to add after replying (used for dedupe) | +| `--mark-read` | `bool` | | Mark threads as read after auto-replying | +| `--max`<br>`--limit` | `int64` | 20 | Max matching messages to inspect | +| `--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) | +| `--reply-to` | `string` | | Reply-To header address | +| `--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. | +| `--skip-bulk` | `bool` | true | Skip auto-generated/list mail | +| `--subject` | `string` | | Override reply subject (default: reply to original subject) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog gmail](gog-gmail.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-batch-delete.md b/docs/commands/gog-gmail-batch-delete.md new file mode 100644 index 0000000..2651aa3 --- /dev/null +++ b/docs/commands/gog-gmail-batch-delete.md @@ -0,0 +1,42 @@ +# `gog gmail batch delete` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Permanently delete multiple messages; use 'gmail trash' to move messages to trash with the default gmail.modify scope + +## Usage + +```bash +gog gmail (mail,email) batch delete (rm,del,remove) <messageId> ... +``` + +## Parent + +- [gog gmail batch](gog-gmail-batch.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 gmail batch](gog-gmail-batch.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-batch-modify.md b/docs/commands/gog-gmail-batch-modify.md new file mode 100644 index 0000000..6f96de3 --- /dev/null +++ b/docs/commands/gog-gmail-batch-modify.md @@ -0,0 +1,44 @@ +# `gog gmail batch modify` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Modify labels on multiple messages + +## Usage + +```bash +gog gmail (mail,email) batch modify (update,edit,set) <messageId> ... [flags] +``` + +## Parent + +- [gog gmail batch](gog-gmail-batch.md) + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--add` | `string` | | Labels to add (comma-separated, name or ID) | +| `--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) | +| `--remove` | `string` | | Labels to remove (comma-separated, name or ID) | +| `--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 gmail batch](gog-gmail-batch.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-batch.md b/docs/commands/gog-gmail-batch.md new file mode 100644 index 0000000..5cb1fb3 --- /dev/null +++ b/docs/commands/gog-gmail-batch.md @@ -0,0 +1,47 @@ +# `gog gmail batch` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Batch operations (permanent delete requires broader Gmail scope; use gmail trash for normal trashing) + +## Usage + +```bash +gog gmail (mail,email) batch <command> +``` + +## Parent + +- [gog gmail](gog-gmail.md) + +## Subcommands + +- [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 + +## 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 gmail](gog-gmail.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-drafts-create.md b/docs/commands/gog-gmail-drafts-create.md new file mode 100644 index 0000000..6043449 --- /dev/null +++ b/docs/commands/gog-gmail-drafts-create.md @@ -0,0 +1,54 @@ +# `gog gmail drafts create` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create a draft + +## Usage + +```bash +gog gmail (mail,email) drafts (draft) create (add,new) [flags] +``` + +## Parent + +- [gog gmail drafts](gog-gmail-drafts.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) | +| `--attach` | `[]string` | | Attachment file path (repeatable) | +| `--bcc` | `string` | | BCC recipients (comma-separated) | +| `--body` | `string` | | Body (plain text; required unless --body-html is set) | +| `--body-file` | `string` | | Body file path (plain text; '-' for stdin) | +| `--body-html` | `string` | | Body (HTML; optional) | +| `--cc` | `string` | | CC recipients (comma-separated) | +| `--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` | | Send from this email address (must be a verified send-as alias) | +| `--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) | +| `--quote` | `bool` | | Include quoted original message in reply (requires --reply-to-message-id) | +| `--reply-to` | `string` | | Reply-To header address | +| `--reply-to-message-id` | `string` | | Reply to Gmail message ID (sets In-Reply-To/References and thread) | +| `--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. | +| `--subject` | `string` | | Subject (required) | +| `--to` | `string` | | Recipients (comma-separated) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog gmail drafts](gog-gmail-drafts.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-drafts-delete.md b/docs/commands/gog-gmail-drafts-delete.md new file mode 100644 index 0000000..5c9dfc8 --- /dev/null +++ b/docs/commands/gog-gmail-drafts-delete.md @@ -0,0 +1,42 @@ +# `gog gmail drafts delete` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete a draft + +## Usage + +```bash +gog gmail (mail,email) drafts (draft) delete (rm,del,remove) <draftId> +``` + +## Parent + +- [gog gmail drafts](gog-gmail-drafts.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 gmail drafts](gog-gmail-drafts.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-drafts-get.md b/docs/commands/gog-gmail-drafts-get.md new file mode 100644 index 0000000..69b3b0f --- /dev/null +++ b/docs/commands/gog-gmail-drafts-get.md @@ -0,0 +1,43 @@ +# `gog gmail drafts get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get draft details + +## Usage + +```bash +gog gmail (mail,email) drafts (draft) get (info,show) <draftId> [flags] +``` + +## Parent + +- [gog gmail drafts](gog-gmail-drafts.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 | +| `--download` | `bool` | | Download draft attachments | +| `-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 gmail drafts](gog-gmail-drafts.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-drafts-list.md b/docs/commands/gog-gmail-drafts-list.md new file mode 100644 index 0000000..1f7d194 --- /dev/null +++ b/docs/commands/gog-gmail-drafts-list.md @@ -0,0 +1,46 @@ +# `gog gmail drafts list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List drafts + +## Usage + +```bash +gog gmail (mail,email) drafts (draft) list (ls) [flags] +``` + +## Parent + +- [gog gmail drafts](gog-gmail-drafts.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` | 20 | 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 gmail drafts](gog-gmail-drafts.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-drafts-send.md b/docs/commands/gog-gmail-drafts-send.md new file mode 100644 index 0000000..ab1b1f1 --- /dev/null +++ b/docs/commands/gog-gmail-drafts-send.md @@ -0,0 +1,42 @@ +# `gog gmail drafts send` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Send a draft + +## Usage + +```bash +gog gmail (mail,email) drafts (draft) send (post) <draftId> +``` + +## Parent + +- [gog gmail drafts](gog-gmail-drafts.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 gmail drafts](gog-gmail-drafts.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-drafts-update.md b/docs/commands/gog-gmail-drafts-update.md new file mode 100644 index 0000000..90a4176 --- /dev/null +++ b/docs/commands/gog-gmail-drafts-update.md @@ -0,0 +1,54 @@ +# `gog gmail drafts update` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Update a draft + +## Usage + +```bash +gog gmail (mail,email) drafts (draft) update (edit,set) <draftId> [flags] +``` + +## Parent + +- [gog gmail drafts](gog-gmail-drafts.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) | +| `--attach` | `[]string` | | Attachment file path (repeatable) | +| `--bcc` | `string` | | BCC recipients (comma-separated) | +| `--body` | `string` | | Body (plain text; required unless --body-html is set) | +| `--body-file` | `string` | | Body file path (plain text; '-' for stdin) | +| `--body-html` | `string` | | Body (HTML; optional) | +| `--cc` | `string` | | CC recipients (comma-separated) | +| `--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` | | Send from this email address (must be a verified send-as alias) | +| `--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) | +| `--quote` | `bool` | | Include quoted original message in reply | +| `--reply-to` | `string` | | Reply-To header address | +| `--reply-to-message-id` | `string` | | Reply to Gmail message ID (sets In-Reply-To/References and thread) | +| `--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. | +| `--subject` | `string` | | Subject (required) | +| `--to` | `*string` | | Recipients (comma-separated; omit to keep existing) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog gmail drafts](gog-gmail-drafts.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-drafts.md b/docs/commands/gog-gmail-drafts.md new file mode 100644 index 0000000..11a6fa2 --- /dev/null +++ b/docs/commands/gog-gmail-drafts.md @@ -0,0 +1,51 @@ +# `gog gmail drafts` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Draft operations + +## Usage + +```bash +gog gmail (mail,email) drafts (draft) <command> +``` + +## Parent + +- [gog gmail](gog-gmail.md) + +## Subcommands + +- [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 + +## 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 gmail](gog-gmail.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-forward.md b/docs/commands/gog-gmail-forward.md new file mode 100644 index 0000000..6ffe98b --- /dev/null +++ b/docs/commands/gog-gmail-forward.md @@ -0,0 +1,49 @@ +# `gog gmail forward` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Forward a message to new recipients + +## Usage + +```bash +gog gmail (mail,email) forward (fwd) --to=STRING <messageId> [flags] +``` + +## Parent + +- [gog gmail](gog-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) | +| `--bcc` | `string` | | BCC recipients (comma-separated) | +| `--cc` | `string` | | CC recipients (comma-separated) | +| `--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` | | Send from this email address (must be a verified send-as alias) | +| `--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) | +| `--note`<br>`--intro` | `string` | | Introductory text above the forwarded message | +| `--note-file` | `string` | | Note file path (plain text; '-' for stdin) | +| `-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. | +| `--skip-attachments` | `bool` | | Do not include original attachments | +| `--to` | `string` | | Recipients (comma-separated; required) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog gmail](gog-gmail.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-get.md b/docs/commands/gog-gmail-get.md new file mode 100644 index 0000000..c9d999a --- /dev/null +++ b/docs/commands/gog-gmail-get.md @@ -0,0 +1,45 @@ +# `gog gmail get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get a message (full|metadata|raw) + +## Usage + +```bash +gog gmail (mail,email) get (info,show) <messageId> [flags] +``` + +## Parent + +- [gog gmail](gog-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) | +| `--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 | +| `--format` | `string` | full | Message format: full\|metadata\|raw | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `--headers` | `string` | | Metadata headers (comma-separated; only for --format=metadata) | +| `-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) | +| `--sanitize-content`<br>`--safe`<br>`--sanitize` | `bool` | | Emit agent-oriented sanitized content: strip HTML, remove HTTP(S) URLs, and omit raw Gmail payloads from JSON | +| `--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 gmail](gog-gmail.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-history.md b/docs/commands/gog-gmail-history.md new file mode 100644 index 0000000..5e89546 --- /dev/null +++ b/docs/commands/gog-gmail-history.md @@ -0,0 +1,47 @@ +# `gog gmail history` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Gmail history + +## Usage + +```bash +gog gmail (mail,email) history [flags] +``` + +## Parent + +- [gog gmail](gog-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) | +| `--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. | +| `--since` | `string` | | Start history ID | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog gmail](gog-gmail.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-labels-create.md b/docs/commands/gog-gmail-labels-create.md new file mode 100644 index 0000000..57735e8 --- /dev/null +++ b/docs/commands/gog-gmail-labels-create.md @@ -0,0 +1,42 @@ +# `gog gmail labels create` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create a new label + +## Usage + +```bash +gog gmail (mail,email) labels (label) create (add,new) <name> +``` + +## Parent + +- [gog gmail labels](gog-gmail-labels.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 gmail labels](gog-gmail-labels.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-labels-delete.md b/docs/commands/gog-gmail-labels-delete.md new file mode 100644 index 0000000..ffc2151 --- /dev/null +++ b/docs/commands/gog-gmail-labels-delete.md @@ -0,0 +1,42 @@ +# `gog gmail labels delete` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete a label + +## Usage + +```bash +gog gmail (mail,email) labels (label) delete (rm,del) <labelIdOrName> +``` + +## Parent + +- [gog gmail labels](gog-gmail-labels.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 gmail labels](gog-gmail-labels.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-labels-get.md b/docs/commands/gog-gmail-labels-get.md new file mode 100644 index 0000000..5ad8e7f --- /dev/null +++ b/docs/commands/gog-gmail-labels-get.md @@ -0,0 +1,42 @@ +# `gog gmail labels get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get label details (including counts) + +## Usage + +```bash +gog gmail (mail,email) labels (label) get (info,show) <labelIdOrName> +``` + +## Parent + +- [gog gmail labels](gog-gmail-labels.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 gmail labels](gog-gmail-labels.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-labels-list.md b/docs/commands/gog-gmail-labels-list.md new file mode 100644 index 0000000..6fc85a3 --- /dev/null +++ b/docs/commands/gog-gmail-labels-list.md @@ -0,0 +1,42 @@ +# `gog gmail labels list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List labels + +## Usage + +```bash +gog gmail (mail,email) labels (label) list (ls) +``` + +## Parent + +- [gog gmail labels](gog-gmail-labels.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 gmail labels](gog-gmail-labels.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-labels-modify.md b/docs/commands/gog-gmail-labels-modify.md new file mode 100644 index 0000000..22f5ab3 --- /dev/null +++ b/docs/commands/gog-gmail-labels-modify.md @@ -0,0 +1,44 @@ +# `gog gmail labels modify` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Modify labels on threads + +## Usage + +```bash +gog gmail (mail,email) labels (label) modify (update,edit,set) <threadId> ... [flags] +``` + +## Parent + +- [gog gmail labels](gog-gmail-labels.md) + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--add` | `string` | | Labels to add (comma-separated, name or ID) | +| `--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) | +| `--remove` | `string` | | Labels to remove (comma-separated, name or ID) | +| `--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 gmail labels](gog-gmail-labels.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-labels-rename.md b/docs/commands/gog-gmail-labels-rename.md new file mode 100644 index 0000000..4fd0614 --- /dev/null +++ b/docs/commands/gog-gmail-labels-rename.md @@ -0,0 +1,42 @@ +# `gog gmail labels rename` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Rename a label + +## Usage + +```bash +gog gmail (mail,email) labels (label) rename (mv) <labelIdOrName> <newName> +``` + +## Parent + +- [gog gmail labels](gog-gmail-labels.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 gmail labels](gog-gmail-labels.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-labels-style.md b/docs/commands/gog-gmail-labels-style.md new file mode 100644 index 0000000..03b85de --- /dev/null +++ b/docs/commands/gog-gmail-labels-style.md @@ -0,0 +1,46 @@ +# `gog gmail labels style` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Change a user label color or visibility + +## Usage + +```bash +gog gmail (mail,email) labels (label) style (color,colour) <labelIdOrName> [flags] +``` + +## Parent + +- [gog gmail labels](gog-gmail-labels.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) | +| `--background-color` | `string` | | Background color as #RRGGBB | +| `--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) | +| `--label-list-visibility` | `string` | | Label-list visibility: labelShow\|labelShowIfUnread\|labelHide | +| `--message-list-visibility` | `string` | | Message-list visibility: show\|hide | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--select`<br>`--pick`<br>`--project` | `string` | | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. | +| `--text-color` | `string` | | Text color as #RRGGBB | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog gmail labels](gog-gmail-labels.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-labels.md b/docs/commands/gog-gmail-labels.md new file mode 100644 index 0000000..b62fa2c --- /dev/null +++ b/docs/commands/gog-gmail-labels.md @@ -0,0 +1,52 @@ +# `gog gmail labels` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Label operations + +## Usage + +```bash +gog gmail (mail,email) labels (label) <command> +``` + +## Parent + +- [gog gmail](gog-gmail.md) + +## Subcommands + +- [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 + +## 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 gmail](gog-gmail.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-mark-read.md b/docs/commands/gog-gmail-mark-read.md new file mode 100644 index 0000000..5aeaee5 --- /dev/null +++ b/docs/commands/gog-gmail-mark-read.md @@ -0,0 +1,44 @@ +# `gog gmail mark-read` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Mark messages as read + +## Usage + +```bash +gog gmail (mail,email) mark-read (read-messages) [<messageId> ...] [flags] +``` + +## Parent + +- [gog gmail](gog-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) | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--max`<br>`--limit` | `int64` | 100 | Max messages (with --query) | +| `--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` | | Mark all messages matching this query as read | +| `--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 gmail](gog-gmail.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-messages-modify.md b/docs/commands/gog-gmail-messages-modify.md new file mode 100644 index 0000000..e97ff44 --- /dev/null +++ b/docs/commands/gog-gmail-messages-modify.md @@ -0,0 +1,44 @@ +# `gog gmail messages modify` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Modify labels on a single message + +## Usage + +```bash +gog gmail (mail,email) messages (message,msg,msgs) modify (update,edit,set) <messageId> [flags] +``` + +## Parent + +- [gog gmail messages](gog-gmail-messages.md) + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--add` | `string` | | Labels to add (comma-separated, name or ID) | +| `--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) | +| `--remove` | `string` | | Labels to remove (comma-separated, name or ID) | +| `--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 gmail messages](gog-gmail-messages.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-messages-search.md b/docs/commands/gog-gmail-messages-search.md new file mode 100644 index 0000000..e5418d8 --- /dev/null +++ b/docs/commands/gog-gmail-messages-search.md @@ -0,0 +1,51 @@ +# `gog gmail messages search` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Search messages using Gmail query syntax + +## Usage + +```bash +gog gmail (mail,email) messages (message,msg,msgs) search (find,query,ls,list) <query> ... [flags] +``` + +## Parent + +- [gog gmail messages](gog-gmail-messages.md) + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--all`<br>`--all-pages`<br>`--allpages` | `bool` | | Fetch all pages | +| `--body-format` | `string` | text | Body format preference when --include-body is set: text or html | +| `--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 | +| `--full` | `bool` | | Show full message bodies without truncation (implies --include-body) | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `--include-body` | `bool` | | Include decoded message body (JSON is full; text output is truncated) | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--local` | `bool` | | Use local timezone (default behavior, useful to override --timezone) | +| `--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) | +| `--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. | +| `-z`<br>`--timezone` | `string` | | Output timezone (IANA name, e.g. America/New_York, UTC). Default: local | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog gmail messages](gog-gmail-messages.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-messages.md b/docs/commands/gog-gmail-messages.md new file mode 100644 index 0000000..6af475e --- /dev/null +++ b/docs/commands/gog-gmail-messages.md @@ -0,0 +1,47 @@ +# `gog gmail messages` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Message operations + +## Usage + +```bash +gog gmail (mail,email) messages (message,msg,msgs) <command> +``` + +## Parent + +- [gog gmail](gog-gmail.md) + +## Subcommands + +- [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 + +## 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 gmail](gog-gmail.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-search.md b/docs/commands/gog-gmail-search.md new file mode 100644 index 0000000..5c7bc06 --- /dev/null +++ b/docs/commands/gog-gmail-search.md @@ -0,0 +1,49 @@ +# `gog gmail search` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Search threads using Gmail query syntax + +## Usage + +```bash +gog gmail (mail,email) search (find,query,ls,list) <query> ... [flags] +``` + +## Parent + +- [gog gmail](gog-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) | +| `--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) | +| `--local` | `bool` | | Use local timezone (default behavior, useful to override --timezone) | +| `--max`<br>`--limit` | `int64` | 10 | Max results | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--oldest` | `bool` | | Show first message date instead of last | +| `--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. | +| `-z`<br>`--timezone` | `string` | | Output timezone (IANA name, e.g. America/New_York, UTC). Default: local | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog gmail](gog-gmail.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-send.md b/docs/commands/gog-gmail-send.md new file mode 100644 index 0000000..eaad7ff --- /dev/null +++ b/docs/commands/gog-gmail-send.md @@ -0,0 +1,61 @@ +# `gog gmail send` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Send an email + +## Usage + +```bash +gog gmail (mail,email) send [flags] +``` + +## Parent + +- [gog gmail](gog-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) | +| `--attach` | `[]string` | | Attachment file path (repeatable) | +| `--bcc` | `string` | | BCC recipients (comma-separated) | +| `--body` | `string` | | Body (plain text; required unless --body-html is set) | +| `--body-file` | `string` | | Body file path (plain text; '-' for stdin) | +| `--body-html` | `string` | | Body (HTML; optional) | +| `--cc` | `string` | | CC recipients (comma-separated) | +| `--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` | | Send from this email address (must be a verified send-as alias) | +| `--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) | +| `--quote` | `bool` | | Include quoted original message in reply (requires --reply-to-message-id or --thread-id) | +| `--reply-all` | `bool` | | Auto-populate recipients from original message (requires --reply-to-message-id or --thread-id) | +| `--reply-to` | `string` | | Reply-To header address | +| `--reply-to-message-id`<br>`--in-reply-to` | `string` | | Reply to Gmail message ID (sets In-Reply-To/References and thread) | +| `--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. | +| `--signature` | `bool` | | Append the Gmail signature from the active send-as address | +| `--signature-file` | `string` | | Append a local signature file (plain text or HTML) | +| `--signature-from` | `string` | | Append the Gmail signature from this send-as email address | +| `--subject` | `string` | | Subject (required) | +| `--thread-id` | `string` | | Reply within a Gmail thread (uses latest message for headers) | +| `--to` | `string` | | Recipients (comma-separated; required unless --reply-all is used) | +| `--track` | `bool` | | Enable open tracking (requires tracking setup) | +| `--track-split` | `bool` | | Send tracked messages separately per recipient | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog gmail](gog-gmail.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-autoforward-get.md b/docs/commands/gog-gmail-settings-autoforward-get.md new file mode 100644 index 0000000..2d3d188 --- /dev/null +++ b/docs/commands/gog-gmail-settings-autoforward-get.md @@ -0,0 +1,42 @@ +# `gog gmail settings autoforward get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get current auto-forwarding settings + +## Usage + +```bash +gog gmail (mail,email) settings autoforward get (info,show) +``` + +## Parent + +- [gog gmail settings autoforward](gog-gmail-settings-autoforward.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 gmail settings autoforward](gog-gmail-settings-autoforward.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-autoforward-update.md b/docs/commands/gog-gmail-settings-autoforward-update.md new file mode 100644 index 0000000..cfb6397 --- /dev/null +++ b/docs/commands/gog-gmail-settings-autoforward-update.md @@ -0,0 +1,46 @@ +# `gog gmail settings autoforward update` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Update auto-forwarding settings + +## Usage + +```bash +gog gmail (mail,email) settings autoforward update (edit,set) [flags] +``` + +## Parent + +- [gog gmail settings autoforward](gog-gmail-settings-autoforward.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` | `bool` | | Disable auto-forwarding | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `--disposition` | `string` | | What to do with forwarded messages: leaveInInbox, archive, trash, markRead | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--email` | `string` | | Email address to forward to (must be verified first) | +| `--enable` | `bool` | | Enable auto-forwarding | +| `--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 gmail settings autoforward](gog-gmail-settings-autoforward.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-autoforward.md b/docs/commands/gog-gmail-settings-autoforward.md new file mode 100644 index 0000000..b8ad9e5 --- /dev/null +++ b/docs/commands/gog-gmail-settings-autoforward.md @@ -0,0 +1,47 @@ +# `gog gmail settings autoforward` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Auto-forwarding settings + +## Usage + +```bash +gog gmail (mail,email) settings autoforward <command> +``` + +## Parent + +- [gog gmail settings](gog-gmail-settings.md) + +## Subcommands + +- [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 + +## 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 gmail settings](gog-gmail-settings.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-delegates-add.md b/docs/commands/gog-gmail-settings-delegates-add.md new file mode 100644 index 0000000..5e4af8d --- /dev/null +++ b/docs/commands/gog-gmail-settings-delegates-add.md @@ -0,0 +1,42 @@ +# `gog gmail settings delegates add` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Add a delegate + +## Usage + +```bash +gog gmail (mail,email) settings delegates add (create,new) <delegateEmail> +``` + +## Parent + +- [gog gmail settings delegates](gog-gmail-settings-delegates.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 gmail settings delegates](gog-gmail-settings-delegates.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-delegates-get.md b/docs/commands/gog-gmail-settings-delegates-get.md new file mode 100644 index 0000000..81c7e93 --- /dev/null +++ b/docs/commands/gog-gmail-settings-delegates-get.md @@ -0,0 +1,42 @@ +# `gog gmail settings delegates get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get a specific delegate's information + +## Usage + +```bash +gog gmail (mail,email) settings delegates get (info,show) <delegateEmail> +``` + +## Parent + +- [gog gmail settings delegates](gog-gmail-settings-delegates.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 gmail settings delegates](gog-gmail-settings-delegates.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-delegates-list.md b/docs/commands/gog-gmail-settings-delegates-list.md new file mode 100644 index 0000000..1b42a67 --- /dev/null +++ b/docs/commands/gog-gmail-settings-delegates-list.md @@ -0,0 +1,42 @@ +# `gog gmail settings delegates list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List all delegates + +## Usage + +```bash +gog gmail (mail,email) settings delegates list (ls) +``` + +## Parent + +- [gog gmail settings delegates](gog-gmail-settings-delegates.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 gmail settings delegates](gog-gmail-settings-delegates.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-delegates-remove.md b/docs/commands/gog-gmail-settings-delegates-remove.md new file mode 100644 index 0000000..fc9b535 --- /dev/null +++ b/docs/commands/gog-gmail-settings-delegates-remove.md @@ -0,0 +1,42 @@ +# `gog gmail settings delegates remove` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Remove a delegate + +## Usage + +```bash +gog gmail (mail,email) settings delegates remove (delete,rm,del) <delegateEmail> +``` + +## Parent + +- [gog gmail settings delegates](gog-gmail-settings-delegates.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 gmail settings delegates](gog-gmail-settings-delegates.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-delegates.md b/docs/commands/gog-gmail-settings-delegates.md new file mode 100644 index 0000000..2f15ce0 --- /dev/null +++ b/docs/commands/gog-gmail-settings-delegates.md @@ -0,0 +1,49 @@ +# `gog gmail settings delegates` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delegate operations + +## Usage + +```bash +gog gmail (mail,email) settings delegates <command> +``` + +## Parent + +- [gog gmail settings](gog-gmail-settings.md) + +## Subcommands + +- [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 + +## 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 gmail settings](gog-gmail-settings.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-filters-create.md b/docs/commands/gog-gmail-settings-filters-create.md new file mode 100644 index 0000000..e0c13e1 --- /dev/null +++ b/docs/commands/gog-gmail-settings-filters-create.md @@ -0,0 +1,56 @@ +# `gog gmail settings filters create` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create a new email filter + +## Usage + +```bash +gog gmail (mail,email) settings filters create (add,new) [flags] +``` + +## Parent + +- [gog gmail settings filters](gog-gmail-settings-filters.md) + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--add-label` | `string` | | Label(s) to add to matching messages (comma-separated, name or ID) | +| `--archive` | `bool` | | Archive matching messages (skip inbox) | +| `--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 | +| `--forward` | `string` | | Forward to this email address | +| `--from` | `string` | | Match messages from this sender | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `--has-attachment` | `bool` | | Match messages with attachments | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `--important` | `bool` | | Mark as important | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--mark-read` | `bool` | | Mark matching messages as read | +| `--never-spam` | `bool` | | Never mark as spam | +| `--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) | +| `--query` | `string` | | Advanced Gmail search query for matching | +| `--remove-label` | `string` | | Label(s) to remove from matching messages (comma-separated, name or ID) | +| `--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. | +| `--star` | `bool` | | Star matching messages | +| `--subject` | `string` | | Match messages with this subject | +| `--to` | `string` | | Match messages to this recipient | +| `--trash` | `bool` | | Move matching messages to trash | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog gmail settings filters](gog-gmail-settings-filters.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-filters-delete.md b/docs/commands/gog-gmail-settings-filters-delete.md new file mode 100644 index 0000000..a33f7cf --- /dev/null +++ b/docs/commands/gog-gmail-settings-filters-delete.md @@ -0,0 +1,42 @@ +# `gog gmail settings filters delete` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete a filter + +## Usage + +```bash +gog gmail (mail,email) settings filters delete (rm,del,remove) <filterId> +``` + +## Parent + +- [gog gmail settings filters](gog-gmail-settings-filters.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 gmail settings filters](gog-gmail-settings-filters.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-filters-export.md b/docs/commands/gog-gmail-settings-filters-export.md new file mode 100644 index 0000000..091e891 --- /dev/null +++ b/docs/commands/gog-gmail-settings-filters-export.md @@ -0,0 +1,43 @@ +# `gog gmail settings filters export` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Export filters as JSON + +## Usage + +```bash +gog gmail (mail,email) settings filters export [flags] +``` + +## Parent + +- [gog gmail settings filters](gog-gmail-settings-filters.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) | +| `-o`<br>`--out` | `string` | | Write JSON export to this file (defaults to stdout) | +| `-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 gmail settings filters](gog-gmail-settings-filters.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-filters-get.md b/docs/commands/gog-gmail-settings-filters-get.md new file mode 100644 index 0000000..ada55c0 --- /dev/null +++ b/docs/commands/gog-gmail-settings-filters-get.md @@ -0,0 +1,42 @@ +# `gog gmail settings filters get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get a specific filter + +## Usage + +```bash +gog gmail (mail,email) settings filters get (info,show) <filterId> +``` + +## Parent + +- [gog gmail settings filters](gog-gmail-settings-filters.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 gmail settings filters](gog-gmail-settings-filters.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-filters-list.md b/docs/commands/gog-gmail-settings-filters-list.md new file mode 100644 index 0000000..19885c5 --- /dev/null +++ b/docs/commands/gog-gmail-settings-filters-list.md @@ -0,0 +1,42 @@ +# `gog gmail settings filters list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List all email filters + +## Usage + +```bash +gog gmail (mail,email) settings filters list (ls) +``` + +## Parent + +- [gog gmail settings filters](gog-gmail-settings-filters.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 gmail settings filters](gog-gmail-settings-filters.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-filters.md b/docs/commands/gog-gmail-settings-filters.md new file mode 100644 index 0000000..af1a4a6 --- /dev/null +++ b/docs/commands/gog-gmail-settings-filters.md @@ -0,0 +1,50 @@ +# `gog gmail settings filters` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Filter operations + +## Usage + +```bash +gog gmail (mail,email) settings filters <command> +``` + +## Parent + +- [gog gmail settings](gog-gmail-settings.md) + +## Subcommands + +- [gog gmail settings filters create](gog-gmail-settings-filters-create.md) - Create a new email filter +- [gog gmail settings filters delete](gog-gmail-settings-filters-delete.md) - Delete a filter +- [gog gmail settings filters export](gog-gmail-settings-filters-export.md) - Export filters as JSON +- [gog gmail settings filters get](gog-gmail-settings-filters-get.md) - Get a specific filter +- [gog gmail settings filters list](gog-gmail-settings-filters-list.md) - List all email filters + +## 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 gmail settings](gog-gmail-settings.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-forwarding-create.md b/docs/commands/gog-gmail-settings-forwarding-create.md new file mode 100644 index 0000000..baeeb89 --- /dev/null +++ b/docs/commands/gog-gmail-settings-forwarding-create.md @@ -0,0 +1,42 @@ +# `gog gmail settings forwarding create` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create/add a forwarding address + +## Usage + +```bash +gog gmail (mail,email) settings forwarding create (add,new) <forwardingEmail> +``` + +## Parent + +- [gog gmail settings forwarding](gog-gmail-settings-forwarding.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 gmail settings forwarding](gog-gmail-settings-forwarding.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-forwarding-delete.md b/docs/commands/gog-gmail-settings-forwarding-delete.md new file mode 100644 index 0000000..124ee24 --- /dev/null +++ b/docs/commands/gog-gmail-settings-forwarding-delete.md @@ -0,0 +1,42 @@ +# `gog gmail settings forwarding delete` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete a forwarding address + +## Usage + +```bash +gog gmail (mail,email) settings forwarding delete (rm,del,remove) <forwardingEmail> +``` + +## Parent + +- [gog gmail settings forwarding](gog-gmail-settings-forwarding.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 gmail settings forwarding](gog-gmail-settings-forwarding.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-forwarding-get.md b/docs/commands/gog-gmail-settings-forwarding-get.md new file mode 100644 index 0000000..f8ae071 --- /dev/null +++ b/docs/commands/gog-gmail-settings-forwarding-get.md @@ -0,0 +1,42 @@ +# `gog gmail settings forwarding get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get a specific forwarding address + +## Usage + +```bash +gog gmail (mail,email) settings forwarding get (info,show) <forwardingEmail> +``` + +## Parent + +- [gog gmail settings forwarding](gog-gmail-settings-forwarding.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 gmail settings forwarding](gog-gmail-settings-forwarding.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-forwarding-list.md b/docs/commands/gog-gmail-settings-forwarding-list.md new file mode 100644 index 0000000..c032340 --- /dev/null +++ b/docs/commands/gog-gmail-settings-forwarding-list.md @@ -0,0 +1,42 @@ +# `gog gmail settings forwarding list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List all forwarding addresses + +## Usage + +```bash +gog gmail (mail,email) settings forwarding list (ls) +``` + +## Parent + +- [gog gmail settings forwarding](gog-gmail-settings-forwarding.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 gmail settings forwarding](gog-gmail-settings-forwarding.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-forwarding.md b/docs/commands/gog-gmail-settings-forwarding.md new file mode 100644 index 0000000..a87992d --- /dev/null +++ b/docs/commands/gog-gmail-settings-forwarding.md @@ -0,0 +1,49 @@ +# `gog gmail settings forwarding` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Forwarding addresses + +## Usage + +```bash +gog gmail (mail,email) settings forwarding <command> +``` + +## Parent + +- [gog gmail settings](gog-gmail-settings.md) + +## Subcommands + +- [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 + +## 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 gmail settings](gog-gmail-settings.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-sendas-create.md b/docs/commands/gog-gmail-settings-sendas-create.md new file mode 100644 index 0000000..98bd57a --- /dev/null +++ b/docs/commands/gog-gmail-settings-sendas-create.md @@ -0,0 +1,46 @@ +# `gog gmail settings sendas create` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create a new send-as alias + +## Usage + +```bash +gog gmail (mail,email) settings sendas create (add,new) <email> [flags] +``` + +## Parent + +- [gog gmail settings sendas](gog-gmail-settings-sendas.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 | +| `--display-name` | `string` | | Name that appears in the From field | +| `-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) | +| `--reply-to` | `string` | | Reply-to address (optional) | +| `--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. | +| `--signature` | `string` | | HTML signature for emails sent from this alias | +| `--treat-as-alias` | `bool` | true | Treat as alias (replies sent from Gmail web) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog gmail settings sendas](gog-gmail-settings-sendas.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-sendas-delete.md b/docs/commands/gog-gmail-settings-sendas-delete.md new file mode 100644 index 0000000..e4d51d1 --- /dev/null +++ b/docs/commands/gog-gmail-settings-sendas-delete.md @@ -0,0 +1,42 @@ +# `gog gmail settings sendas delete` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete a send-as alias + +## Usage + +```bash +gog gmail (mail,email) settings sendas delete (rm,del,remove) <email> +``` + +## Parent + +- [gog gmail settings sendas](gog-gmail-settings-sendas.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 gmail settings sendas](gog-gmail-settings-sendas.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-sendas-get.md b/docs/commands/gog-gmail-settings-sendas-get.md new file mode 100644 index 0000000..7150f89 --- /dev/null +++ b/docs/commands/gog-gmail-settings-sendas-get.md @@ -0,0 +1,42 @@ +# `gog gmail settings sendas get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get details of a send-as alias + +## Usage + +```bash +gog gmail (mail,email) settings sendas get (info,show) <email> +``` + +## Parent + +- [gog gmail settings sendas](gog-gmail-settings-sendas.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 gmail settings sendas](gog-gmail-settings-sendas.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-sendas-list.md b/docs/commands/gog-gmail-settings-sendas-list.md new file mode 100644 index 0000000..0fb72d4 --- /dev/null +++ b/docs/commands/gog-gmail-settings-sendas-list.md @@ -0,0 +1,42 @@ +# `gog gmail settings sendas list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List send-as aliases + +## Usage + +```bash +gog gmail (mail,email) settings sendas list (ls) +``` + +## Parent + +- [gog gmail settings sendas](gog-gmail-settings-sendas.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 gmail settings sendas](gog-gmail-settings-sendas.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-sendas-update.md b/docs/commands/gog-gmail-settings-sendas-update.md new file mode 100644 index 0000000..22a8ccf --- /dev/null +++ b/docs/commands/gog-gmail-settings-sendas-update.md @@ -0,0 +1,47 @@ +# `gog gmail settings sendas update` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Update a send-as alias + +## Usage + +```bash +gog gmail (mail,email) settings sendas update (edit,set) <email> [flags] +``` + +## Parent + +- [gog gmail settings sendas](gog-gmail-settings-sendas.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 | +| `--display-name` | `string` | | Name that appears in the From field | +| `-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) | +| `--make-default` | `bool` | | Make this the default send-as address | +| `--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) | +| `--reply-to` | `string` | | Reply-to address | +| `--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. | +| `--signature` | `string` | | HTML signature | +| `--treat-as-alias` | `bool` | true | Treat as alias | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog gmail settings sendas](gog-gmail-settings-sendas.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-sendas-verify.md b/docs/commands/gog-gmail-settings-sendas-verify.md new file mode 100644 index 0000000..961e0c8 --- /dev/null +++ b/docs/commands/gog-gmail-settings-sendas-verify.md @@ -0,0 +1,42 @@ +# `gog gmail settings sendas verify` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Resend verification email for a send-as alias + +## Usage + +```bash +gog gmail (mail,email) settings sendas verify (resend) <email> +``` + +## Parent + +- [gog gmail settings sendas](gog-gmail-settings-sendas.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 gmail settings sendas](gog-gmail-settings-sendas.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-sendas.md b/docs/commands/gog-gmail-settings-sendas.md new file mode 100644 index 0000000..8552045 --- /dev/null +++ b/docs/commands/gog-gmail-settings-sendas.md @@ -0,0 +1,51 @@ +# `gog gmail settings sendas` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Send-as settings + +## Usage + +```bash +gog gmail (mail,email) settings sendas <command> +``` + +## Parent + +- [gog gmail settings](gog-gmail-settings.md) + +## Subcommands + +- [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 + +## 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 gmail settings](gog-gmail-settings.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-vacation-get.md b/docs/commands/gog-gmail-settings-vacation-get.md new file mode 100644 index 0000000..3a506b3 --- /dev/null +++ b/docs/commands/gog-gmail-settings-vacation-get.md @@ -0,0 +1,42 @@ +# `gog gmail settings vacation get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get current vacation responder settings + +## Usage + +```bash +gog gmail (mail,email) settings vacation get (info,show) +``` + +## Parent + +- [gog gmail settings vacation](gog-gmail-settings-vacation.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 gmail settings vacation](gog-gmail-settings-vacation.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-vacation-update.md b/docs/commands/gog-gmail-settings-vacation-update.md new file mode 100644 index 0000000..cdfcde2 --- /dev/null +++ b/docs/commands/gog-gmail-settings-vacation-update.md @@ -0,0 +1,50 @@ +# `gog gmail settings vacation update` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Update vacation responder settings + +## Usage + +```bash +gog gmail (mail,email) settings vacation update (edit,set) [flags] +``` + +## Parent + +- [gog gmail settings vacation](gog-gmail-settings-vacation.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) | +| `--body` | `string` | | HTML body of the auto-reply message | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--contacts-only` | `bool` | | Only respond to contacts | +| `--disable` | `bool` | | Disable vacation responder | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `--domain-only` | `bool` | | Only respond to same domain | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable` | `bool` | | Enable vacation responder | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `--end` | `string` | | End time in RFC3339 format (e.g., 2024-12-31T23:59:59Z) | +| `-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. | +| `--start` | `string` | | Start time in RFC3339 format (e.g., 2024-12-20T00:00:00Z) | +| `--subject` | `string` | | Subject line for auto-reply | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog gmail settings vacation](gog-gmail-settings-vacation.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-vacation.md b/docs/commands/gog-gmail-settings-vacation.md new file mode 100644 index 0000000..77f7ec0 --- /dev/null +++ b/docs/commands/gog-gmail-settings-vacation.md @@ -0,0 +1,47 @@ +# `gog gmail settings vacation` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Vacation responder + +## Usage + +```bash +gog gmail (mail,email) settings vacation <command> +``` + +## Parent + +- [gog gmail settings](gog-gmail-settings.md) + +## Subcommands + +- [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 + +## 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 gmail settings](gog-gmail-settings.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-watch-renew.md b/docs/commands/gog-gmail-settings-watch-renew.md new file mode 100644 index 0000000..d0a22c2 --- /dev/null +++ b/docs/commands/gog-gmail-settings-watch-renew.md @@ -0,0 +1,43 @@ +# `gog gmail settings watch renew` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Renew Gmail watch using stored config + +## Usage + +```bash +gog gmail (mail,email) settings watch renew (update) [flags] +``` + +## Parent + +- [gog gmail settings watch](gog-gmail-settings-watch.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. | +| `--ttl` | `string` | | Renew after duration (seconds or Go duration) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog gmail settings watch](gog-gmail-settings-watch.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-watch-serve.md b/docs/commands/gog-gmail-settings-watch-serve.md new file mode 100644 index 0000000..e64220c --- /dev/null +++ b/docs/commands/gog-gmail-settings-watch-serve.md @@ -0,0 +1,59 @@ +# `gog gmail settings watch serve` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Run Pub/Sub push handler + +## Usage + +```bash +gog gmail (mail,email) settings watch serve [flags] +``` + +## Parent + +- [gog gmail settings watch](gog-gmail-settings-watch.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) | +| `--bind` | `string` | 127.0.0.1 | Bind address | +| `--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) | +| `--exclude-labels` | `string` | SPAM,TRASH | List of Gmail label IDs to exclude from hook payload (e.g. SPAM,TRASH,Label_123). Set to empty string to disable. | +| `--fetch-delay` | `string` | 3s | Delay before fetching Gmail history (seconds or duration) | +| `-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. | +| `--history-types` | `[]string` | | History types to include (repeatable, comma-separated: messageAdded,messageDeleted,labelAdded,labelRemoved). Default: messageAdded | +| `--hook-token` | `string` | | Webhook bearer token | +| `--hook-url` | `string` | | Webhook URL to forward messages | +| `--include-body` | `bool` | | Include text/plain body in hook payload | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--local` | `bool` | | Use local timezone (default behavior, useful to override --timezone) | +| `--max-bytes` | `int` | 20000 | Max bytes of body to include | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--oidc-audience` | `string` | | Expected OIDC audience | +| `--oidc-email` | `string` | | Expected service account email | +| `--path` | `string` | /gmail-pubsub | Push handler path | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--port` | `int` | 8788 | Listen port | +| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | +| `--save-hook` | `bool` | | Persist hook settings to watch state | +| `--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. | +| `-z`<br>`--timezone` | `string` | | Output timezone (IANA name, e.g. America/New_York, UTC). Default: local | +| `--token` | `string` | | Shared token for x-gog-token or ?token= | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--verify-oidc` | `bool` | | Verify Pub/Sub OIDC tokens | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog gmail settings watch](gog-gmail-settings-watch.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-watch-start.md b/docs/commands/gog-gmail-settings-watch-start.md new file mode 100644 index 0000000..aaae31b --- /dev/null +++ b/docs/commands/gog-gmail-settings-watch-start.md @@ -0,0 +1,49 @@ +# `gog gmail settings watch start` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Start Gmail watch for Pub/Sub + +## Usage + +```bash +gog gmail (mail,email) settings watch start (begin) [flags] +``` + +## Parent + +- [gog gmail settings watch](gog-gmail-settings-watch.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. | +| `--hook-token` | `string` | | Webhook bearer token | +| `--hook-url` | `string` | | Webhook URL to forward messages | +| `--include-body` | `bool` | | Include text/plain body in hook payload | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--label` | `[]string` | | Label IDs or names (repeatable, comma-separated) | +| `--max-bytes` | `int` | 20000 | Max bytes of body to include | +| `--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. | +| `--topic` | `string` | | Pub/Sub topic (projects/.../topics/...) | +| `--ttl` | `string` | | Renew after duration (seconds or Go duration) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog gmail settings watch](gog-gmail-settings-watch.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-watch-status.md b/docs/commands/gog-gmail-settings-watch-status.md new file mode 100644 index 0000000..810542d --- /dev/null +++ b/docs/commands/gog-gmail-settings-watch-status.md @@ -0,0 +1,43 @@ +# `gog gmail settings watch status` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Show stored watch state + +## Usage + +```bash +gog gmail (mail,email) settings watch status (ls) [flags] +``` + +## Parent + +- [gog gmail settings watch](gog-gmail-settings-watch.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. | +| `--show-secrets` | `bool` | | Show secret values (e.g. hook token) in plaintext | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog gmail settings watch](gog-gmail-settings-watch.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-watch-stop.md b/docs/commands/gog-gmail-settings-watch-stop.md new file mode 100644 index 0000000..40e52f1 --- /dev/null +++ b/docs/commands/gog-gmail-settings-watch-stop.md @@ -0,0 +1,42 @@ +# `gog gmail settings watch stop` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Stop Gmail watch and clear stored state + +## Usage + +```bash +gog gmail (mail,email) settings watch stop (rm,delete) +``` + +## Parent + +- [gog gmail settings watch](gog-gmail-settings-watch.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 gmail settings watch](gog-gmail-settings-watch.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings-watch.md b/docs/commands/gog-gmail-settings-watch.md new file mode 100644 index 0000000..2407345 --- /dev/null +++ b/docs/commands/gog-gmail-settings-watch.md @@ -0,0 +1,50 @@ +# `gog gmail settings watch` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Manage Gmail watch + +## Usage + +```bash +gog gmail (mail,email) settings watch <command> +``` + +## Parent + +- [gog gmail settings](gog-gmail-settings.md) + +## Subcommands + +- [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 + +## 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 gmail settings](gog-gmail-settings.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-settings.md b/docs/commands/gog-gmail-settings.md new file mode 100644 index 0000000..bc55028 --- /dev/null +++ b/docs/commands/gog-gmail-settings.md @@ -0,0 +1,52 @@ +# `gog gmail settings` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Settings and admin + +## Usage + +```bash +gog gmail (mail,email) settings <command> +``` + +## Parent + +- [gog gmail](gog-gmail.md) + +## Subcommands + +- [gog gmail settings autoforward](gog-gmail-settings-autoforward.md) - Auto-forwarding settings +- [gog gmail settings delegates](gog-gmail-settings-delegates.md) - Delegate operations +- [gog gmail settings filters](gog-gmail-settings-filters.md) - Filter operations +- [gog gmail settings forwarding](gog-gmail-settings-forwarding.md) - Forwarding addresses +- [gog gmail settings sendas](gog-gmail-settings-sendas.md) - Send-as settings +- [gog gmail settings vacation](gog-gmail-settings-vacation.md) - Vacation responder +- [gog gmail settings watch](gog-gmail-settings-watch.md) - Manage Gmail watch + +## 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 gmail](gog-gmail.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-thread-attachments.md b/docs/commands/gog-gmail-thread-attachments.md new file mode 100644 index 0000000..f0a4e60 --- /dev/null +++ b/docs/commands/gog-gmail-thread-attachments.md @@ -0,0 +1,44 @@ +# `gog gmail thread attachments` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List all attachments in a thread + +## Usage + +```bash +gog gmail (mail,email) thread (threads,read) attachments (files) <threadId> [flags] +``` + +## Parent + +- [gog gmail thread](gog-gmail-thread.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 | +| `--download` | `bool` | | Download all attachments | +| `-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-dir`<br>`--output-dir` | `string` | | Directory to write attachments to (default: current directory) | +| `-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 gmail thread](gog-gmail-thread.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-thread-get.md b/docs/commands/gog-gmail-thread-get.md new file mode 100644 index 0000000..45c8714 --- /dev/null +++ b/docs/commands/gog-gmail-thread-get.md @@ -0,0 +1,46 @@ +# `gog gmail thread get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get a thread with all messages (optionally download attachments) + +## Usage + +```bash +gog gmail (mail,email) thread (threads,read) get (info,show) <threadId> [flags] +``` + +## Parent + +- [gog gmail thread](gog-gmail-thread.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 | +| `--download` | `bool` | | Download attachments | +| `-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 | +| `--full` | `bool` | | Show full message bodies | +| `--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-dir`<br>`--output-dir` | `string` | | Directory to write attachments to (default: current directory) | +| `-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) | +| `--sanitize-content`<br>`--safe`<br>`--sanitize` | `bool` | | Emit agent-oriented sanitized content: strip HTML, remove HTTP(S) URLs, and omit raw Gmail payloads from JSON | +| `--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 gmail thread](gog-gmail-thread.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-thread-modify.md b/docs/commands/gog-gmail-thread-modify.md new file mode 100644 index 0000000..eed217a --- /dev/null +++ b/docs/commands/gog-gmail-thread-modify.md @@ -0,0 +1,44 @@ +# `gog gmail thread modify` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Modify labels on all messages in a thread + +## Usage + +```bash +gog gmail (mail,email) thread (threads,read) modify (update,edit,set) <threadId> [flags] +``` + +## Parent + +- [gog gmail thread](gog-gmail-thread.md) + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--add` | `string` | | Labels to add (comma-separated, name or ID) | +| `--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) | +| `--remove` | `string` | | Labels to remove (comma-separated, name or ID) | +| `--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 gmail thread](gog-gmail-thread.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-thread.md b/docs/commands/gog-gmail-thread.md new file mode 100644 index 0000000..02dc8e1 --- /dev/null +++ b/docs/commands/gog-gmail-thread.md @@ -0,0 +1,48 @@ +# `gog gmail thread` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Thread operations (get, modify) + +## Usage + +```bash +gog gmail (mail,email) thread (threads,read) <command> +``` + +## Parent + +- [gog gmail](gog-gmail.md) + +## Subcommands + +- [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 + +## 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 gmail](gog-gmail.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-track-key-rotate.md b/docs/commands/gog-gmail-track-key-rotate.md new file mode 100644 index 0000000..7bb6c36 --- /dev/null +++ b/docs/commands/gog-gmail-track-key-rotate.md @@ -0,0 +1,44 @@ +# `gog gmail track key rotate` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Rotate tracking encryption key + +## Usage + +```bash +gog gmail (mail,email) track key rotate [flags] +``` + +## Parent + +- [gog gmail track key](gog-gmail-track-key.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-deploy` | `bool` | | Update local tracking keys without deploying the Worker | +| `--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 | +| `--worker-dir` | `string` | | Worker directory (default: internal/tracking/worker) | + +## See Also + +- [gog gmail track key](gog-gmail-track-key.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-track-key.md b/docs/commands/gog-gmail-track-key.md new file mode 100644 index 0000000..29540f7 --- /dev/null +++ b/docs/commands/gog-gmail-track-key.md @@ -0,0 +1,46 @@ +# `gog gmail track key` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Manage tracking encryption keys + +## Usage + +```bash +gog gmail (mail,email) track key <command> +``` + +## Parent + +- [gog gmail track](gog-gmail-track.md) + +## Subcommands + +- [gog gmail track key rotate](gog-gmail-track-key-rotate.md) - Rotate tracking encryption 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 gmail track](gog-gmail-track.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-track-opens.md b/docs/commands/gog-gmail-track-opens.md new file mode 100644 index 0000000..7b627f8 --- /dev/null +++ b/docs/commands/gog-gmail-track-opens.md @@ -0,0 +1,44 @@ +# `gog gmail track opens` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Query email opens + +## Usage + +```bash +gog gmail (mail,email) track opens [<tracking-id>] [flags] +``` + +## Parent + +- [gog gmail track](gog-gmail-track.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. | +| `--since` | `string` | | Filter by time (e.g., '24h', '2024-01-01') | +| `--to` | `string` | | Filter by recipient email | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog gmail track](gog-gmail-track.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-track-setup.md b/docs/commands/gog-gmail-track-setup.md new file mode 100644 index 0000000..c8b124d --- /dev/null +++ b/docs/commands/gog-gmail-track-setup.md @@ -0,0 +1,49 @@ +# `gog gmail track setup` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Set up email tracking (deploy Cloudflare Worker) + +## Usage + +```bash +gog gmail (mail,email) track setup [flags] +``` + +## Parent + +- [gog gmail track](gog-gmail-track.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-key` | `string` | | Admin key for /opens (generates one if omitted) | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--db-name` | `string` | | D1 database name (defaults to worker name) | +| `--deploy` | `bool` | | Provision D1 + deploy the worker (requires wrangler) | +| `--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. | +| `--tracking-key` | `string` | | Tracking key (base64; generates one if omitted) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | +| `--worker-dir` | `string` | | Worker directory (default: internal/tracking/worker) | +| `--worker-name` | `string` | | Cloudflare Worker name (defaults to gog-email-tracker-<account>) | +| `--worker-url`<br>`--domain` | `string` | | Tracking worker base URL (e.g. https://gog-email-tracker.<acct>.workers.dev) | + +## See Also + +- [gog gmail track](gog-gmail-track.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-track-status.md b/docs/commands/gog-gmail-track-status.md new file mode 100644 index 0000000..d1aa09e --- /dev/null +++ b/docs/commands/gog-gmail-track-status.md @@ -0,0 +1,42 @@ +# `gog gmail track status` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Show tracking configuration status + +## Usage + +```bash +gog gmail (mail,email) track status +``` + +## Parent + +- [gog gmail track](gog-gmail-track.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 gmail track](gog-gmail-track.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-track.md b/docs/commands/gog-gmail-track.md new file mode 100644 index 0000000..5f33641 --- /dev/null +++ b/docs/commands/gog-gmail-track.md @@ -0,0 +1,49 @@ +# `gog gmail track` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Email open tracking + +## Usage + +```bash +gog gmail (mail,email) track <command> +``` + +## Parent + +- [gog gmail](gog-gmail.md) + +## Subcommands + +- [gog gmail track key](gog-gmail-track-key.md) - Manage tracking encryption keys +- [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 + +## 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 gmail](gog-gmail.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-trash.md b/docs/commands/gog-gmail-trash.md new file mode 100644 index 0000000..3032de7 --- /dev/null +++ b/docs/commands/gog-gmail-trash.md @@ -0,0 +1,44 @@ +# `gog gmail trash` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Move messages to trash + +## Usage + +```bash +gog gmail (mail,email) trash [<messageId> ...] [flags] +``` + +## Parent + +- [gog gmail](gog-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) | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--max`<br>`--limit` | `int64` | 100 | Max messages to trash (with --query) | +| `--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` | | Trash all messages matching this Gmail search query | +| `--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 gmail](gog-gmail.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-unread.md b/docs/commands/gog-gmail-unread.md new file mode 100644 index 0000000..af4d719 --- /dev/null +++ b/docs/commands/gog-gmail-unread.md @@ -0,0 +1,44 @@ +# `gog gmail unread` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Mark messages as unread + +## Usage + +```bash +gog gmail (mail,email) unread (mark-unread) [<messageId> ...] [flags] +``` + +## Parent + +- [gog gmail](gog-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) | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--max`<br>`--limit` | `int64` | 100 | Max messages (with --query) | +| `--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` | | Mark all messages matching this query as unread | +| `--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 gmail](gog-gmail.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail-url.md b/docs/commands/gog-gmail-url.md new file mode 100644 index 0000000..8688210 --- /dev/null +++ b/docs/commands/gog-gmail-url.md @@ -0,0 +1,42 @@ +# `gog gmail url` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Print Gmail web URLs for threads + +## Usage + +```bash +gog gmail (mail,email) url <threadId> ... +``` + +## Parent + +- [gog gmail](gog-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) | +| `--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 gmail](gog-gmail.md) +- [Command index](README.md) diff --git a/docs/commands/gog-gmail.md b/docs/commands/gog-gmail.md new file mode 100644 index 0000000..4a30820 --- /dev/null +++ b/docs/commands/gog-gmail.md @@ -0,0 +1,64 @@ +# `gog gmail` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Gmail + +## Usage + +```bash +gog gmail (mail,email) <command> [flags] +``` + +## Parent + +- [gog](gog.md) + +## Subcommands + +- [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 drafts](gog-gmail-drafts.md) - Draft operations +- [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 mark-read](gog-gmail-mark-read.md) - Mark messages as read +- [gog gmail messages](gog-gmail-messages.md) - Message operations +- [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 thread](gog-gmail-thread.md) - Thread operations (get, modify) +- [gog gmail track](gog-gmail-track.md) - Email open tracking +- [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 + +## 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) diff --git a/docs/commands/gog-groups-list.md b/docs/commands/gog-groups-list.md new file mode 100644 index 0000000..36e9adb --- /dev/null +++ b/docs/commands/gog-groups-list.md @@ -0,0 +1,46 @@ +# `gog groups list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List groups you belong to + +## Usage + +```bash +gog groups (group) list (ls) [flags] +``` + +## Parent + +- [gog groups](gog-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 | +| `-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 groups](gog-groups.md) +- [Command index](README.md) diff --git a/docs/commands/gog-groups-members.md b/docs/commands/gog-groups-members.md new file mode 100644 index 0000000..d753129 --- /dev/null +++ b/docs/commands/gog-groups-members.md @@ -0,0 +1,46 @@ +# `gog groups members` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List members of a group + +## Usage + +```bash +gog groups (group) members <groupEmail> [flags] +``` + +## Parent + +- [gog groups](gog-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 | +| `-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 groups](gog-groups.md) +- [Command index](README.md) diff --git a/docs/commands/gog-groups.md b/docs/commands/gog-groups.md new file mode 100644 index 0000000..52e644b --- /dev/null +++ b/docs/commands/gog-groups.md @@ -0,0 +1,47 @@ +# `gog groups` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Google Groups + +## Usage + +```bash +gog groups (group) <command> [flags] +``` + +## Parent + +- [gog](gog.md) + +## Subcommands + +- [gog groups list](gog-groups-list.md) - List groups you belong to +- [gog groups members](gog-groups-members.md) - List members of 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](gog.md) +- [Command index](README.md) diff --git a/docs/commands/gog-keep-attachment.md b/docs/commands/gog-keep-attachment.md new file mode 100644 index 0000000..589792e --- /dev/null +++ b/docs/commands/gog-keep-attachment.md @@ -0,0 +1,46 @@ +# `gog keep attachment` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Download an attachment + +## Usage + +```bash +gog keep attachment <attachmentName> [flags] +``` + +## Parent + +- [gog keep](gog-keep.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. | +| `--impersonate` | `string` | | Email to impersonate (required with service-account) | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--mime-type` | `string` | application/octet-stream | MIME type of attachment (e.g. image/jpeg) | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--out` | `string` | | Output file path (default: attachment filename or ID) | +| `-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. | +| `--service-account` | `string` | | Path to service account JSON file | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog keep](gog-keep.md) +- [Command index](README.md) diff --git a/docs/commands/gog-keep-create.md b/docs/commands/gog-keep-create.md new file mode 100644 index 0000000..06da48c --- /dev/null +++ b/docs/commands/gog-keep-create.md @@ -0,0 +1,47 @@ +# `gog keep create` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create a new note + +## Usage + +```bash +gog keep create [flags] +``` + +## Parent + +- [gog keep](gog-keep.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. | +| `--impersonate` | `string` | | Email to impersonate (required with service-account) | +| `--item` | `[]string` | | List item text (repeatable; creates a checklist note) | +| `-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. | +| `--service-account` | `string` | | Path to service account JSON file | +| `--text` | `string` | | Note body text | +| `--title` | `string` | | Note title | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog keep](gog-keep.md) +- [Command index](README.md) diff --git a/docs/commands/gog-keep-delete.md b/docs/commands/gog-keep-delete.md new file mode 100644 index 0000000..3f6515e --- /dev/null +++ b/docs/commands/gog-keep-delete.md @@ -0,0 +1,44 @@ +# `gog keep delete` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete a note + +## Usage + +```bash +gog keep delete <noteId> [flags] +``` + +## Parent + +- [gog keep](gog-keep.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. | +| `--impersonate` | `string` | | Email to impersonate (required with service-account) | +| `-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. | +| `--service-account` | `string` | | Path to service account JSON file | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog keep](gog-keep.md) +- [Command index](README.md) diff --git a/docs/commands/gog-keep-get.md b/docs/commands/gog-keep-get.md new file mode 100644 index 0000000..6192f22 --- /dev/null +++ b/docs/commands/gog-keep-get.md @@ -0,0 +1,44 @@ +# `gog keep get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get a note + +## Usage + +```bash +gog keep get <noteId> [flags] +``` + +## Parent + +- [gog keep](gog-keep.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. | +| `--impersonate` | `string` | | Email to impersonate (required with service-account) | +| `-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. | +| `--service-account` | `string` | | Path to service account JSON file | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog keep](gog-keep.md) +- [Command index](README.md) diff --git a/docs/commands/gog-keep-list.md b/docs/commands/gog-keep-list.md new file mode 100644 index 0000000..57bf97a --- /dev/null +++ b/docs/commands/gog-keep-list.md @@ -0,0 +1,49 @@ +# `gog keep list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List notes + +## Usage + +```bash +gog keep list [flags] +``` + +## Parent + +- [gog keep](gog-keep.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 | +| `--filter` | `string` | | Filter expression (e.g. 'create_time > "2024-01-01T00:00:00Z"') | +| `-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. | +| `--impersonate` | `string` | | Email to impersonate (required with service-account) | +| `-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. | +| `--service-account` | `string` | | Path to service account JSON file | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog keep](gog-keep.md) +- [Command index](README.md) diff --git a/docs/commands/gog-keep-search.md b/docs/commands/gog-keep-search.md new file mode 100644 index 0000000..ec260b7 --- /dev/null +++ b/docs/commands/gog-keep-search.md @@ -0,0 +1,45 @@ +# `gog keep search` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Search notes by text (client-side) + +## Usage + +```bash +gog keep search <query> [flags] +``` + +## Parent + +- [gog keep](gog-keep.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. | +| `--impersonate` | `string` | | Email to impersonate (required with service-account) | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--max`<br>`--limit` | `int64` | 500 | Max results to fetch before filtering | +| `--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. | +| `--service-account` | `string` | | Path to service account JSON file | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog keep](gog-keep.md) +- [Command index](README.md) diff --git a/docs/commands/gog-keep.md b/docs/commands/gog-keep.md new file mode 100644 index 0000000..0442d61 --- /dev/null +++ b/docs/commands/gog-keep.md @@ -0,0 +1,53 @@ +# `gog keep` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Google Keep (Workspace only) + +## Usage + +```bash +gog keep <command> [flags] +``` + +## Parent + +- [gog](gog.md) + +## Subcommands + +- [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) + +## 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. | +| `--impersonate` | `string` | | Email to impersonate (required with service-account) | +| `-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. | +| `--service-account` | `string` | | Path to service account JSON file | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog](gog.md) +- [Command index](README.md) diff --git a/docs/commands/gog-login.md b/docs/commands/gog-login.md new file mode 100644 index 0000000..44d3db9 --- /dev/null +++ b/docs/commands/gog-login.md @@ -0,0 +1,56 @@ +# `gog login` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Authorize and store a refresh token (alias for 'auth add') + +## Usage + +```bash +gog login <email> [flags] +``` + +## Parent + +- [gog](gog.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](gog.md) +- [Command index](README.md) diff --git a/docs/commands/gog-logout.md b/docs/commands/gog-logout.md new file mode 100644 index 0000000..8cae26f --- /dev/null +++ b/docs/commands/gog-logout.md @@ -0,0 +1,42 @@ +# `gog logout` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Remove a stored refresh token (alias for 'auth remove') + +## Usage + +```bash +gog logout <email> [flags] +``` + +## Parent + +- [gog](gog.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](gog.md) +- [Command index](README.md) diff --git a/docs/commands/gog-ls.md b/docs/commands/gog-ls.md new file mode 100644 index 0000000..4d6dbea --- /dev/null +++ b/docs/commands/gog-ls.md @@ -0,0 +1,48 @@ +# `gog ls` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List Drive files (alias for 'drive ls') + +## Usage + +```bash +gog ls (list) [flags] +``` + +## Parent + +- [gog](gog.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>`--global` | `bool` | | List all accessible files (mutually exclusive with --parent) | +| `--all-drives` | `bool` | true | Include shared drives (default: true; use --no-all-drives for My Drive only) | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--max`<br>`--limit` | `int64` | 20 | Max results | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--page`<br>`--cursor` | `string` | | Page token | +| `--parent` | `string` | | Folder ID to list (default: root) | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--query` | `string` | | Drive query filter | +| `--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) diff --git a/docs/commands/gog-me.md b/docs/commands/gog-me.md new file mode 100644 index 0000000..ab706ae --- /dev/null +++ b/docs/commands/gog-me.md @@ -0,0 +1,42 @@ +# `gog me` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Show your profile (alias for 'people me') + +## Usage + +```bash +gog me [flags] +``` + +## Parent + +- [gog](gog.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](gog.md) +- [Command index](README.md) diff --git a/docs/commands/gog-open.md b/docs/commands/gog-open.md new file mode 100644 index 0000000..b357453 --- /dev/null +++ b/docs/commands/gog-open.md @@ -0,0 +1,43 @@ +# `gog open` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Print a best-effort web URL for a Google URL/ID (offline) + +## Usage + +```bash +gog open (browse) <target> [flags] +``` + +## Parent + +- [gog](gog.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. | +| `--type` | `string` | auto | Type hint (auto\|drive\|folder\|docs\|sheets\|slides\|gmail-thread) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog](gog.md) +- [Command index](README.md) diff --git a/docs/commands/gog-people-get.md b/docs/commands/gog-people-get.md new file mode 100644 index 0000000..34d2e87 --- /dev/null +++ b/docs/commands/gog-people-get.md @@ -0,0 +1,42 @@ +# `gog people get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get a user profile by ID + +## Usage + +```bash +gog people (person) get (info,show) <userId> +``` + +## Parent + +- [gog people](gog-people.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 people](gog-people.md) +- [Command index](README.md) diff --git a/docs/commands/gog-people-me.md b/docs/commands/gog-people-me.md new file mode 100644 index 0000000..c42000b --- /dev/null +++ b/docs/commands/gog-people-me.md @@ -0,0 +1,42 @@ +# `gog people me` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Show your profile (people/me) + +## Usage + +```bash +gog people (person) me +``` + +## Parent + +- [gog people](gog-people.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 people](gog-people.md) +- [Command index](README.md) diff --git a/docs/commands/gog-people-relations.md b/docs/commands/gog-people-relations.md new file mode 100644 index 0000000..653d0e4 --- /dev/null +++ b/docs/commands/gog-people-relations.md @@ -0,0 +1,43 @@ +# `gog people relations` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get user relations + +## Usage + +```bash +gog people (person) relations [<userId>] [flags] +``` + +## Parent + +- [gog people](gog-people.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. | +| `--type` | `string` | | Filter relation type | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog people](gog-people.md) +- [Command index](README.md) diff --git a/docs/commands/gog-people-search.md b/docs/commands/gog-people-search.md new file mode 100644 index 0000000..8d5fda2 --- /dev/null +++ b/docs/commands/gog-people-search.md @@ -0,0 +1,46 @@ +# `gog people search` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Search the Workspace directory + +## Usage + +```bash +gog people (person) search (find,query) <query> ... [flags] +``` + +## Parent + +- [gog people](gog-people.md) + +## Flags + +| Flag | Type | Default | Help | +| --- | --- | --- | --- | +| `--access-token` | `string` | | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | +| `-a`<br>`--account`<br>`--acct` | `string` | | Account email for API commands (gmail/calendar/chat/classroom/drive/docs/slides/contacts/tasks/people/sheets/forms/appscript/ads) | +| `--all`<br>`--all-pages`<br>`--allpages` | `bool` | | Fetch all pages | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--disable-commands` | `string` | | Comma-separated list of disabled commands; dot paths allowed | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `--fail-empty`<br>`--non-empty`<br>`--require-results` | `bool` | | Exit with code 3 if no results | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--max`<br>`--limit` | `int64` | 50 | Max results | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--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 people](gog-people.md) +- [Command index](README.md) diff --git a/docs/commands/gog-people.md b/docs/commands/gog-people.md new file mode 100644 index 0000000..3802d1b --- /dev/null +++ b/docs/commands/gog-people.md @@ -0,0 +1,49 @@ +# `gog people` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Google People + +## Usage + +```bash +gog people (person) <command> [flags] +``` + +## Parent + +- [gog](gog.md) + +## Subcommands + +- [gog people get](gog-people-get.md) - Get a user profile by ID +- [gog people me](gog-people-me.md) - Show your profile (people/me) +- [gog people relations](gog-people-relations.md) - Get user relations +- [gog people search](gog-people-search.md) - Search the Workspace directory + +## 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) diff --git a/docs/commands/gog-schema.md b/docs/commands/gog-schema.md new file mode 100644 index 0000000..9dd2fc5 --- /dev/null +++ b/docs/commands/gog-schema.md @@ -0,0 +1,43 @@ +# `gog schema` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Machine-readable command/flag schema + +## Usage + +```bash +gog schema (help-json,helpjson) [<command> ...] [flags] +``` + +## Parent + +- [gog](gog.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. | +| `--include-hidden` | `bool` | | Include hidden commands and flags | +| `-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) diff --git a/docs/commands/gog-search.md b/docs/commands/gog-search.md new file mode 100644 index 0000000..a68f3dd --- /dev/null +++ b/docs/commands/gog-search.md @@ -0,0 +1,48 @@ +# `gog search` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Search Drive files (alias for 'drive search') + +## Usage + +```bash +gog search (find) <query> ... [flags] +``` + +## Parent + +- [gog](gog.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-drives` | `bool` | true | Include shared drives (default: true; use --no-all-drives for My Drive only) | +| `--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`<br>`--drive-id` | `string` | | Scope search to a specific shared drive (uses corpora=drive with driveId). Mutually exclusive with --no-all-drives. Pass the driveId from 'gog drive drives'. | +| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` | | Do not make changes; print intended actions and exit successfully | +| `--enable-commands` | `string` | | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) | +| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` | | Skip confirmations for destructive commands | +| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) | +| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. | +| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) | +| `--max`<br>`--limit` | `int64` | 20 | Max results | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--page`<br>`--cursor` | `string` | | Page token | +| `--parent` | `string` | | Scope search to direct children of a specific folder or shared drive. Wraps the query with "'<parentId>' in parents". | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--raw-query`<br>`--raw` | `bool` | | Treat query as Drive query language (pass through; may error if invalid) | +| `--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) diff --git a/docs/commands/gog-send.md b/docs/commands/gog-send.md new file mode 100644 index 0000000..a1517a5 --- /dev/null +++ b/docs/commands/gog-send.md @@ -0,0 +1,61 @@ +# `gog send` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Send an email (alias for 'gmail send') + +## Usage + +```bash +gog send [flags] +``` + +## Parent + +- [gog](gog.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) | +| `--attach` | `[]string` | | Attachment file path (repeatable) | +| `--bcc` | `string` | | BCC recipients (comma-separated) | +| `--body` | `string` | | Body (plain text; required unless --body-html is set) | +| `--body-file` | `string` | | Body file path (plain text; '-' for stdin) | +| `--body-html` | `string` | | Body (HTML; optional) | +| `--cc` | `string` | | CC recipients (comma-separated) | +| `--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` | | Send from this email address (must be a verified send-as alias) | +| `--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) | +| `--quote` | `bool` | | Include quoted original message in reply (requires --reply-to-message-id or --thread-id) | +| `--reply-all` | `bool` | | Auto-populate recipients from original message (requires --reply-to-message-id or --thread-id) | +| `--reply-to` | `string` | | Reply-To header address | +| `--reply-to-message-id`<br>`--in-reply-to` | `string` | | Reply to Gmail message ID (sets In-Reply-To/References and thread) | +| `--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. | +| `--signature` | `bool` | | Append the Gmail signature from the active send-as address | +| `--signature-file` | `string` | | Append a local signature file (plain text or HTML) | +| `--signature-from` | `string` | | Append the Gmail signature from this send-as email address | +| `--subject` | `string` | | Subject (required) | +| `--thread-id` | `string` | | Reply within a Gmail thread (uses latest message for headers) | +| `--to` | `string` | | Recipients (comma-separated; required unless --reply-all is used) | +| `--track` | `bool` | | Enable open tracking (requires tracking setup) | +| `--track-split` | `bool` | | Send tracked messages separately per recipient | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog](gog.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-add-tab.md b/docs/commands/gog-sheets-add-tab.md new file mode 100644 index 0000000..2255445 --- /dev/null +++ b/docs/commands/gog-sheets-add-tab.md @@ -0,0 +1,43 @@ +# `gog sheets add-tab` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Add a new tab/sheet to a spreadsheet + +## Usage + +```bash +gog sheets (sheet) add-tab (add-sheet) <spreadsheetId> <tabName> [flags] +``` + +## Parent + +- [gog sheets](gog-sheets.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. | +| `--index` | `*int64` | | Zero-based tab index for the new tab | +| `-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 sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-append.md b/docs/commands/gog-sheets-append.md new file mode 100644 index 0000000..5545910 --- /dev/null +++ b/docs/commands/gog-sheets-append.md @@ -0,0 +1,46 @@ +# `gog sheets append` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Append values to a range + +## Usage + +```bash +gog sheets (sheet) append (add) <spreadsheetId> <range> [<values> ...] [flags] +``` + +## Parent + +- [gog sheets](gog-sheets.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 | +| `--copy-validation-from` | `string` | | Copy data validation from an A1 range or named range (e.g. 'Sheet1!A2:D2' or MyNamedRange) to the appended cells | +| `--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. | +| `--input` | `string` | USER_ENTERED | Value input option: RAW or USER_ENTERED | +| `--insert` | `string` | | Insert data option: OVERWRITE or INSERT_ROWS | +| `-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. | +| `--values-json` | `string` | | Values as JSON 2D array | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-chart-create.md b/docs/commands/gog-sheets-chart-create.md new file mode 100644 index 0000000..5fe6199 --- /dev/null +++ b/docs/commands/gog-sheets-chart-create.md @@ -0,0 +1,47 @@ +# `gog sheets chart create` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create a chart from a JSON spec + +## Usage + +```bash +gog sheets (sheet) chart (charts) create (add,new) --spec-json=STRING <spreadsheetId> [flags] +``` + +## Parent + +- [gog sheets chart](gog-sheets-chart.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) | +| `--anchor` | `string` | | Anchor cell in A1 notation (e.g. A1, E10) | +| `--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) | +| `--height` | `int64` | 371 | Chart height in pixels | +| `-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. | +| `--sheet` | `string` | | Sheet name for anchor (resolved to sheetId) | +| `--spec-json` | `string` | | ChartSpec or EmbeddedChart JSON (inline or @file) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | +| `--width` | `int64` | 600 | Chart width in pixels | + +## See Also + +- [gog sheets chart](gog-sheets-chart.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-chart-delete.md b/docs/commands/gog-sheets-chart-delete.md new file mode 100644 index 0000000..5977896 --- /dev/null +++ b/docs/commands/gog-sheets-chart-delete.md @@ -0,0 +1,42 @@ +# `gog sheets chart delete` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete a chart + +## Usage + +```bash +gog sheets (sheet) chart (charts) delete (rm,remove,del) <spreadsheetId> <chartId> +``` + +## Parent + +- [gog sheets chart](gog-sheets-chart.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 sheets chart](gog-sheets-chart.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-chart-get.md b/docs/commands/gog-sheets-chart-get.md new file mode 100644 index 0000000..7714eb9 --- /dev/null +++ b/docs/commands/gog-sheets-chart-get.md @@ -0,0 +1,42 @@ +# `gog sheets chart get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get full chart definition (spec + position) + +## Usage + +```bash +gog sheets (sheet) chart (charts) get (show,info) <spreadsheetId> <chartId> +``` + +## Parent + +- [gog sheets chart](gog-sheets-chart.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 sheets chart](gog-sheets-chart.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-chart-list.md b/docs/commands/gog-sheets-chart-list.md new file mode 100644 index 0000000..35918fb --- /dev/null +++ b/docs/commands/gog-sheets-chart-list.md @@ -0,0 +1,42 @@ +# `gog sheets chart list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List charts in a spreadsheet + +## Usage + +```bash +gog sheets (sheet) chart (charts) list <spreadsheetId> +``` + +## Parent + +- [gog sheets chart](gog-sheets-chart.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 sheets chart](gog-sheets-chart.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-chart-update.md b/docs/commands/gog-sheets-chart-update.md new file mode 100644 index 0000000..97d6343 --- /dev/null +++ b/docs/commands/gog-sheets-chart-update.md @@ -0,0 +1,43 @@ +# `gog sheets chart update` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Update a chart spec + +## Usage + +```bash +gog sheets (sheet) chart (charts) update (edit,set) --spec-json=STRING <spreadsheetId> <chartId> +``` + +## Parent + +- [gog sheets chart](gog-sheets-chart.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. | +| `--spec-json` | `string` | | ChartSpec or EmbeddedChart JSON (inline or @file) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog sheets chart](gog-sheets-chart.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-chart.md b/docs/commands/gog-sheets-chart.md new file mode 100644 index 0000000..783c289 --- /dev/null +++ b/docs/commands/gog-sheets-chart.md @@ -0,0 +1,50 @@ +# `gog sheets chart` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Manage spreadsheet charts + +## Usage + +```bash +gog sheets (sheet) chart (charts) <command> +``` + +## Parent + +- [gog sheets](gog-sheets.md) + +## Subcommands + +- [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 + +## 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 sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-clear.md b/docs/commands/gog-sheets-clear.md new file mode 100644 index 0000000..5b9d44c --- /dev/null +++ b/docs/commands/gog-sheets-clear.md @@ -0,0 +1,42 @@ +# `gog sheets clear` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Clear values in a range + +## Usage + +```bash +gog sheets (sheet) clear <spreadsheetId> <range> +``` + +## Parent + +- [gog sheets](gog-sheets.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 sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-copy.md b/docs/commands/gog-sheets-copy.md new file mode 100644 index 0000000..6d5397a --- /dev/null +++ b/docs/commands/gog-sheets-copy.md @@ -0,0 +1,43 @@ +# `gog sheets copy` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Copy a Google Sheet + +## Usage + +```bash +gog sheets (sheet) copy (cp,duplicate) <spreadsheetId> <title> [flags] +``` + +## Parent + +- [gog sheets](gog-sheets.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` | `string` | | Destination folder ID | +| `-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 sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-create.md b/docs/commands/gog-sheets-create.md new file mode 100644 index 0000000..3a5186a --- /dev/null +++ b/docs/commands/gog-sheets-create.md @@ -0,0 +1,44 @@ +# `gog sheets create` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create a new spreadsheet + +## Usage + +```bash +gog sheets (sheet) create (new) <title> [flags] +``` + +## Parent + +- [gog sheets](gog-sheets.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` | `string` | | Destination folder ID | +| `-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. | +| `--sheets` | `string` | | Comma-separated sheet names to create | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-delete-tab.md b/docs/commands/gog-sheets-delete-tab.md new file mode 100644 index 0000000..be4d7da --- /dev/null +++ b/docs/commands/gog-sheets-delete-tab.md @@ -0,0 +1,42 @@ +# `gog sheets delete-tab` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete a tab/sheet from a spreadsheet (use --force to skip confirmation) + +## Usage + +```bash +gog sheets (sheet) delete-tab (delete-sheet) <spreadsheetId> <tabName> +``` + +## Parent + +- [gog sheets](gog-sheets.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 sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-export.md b/docs/commands/gog-sheets-export.md new file mode 100644 index 0000000..fb4a7b8 --- /dev/null +++ b/docs/commands/gog-sheets-export.md @@ -0,0 +1,44 @@ +# `gog sheets export` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Export a Google Sheet (pdf|xlsx|csv) via Drive + +## Usage + +```bash +gog sheets (sheet) export (download,dl) <spreadsheetId> [flags] +``` + +## Parent + +- [gog sheets](gog-sheets.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 | +| `--format` | `string` | xlsx | Export format: pdf\|xlsx\|csv | +| `--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 (default: gogcli config dir) | +| `-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 sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-find-replace.md b/docs/commands/gog-sheets-find-replace.md new file mode 100644 index 0000000..f6c6516 --- /dev/null +++ b/docs/commands/gog-sheets-find-replace.md @@ -0,0 +1,47 @@ +# `gog sheets find-replace` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Find and replace text across a spreadsheet + +## Usage + +```bash +gog sheets (sheet) find-replace <spreadsheetId> <find> <replace> [flags] +``` + +## Parent + +- [gog sheets](gog-sheets.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 | +| `--formulas` | `bool` | | Include formula cells in search | +| `--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) | +| `--match-case` | `bool` | | Case-sensitive matching | +| `--match-entire`<br>`--exact` | `bool` | | Match entire cell value | +| `--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) | +| `--regex` | `bool` | | Treat find text as a regex | +| `--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. | +| `--sheet` | `string` | | Sheet name to scope the operation | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-format.md b/docs/commands/gog-sheets-format.md new file mode 100644 index 0000000..a5c30c5 --- /dev/null +++ b/docs/commands/gog-sheets-format.md @@ -0,0 +1,44 @@ +# `gog sheets format` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Apply cell formatting to a range + +## Usage + +```bash +gog sheets (sheet) format <spreadsheetId> <range> [flags] +``` + +## Parent + +- [gog sheets](gog-sheets.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 | +| `--format-fields` | `string` | | Format field mask (eg. userEnteredFormat.textFormat.bold or textFormat.bold) | +| `--format-json` | `string` | | Cell format as JSON (Sheets API CellFormat) | +| `--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 sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-freeze.md b/docs/commands/gog-sheets-freeze.md new file mode 100644 index 0000000..b26b8bb --- /dev/null +++ b/docs/commands/gog-sheets-freeze.md @@ -0,0 +1,45 @@ +# `gog sheets freeze` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Freeze rows and columns on a sheet + +## Usage + +```bash +gog sheets (sheet) freeze <spreadsheetId> [flags] +``` + +## Parent + +- [gog sheets](gog-sheets.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 | +| `--cols` | `int64` | -1 | Number of columns to freeze (0 to unfreeze) | +| `--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) | +| `--rows` | `int64` | -1 | Number of rows to freeze (0 to unfreeze) | +| `--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. | +| `--sheet` | `string` | | Sheet name (defaults to the first sheet) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-get.md b/docs/commands/gog-sheets-get.md new file mode 100644 index 0000000..d7af278 --- /dev/null +++ b/docs/commands/gog-sheets-get.md @@ -0,0 +1,44 @@ +# `gog sheets get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get values from a range + +## Usage + +```bash +gog sheets (sheet) get (read,show) <spreadsheetId> <range> [flags] +``` + +## Parent + +- [gog sheets](gog-sheets.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 | +| `--dimension` | `string` | | Major dimension: ROWS or COLUMNS | +| `--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) | +| `--render` | `string` | | Value render option: FORMATTED_VALUE, UNFORMATTED_VALUE, or FORMULA | +| `--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 sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-insert.md b/docs/commands/gog-sheets-insert.md new file mode 100644 index 0000000..c003d15 --- /dev/null +++ b/docs/commands/gog-sheets-insert.md @@ -0,0 +1,44 @@ +# `gog sheets insert` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Insert empty rows or columns into a sheet + +## Usage + +```bash +gog sheets (sheet) insert <spreadsheetId> <sheet> <dimension> <start> [flags] +``` + +## Parent + +- [gog sheets](gog-sheets.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) | +| `--after` | `bool` | | Insert after the position instead of before | +| `--client` | `string` | | OAuth client name (selects stored credentials + token bucket) | +| `--color` | `string` | auto | Color output: auto\|always\|never | +| `--count` | `int64` | 1 | Number of rows/columns to insert | +| `--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 sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-links.md b/docs/commands/gog-sheets-links.md new file mode 100644 index 0000000..826deb6 --- /dev/null +++ b/docs/commands/gog-sheets-links.md @@ -0,0 +1,42 @@ +# `gog sheets links` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get cell hyperlinks from a range + +## Usage + +```bash +gog sheets (sheet) links (hyperlinks) <spreadsheetId> <range> +``` + +## Parent + +- [gog sheets](gog-sheets.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 sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-merge.md b/docs/commands/gog-sheets-merge.md new file mode 100644 index 0000000..763f51a --- /dev/null +++ b/docs/commands/gog-sheets-merge.md @@ -0,0 +1,43 @@ +# `gog sheets merge` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Merge cells in a range + +## Usage + +```bash +gog sheets (sheet) merge <spreadsheetId> <range> [flags] +``` + +## Parent + +- [gog sheets](gog-sheets.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. | +| `--type` | `string` | MERGE_ALL | Merge type: MERGE_ALL, MERGE_COLUMNS, MERGE_ROWS | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-metadata.md b/docs/commands/gog-sheets-metadata.md new file mode 100644 index 0000000..ff00b78 --- /dev/null +++ b/docs/commands/gog-sheets-metadata.md @@ -0,0 +1,42 @@ +# `gog sheets metadata` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get spreadsheet metadata + +## Usage + +```bash +gog sheets (sheet) metadata (info) <spreadsheetId> +``` + +## Parent + +- [gog sheets](gog-sheets.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 sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-named-ranges-add.md b/docs/commands/gog-sheets-named-ranges-add.md new file mode 100644 index 0000000..f262435 --- /dev/null +++ b/docs/commands/gog-sheets-named-ranges-add.md @@ -0,0 +1,42 @@ +# `gog sheets named-ranges add` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Add a named range + +## Usage + +```bash +gog sheets (sheet) named-ranges (namedranges,nr) add (create,new) <spreadsheetId> <name> <range> +``` + +## Parent + +- [gog sheets named-ranges](gog-sheets-named-ranges.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 sheets named-ranges](gog-sheets-named-ranges.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-named-ranges-delete.md b/docs/commands/gog-sheets-named-ranges-delete.md new file mode 100644 index 0000000..64275af --- /dev/null +++ b/docs/commands/gog-sheets-named-ranges-delete.md @@ -0,0 +1,42 @@ +# `gog sheets named-ranges delete` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete a named range + +## Usage + +```bash +gog sheets (sheet) named-ranges (namedranges,nr) delete (rm,remove,del) <spreadsheetId> <nameOrId> +``` + +## Parent + +- [gog sheets named-ranges](gog-sheets-named-ranges.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 sheets named-ranges](gog-sheets-named-ranges.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-named-ranges-get.md b/docs/commands/gog-sheets-named-ranges-get.md new file mode 100644 index 0000000..b2bacd2 --- /dev/null +++ b/docs/commands/gog-sheets-named-ranges-get.md @@ -0,0 +1,42 @@ +# `gog sheets named-ranges get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get a named range + +## Usage + +```bash +gog sheets (sheet) named-ranges (namedranges,nr) get (show,info) <spreadsheetId> <nameOrId> +``` + +## Parent + +- [gog sheets named-ranges](gog-sheets-named-ranges.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 sheets named-ranges](gog-sheets-named-ranges.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-named-ranges-list.md b/docs/commands/gog-sheets-named-ranges-list.md new file mode 100644 index 0000000..eab54b0 --- /dev/null +++ b/docs/commands/gog-sheets-named-ranges-list.md @@ -0,0 +1,42 @@ +# `gog sheets named-ranges list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List named ranges + +## Usage + +```bash +gog sheets (sheet) named-ranges (namedranges,nr) list <spreadsheetId> +``` + +## Parent + +- [gog sheets named-ranges](gog-sheets-named-ranges.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 sheets named-ranges](gog-sheets-named-ranges.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-named-ranges-update.md b/docs/commands/gog-sheets-named-ranges-update.md new file mode 100644 index 0000000..2b2b1a5 --- /dev/null +++ b/docs/commands/gog-sheets-named-ranges-update.md @@ -0,0 +1,44 @@ +# `gog sheets named-ranges update` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Update a named range + +## Usage + +```bash +gog sheets (sheet) named-ranges (namedranges,nr) update (edit,set) <spreadsheetId> <nameOrId> [flags] +``` + +## Parent + +- [gog sheets named-ranges](gog-sheets-named-ranges.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) | +| `--name` | `string` | | New name | +| `--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) | +| `--range` | `string` | | New A1 range (must include sheet name; e.g. Sheet1!A1:B2 or Sheet1!A:C) | +| `--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 sheets named-ranges](gog-sheets-named-ranges.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-named-ranges.md b/docs/commands/gog-sheets-named-ranges.md new file mode 100644 index 0000000..a61dc70 --- /dev/null +++ b/docs/commands/gog-sheets-named-ranges.md @@ -0,0 +1,50 @@ +# `gog sheets named-ranges` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Manage named ranges + +## Usage + +```bash +gog sheets (sheet) named-ranges (namedranges,nr) <command> +``` + +## Parent + +- [gog sheets](gog-sheets.md) + +## Subcommands + +- [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 + +## 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 sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-notes.md b/docs/commands/gog-sheets-notes.md new file mode 100644 index 0000000..3adcfeb --- /dev/null +++ b/docs/commands/gog-sheets-notes.md @@ -0,0 +1,42 @@ +# `gog sheets notes` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get cell notes from a range + +## Usage + +```bash +gog sheets (sheet) notes <spreadsheetId> <range> +``` + +## Parent + +- [gog sheets](gog-sheets.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 sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-number-format.md b/docs/commands/gog-sheets-number-format.md new file mode 100644 index 0000000..a83a2e2 --- /dev/null +++ b/docs/commands/gog-sheets-number-format.md @@ -0,0 +1,44 @@ +# `gog sheets number-format` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Apply number format to a range + +## Usage + +```bash +gog sheets (sheet) number-format <spreadsheetId> <range> [flags] +``` + +## Parent + +- [gog sheets](gog-sheets.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) | +| `--pattern` | `string` | | Custom number format pattern (eg. $#,##0.00 or yyyy-mm-dd) | +| `-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. | +| `--type` | `string` | NUMBER | Number format type: NUMBER, CURRENCY, PERCENT, DATE, TIME, DATE_TIME, SCIENTIFIC, TEXT | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-read-format.md b/docs/commands/gog-sheets-read-format.md new file mode 100644 index 0000000..9815f29 --- /dev/null +++ b/docs/commands/gog-sheets-read-format.md @@ -0,0 +1,43 @@ +# `gog sheets read-format` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Read cell formatting from a range + +## Usage + +```bash +gog sheets (sheet) read-format (get-format,format-read) <spreadsheetId> <range> [flags] +``` + +## Parent + +- [gog sheets](gog-sheets.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 | +| `--effective` | `bool` | | Read effective format instead of user-entered format | +| `--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 sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-rename-tab.md b/docs/commands/gog-sheets-rename-tab.md new file mode 100644 index 0000000..7147a9b --- /dev/null +++ b/docs/commands/gog-sheets-rename-tab.md @@ -0,0 +1,42 @@ +# `gog sheets rename-tab` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Rename a tab/sheet in a spreadsheet + +## Usage + +```bash +gog sheets (sheet) rename-tab (rename-sheet) <spreadsheetId> <oldName> <newName> +``` + +## Parent + +- [gog sheets](gog-sheets.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 sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-resize-columns.md b/docs/commands/gog-sheets-resize-columns.md new file mode 100644 index 0000000..fa41b4f --- /dev/null +++ b/docs/commands/gog-sheets-resize-columns.md @@ -0,0 +1,44 @@ +# `gog sheets resize-columns` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Resize sheet columns + +## Usage + +```bash +gog sheets (sheet) resize-columns <spreadsheetId> <columns> [flags] +``` + +## Parent + +- [gog sheets](gog-sheets.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` | `bool` | | Auto-fit columns to content | +| `--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 | +| `--width` | `int64` | | Column width in pixels | + +## See Also + +- [gog sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-resize-rows.md b/docs/commands/gog-sheets-resize-rows.md new file mode 100644 index 0000000..c9f760a --- /dev/null +++ b/docs/commands/gog-sheets-resize-rows.md @@ -0,0 +1,44 @@ +# `gog sheets resize-rows` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Resize sheet rows + +## Usage + +```bash +gog sheets (sheet) resize-rows <spreadsheetId> <rows> [flags] +``` + +## Parent + +- [gog sheets](gog-sheets.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` | `bool` | | Auto-fit rows to content | +| `--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) | +| `--height` | `int64` | | Row height in pixels | +| `-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 sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-unmerge.md b/docs/commands/gog-sheets-unmerge.md new file mode 100644 index 0000000..3a9a379 --- /dev/null +++ b/docs/commands/gog-sheets-unmerge.md @@ -0,0 +1,42 @@ +# `gog sheets unmerge` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Unmerge cells in a range + +## Usage + +```bash +gog sheets (sheet) unmerge <spreadsheetId> <range> +``` + +## Parent + +- [gog sheets](gog-sheets.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 sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-update-note.md b/docs/commands/gog-sheets-update-note.md new file mode 100644 index 0000000..e16c89a --- /dev/null +++ b/docs/commands/gog-sheets-update-note.md @@ -0,0 +1,44 @@ +# `gog sheets update-note` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Set or clear a cell note + +## Usage + +```bash +gog sheets (sheet) update-note (set-note) <spreadsheetId> <range> [flags] +``` + +## Parent + +- [gog sheets](gog-sheets.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) | +| `--note` | `*string` | | Note text to set (use --note '' to clear notes) | +| `--note-file` | `string` | | Path to file containing note text | +| `-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 sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets-update.md b/docs/commands/gog-sheets-update.md new file mode 100644 index 0000000..da5420e --- /dev/null +++ b/docs/commands/gog-sheets-update.md @@ -0,0 +1,45 @@ +# `gog sheets update` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Update values in a range + +## Usage + +```bash +gog sheets (sheet) update (edit,set) <spreadsheetId> <range> [<values> ...] [flags] +``` + +## Parent + +- [gog sheets](gog-sheets.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 | +| `--copy-validation-from` | `string` | | Copy data validation from an A1 range or named range (e.g. 'Sheet1!A2:D2' or MyNamedRange) to the updated cells | +| `--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. | +| `--input` | `string` | USER_ENTERED | Value input option: RAW or USER_ENTERED | +| `-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. | +| `--values-json` | `string` | | Values as JSON 2D array | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog sheets](gog-sheets.md) +- [Command index](README.md) diff --git a/docs/commands/gog-sheets.md b/docs/commands/gog-sheets.md new file mode 100644 index 0000000..5a1411f --- /dev/null +++ b/docs/commands/gog-sheets.md @@ -0,0 +1,71 @@ +# `gog sheets` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Google Sheets + +## Usage + +```bash +gog sheets (sheet) <command> [flags] +``` + +## Parent + +- [gog](gog.md) + +## Subcommands + +- [gog sheets add-tab](gog-sheets-add-tab.md) - Add a new tab/sheet to a spreadsheet +- [gog sheets append](gog-sheets-append.md) - Append values to a range +- [gog sheets chart](gog-sheets-chart.md) - Manage spreadsheet charts +- [gog sheets clear](gog-sheets-clear.md) - Clear values in a range +- [gog sheets copy](gog-sheets-copy.md) - Copy a Google Sheet +- [gog sheets create](gog-sheets-create.md) - Create a new spreadsheet +- [gog sheets delete-tab](gog-sheets-delete-tab.md) - Delete a tab/sheet from a spreadsheet (use --force to skip confirmation) +- [gog sheets export](gog-sheets-export.md) - Export a Google Sheet (pdf|xlsx|csv) via Drive +- [gog sheets find-replace](gog-sheets-find-replace.md) - Find and replace text across a spreadsheet +- [gog sheets format](gog-sheets-format.md) - Apply cell formatting to a range +- [gog sheets freeze](gog-sheets-freeze.md) - Freeze rows and columns on a sheet +- [gog sheets get](gog-sheets-get.md) - Get values from a range +- [gog sheets insert](gog-sheets-insert.md) - Insert empty rows or columns into a sheet +- [gog sheets links](gog-sheets-links.md) - Get cell hyperlinks from a range +- [gog sheets merge](gog-sheets-merge.md) - Merge cells in a range +- [gog sheets metadata](gog-sheets-metadata.md) - Get spreadsheet metadata +- [gog sheets named-ranges](gog-sheets-named-ranges.md) - Manage named ranges +- [gog sheets notes](gog-sheets-notes.md) - Get cell notes from a range +- [gog sheets number-format](gog-sheets-number-format.md) - Apply number format to a range +- [gog sheets read-format](gog-sheets-read-format.md) - Read cell formatting from a range +- [gog sheets rename-tab](gog-sheets-rename-tab.md) - Rename a tab/sheet in a spreadsheet +- [gog sheets resize-columns](gog-sheets-resize-columns.md) - Resize sheet columns +- [gog sheets resize-rows](gog-sheets-resize-rows.md) - Resize sheet rows +- [gog sheets unmerge](gog-sheets-unmerge.md) - Unmerge cells in a range +- [gog sheets update](gog-sheets-update.md) - Update values in a range +- [gog sheets update-note](gog-sheets-update-note.md) - Set or clear a cell note + +## 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) diff --git a/docs/commands/gog-slides-add-slide.md b/docs/commands/gog-slides-add-slide.md new file mode 100644 index 0000000..1b677ee --- /dev/null +++ b/docs/commands/gog-slides-add-slide.md @@ -0,0 +1,45 @@ +# `gog slides add-slide` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Add a slide with a full-bleed image and optional speaker notes + +## Usage + +```bash +gog slides (slide) add-slide <presentationId> <image> [flags] +``` + +## Parent + +- [gog slides](gog-slides.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) | +| `--before` | `string` | | Insert before this slide ID (appends to end if omitted) | +| `--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) | +| `--notes` | `string` | | Speaker notes text | +| `--notes-file` | `string` | | Path to file containing speaker notes | +| `-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 slides](gog-slides.md) +- [Command index](README.md) diff --git a/docs/commands/gog-slides-copy.md b/docs/commands/gog-slides-copy.md new file mode 100644 index 0000000..0a67f6a --- /dev/null +++ b/docs/commands/gog-slides-copy.md @@ -0,0 +1,43 @@ +# `gog slides copy` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Copy a Google Slides presentation + +## Usage + +```bash +gog slides (slide) copy (cp,duplicate) <presentationId> <title> [flags] +``` + +## Parent + +- [gog slides](gog-slides.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` | `string` | | Destination folder ID | +| `-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 slides](gog-slides.md) +- [Command index](README.md) diff --git a/docs/commands/gog-slides-create-from-markdown.md b/docs/commands/gog-slides-create-from-markdown.md new file mode 100644 index 0000000..486fb85 --- /dev/null +++ b/docs/commands/gog-slides-create-from-markdown.md @@ -0,0 +1,46 @@ +# `gog slides create-from-markdown` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create a Google Slides presentation from markdown + +## Usage + +```bash +gog slides (slide) create-from-markdown <title> [flags] +``` + +## Parent + +- [gog slides](gog-slides.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 | +| `--content` | `string` | | Markdown content (inline) | +| `--content-file` | `string` | | Read markdown content from file | +| `--debug` | `bool` | | Show debug output | +| `--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` | `string` | | Destination folder ID | +| `-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 slides](gog-slides.md) +- [Command index](README.md) diff --git a/docs/commands/gog-slides-create-from-template.md b/docs/commands/gog-slides-create-from-template.md new file mode 100644 index 0000000..9a72a70 --- /dev/null +++ b/docs/commands/gog-slides-create-from-template.md @@ -0,0 +1,46 @@ +# `gog slides create-from-template` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create a presentation from template with text replacements + +## Usage + +```bash +gog slides (slide) create-from-template <templateId> <title> [flags] +``` + +## Parent + +- [gog slides](gog-slides.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) | +| `--exact` | `bool` | | Use exact string matching instead of {{key}} placeholders | +| `-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` | `string` | | Destination folder ID | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--replace` | `[]string` | | Text replacement in format 'key=value' (repeatable) | +| `--replacements` | `string` | | JSON file containing replacements | +| `--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 slides](gog-slides.md) +- [Command index](README.md) diff --git a/docs/commands/gog-slides-create.md b/docs/commands/gog-slides-create.md new file mode 100644 index 0000000..f6443d0 --- /dev/null +++ b/docs/commands/gog-slides-create.md @@ -0,0 +1,44 @@ +# `gog slides create` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create a Google Slides presentation + +## Usage + +```bash +gog slides (slide) create (add,new) <title> [flags] +``` + +## Parent + +- [gog slides](gog-slides.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` | `string` | | Destination folder ID | +| `-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. | +| `--template` | `string` | | Template presentation ID to copy from | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog slides](gog-slides.md) +- [Command index](README.md) diff --git a/docs/commands/gog-slides-delete-slide.md b/docs/commands/gog-slides-delete-slide.md new file mode 100644 index 0000000..2332d63 --- /dev/null +++ b/docs/commands/gog-slides-delete-slide.md @@ -0,0 +1,42 @@ +# `gog slides delete-slide` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete a slide by object ID + +## Usage + +```bash +gog slides (slide) delete-slide <presentationId> <slideId> +``` + +## Parent + +- [gog slides](gog-slides.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 slides](gog-slides.md) +- [Command index](README.md) diff --git a/docs/commands/gog-slides-export.md b/docs/commands/gog-slides-export.md new file mode 100644 index 0000000..acb7e63 --- /dev/null +++ b/docs/commands/gog-slides-export.md @@ -0,0 +1,44 @@ +# `gog slides export` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Export a Google Slides deck (pdf|pptx) + +## Usage + +```bash +gog slides (slide) export (download,dl) <presentationId> [flags] +``` + +## Parent + +- [gog slides](gog-slides.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 | +| `--format` | `string` | pptx | Export format: pdf\|pptx | +| `--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 (default: gogcli config dir) | +| `-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 slides](gog-slides.md) +- [Command index](README.md) diff --git a/docs/commands/gog-slides-info.md b/docs/commands/gog-slides-info.md new file mode 100644 index 0000000..f87de9c --- /dev/null +++ b/docs/commands/gog-slides-info.md @@ -0,0 +1,42 @@ +# `gog slides info` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get Google Slides presentation metadata + +## Usage + +```bash +gog slides (slide) info (get,show) <presentationId> +``` + +## Parent + +- [gog slides](gog-slides.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 slides](gog-slides.md) +- [Command index](README.md) diff --git a/docs/commands/gog-slides-insert-text.md b/docs/commands/gog-slides-insert-text.md new file mode 100644 index 0000000..4bb6788 --- /dev/null +++ b/docs/commands/gog-slides-insert-text.md @@ -0,0 +1,44 @@ +# `gog slides insert-text` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Insert text into an existing page element (shape or table) by objectId + +## Usage + +```bash +gog slides (slide) insert-text <presentationId> <objectId> <text> [flags] +``` + +## Parent + +- [gog slides](gog-slides.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. | +| `--insertion-index` | `int64` | 0 | Zero-based index where text is inserted within the element's existing text | +| `-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) | +| `--replace` | `bool` | | Clear existing text in the element before inserting (emits DeleteText + InsertText in the same batch) | +| `--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 slides](gog-slides.md) +- [Command index](README.md) diff --git a/docs/commands/gog-slides-list-slides.md b/docs/commands/gog-slides-list-slides.md new file mode 100644 index 0000000..4e72002 --- /dev/null +++ b/docs/commands/gog-slides-list-slides.md @@ -0,0 +1,42 @@ +# `gog slides list-slides` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List all slides with their object IDs + +## Usage + +```bash +gog slides (slide) list-slides <presentationId> +``` + +## Parent + +- [gog slides](gog-slides.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 slides](gog-slides.md) +- [Command index](README.md) diff --git a/docs/commands/gog-slides-read-slide.md b/docs/commands/gog-slides-read-slide.md new file mode 100644 index 0000000..9081fa1 --- /dev/null +++ b/docs/commands/gog-slides-read-slide.md @@ -0,0 +1,42 @@ +# `gog slides read-slide` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Read slide content: speaker notes, text elements, and images + +## Usage + +```bash +gog slides (slide) read-slide <presentationId> <slideId> +``` + +## Parent + +- [gog slides](gog-slides.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 slides](gog-slides.md) +- [Command index](README.md) diff --git a/docs/commands/gog-slides-replace-slide.md b/docs/commands/gog-slides-replace-slide.md new file mode 100644 index 0000000..da49480 --- /dev/null +++ b/docs/commands/gog-slides-replace-slide.md @@ -0,0 +1,44 @@ +# `gog slides replace-slide` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Replace the image on an existing slide in-place + +## Usage + +```bash +gog slides (slide) replace-slide <presentationId> <slideId> <image> [flags] +``` + +## Parent + +- [gog slides](gog-slides.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) | +| `--notes` | `*string` | | New speaker notes text (omit to preserve existing notes; use --notes '' to clear) | +| `--notes-file` | `string` | | Path to file containing new speaker notes | +| `-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 slides](gog-slides.md) +- [Command index](README.md) diff --git a/docs/commands/gog-slides-replace-text.md b/docs/commands/gog-slides-replace-text.md new file mode 100644 index 0000000..3dc048f --- /dev/null +++ b/docs/commands/gog-slides-replace-text.md @@ -0,0 +1,44 @@ +# `gog slides replace-text` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Find-and-replace text across a presentation + +## Usage + +```bash +gog slides (slide) replace-text <presentationId> <find> <replacement> [flags] +``` + +## Parent + +- [gog slides](gog-slides.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) | +| `--match-case` | `bool` | | Case-sensitive match (default: false) | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--page` | `[]string` | | Restrict replacement to specific slide object IDs (repeatable) | +| `-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 slides](gog-slides.md) +- [Command index](README.md) diff --git a/docs/commands/gog-slides-thumbnail.md b/docs/commands/gog-slides-thumbnail.md new file mode 100644 index 0000000..9c2da4a --- /dev/null +++ b/docs/commands/gog-slides-thumbnail.md @@ -0,0 +1,45 @@ +# `gog slides thumbnail` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get or download a rendered thumbnail for a slide + +## Usage + +```bash +gog slides (slide) thumbnail (thumb) <presentationId> <slideId> [flags] +``` + +## Parent + +- [gog slides](gog-slides.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 | +| `--format` | `string` | png | Thumbnail format: png\|jpeg | +| `--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` | | Write the thumbnail image to a local file | +| `-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. | +| `--size` | `string` | large | Thumbnail size: small\|medium\|large | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog slides](gog-slides.md) +- [Command index](README.md) diff --git a/docs/commands/gog-slides-update-notes.md b/docs/commands/gog-slides-update-notes.md new file mode 100644 index 0000000..bc64906 --- /dev/null +++ b/docs/commands/gog-slides-update-notes.md @@ -0,0 +1,44 @@ +# `gog slides update-notes` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Update speaker notes on an existing slide + +## Usage + +```bash +gog slides (slide) update-notes <presentationId> <slideId> [flags] +``` + +## Parent + +- [gog slides](gog-slides.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) | +| `--notes` | `*string` | | Speaker notes text (use --notes '' to clear notes) | +| `--notes-file` | `string` | | Path to file containing speaker notes | +| `-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 slides](gog-slides.md) +- [Command index](README.md) diff --git a/docs/commands/gog-slides.md b/docs/commands/gog-slides.md new file mode 100644 index 0000000..a7971ee --- /dev/null +++ b/docs/commands/gog-slides.md @@ -0,0 +1,60 @@ +# `gog slides` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Google Slides + +## Usage + +```bash +gog slides (slide) <command> [flags] +``` + +## Parent + +- [gog](gog.md) + +## Subcommands + +- [gog slides add-slide](gog-slides-add-slide.md) - Add a slide with a full-bleed image and optional speaker notes +- [gog slides copy](gog-slides-copy.md) - Copy a Google Slides presentation +- [gog slides create](gog-slides-create.md) - Create a Google Slides presentation +- [gog slides create-from-markdown](gog-slides-create-from-markdown.md) - Create a Google Slides presentation from markdown +- [gog slides create-from-template](gog-slides-create-from-template.md) - Create a presentation from template with text replacements +- [gog slides delete-slide](gog-slides-delete-slide.md) - Delete a slide by object ID +- [gog slides export](gog-slides-export.md) - Export a Google Slides deck (pdf|pptx) +- [gog slides info](gog-slides-info.md) - Get Google Slides presentation metadata +- [gog slides insert-text](gog-slides-insert-text.md) - Insert text into an existing page element (shape or table) by objectId +- [gog slides list-slides](gog-slides-list-slides.md) - List all slides with their object IDs +- [gog slides read-slide](gog-slides-read-slide.md) - Read slide content: speaker notes, text elements, and images +- [gog slides replace-slide](gog-slides-replace-slide.md) - Replace the image on an existing slide in-place +- [gog slides replace-text](gog-slides-replace-text.md) - Find-and-replace text across a presentation +- [gog slides thumbnail](gog-slides-thumbnail.md) - Get or download a rendered thumbnail for a slide +- [gog slides update-notes](gog-slides-update-notes.md) - Update speaker notes on an existing slide + +## 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) diff --git a/docs/commands/gog-status.md b/docs/commands/gog-status.md new file mode 100644 index 0000000..395d342 --- /dev/null +++ b/docs/commands/gog-status.md @@ -0,0 +1,42 @@ +# `gog status` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Show auth/config status (alias for 'auth status') + +## Usage + +```bash +gog status (st) [flags] +``` + +## Parent + +- [gog](gog.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](gog.md) +- [Command index](README.md) diff --git a/docs/commands/gog-tasks-add.md b/docs/commands/gog-tasks-add.md new file mode 100644 index 0000000..3bdbe9b --- /dev/null +++ b/docs/commands/gog-tasks-add.md @@ -0,0 +1,52 @@ +# `gog tasks add` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Add a task + +## Usage + +```bash +gog tasks (task) add (create) <tasklistId> [flags] +``` + +## Parent + +- [gog tasks](gog-tasks.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 | +| `--due` | `string` | | Due date (RFC3339 or YYYY-MM-DD; time may be ignored by Google Tasks) | +| `--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) | +| `--notes` | `string` | | Task notes/description | +| `--parent` | `string` | | Parent task ID (create as subtask) | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--previous` | `string` | | Previous sibling task ID (controls ordering) | +| `--recur` | `string` | | Alias for --repeat cadence: daily, weekly, monthly, yearly | +| `--recur-rrule` | `string` | | Alias for --repeat cadence via RRULE (supports FREQ + optional INTERVAL) | +| `--repeat` | `string` | | Materialize repeated tasks: daily, weekly, monthly, yearly | +| `--repeat-count` | `int` | | Number of occurrences to create (requires --repeat, --recur, or --recur-rrule) | +| `--repeat-until` | `string` | | Repeat until date/time (RFC3339 or YYYY-MM-DD; requires --repeat, --recur, or --recur-rrule) | +| `--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` | | Task title (required) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog tasks](gog-tasks.md) +- [Command index](README.md) diff --git a/docs/commands/gog-tasks-clear.md b/docs/commands/gog-tasks-clear.md new file mode 100644 index 0000000..ec4025d --- /dev/null +++ b/docs/commands/gog-tasks-clear.md @@ -0,0 +1,42 @@ +# `gog tasks clear` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Clear completed tasks + +## Usage + +```bash +gog tasks (task) clear <tasklistId> +``` + +## Parent + +- [gog tasks](gog-tasks.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 tasks](gog-tasks.md) +- [Command index](README.md) diff --git a/docs/commands/gog-tasks-delete.md b/docs/commands/gog-tasks-delete.md new file mode 100644 index 0000000..957e124 --- /dev/null +++ b/docs/commands/gog-tasks-delete.md @@ -0,0 +1,42 @@ +# `gog tasks delete` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Delete a task + +## Usage + +```bash +gog tasks (task) delete (rm,del,remove) <tasklistId> <taskId> +``` + +## Parent + +- [gog tasks](gog-tasks.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 tasks](gog-tasks.md) +- [Command index](README.md) diff --git a/docs/commands/gog-tasks-done.md b/docs/commands/gog-tasks-done.md new file mode 100644 index 0000000..6275f0b --- /dev/null +++ b/docs/commands/gog-tasks-done.md @@ -0,0 +1,42 @@ +# `gog tasks done` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Mark task completed + +## Usage + +```bash +gog tasks (task) done (complete) <tasklistId> <taskId> +``` + +## Parent + +- [gog tasks](gog-tasks.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 tasks](gog-tasks.md) +- [Command index](README.md) diff --git a/docs/commands/gog-tasks-get.md b/docs/commands/gog-tasks-get.md new file mode 100644 index 0000000..2031686 --- /dev/null +++ b/docs/commands/gog-tasks-get.md @@ -0,0 +1,42 @@ +# `gog tasks get` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Get a task + +## Usage + +```bash +gog tasks (task) get (info,show) <tasklistId> <taskId> +``` + +## Parent + +- [gog tasks](gog-tasks.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 tasks](gog-tasks.md) +- [Command index](README.md) diff --git a/docs/commands/gog-tasks-list.md b/docs/commands/gog-tasks-list.md new file mode 100644 index 0000000..9a1eca5 --- /dev/null +++ b/docs/commands/gog-tasks-list.md @@ -0,0 +1,55 @@ +# `gog tasks list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List tasks + +## Usage + +```bash +gog tasks (task) list (ls) <tasklistId> [flags] +``` + +## Parent + +- [gog tasks](gog-tasks.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 | +| `--completed-max` | `string` | | Upper bound for completion date filter (RFC3339) | +| `--completed-min` | `string` | | Lower bound for completion date filter (RFC3339) | +| `--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 | +| `--due-max` | `string` | | Upper bound for due date filter (RFC3339) | +| `--due-min` | `string` | | Lower bound for due date filter (RFC3339) | +| `--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` | 20 | Max results (max allowed: 100) | +| `--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. | +| `--show-assigned` | `bool` | true | Include tasks assigned to current user | +| `--show-completed` | `bool` | true | Include completed tasks (requires --show-hidden for some clients) | +| `--show-deleted` | `bool` | | Include deleted tasks | +| `--show-hidden` | `bool` | | Include hidden tasks | +| `--updated-min` | `string` | | Lower bound for updated time filter (RFC3339) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog tasks](gog-tasks.md) +- [Command index](README.md) diff --git a/docs/commands/gog-tasks-lists-create.md b/docs/commands/gog-tasks-lists-create.md new file mode 100644 index 0000000..3b0d1db --- /dev/null +++ b/docs/commands/gog-tasks-lists-create.md @@ -0,0 +1,42 @@ +# `gog tasks lists create` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Create a task list + +## Usage + +```bash +gog tasks (task) lists create (add,new) <title> ... +``` + +## Parent + +- [gog tasks lists](gog-tasks-lists.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 tasks lists](gog-tasks-lists.md) +- [Command index](README.md) diff --git a/docs/commands/gog-tasks-lists-list.md b/docs/commands/gog-tasks-lists-list.md new file mode 100644 index 0000000..bc63b44 --- /dev/null +++ b/docs/commands/gog-tasks-lists-list.md @@ -0,0 +1,46 @@ +# `gog tasks lists list` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List task lists + +## Usage + +```bash +gog tasks (task) lists list [flags] +``` + +## Parent + +- [gog tasks lists](gog-tasks-lists.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 (max allowed: 1000) | +| `--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 tasks lists](gog-tasks-lists.md) +- [Command index](README.md) diff --git a/docs/commands/gog-tasks-lists.md b/docs/commands/gog-tasks-lists.md new file mode 100644 index 0000000..e3cd62e --- /dev/null +++ b/docs/commands/gog-tasks-lists.md @@ -0,0 +1,47 @@ +# `gog tasks lists` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +List task lists + +## Usage + +```bash +gog tasks (task) lists <command> +``` + +## Parent + +- [gog tasks](gog-tasks.md) + +## Subcommands + +- [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 + +## 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 tasks](gog-tasks.md) +- [Command index](README.md) diff --git a/docs/commands/gog-tasks-undo.md b/docs/commands/gog-tasks-undo.md new file mode 100644 index 0000000..b7ea031 --- /dev/null +++ b/docs/commands/gog-tasks-undo.md @@ -0,0 +1,42 @@ +# `gog tasks undo` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Mark task needs action + +## Usage + +```bash +gog tasks (task) undo (uncomplete,undone) <tasklistId> <taskId> +``` + +## Parent + +- [gog tasks](gog-tasks.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 tasks](gog-tasks.md) +- [Command index](README.md) diff --git a/docs/commands/gog-tasks-update.md b/docs/commands/gog-tasks-update.md new file mode 100644 index 0000000..922aea4 --- /dev/null +++ b/docs/commands/gog-tasks-update.md @@ -0,0 +1,46 @@ +# `gog tasks update` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Update a task + +## Usage + +```bash +gog tasks (task) update (edit,set) <tasklistId> <taskId> [flags] +``` + +## Parent + +- [gog tasks](gog-tasks.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 | +| `--due` | `string` | | New due date (RFC3339 or YYYY-MM-DD; time may be ignored; set empty to clear) | +| `--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) | +| `--notes` | `string` | | New notes (set empty to clear) | +| `-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` | | New status: needsAction\|completed (set empty to clear) | +| `--title` | `string` | | New title (set empty to clear) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog tasks](gog-tasks.md) +- [Command index](README.md) diff --git a/docs/commands/gog-tasks.md b/docs/commands/gog-tasks.md new file mode 100644 index 0000000..9c78b3f --- /dev/null +++ b/docs/commands/gog-tasks.md @@ -0,0 +1,54 @@ +# `gog tasks` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Google Tasks + +## Usage + +```bash +gog tasks (task) <command> [flags] +``` + +## Parent + +- [gog](gog.md) + +## Subcommands + +- [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 undo](gog-tasks-undo.md) - Mark task needs action +- [gog tasks update](gog-tasks-update.md) - Update a task + +## 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) diff --git a/docs/commands/gog-time-now.md b/docs/commands/gog-time-now.md new file mode 100644 index 0000000..30a9a67 --- /dev/null +++ b/docs/commands/gog-time-now.md @@ -0,0 +1,43 @@ +# `gog time now` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Show current time + +## Usage + +```bash +gog time now [flags] +``` + +## Parent + +- [gog time](gog-time.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. | +| `--timezone` | `string` | | Timezone (e.g., America/New_York, UTC) | +| `-v`<br>`--verbose` | `bool` | | Enable verbose logging | +| `--version` | `kong.VersionFlag` | | Print version and exit | + +## See Also + +- [gog time](gog-time.md) +- [Command index](README.md) diff --git a/docs/commands/gog-time.md b/docs/commands/gog-time.md new file mode 100644 index 0000000..9762aaf --- /dev/null +++ b/docs/commands/gog-time.md @@ -0,0 +1,46 @@ +# `gog time` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Local time utilities + +## Usage + +```bash +gog time <command> [flags] +``` + +## Parent + +- [gog](gog.md) + +## Subcommands + +- [gog time now](gog-time-now.md) - Show current time + +## 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) diff --git a/docs/commands/gog-upload.md b/docs/commands/gog-upload.md new file mode 100644 index 0000000..15f7242 --- /dev/null +++ b/docs/commands/gog-upload.md @@ -0,0 +1,50 @@ +# `gog upload` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Upload a file to Drive (alias for 'drive upload') + +## Usage + +```bash +gog upload (up,put) <localPath> [flags] +``` + +## Parent + +- [gog](gog.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 | +| `--convert` | `bool` | | Auto-convert to native Google format based on file extension (create only) | +| `--convert-to` | `string` | | Convert to a specific Google format: doc\|sheet\|slides (create only) | +| `--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) | +| `--keep-frontmatter` | `bool` | | Keep YAML frontmatter (---) in Markdown when converting to a Google Doc (--convert or --convert-to doc; default: strip) | +| `--keep-revision-forever` | `bool` | | Keep the new head revision forever (binary files only) | +| `--mime-type` | `string` | | Override MIME type inference | +| `--name` | `string` | | Override filename (create) or rename target (replace) | +| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) | +| `--parent` | `string` | | Destination folder ID (create only) | +| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) | +| `--replace` | `string` | | Replace the content of an existing Drive file ID (preserves shared link/permissions) | +| `--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) diff --git a/docs/commands/gog-version.md b/docs/commands/gog-version.md new file mode 100644 index 0000000..73d5a51 --- /dev/null +++ b/docs/commands/gog-version.md @@ -0,0 +1,42 @@ +# `gog version` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Print version + +## Usage + +```bash +gog version [flags] +``` + +## Parent + +- [gog](gog.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](gog.md) +- [Command index](README.md) diff --git a/docs/commands/gog-whoami.md b/docs/commands/gog-whoami.md new file mode 100644 index 0000000..3008a0e --- /dev/null +++ b/docs/commands/gog-whoami.md @@ -0,0 +1,42 @@ +# `gog whoami` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Show your profile (alias for 'people me') + +## Usage + +```bash +gog whoami (who-am-i) [flags] +``` + +## Parent + +- [gog](gog.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](gog.md) +- [Command index](README.md) diff --git a/docs/commands/gog.md b/docs/commands/gog.md new file mode 100644 index 0000000..5779883 --- /dev/null +++ b/docs/commands/gog.md @@ -0,0 +1,80 @@ +# `gog` + +> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`. + +Google CLI for Gmail/Calendar/Chat/Classroom/Drive/Contacts/Tasks/Sheets/Docs/Slides/People/Forms/App Script/Ads/Groups/Admin/Keep + +Config: + file: /Users/steipete/Library/Application Support/gogcli/config.json + keyring backend: file (source: config) + +## Usage + +```bash +gog <command> [flags] +``` + +## Subcommands + +- [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') + +## 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 + +- [Command index](README.md) diff --git a/scripts/build-docs-site.mjs b/scripts/build-docs-site.mjs new file mode 100755 index 0000000..b4abdc9 --- /dev/null +++ b/scripts/build-docs-site.mjs @@ -0,0 +1,581 @@ +#!/usr/bin/env node +import fs from "node:fs"; +import path from "node:path"; + +const root = process.cwd(); +const docsDir = path.join(root, "docs"); +const outDir = path.join(root, "dist", "docs-site"); +const repoEditBase = "https://github.com/steipete/gogcli/edit/main/docs"; + +const sections = [ + ["Start", ["README.md", "auth-clients.md", "spec.md", "dates.md"]], + ["Commands", rels("commands")], + ["Gmail", ["gmail-autoreply.md", "watch.md", "email-tracking.md", "email-tracking-worker.md"]], + ["Workspace", ["backup.md", "contacts-json-update.md", "slides-markdown.md", "slides-template-replacement.md", "sedmat.md"]], + ["Safety", ["safety-profiles.md", "RELEASING.md"]], +]; + +fs.rmSync(outDir, { recursive: true, force: true }); +fs.mkdirSync(outDir, { recursive: true }); + +const pages = allMarkdown(docsDir).map((file) => { + const rel = path.relative(docsDir, file).replaceAll(path.sep, "/"); + const markdown = fs.readFileSync(file, "utf8"); + const title = firstHeading(markdown) || titleize(path.basename(rel, ".md")); + return { file, rel, title, outRel: outPath(rel), markdown }; +}); + +const pageMap = new Map(pages.map((page) => [page.rel, page])); +const nav = sections + .map(([name, relList]) => ({ + name, + pages: relList.map((rel) => pageMap.get(rel)).filter(Boolean), + })) + .filter((section) => section.pages.length > 0); +const orderedPages = nav.flatMap((section) => section.pages); +const sectionByRel = new Map(); +for (const section of nav) { + for (const page of section.pages) sectionByRel.set(page.rel, section.name); +} + +for (const page of pages) { + const html = markdownToHtml(page.markdown, page.rel); + const toc = tocFromHtml(html); + const idx = orderedPages.findIndex((candidate) => candidate.rel === page.rel); + const prev = idx > 0 ? orderedPages[idx - 1] : null; + const next = idx >= 0 && idx < orderedPages.length - 1 ? orderedPages[idx + 1] : null; + const pageOut = path.join(outDir, page.outRel); + fs.mkdirSync(path.dirname(pageOut), { recursive: true }); + fs.writeFileSync( + pageOut, + layout({ page, html, toc, prev, next, sectionName: sectionByRel.get(page.rel) || "Docs" }), + "utf8", + ); +} + +for (const name of ["CNAME"]) { + const src = path.join(docsDir, name); + if (fs.existsSync(src)) fs.copyFileSync(src, path.join(outDir, name)); +} +fs.writeFileSync(path.join(outDir, ".nojekyll"), "", "utf8"); +console.log(`built docs site: ${path.relative(root, outDir)}`); + +function rels(dir) { + const full = path.join(docsDir, dir); + if (!fs.existsSync(full)) return []; + return fs + .readdirSync(full) + .filter((name) => name.endsWith(".md")) + .sort((a, b) => (a === "README.md" ? -1 : b === "README.md" ? 1 : a.localeCompare(b))) + .map((name) => `${dir}/${name}`); +} + +function allMarkdown(dir) { + return fs + .readdirSync(dir, { withFileTypes: true }) + .flatMap((entry) => { + const full = path.join(dir, entry.name); + if (entry.isDirectory()) return allMarkdown(full); + return entry.name.endsWith(".md") ? [full] : []; + }) + .sort(); +} + +function outPath(rel) { + if (rel === "README.md") return "index.html"; + if (rel.endsWith("/README.md")) return rel.replace(/README\.md$/, "index.html"); + return rel.replace(/\.md$/, ".html"); +} + +function firstHeading(markdown) { + return markdown.match(/^#\s+(.+)$/m)?.[1]?.trim(); +} + +function titleize(input) { + return input.replaceAll("-", " ").replace(/\b\w/g, (m) => m.toUpperCase()); +} + +function markdownToHtml(markdown, currentRel) { + const lines = markdown.replace(/\r\n/g, "\n").split("\n"); + const html = []; + let paragraph = []; + let list = null; + let fence = null; + + const flushParagraph = () => { + if (!paragraph.length) return; + html.push(`<p>${inline(paragraph.join(" "), currentRel)}</p>`); + paragraph = []; + }; + const closeList = () => { + if (!list) return; + html.push(`</${list}>`); + list = null; + }; + const splitRow = (line) => { + const trimmed = line.replace(/^\s*\|/, "").replace(/\|\s*$/, ""); + const cells = []; + let cell = ""; + let escaped = false; + for (const ch of trimmed) { + if (escaped) { + cell += ch; + escaped = false; + continue; + } + if (ch === "\\") { + escaped = true; + cell += ch; + continue; + } + if (ch === "|") { + cells.push(cell.trim()); + cell = ""; + continue; + } + cell += ch; + } + cells.push(cell.trim()); + return cells; + }; + const isDivider = (line) => /^\s*\|?\s*:?-{2,}:?\s*(\|\s*:?-{2,}:?\s*)+\|?\s*$/.test(line); + + for (let i = 0; i < lines.length; i++) { + const line = lines[i]; + const fenceMatch = line.match(/^```([\w+-]+)?\s*$/); + if (fenceMatch) { + flushParagraph(); + closeList(); + if (fence) { + html.push(`<pre><code class="language-${escapeAttr(fence.lang)}">${escapeHtml(fence.lines.join("\n"))}</code></pre>`); + fence = null; + } else { + fence = { lang: fenceMatch[1] || "text", lines: [] }; + } + continue; + } + if (fence) { + fence.lines.push(line); + continue; + } + if (!line.trim()) { + flushParagraph(); + closeList(); + continue; + } + const heading = line.match(/^(#{1,4})\s+(.+)$/); + if (heading) { + flushParagraph(); + closeList(); + const level = heading[1].length; + const text = heading[2].trim(); + const id = slug(text); + const inner = inline(text, currentRel); + const anchor = level === 1 ? "" : `<a class="anchor" href="#${id}" aria-label="Anchor link">#</a>`; + html.push(`<h${level} id="${id}">${anchor}${inner}</h${level}>`); + continue; + } + if (line.trimStart().startsWith("|") && line.includes("|", line.indexOf("|") + 1) && isDivider(lines[i + 1] || "")) { + flushParagraph(); + closeList(); + const header = splitRow(line); + i += 1; + const rows = []; + while (i + 1 < lines.length && lines[i + 1].trimStart().startsWith("|")) { + i += 1; + rows.push(splitRow(lines[i])); + } + const th = header.map((cell) => `<th>${inline(cell, currentRel)}</th>`).join(""); + const tb = rows + .map((row) => `<tr>${row.map((cell) => `<td>${inline(cell, currentRel)}</td>`).join("")}</tr>`) + .join(""); + html.push(`<table><thead><tr>${th}</tr></thead><tbody>${tb}</tbody></table>`); + continue; + } + const bullet = line.match(/^\s*-\s+(.+)$/); + const numbered = line.match(/^\s*\d+\.\s+(.+)$/); + const quote = line.match(/^>\s+(.+)$/); + if (quote) { + flushParagraph(); + closeList(); + html.push(`<blockquote>${inline(quote[1], currentRel)}</blockquote>`); + continue; + } + if (bullet || numbered) { + flushParagraph(); + const tag = bullet ? "ul" : "ol"; + if (list && list !== tag) closeList(); + if (!list) { + list = tag; + html.push(`<${tag}>`); + } + html.push(`<li>${inline((bullet || numbered)[1], currentRel)}</li>`); + continue; + } + paragraph.push(line.trim()); + } + flushParagraph(); + closeList(); + return html.join("\n"); +} + +function inline(text, currentRel) { + const stash = []; + let out = text.replace(/`([^`]+)`/g, (_, code) => { + stash.push(`<code>${escapeHtml(code)}</code>`); + return `\u0000${stash.length - 1}\u0000`; + }); + out = escapeHtml(out) + .replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>") + .replace(/\[([^\]]+)\]\(([^)]+)\)/g, (_, label, href) => `<a href="${escapeAttr(rewriteHref(href, currentRel))}">${label}</a>`); + out = out.replace(/\\\|/g, "|"); + out = out.replace(/<br>/g, "<br>"); + return out.replace(/\u0000(\d+)\u0000/g, (_, index) => stash[Number(index)]); +} + +function rewriteHref(href, currentRel) { + if (/^(https?:|mailto:|#)/.test(href)) return href; + const [raw, hash = ""] = href.split("#"); + if (!raw) return `#${hash}`; + if (!raw.endsWith(".md")) return href; + const target = path.posix.normalize(path.posix.join(path.posix.dirname(currentRel), raw)); + const rewritten = path.posix.relative(path.posix.dirname(outPath(currentRel)), outPath(target)) || "index.html"; + return `${rewritten}${hash ? `#${hash}` : ""}`; +} + +function tocFromHtml(html) { + const items = []; + const re = /<h([23]) id="([^"]+)">([\s\S]*?)<\/h[23]>/g; + let match; + while ((match = re.exec(html))) { + const text = match[3] + .replace(/<a class="anchor"[^>]*>.*?<\/a>/, "") + .replace(/<[^>]+>/g, "") + .trim(); + items.push({ level: Number(match[1]), id: match[2], text }); + } + if (items.length < 2) return ""; + return `<nav class="toc" aria-label="On this page"><h2>On This Page</h2>${items + .map((item) => `<a class="toc-l${item.level}" href="#${item.id}">${escapeHtml(item.text)}</a>`) + .join("")}</nav>`; +} + +function layout({ page, html, toc, prev, next, sectionName }) { + const depth = page.outRel.split("/").length - 1; + const rootPrefix = depth ? "../".repeat(depth) : ""; + const editUrl = `${repoEditBase}/${page.rel}`; + return `<!doctype html> +<html lang="en"> +<head> + <meta charset="utf-8"> + <meta name="viewport" content="width=device-width, initial-scale=1"> + <title>${escapeHtml(page.title)} - gog docs + + + + + +
+ +
+
+
+

${escapeHtml(sectionName)}

+

${escapeHtml(page.title)}

+
+
+ GitHub + Edit +
+
+
+
${html}${pageNavHtml(prev, next, rootPrefix)}
+ ${toc} +
+
+
+ + +`; +} + +function navHtml(currentRel, rootPrefix) { + return nav + .map((section) => { + const pages = section.pages + .map((page) => { + const href = rootPrefix + page.outRel; + const active = page.rel === currentRel ? " aria-current=\"page\"" : ""; + return `${escapeHtml(shortTitle(page))}`; + }) + .join(""); + return `

${escapeHtml(section.name)}

${pages}
`; + }) + .join(""); +} + +function shortTitle(page) { + if (page.rel === "README.md") return "Overview"; + if (page.rel === "commands/README.md") return "Command Index"; + return page.title.replace(/^`gog\s*/, "").replace(/`$/, ""); +} + +function pageNavHtml(prev, next, rootPrefix) { + if (!prev && !next) return ""; + return ``; +} + +function slug(text) { + return text + .toLowerCase() + .replace(/<[^>]+>/g, "") + .replace(/`/g, "") + .replace(/[^a-z0-9]+/g, "-") + .replace(/^-|-$/g, ""); +} + +function escapeHtml(value) { + return String(value ?? "") + .replace(/&/g, "&") + .replace(//g, ">") + .replace(/"/g, """); +} + +function escapeAttr(value) { + return escapeHtml(value).replace(/'/g, "'"); +} + +function css() { + return ` +:root { + --bg: #fbfbfa; + --panel: #ffffff; + --ink: #18202a; + --muted: #667085; + --line: #e6e8ec; + --blue: #1a73e8; + --red: #ea4335; + --yellow: #fbbc04; + --green: #34a853; + --code: #f6f8fb; + --shadow: 0 18px 44px rgba(24,32,42,.08); + color-scheme: light; +} +* { box-sizing: border-box; } +html { scroll-behavior: smooth; } +body { + margin: 0; + background: var(--bg); + color: var(--ink); + font: 15px/1.62 ui-sans-serif, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; +} +a { color: var(--blue); text-decoration: none; } +a:hover { text-decoration: underline; } +code, pre { font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; } +.shell { display: grid; grid-template-columns: 292px minmax(0, 1fr); min-height: 100vh; } +.sidebar { + position: sticky; + top: 0; + height: 100vh; + overflow: auto; + border-right: 1px solid var(--line); + background: rgba(255,255,255,.86); + padding: 22px 18px; +} +.brand { display: flex; align-items: center; gap: 12px; color: var(--ink); margin-bottom: 22px; } +.brand:hover { text-decoration: none; } +.brand strong { display: block; font-size: 21px; line-height: 1; letter-spacing: -.02em; } +.brand small { color: var(--muted); font-size: 12px; } +.mark { display: grid; grid-template-columns: repeat(2, 12px); grid-template-rows: repeat(2, 12px); gap: 3px; } +.mark i:nth-child(1) { background: var(--blue); } +.mark i:nth-child(2) { background: var(--red); } +.mark i:nth-child(3) { background: var(--yellow); } +.mark i:nth-child(4) { background: var(--green); } +.mark i { border-radius: 3px; display: block; } +.search { display: block; margin-bottom: 18px; } +.search span { display: block; color: var(--muted); font-size: 12px; margin-bottom: 6px; } +.search input { + width: 100%; + border: 1px solid var(--line); + border-radius: 8px; + padding: 9px 10px; + color: var(--ink); + background: var(--panel); +} +.sidebar section { margin: 20px 0; } +.sidebar h2 { color: var(--muted); font-size: 11px; letter-spacing: .1em; text-transform: uppercase; margin: 0 0 7px; } +.sidebar a { + display: block; + color: #3f4a59; + padding: 5px 8px; + border-radius: 7px; + font-size: 13px; + overflow: hidden; + text-overflow: ellipsis; + white-space: nowrap; +} +.sidebar a[aria-current="page"], .sidebar a:hover { color: var(--ink); background: #f0f4fb; text-decoration: none; } +main { padding: 34px min(5vw, 64px) 64px; min-width: 0; } +.hero { + display: flex; + justify-content: space-between; + gap: 24px; + align-items: flex-start; + margin: 0 auto 26px; + max-width: 1180px; +} +.eyebrow { color: var(--muted); text-transform: uppercase; letter-spacing: .11em; font-size: 12px; margin: 0 0 8px; } +h1 { font-size: clamp(34px, 5vw, 58px); line-height: 1; letter-spacing: -.045em; margin: 0; max-width: 880px; } +.hero-links { display: flex; gap: 8px; flex-wrap: wrap; } +.hero-links a { + color: var(--ink); + border: 1px solid var(--line); + background: var(--panel); + border-radius: 8px; + padding: 8px 11px; + box-shadow: 0 8px 20px rgba(24,32,42,.04); +} +.doc-grid { + max-width: 1180px; + margin: 0 auto; + display: grid; + grid-template-columns: minmax(0, 1fr) 220px; + gap: 30px; + align-items: start; +} +.doc { + background: var(--panel); + border: 1px solid var(--line); + border-radius: 10px; + box-shadow: var(--shadow); + padding: min(5vw, 48px); + min-width: 0; +} +.doc h1 { font-size: 36px; margin-bottom: 18px; } +.doc h2 { font-size: 24px; margin: 38px 0 12px; padding-top: 4px; } +.doc h3 { font-size: 18px; margin: 28px 0 10px; } +.doc p, .doc li { color: #344054; } +.doc blockquote { + margin: 18px 0; + padding: 12px 16px; + border-left: 4px solid var(--blue); + background: #f7faff; + color: #344054; +} +.doc pre { + overflow: auto; + border-radius: 8px; + border: 1px solid var(--line); + background: var(--code); + padding: 15px; +} +.doc code { font-size: .92em; } +.doc :not(pre) > code { + background: var(--code); + border: 1px solid #e8ebf1; + border-radius: 5px; + padding: 1px 5px; +} +.doc table { + display: block; + width: 100%; + overflow: auto; + border-collapse: collapse; + margin: 18px 0; + font-size: 13px; +} +.doc th, .doc td { border: 1px solid var(--line); padding: 8px 10px; vertical-align: top; } +.doc th { background: #f8fafc; text-align: left; } +.anchor { color: #b5bdc9; margin-right: 7px; } +.toc { + position: sticky; + top: 24px; + color: var(--muted); + font-size: 13px; + max-height: calc(100vh - 48px); + overflow: auto; +} +.toc h2 { color: var(--ink); font-size: 12px; text-transform: uppercase; letter-spacing: .1em; } +.toc a { display: block; color: var(--muted); padding: 5px 0; } +.toc-l3 { padding-left: 12px !important; } +.page-nav { + display: grid; + grid-template-columns: 1fr 1fr; + gap: 12px; + margin-top: 42px; + border-top: 1px solid var(--line); + padding-top: 20px; +} +.page-nav a { + border: 1px solid var(--line); + border-radius: 8px; + padding: 12px; + color: var(--muted); +} +.page-nav a:last-child { text-align: right; } +.page-nav strong { color: var(--ink); } +.nav-toggle { display: none; } +@media (max-width: 960px) { + .shell { display: block; } + .sidebar { + position: fixed; + inset: 0 auto 0 0; + width: min(320px, 86vw); + transform: translateX(-100%); + transition: transform .18s ease; + z-index: 10; + } + body.nav-open .sidebar { transform: translateX(0); } + .nav-toggle { + display: grid; + position: fixed; + top: 12px; + left: 12px; + z-index: 20; + gap: 4px; + border: 1px solid var(--line); + background: var(--panel); + border-radius: 8px; + padding: 10px; + } + .nav-toggle span { width: 18px; height: 2px; background: var(--ink); display: block; } + main { padding: 70px 18px 42px; } + .hero { display: block; } + .hero-links { margin-top: 18px; } + .doc-grid { display: block; } + .toc { display: none; } + .doc { padding: 24px; } +} +`; +} + +function js() { + return ` +const toggle = document.querySelector(".nav-toggle"); +toggle?.addEventListener("click", () => { + const open = document.body.classList.toggle("nav-open"); + toggle.setAttribute("aria-expanded", String(open)); +}); +document.querySelectorAll(".sidebar a").forEach((link) => { + link.addEventListener("click", () => document.body.classList.remove("nav-open")); +}); +const search = document.getElementById("doc-search"); +search?.addEventListener("input", () => { + const q = search.value.trim().toLowerCase(); + document.querySelectorAll(".sidebar nav a").forEach((link) => { + const haystack = (link.dataset.title || "") + " " + link.textContent.toLowerCase(); + link.hidden = q !== "" && !haystack.includes(q); + }); +}); +`; +} diff --git a/scripts/gen-command-reference.sh b/scripts/gen-command-reference.sh index 3f008e7..7b377fd 100755 --- a/scripts/gen-command-reference.sh +++ b/scripts/gen-command-reference.sh @@ -5,6 +5,7 @@ ROOT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)" BIN="${GOG_BIN:-$ROOT_DIR/bin/gog}" OUT="${1:-}" PY="${PYTHON:-python3}" +DOCS_DIR="$ROOT_DIR/docs" if ! command -v "$PY" >/dev/null 2>&1; then PY="python" @@ -17,53 +18,198 @@ schema_file="$(mktemp "${TMPDIR:-/tmp}/gog-schema-XXXXXX.json")" trap 'rm -f "$schema_file"' EXIT "$BIN" schema --json >"$schema_file" -generate() { - "$PY" - "$schema_file" <<'PY' +"$PY" - "$schema_file" "$OUT" "$DOCS_DIR" <<'PY' import json +import os +import re +import shutil import sys -schema_path = sys.argv[1] +schema_path, out_path, docs_dir = sys.argv[1:4] with open(schema_path, "r", encoding="utf-8") as f: schema = json.load(f) root = schema.get("command") or {} -lines = [ - "# Command Reference", - "", - "Generated from `gog schema --json`.", - "", -] def first_line(value): return (value or "").strip().splitlines()[0] if (value or "").strip() else "" -def walk(command): +def canonical_tokens(path): + return [part for part in (path or "").split() if not (part.startswith("(") and part.endswith(")"))] + + +def canonical_path(command): + tokens = canonical_tokens(command.get("path") or command.get("name") or "") + return " ".join(tokens) + + +def command_slug(command): + path = canonical_path(command) + slug = re.sub(r"[^a-z0-9]+", "-", path.lower()).strip("-") + return slug or "gog" + + +def command_label(command): path = command.get("path") or command.get("name") or "" usage = command.get("usage") or "" - summary = first_line(command.get("help")) prefix = path.removeprefix("gog ").strip() suffix = usage if prefix and usage.startswith(prefix): suffix = usage[len(prefix):].strip() - label = path if not suffix else f"{path} {suffix}" - if label: - if summary: - lines.append(f"- `{label}` - {summary}") - else: - lines.append(f"- `{label}`") + return path if not suffix else f"{path} {suffix}" + + +def walk(command, parent=None, depth=0): + command["_parent"] = parent + command["_depth"] = depth + yield command for child in command.get("subcommands") or []: - walk(child) + yield from walk(child, command, depth + 1) -walk(root) -print("\n".join(lines)) +commands = list(walk(root)) +slug_to_command = {} +for command in commands: + base = command_slug(command) + slug = base + suffix = 2 + while slug in slug_to_command: + slug = f"{base}-{suffix}" + suffix += 1 + command["_slug"] = slug + command["_page"] = f"commands/{slug}.md" + slug_to_command[slug] = command + + +def md_escape(value): + return (value or "").replace("|", "\\|").replace("\n", "
") + + +def link(command, label=None): + return f"[{label or canonical_path(command)}]({command['_slug']}.md)" + + +def command_reference(): + lines = [ + "# Command Reference", + "", + "Generated from `gog schema --json`.", + "", + ] + for command in commands: + label = command_label(command) + if not label: + continue + summary = first_line(command.get("help")) + indent = " " * max(command.get("_depth", 0), 0) + target = f"commands/{command['_slug']}.md" + if summary: + lines.append(f"{indent}- [`{label}`]({target}) - {summary}") + else: + lines.append(f"{indent}- [`{label}`]({target})") + lines.append("") + return "\n".join(lines) + + +def command_page(command): + parent = command.get("_parent") + children = command.get("subcommands") or [] + flags = command.get("flags") or [] + args = command.get("arguments") or [] + title = canonical_path(command) + lines = [ + f"# `{title}`", + "", + "> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.", + "", + ] + if command.get("help"): + lines.extend([command.get("help").strip(), ""]) + lines.extend(["## Usage", "", "```bash", f"{command_label(command)}", "```", ""]) + if parent: + lines.extend(["## Parent", "", f"- {link(parent)}", ""]) + if children: + lines.extend(["## Subcommands", ""]) + for child in children: + summary = first_line(child.get("help")) + item = f"- {link(child)}" + if summary: + item += f" - {summary}" + lines.append(item) + lines.append("") + if args: + lines.extend(["## Arguments", "", "| Name | Help |", "| --- | --- |"]) + for arg in args: + lines.append(f"| `{md_escape(arg.get('name'))}` | {md_escape(arg.get('help'))} |") + lines.append("") + if flags: + lines.extend(["## Flags", "", "| Flag | Type | Default | Help |", "| --- | --- | --- | --- |"]) + for flag in flags: + names = [] + if flag.get("short"): + names.append(f"`-{flag['short']}`") + names.append(f"`--{flag.get('name')}`") + for alias in flag.get("aliases") or []: + names.append(f"`--{alias}`") + default = flag.get("default") if flag.get("has_default") else "" + lines.append( + f"| {'
'.join(names)} | `{md_escape(flag.get('type'))}` | {md_escape(default)} | {md_escape(flag.get('help'))} |" + ) + lines.append("") + lines.extend(["## See Also", ""]) + if parent: + lines.append(f"- {link(parent)}") + lines.append("- [Command index](README.md)") + lines.append("") + return "\n".join(lines) + + +def command_index(): + top = [c for c in commands if c.get("_depth") == 1] + lines = [ + "# 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.", + "", + f"Generated pages: {len(commands)}.", + "", + "## Top-level Commands", + "", + ] + for command in top: + summary = first_line(command.get("help")) + item = f"- {link(command)}" + if summary: + item += f" - {summary}" + lines.append(item) + lines.extend(["", "## All Commands", ""]) + for command in commands: + summary = first_line(command.get("help")) + indent = " " * max(command.get("_depth", 0), 0) + item = f"{indent}- {link(command)}" + if summary: + item += f" - {summary}" + lines.append(item) + lines.append("") + return "\n".join(lines) + + +if out_path: + with open(out_path, "w", encoding="utf-8") as f: + f.write(command_reference()) +else: + print(command_reference()) + +commands_dir = os.path.join(docs_dir, "commands") +shutil.rmtree(commands_dir, ignore_errors=True) +os.makedirs(commands_dir, exist_ok=True) +with open(os.path.join(commands_dir, "README.md"), "w", encoding="utf-8") as f: + f.write(command_index()) +for command in commands: + with open(os.path.join(commands_dir, f"{command['_slug']}.md"), "w", encoding="utf-8") as f: + f.write(command_page(command)) + +print(f"generated {len(commands)} command pages in {os.path.relpath(commands_dir, os.getcwd())}", file=sys.stderr) PY -} - -if [ -n "$OUT" ]; then - generate >"$OUT" -else - generate -fi