Filtering Notifications

histui provides powerful filtering capabilities for querying your notification history.

Filter Syntax

Filters use a simple key:value syntax:

histui get --filter "app:firefox"

Available Filters

Filter	Description	Example
app	Application name	app:firefox
urgency	Urgency level	urgency:critical
summary	Match summary text	summary:download
body	Match body text	body:error

Combining Filters

Multiple filters are combined with AND logic:

histui get --filter "app:firefox urgency:critical"

Time-Based Filtering

Use the --since flag for time-based filtering:

# Last hour
histui get --since 1h

# Last 30 minutes
histui get --since 30m

# Last 7 days
histui get --since 168h

Examples

Critical Firefox notifications from the last hour

histui get --filter "app:firefox urgency:critical" --since 1h

All download-related notifications

histui get --filter "summary:download"