Showing tasks
ultralist (list|l)
- List all tasks.
Filtering tasks
You can use filter criteria to show specific tasks. Filter criteria is in the form of thing:value
, much like the syntax for filtering Github issues.
Here are the following filters available:
due
duebefore
dueafter
completed
priority
archived
status
project
context
Filtering by date
due:(tod|today|tom|tomorrow|thisweek|nextweek|lastweek|mon|tue|wed|thu|fri|sat|sun|none|<specific date>)
Examples
ultralist l due:tod
- show tasks due todayultralist l duebefore:tom
- show tasks due before tomorrow (today and earlier)ultralist l dueafter:tod
- show tasks due after today
Currently, only one due
filter is allowed.
Filtering tasks by completion or priority
completed:true
completed:false
priority:true
priority:false
Examples
ultralist l completed:true
- show only completed tasksultralist l completed:false
- show only incomplete tasksultralist l priority:true
- show only prioritized tasksultralist l priority:false
- show only non-prioritized tasks
Filtering archived tasks
archived:true
archived:false
- note that this option is implicitly added! Ultralist defaults to not showing archived tasks.
Examples
ultralist l archived:true
- show archived tasks
Filtering by completion date
completed:(tod|today)
completed:thisweek
Examples
ultralist l completed:tod
- show tasks that were completed todayultralist l completed:thisweek
- show tasks that were completed this week
Filtering by a project, context, or status
ultralist l project:mobile
- Show all tasks with a project ofmobile
ultralist l project:mobile,devops
- Show all tasks with a project ofmobile
ordevops
Negation filters
Adding a minus (-
) to a project, context or status will remove those matching tasks from the list.
ultralist l project:-devops
- Show all tasks without a devops project.ultralist l project:mobile,-devops
- Show only tasks with a project ofmobile
but exclude tasks with adevops
project.
Combining things
ultralist l project:mobile status:next due:tod
- Show all tasks with a project ofmobile
, a status ofnext
, and is due today.
Combining with grep or fzf
ultralist
is a unix tool, just like any other. You can use grep
to combine a complex listing with a filter.
Example: ultralist l due:tom | grep @bob
Or you can have some fancy times by piping the output to fzf
:
Grouping
-
group:project
-
group:context
-
group:status
-
ultralist l group:project
orultralist l group:p
- List all tasks, grouped by project. -
ultralist l group:context
orultralist l group:c
- List all tasks, grouped by context. -
ultralist l group:status
orultralist l group:s
- List all tasks, grouped by status.
Showing tasks with notes
Use the --notes
flag to show notes on tasks when listing.
ultralist l --notes duebefore:tom group:p
Real world examples of combining groups and listing filters
Below is the command I run every day. So often, in fact, I have an alias for it called now
:
ultralist l duebefore:tom status:now
- Show all tasks due today or earlier, with the status ofnow
(I’m using now/next/later for prioritization)ultralist l group:context due:tom
- Show all tasks due tomorrow, and group them by context:ultralist l completed:tod
- Look back at all the tasks you completed today, and feel good about yourself: