The List and quick add
The List is home: every open task you have, grouped by when it’s due. Select List in the top bar to get there.
At the top of the page are today’s date, a greeting, and how today is going:
- The streak chip (🔥 6 day streak) shows your day streak. It’s hidden until you have one.
- The paused chip (⏸ 4 paused until Thu 8 Oct) appears while any repeating tasks are paused.
- The progress bar fills as you finish what’s due today, with a line like 3 of 5 done today. Today’s tasks are everything due today or overdue, plus what you’ve finished today. It counts ticks, so a task that takes several counts each one, and its first tick moves the bar. With nothing due, it says Nothing scheduled for today.; with everything done, Everything due today is done.
Adding a task
Section titled “Adding a task”Type into the quick-add bar (What needs doing?) and press Enter or select Add. The task appears straight away, and a toast confirms it, like Task added. Press N anywhere on the List to jump to the bar.
You can say more than the title in the same line, with the shorthand below. As you type, each piece the app has understood shows as a chip in the bar, so you can see what you’ll get before you press Enter. A reminder of the shorthand sits in small text just under the bar (Try #tag, !1–!3 for priority, @fri @7pm for when, ~2wed to repeat, *2 to need two ticks.), and stays there while you type. For example, Take the bins out @wed @7pm ~2wed #home is due next Wednesday at 7pm, repeats every second Wednesday, and is tagged home.
You can also add a task from the command palette, from any page, with the same shorthand.
Quick-add shorthand
Section titled “Quick-add shorthand”Only words that start with #, !, @, ~ or * are read as shorthand. Everything else stays in the title, so “Call mum today” is a task called Call mum today, while “Call mum @today” is a task called Call mum, due today.
| Type | To get |
|---|---|
#home |
A tag. Tags are one word of letters, numbers, - or _, and are always lower case. |
!1 !2 !3, or !low !med !high |
Priority: Low, Medium or High. |
@today @tomorrow @tmrw |
Due today or tomorrow. Before your new day starts, “today” is still the day before. |
@mon … @sun, or @friday |
Due on the next such day. On a Friday, @fri means next Friday, not today. |
@30sep or @sep30 |
Due on that date: this year, or next year if it’s already gone by. |
@2026-10-01 |
Due on that exact date. |
@someday |
No due date. |
@7pm @7:30am @19:00 |
A due time. A time with no date means today. |
~daily ~weekly ~fortnightly ~monthly ~yearly ~weekdays |
Repeats on that schedule. |
~3days ~2weeks ~2w ~6months |
Repeats every so many days, weeks, months or years. |
~2d, ~eod or ~otherday |
Repeats every second day. |
~wed or ~mon,thu |
Repeats weekly, on those days. |
~2wed |
Repeats every second Wednesday. |
*2 … *12 |
Takes that many ticks before it’s done. See Tasks that take several ticks. |
A repeat with no date starts today, or on a weekly rule’s first day if today isn’t one of its days. There’s more on repeats, including rules the shorthand can’t write, in Repeating tasks.
A new task with a due time gets your default reminders straight away. Out of the box that’s one at the due time by push and in-app, and one an hour before by push.
How the List is grouped
Section titled “How the List is grouped”Tasks are grouped by their due date, in this order:
| Group | What it holds |
|---|---|
| Overdue | Due before today. The group only shows when something is in it. |
| Today | Due today. Empty, it says Nothing due today. |
| Upcoming | The next seven days, with a heading for each day (Tomorrow, Saturday, Thu 1 Oct). Folds. |
| Later | More than a week away. Folds. |
| Someday | No due date. Empty, it says No undated tasks. Folds. |
| Paused | Repeating tasks you’ve paused, shown only when there are some. Folds. |
| Done today | What you’ve finished today, at the bottom. Folds. |
Overdue and Today are always open. Every other group starts folded, showing just its name and a count; select its heading to open or close it. The List remembers which groups you’ve opened on each device, and a task moving into a folded group, such as a repeating task’s next occurrence after you tick it, leaves the group folded rather than jumping down to it. Likewise, a task you add to a folded group shows by flashing that group’s heading.
“Today” here is your day, which starts at the hour set in New day starts at (3:00 unless you change it). Until then, yesterday’s tasks stay in Today rather than moving to Overdue, and anything you finish still counts as done that day.
Within a group, tasks are sorted by priority first, then by due date, then by time, then oldest first. You can’t drag tasks into your own order on the List; the Board is where cards keep a manual order.
A brand-new account’s List says Nothing here yet. Add your first task above. Above the quick-add bar is the welcome card, and until it’s gone, the top of the page says Welcome. Let’s get started. instead of the greeting and today’s progress.
What a row shows
Section titled “What a row shows”Each row has a checkbox, whose ring is coloured by priority, then the title, then whatever applies:
- In progress, if you’ve started it.
- The priority marker: ! for Low, !! for Medium, !!! for High.
- Its tags.
- Its repeat, like Weekly or Every other day, and its streak (🔥 4) once it has been done more than once in a row.
- How many of its ticks it has had, like 1/3, if it takes several.
- Checklist progress, like 2/5.
- A bell if it has reminders, and a page if it has notes.
On the right is when it’s due. In Today and Upcoming that’s the time, if it has one. In Overdue and Later it’s the date in words, like 3 days ago or Thu 8 Oct.
With a mouse, hovering over a row that isn’t started yet (or moving to it with the keyboard) shows a Start button just left of the due time. Select it to mark the task In progress. On a touch screen, use Start in the row menu instead.
Select a task’s title to open it in full. See A task in full.
The row menu
Section titled “The row menu”The ⋯ at the end of a row offers what makes sense for that task:
- Start, or Back to To Do on a task that’s already in progress. It’s the same as pressing S. On the Board, Start moves the card into In Progress.
- Missed it: a repeating task that’s due or overdue. See Missed it.
- Reschedule…: move it to another day. See Rescheduling.
- Pause…: repeating tasks only. Resume takes its place while it’s paused.
- Open: the same as selecting the title.
- Delete.
Filtering
Section titled “Filtering”The row of chips above the groups narrows the List. Filters combine, so you can show High priority tasks tagged work.
- All clears every filter.
- Tags opens a menu of your tags. Pick one to show only tasks with that tag; it then shows as a chip of its own beside the menu, and selecting it again clears it. Edit tags at the foot of the menu opens the Tags page.
- !!! High shows only High priority tasks.
- In progress shows only tasks you’ve started.
The filters are part of the page’s address, so a bookmarked or reloaded List keeps them.
Finishing a task
Section titled “Finishing a task”Tick the checkbox. The row strikes through, there’s a burst of confetti from the checkbox, and a toast says something like Great job! Task completed. After a moment the row folds away into Done today.
Bigger moments get bigger celebrations:
- Finishing a High priority task gets a bigger burst, and a toast like High-priority task completed.
- Finishing the last thing due today gets a shower of confetti, and a toast like Everything due today is done.
- Reaching a day-streak milestone (5 days, 15, 30, 60, 100 and on up to 365) gets the shower too, and a toast like 15-day streak. Well done.
You can turn the confetti down or off, and turn on sound, in Effects and sound.
A repeating task doesn’t fold away for good. Its occurrence goes into Done today, and the task moves on to its next date. See Repeating tasks.
Ticking a task with unticked checklist steps is fine: a checklist is a guide, not a gate.
Tasks that take several ticks
Section titled “Tasks that take several ticks”Some things want doing more than once before they count: brushing your teeth twice, three glasses of water. A task can take anything from 2 to 12 ticks. Set it with *2 (or *3 and so on) in quick add, or with Times on the task; see Times.
The task’s checkbox ring is split into that many arcs, and each tick fills one. The first tick moves the task to In progress. Every tick but the last gets a small burst and a toast like 1 of 2 done., with Undo; only the last one finishes the task, with the full celebration. The row shows how far it’s got, like 1/2.
A few things finish it however many ticks are left: choosing Done as its status, or dropping its card into Done on the Board. Moving it back to To Do keeps the ticks it has. Unticking a finished one takes it back one tick short, In progress.
On a repeating task, the ticks are for each occurrence, and each new one starts again from none.
Finishing, one tick of a task that takes several, deleting, rescheduling, and a repeating task’s Missed it, Pause and Resume each show a toast with Undo. The toast stays for about eight seconds. Undo puts things back exactly as they were, including any checklist steps that were ticked, and says Restored.
To un-finish something later, open Done today and untick it. For older tasks, use Re-open in the Stats history.
