---
name: gog-drive
description: "Google Drive operations through gog."
---

# Google Drive

<!-- Generated by scripts/gen-agent-skills.mjs; do not edit. -->

Use `gog` for Google Drive 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 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.