Commands
mksearch
Create a saved search ("smart folder") in Poly.
poly mksearch saves a search as a .polysearch smart folder, a folder that always shows the live results of a query instead of a fixed set of files. It accepts the same filters as poly search.
Usage
poly mksearch [PARENT-REF] --title <TITLE>
PARENT-REF defaults to the current context if omitted. --title is required.
Flags
| Flag | Description |
|---|---|
--title <TITLE> | Name of the saved search. Required. |
--query <TEXT> | Query text. Requires --smart or --text. |
--smart | Semantic-only matching for --query. |
--text | Full-text-only matching for --query. |
--execute | Run the search once immediately and include the first page of results in the output. |
All filters from poly search are also accepted — name, type, mime, location, dates, size, tags, rating, and more — and are saved as part of the smart folder's definition. See Faceted Search for the full filter reference.
Examples
# Save a smart folder for recent PDFs
poly mksearch //Home --title "Recent PDFs" --include-type pdf --modified-after "7 days ago"
# Save a semantic search as a smart folder
poly mksearch //Home --title "Whale research" --smart --query "marine biology notes"
# Save a smart folder and see its first results right away
poly mksearch //Home --title "Large videos" --include-type video --size-gt 500MB --execute
# Save a smart folder scoped to a shared drive
poly mksearch //shared/design-team --title "Unrated assets" --rating-lte 0
Related
search— run a one-off search with the same filters.- Faceted Search — full filter and facet reference.
- How it Works — file reference syntax and the local cache.