gog-docs

# Google Docs <!-- Generated by scripts/gen-agent-skills.mjs; do not edit. --> Use `gog` for Google Docs operations. Read `../gog/SKILL.md` first for shared auth, output, safety, and live-write rules. ## Safe start ```bash gog auth list --check --json --no-input gog schema docs --json gog --readonly --account user@example.com docs cat DOCUMENT_ID --json --wrap-untrusted ``` - 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.