| name | gws-drive-upload |
| description | Upload one local file to Google Drive with the gws helper. Use when the user asks to place a specific file in Drive with an optional destination folder or target filename; use gws-drive for sharing, moving, copying, or permission changes. |
Upload one file to Google Drive
Use the pinned gws drive +upload helper. Read the Drive gws reference before choosing an account or executing the write.
Command shape
The local file is a positional argument; there is no --file flag.
gws drive +upload '<LOCAL_FILE>' [--parent '<FOLDER_ID>'] [--name '<DRIVE_FILENAME>']
Required write gate
- Verify that the requested local path is a regular file and resolve the target account, parent folder, filename, and file size. Do not read or summarize file contents unless the request requires it.
- Run the exact upload command with
--dry-run.
- Show the user the source path, size, target account, destination folder, and final filename.
- Ask for explicit confirmation immediately before running the command without
--dry-run.
- Verify the returned Drive file ID, filename, and parent. Do not claim success from the process exit alone.
Never broaden an upload from one named file to a directory or wildcard without a new confirmation. Use gws-drive for permissions or other Drive mutations.
