Star-Filter System

Filter clips by any field using *field=value queries — works in both the Clips workspace search bar and the Quick Overlay.

Type * followed by a field name and value to narrow results instantly. Combine multiple filters, use comparison operators, and mix with regular text search — all without leaving the keyboard.

How to use it

Type a star-filter anywhere in the search bar:

*type=CODE
*source=Chrome|Firefox
*pinned=true *uses>=5
*edited=true async

As you type, a dropdown shows field name suggestions. Once a filter token is complete (followed by a space), it becomes a visual chip you can click to edit or dismiss.

In the Quick Overlay, chips are replaced by ghost text and dropdown completion — the same syntax works, just without the visual chip UI.

Filter syntax

What you type	What it finds
`*type=TXT`	Text clips only
`*type=IMG`	Image clips only
`*type=CODE`	Code clips only
`*source=Chrome`	Clips copied from Chrome
`*source=Chrome\\|Firefox`	Clips from Chrome or Firefox
`*pinned=true`	Pinned clips only
`*edited=true`	Clips you’ve manually edited
`*uses>=5`	Clips used 5 or more times
`*masked=true`	Clips hidden by a retention rule
`*format=HTML`	Clips whose richest captured format is HTML

Mix with plain text: *type=CODE async finds code clips containing “async”.

Operators

Operator	Use for
`=`	Equals (text fields)
`>` `<` `>=` `<=`	Numeric comparisons (`*uses>10`)
`\\|`	OR — `*type=TXT\\|CODE`

Use double quotes for values with spaces: *source="Google Chrome"

Field aliases

You type	Same as
`type`	content type
`source` or `app`	source application
`edited`	has original content saved
`masked`	masked by retention rule
`format`	richest clipboard format
`formats`	number of captured formats

Tips & gotchas

Unknown field names are silently ignored.
Boolean fields accept true/false, 1/0, or yes/no.
Tags use exact match per tag, not substring.
*source uses contains matching — *source=Chrome also matches “Google Chrome”.
Chips only appear in the Clips workspace; the Quick Overlay uses ghost text and dropdown completion.

Configuration

Setting	Default	Description
Star-Filter Dropdown	On	Show autocomplete when typing star-filter tokens in the overlay

Find this under Settings → Overlay → Star-Filter Dropdown.