CLI
Commands
Every poly command at a glance.
The complete poly command reference. Every command also documents itself: poly <command> --help.
Browsing & searching
| Command | What it does |
|---|---|
ls | List the contents of a Poly folder |
find | Find files by name, type, or path — a find(1)-compatible subset |
search | Semantic, full-text, and metadata search across your files |
Moving data
| Command | What it does |
|---|---|
cp | Copy between local disk and Poly, or within Poly |
mv | Move a file or folder within Poly |
rm | Archive a file — or permanently delete an already-archived one |
wget | Download a URL straight into Poly |
Creating things
| Command | What it does |
|---|---|
mkdir | Create a folder |
mkurl | Create a bookmark pointing at a URL |
mksearch | Create a saved search ("smart folder") |
mkdrive | Create a shared drive |
rmdrive | Permanently delete a shared drive |
File utilities
| Command | What it does |
|---|---|
file show | Detailed metadata for a file or folder |
file read | Read content — text, extracted PDF text, transcripts |
file write | Write bytes into a file (create or replace) |
file update | Rename, tag, rate, annotate — metadata in one request |
file search | Search for fragments within a single file |
file history | The change history of a file |
file restore | Roll back to a revision or point in time |
file revert | Undo one specific change |
file open | Open in a native application |
file download | Download to a local directory |
file share | Make public, invite people, revoke access |
App & session
Global flags
A handful of flags work on every command — --output json, --cache-only, --no-stale, --wait-for-indexing, --disallow-force, and friends. See Global Flags for the full reference.