Saved searches

A saved search is a name attached to a query, stored in the settings file so it shows up in the app’s sidebar and the CLI without retyping it.

Saving a query

quarry saved add weekly-invoices 'ext:md AND path:invoices/ AND modified:>2026-06-01'

The name, weekly-invoices here, must be unique and contains no spaces. Running the same add command again with a new query overwrites the old one.

Listing saved searches

quarry saved list

weekly-invoices   ext:md AND path:invoices/ AND modified:>2026-06-01
standups          path:notes/standups/

Running a saved search

quarry saved run weekly-invoices

This behaves exactly like quarry search with the stored query substituted in, including every flag search accepts, like --index or --limit.

quarry saved run weekly-invoices --index notes --limit 5

Removing one

quarry saved remove weekly-invoices

Where they live

Saved searches are stored in config.toml, not in a separate file:

[saved.weekly-invoices]
query = "ext:md AND path:invoices/ AND modified:>2026-06-01"

[saved.standups]
query = "path:notes/standups/"

They can be edited directly here instead of through quarry saved, and they sync between the app and the CLI automatically since both read the same file.

The Free plan limit

Free allows three saved searches at a time. Adding a fourth returns an error and exit code 1 until one is removed:

error: saved search limit reached (3 of 3 on the Free plan)

Pro removes this limit. See /pricing for the full comparison between plans.

In the desktop app

Saved searches appear in the sidebar under Saved. Clicking one runs it against the currently selected index, or all indexes if none is selected. The app and the CLI share the same list, so a search saved from the sidebar is immediately available to quarry saved run from a terminal.