ultralist (list|l)- List all 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:
Filtering by date
There are 3 directives for filtering by date:
<date> is one of:
- A specific date, in the format of
ultralist l due:tod- show tasks due today
ultralist 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
ultralist l completed:true- show only completed tasks
ultralist l completed:false- show only incomplete tasks
ultralist l priority:true- show only prioritized tasks
ultralist l priority:false- show only non-prioritized tasks
Filtering archived tasks
archived:false- note that this option is implicitly added! Ultralist defaults to not showing archived tasks.
ultralist l archived:true- show archived tasks
Filtering by completion date
ultralist l completed:tod- show tasks that were completed today
ultralist 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 of
ultralist l project:mobile,devops- Show all tasks with a project of
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 of
mobilebut exclude tasks with a
ultralist l project:mobile status:next due:tod- Show all tasks with a project of
mobile, a status of
next, 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.
ultralist l due:tom | grep @bob
Or you can have some fancy times by piping the output to
ultralist l group:projector
ultralist l group:p- List all tasks, grouped by project.
ultralist l group:contextor
ultralist l group:c- List all tasks, grouped by context.
ultralist l group:statusor
ultralist l group:s- List all tasks, grouped by status.
Showing tasks with notes
--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
ultralist l duebefore:tom status:now- Show all tasks due today or earlier, with the status of
now(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: