Google Drive

Use gog for Google Drive operations. Read ../gog/SKILL.md first for shared auth, output, safety, and live-write rules.

Safe start

gog auth list --check --json --no-input
gog schema drive --json
gog --readonly --account user@example.com drive ls --max 20 --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
activity	Query Drive Activity audit events
audit	Audit Drive sharing without mutation
bulk	Bulk Drive permission operations
changes	Track Drive changes for sync and automation
comments	Manage comments on files
copy	Copy a file
delete	Move a file to trash (use --permanent to delete forever)
download	Download a file (exports Google Docs formats)
drives	List shared drives (Team Drives)
du	Summarize Drive folder sizes
get	Get file metadata
inventory	Export a read-only Drive inventory
labels	Read and modify Drive labels
ls	List files in a folder (default: root)
mkdir	Create a folder
move	Move a file to a different folder
permissions	List permissions on a file
raw	Dump raw Google Drive API response as JSON (Files.Get; lossless; for scripting and LLM consumption)
rename	Rename a file or folder
revisions	List and inspect file revisions
search	Full-text search across Drive
share	Share a file or folder
shortcut	Manage shortcuts to Drive files and folders
sync	Reconcile local files with Drive
tree	Print a read-only folder tree
unshare	Remove a permission from a file
upload	Upload a file
url	Print web URLs for files

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