@@ -0,0 +1,34 @@ + # IM Interface Command: Filter + + Filters allow you to temporarily hide tasks that you don't want to see. + + You can set filters for any task property that can search for. Tags, group, due date, priority, task summary, and so on. + + When you apply a filter, only tasks that match the filter will be shown by IM commands that list tasks, such as `review`, `todo`, `search` and so on. + + To see the currently applied filters, type: + filter + + To clear all current filters, type: + filter clear + + To clear one filter, type: + filter clear n + where _n_ is a number associated with a filter. + + ## Examples ## + + Show only tasks tagged with _@work_: + filter tag @work + todo + filter clear + + Show only tasks due before saturday: + filter due before saturday + review + filter clear + + Show only tasks that contain text `steve` in tags, summaries, notes, etc. + filter query steve + todo + filter clear
IM Interface Command: Filter
Filters allow you to temporarily hide tasks that you don't want to see.
You can set filters for any task property that can search for. Tags, group, due date, priority, task summary, and so on.
When you apply a filter, only tasks that match the filter will be shown by IM commands that list tasks, such as review, todo, search and so on.
To see the currently applied filters, type: filter
To clear all current filters, type: filter clear
To clear one filter, type: filter clear n where n is a number associated with a filter.
Examples
Show only tasks tagged with @work: filter tag @work todo filter clear
Show only tasks due before saturday: filter due before saturday review filter clear
Show only tasks that contain text steve in tags, summaries, notes, etc.
filter query steve
todo
filter clear
