Commands
ls
List the contents of a Poly folder.
poly ls lists the contents of a Poly folder. It works like the Unix ls you already know, with columns tuned for Poly's metadata.
Usage
poly ls [TARGET]
TARGET defaults to .. It 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. A bare // lists every accessible root: your Home and Archive, the Agent folder, and each shared drive's home and archive.
Flags
| Flag | Description |
|---|---|
-l, --long | Show detailed columns instead of just names. |
--sort <size|modified|name|mime> | Sort order for the listing. |
--columns <COL,...> | Choose exactly which columns to display. |
--classic | Mimic classic ls output. |
--custom-properties | One column per custom property defined on the folder's root. Conflicts with --columns. |
-a, --all | Every common property column that has a value. Implies --long. |
--at <REVISION|TIME> | List the folder as it looked at a revision or fuzzy time (e.g. "yesterday"). Custom properties aren't supported in this mode. |
Examples
# List your home drive
poly ls //Home
# Long listing sorted by most recently modified
poly ls //Home/projects -l --sort modified
# List every root you have access to
poly ls //
# Show only name and size columns
poly ls //Home/docs --columns name,size
# See what a folder looked like yesterday
poly ls //Home/docs --at yesterday
# List the current directory in the sync folder, classic style
poly ls . --classic
Related
find— recursively search folder contents instead of listing one level.search— search by content, metadata, or similarity across all of Poly.file show— detailed metadata for a single file or folder.- How it Works — file reference syntax and the local cache.