drive_download
Download files or folders from Proton Drive to your local machine. Specify a destination folder; remote items keep their original names. Handles conflicts via skip, rename, or remove options.
Instructions
Download a file or folder from Proton Drive to the local filesystem. Requires authentication. localPath is a destination FOLDER, not the file's exact final path — the CLI creates it automatically if missing and places the downloaded item inside it under its original remote name. E.g. downloading /my-files/report.pdf with localPath '/tmp/out' produces /tmp/out/report.pdf, not /tmp/out itself as a file — confirmed live against the real CLI (v0.8.0). For folders, downloads recursively. Conflict strategies are set separately for files and folders (CLI v0.8.0+) — both default to 'skip'. Returns {downloaded} count — not the actual local path; construct it as localPath + the remote item's basename if you need it. Do not use to move files within Drive (use drive_move) or to read a small text file's contents (use drive_read_file if PROTON_DRIVE_SYNC_PATH is set).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| localPath | Yes | Absolute local DESTINATION FOLDER (must start with '/'), not the file's final path. Created automatically if it doesn't exist. The downloaded item is placed inside it, keeping its original remote name. | |
| remotePath | Yes | Absolute remote Drive path to download (must start with '/'). E.g. /my-files/report.pdf | |
| fileConflictStrategy | No | 'skip' leaves an existing local file unchanged (default). 'rename' downloads under a unique name. 'remove' deletes the local file and downloads the remote copy in its place — confirm with user first. | |
| folderConflictStrategy | No | 'skip' leaves an existing local folder unchanged (default). 'merge' merges the downloaded folder's contents into the existing one. 'rename' downloads under a unique name. 'remove' deletes the local folder and downloads the remote copy in its place — confirm with user first. |