Commands

file download

Download a file to a local directory.

poly file download downloads a file to a local directory outside the sync folder.

Usage

poly file download <TARGET> [DEST_DIR]

TARGET accepts a local path inside the sync folder, a //-prefixed Poly path, a deep link, or a web URL — see How it Works for the full reference syntax. DEST_DIR defaults to the current directory.

Flags

FlagDescription
--at <REVISION|TIME>Download the file as of a revision ID (from file history) or a fuzzy time, e.g. "yesterday".
--forceRe-download even if a fresh local copy already exists.

Examples

# Download into the current directory
poly file download //Home/docs/report.pdf

# Download into a specific directory
poly file download //Home/docs/report.pdf ~/Downloads

# Download a past revision
poly file download //Home/docs/report.pdf --at yesterday ~/Downloads

# Force a fresh download even if cached locally
poly file download //Home/docs/report.pdf --force
  • file open — open the file in a native app instead of downloading it.
  • cp — copy between local disk and Poly, or within Poly.
  • How it Works — file reference syntax and the local cache.
© Poly Corp. 2026