Select the account explicitly with --account.
Use --json --wrap-untrusted for agent-readable Google content.
Use --readonly when the task must not mutate Google data.
Use --no-input in automation and --dry-run before supported writes.
Confirm the exact account, object, and mutation before any write or delete.

Commands

Command	Purpose
`add-tab`	Add a tab to a Google Doc
`cat`	Print a Google Doc as plain text
`cell-style`	Apply table cell, border, padding, alignment, and text styling
`cell-update`	Replace or append content inside a specific table cell
`clear`	Clear all content from a Google Doc
`comments`	Manage comments on files
`copy`	Copy a Google Doc
`create`	Create a Google Doc
`delete`	Delete text range from document
`delete-tab`	Delete a tab from a Google Doc
`edit`	Find and replace text in a Google Doc
`export`	Export a Google Doc (pdf\|docx\|txt\|md\|html)
`find-range`	Find text and print Docs API UTF-16 index ranges
`find-replace`	Find and replace text. Supports plain text or markdown with images; use --first for a single occurrence.
`footer`	List, create, or delete document footers
`format`	Apply text or paragraph formatting to a Google Doc
`header`	List, create, or delete document headers
`headings`	List document headings
`images`	List document images
`info`	Get Google Doc metadata
`insert`	Insert text at a specific position
`insert-date-chip`	Insert a native date smart chip
`insert-file-chip`	Insert a native Drive file smart chip
`insert-footnote`	Insert and populate a footnote
`insert-horizontal-rule`	Insert a paragraph-border horizontal rule
`insert-image`	Insert a public image URL or upload a local image into a Google Doc
`insert-page-break`	Insert a page break at a specific position (or end-of-doc with --at-end)
`insert-person`	Insert a native person smart chip
`insert-section-break`	Insert a continuous or next-page section break
`insert-table`	Insert a native table at a specific position (or end-of-doc with --at-end), optionally populated via --values-json
`list-tabs`	List all tabs in a Google Doc
`named-range`	Manage named ranges
`page-layout`	Set page layout (pageless\|pages) on an existing Google Doc
`paragraphs`	List document paragraphs
`raw`	Dump raw Google Docs API response as JSON (Documents.Get; lossless; for scripting and LLM consumption)
`rename-tab`	Rename a tab in a Google Doc
`replace-image`	Replace an existing image without changing its position or bounds
`section-columns`	Set the column count for a document section
`sed`	Regex find/replace (sed-style: s/pattern/replacement/g)
`structure`	Show document structure with numbered paragraphs
`suggestions`	List pending text suggestions
`table-column`	Insert or delete native table columns
`table-column-width`	Set or reset native table column widths
`table-merge`	Merge a native table cell range
`table-row`	Insert, delete, style, or pin native table rows
`table-unmerge`	Unmerge the region containing a native table cell
`tables`	List native tables
`tabs`	Manage Google Doc tabs
`update`	Insert or replace text at a specific index or range in a Google Doc
`write`	Write content to a Google Doc

Run gog docs <command> --help for flags and gog schema docs <command> --json for the machine-readable contract. Do not guess command syntax.

gog-docs

Google Docs

Safe start