Commands
find
Find files and folders by name, path, type, or depth.
poly find is a find(1)-compatible subset for locating files and folders by name, path, type, or depth. It's answered entirely from the local cache, so it works offline and stays fast.
Usage
poly find [START...]
START defaults to .. Pass a //-prefixed Poly path, local sync-folder path, or // to search every accessible root. See How it Works for the full reference syntax.
Predicates
| Flag | Description |
|---|---|
-name <GLOB> / -iname | Match by filename glob; -iname is case-insensitive, -name is case-sensitive. |
-path <GLOB> / -ipath | Match by path glob; * matches / too. |
-type <f|d|l> | Restrict to files, directories, or links. |
-mindepth <N> / -maxdepth <N> | Limit how deep the search descends. |
-print0 | NUL-separate results for safe piping. Conflicts with --output json. |
-print | Accepted for compatibility; ignored. |
--limit <N> | Cap results (default 1000). Truncation is always reported. |
--at <REVISION|TIME> | Search the tree as it looked at a revision or fuzzy time. |
Boolean operators, -exec, -delete, -prune, and -regex are unsupported. Pipe -print0 into xargs -0, or use poly search for content and metadata queries.
Examples
# Find every markdown file under the current directory
poly find . -name "*.md"
# List folders two levels deep in Home
poly find //Home -type d -maxdepth 2
# Case-insensitive filename match, piped into another command
poly find //Home/docs -iname "report*" -print0 | xargs -0 poly file show
# Search a folder as it existed yesterday
poly find //Home --at yesterday -name "*.md"
# Search across every root you can access
poly find // -name "invoice*"
Related
ls— list one folder's contents rather than recursing.search— full-text, semantic, and metadata search.- How it Works — file reference syntax and the local cache.