Commands
file search
Search for matching fragments within a single file.
poly file search searches for matching fragments within a single file, rather than across all of Poly. By default it runs both full-text and semantic matching and merges the results.
Usage
poly file search <TARGET> [QUERY]
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.
Flags
| Flag | Description |
|---|---|
--text <PHRASE> | Full-text search only. |
--smart <QUERY> | Semantic search only. |
--offset <N> | Skip this many results. Default 0. |
--limit <N> | Max results to return, 1–1000. Default 20. |
--show-all | Include semantic matches below the relevance cutoff. |
Examples
# Search a file with the default dual smart+text mode
poly file search //Home/docs/report.pdf "quarterly revenue"
# Full-text only
poly file search //Home/docs/report.pdf --text "quarterly revenue"
# Semantic search only
poly file search //Home/docs/report.pdf --smart "financial performance concerns"
# Page through results
poly file search //Home/docs/report.pdf "budget" --offset 20 --limit 20
# Include lower-relevance semantic matches
poly file search //Home/docs/report.pdf --smart "risk factors" --show-all