Todos
A todo is a checkbox line in a note, with its priority, due date, repeat, assignees, and tags written on the same line. This page shows how to write each one, what checking off a repeating todo does, and how to work with the Todos page and daily notes.
Write a todo
Start a list item with a checkbox anywhere in a note outside a code block:
- [ ] !! Call the bank due:2026-10-14 every:1m [[person:Sam Okafor]] #money
Any list mark works (-, *, +, 1.), at any indent. - [x] is a done todo, - [-] one you won't do, and - [>] one put off in the backlog. An abandoned todo is struck through and a backlogged one is dimmed. Both stay in their note and leave the Todos page until you ask for them with is:abandoned or is:backlog. Click either one's box to open it again. The editor draws each option as a chip. Click a chip to change it from a popover instead of typing.
| Part | Written | Notes |
|---|---|---|
| Priority | !, !!, !!! |
Low, Medium, High. Right after the checkbox. With none it is None |
| Due date | due:2026-10-14 |
A calendar date as YYYY-MM-DD, with no time. Typing due: offers the days ahead |
| Repeat | every:2w |
One of the rules below |
| Assignee | [[person:Sam Okafor]] |
A mention on the line. Type @ and a name to write one. A todo can have several |
| Tag | #money |
Tags the todo, and its note. A todo also has the tags over it: see below |
A todo has the tags written on its line and the ones over it, and no other tag of its note:
- A tag in a heading covers everything under the heading, up to the next heading at the same or a higher level.
- A line of nothing but tags covers the rest of its section. Right under the note's title it covers the whole note, and before the first heading it covers the lines up to it.
- A tag in a list item covers the items nested under it.
So in a daily note, #common-ink on a line of its own under Building tags Building's todos and not those under Chores. The note itself has every tag written in it, wherever it is.
The due date's popover offers Today, Tomorrow, Next week, Clear, and a date field. The priority's offers High, Medium, Low, and None.
A due date is a day, so whether a todo is due today depends on your own time zone. A todo is overdue when its due date is before today.
Make a todo repeat
Write every: and a rule. Each rule has one spelling, in lower case, with commas and no spaces. These are the most useful:
| Written | Repeats |
|---|---|
every:1d, every:2w, every:1m, every:1y |
Every N days, weeks, months, or years after the due date |
every:3d-after-done |
N days after you last checked it off |
every:mon,thu |
On those days of every week |
every:mon,tue,wed,thu,fri |
Every weekday |
every:2w-mon |
On Monday of every second week |
every:1st-day, every:15th-day |
On that day of every month |
every:last-day |
On the last day of every month |
every:2nd-tue, every:last-fri |
On that weekday of every month |
every:mar-1 |
On that date every year |
every:1st-mon-sep |
On that weekday of that month every year |
every:1m-times-5 |
Monthly, 5 more times, then it stops |
every:mon-until-2026-12-31 |
Every Monday until that day |
For a rule like every:2w, a todo you check off late moves past the dates you missed, so it is never left overdue. A month too short for every:31st-day uses its last day. Use every:last-day to stay on the month's end.
You don't have to type a rule. The Repeat chip's popover offers Doesn't repeat, Daily, Weekdays, a weekly and a monthly rule from the due date, Yearly, and Custom, which builds any rule as a sentence. Press Done to save.
Check off a repeating todo
Checking off a repeating todo does three things at once:
- The line stays open, with its next due date.
- Its
done:mark records the day and how many times it has been done. - A checked copy of the line, with a link back to its note, goes at the end of your daily note for that day.
- [ ] Water the plants due:2026-10-17 every:1w #home done:2026-10-11x1
- [x] Water the plants due:2026-10-10 #home [[k3j5h8d9f0a1]]
The first line is the todo after you checked it off on the 11th. The second is the copy on your daily note. The result is the same whether you check the box in the note, on the Todos page, or an agent does it.
The Todo completed notice has an Undo button. Undo puts the line back and takes the copy off your daily note. To skip one occurrence without checking it off, open the due date's popover and pick Skip to the next date.
To stop a todo repeating, pick Doesn't repeat, or remove the every: token. A rule with an end, such as -times-5, checks the todo off for good on its last time.
Assign a todo
Type @ on the todo's line and pick a member or one of your contacts. Assigning gives the person no access to the note and doesn't notify them. On the Todos page, press an assignee's chip to change who the todo is assigned to. A todo with nobody has a quiet Assign chip after Add date.
The Todos page
Todos in the sidebar lists the open todos in every note you can see, leaving out notes in Trash. Archiving a note doesn't take its todos off your list: they stay, with "archived" after the note's name. The notice that says so has Backlog them, which moves them all to the backlog, with its own Undo. To leave them off your lists, and your agents', set Todos in archived notes to Hide in Settings, under Todos, or set it to Move to backlog to have them moved each time you archive a note, where one Undo takes back both. In a query, is:archived lists only those and -is:archived leaves them out, whatever the setting says. Each row shows the todo, its chips, and its note's name. Press the note's name to open the note at that line. A tag the todo has from another line, a heading or a list item over it, shows after its own tags, outlined: point at it to see where it is from, and press it to open that line. Press the words to edit them in place. Right-click a row for Open note, Split right, Complete, Abandon, and Move to backlog.
A row's second line shows only what is set on the todo. Point at a row, or give it the keyboard, and the rest shows after it: Abandon, Move to backlog, and a button for each thing not set yet, with Repeat and Priority last. With the keyboard on a row, these keys do the same:
| On a row | On a todo's line in a note, or a row | With vim mode, in both | What it does |
|---|---|---|---|
x |
mod+enter |
gx |
Complete the todo |
- |
mod+shift+enter |
g- |
Abandon it |
> |
mod+alt+enter |
g> |
Move it to the backlog |
The keys with mod, and vim's, are the same on the Todos page and with the cursor on a todo's line in a note. A key alone, such as x, works only on a row, since in a note it is a letter. Press the key for the state a todo is in to open it again. The up and down arrows select the row above or below, and the down arrow in the query bar selects the first row. On a selected row, Space checks the todo off and Enter opens its note. With vim mode on, dd abandons it too, gd and l open its note as Enter does, and j and k move between rows as the arrows do. Going back to the page with ctrl+o selects the row you left, where you left it. When a todo leaves the list, the next row is selected, so you can work down the list. A notice says what happened, with Undo. To keep the todos you put away in sight, turn on Leave todos in place when you check them off under Todos in Settings: each stays where it is, in its new state, until you come back to the page or change the filter. Press ? to see every key, or change them in Settings.
The query bar at the top narrows the list. It reads the same language as search, so assignee:@me due:<=today lists what is yours and due. Advanced builds a query by picking. Sort orders the list by Due date, Priority, Recently changed, Note, or the todo's words. A few queries to start from:
| Query | Lists |
|---|---|
due:<today |
Overdue todos |
assignee:@me |
Todos assigned to you |
priority:>=medium #work |
Medium and High todos tagged work |
has:repeat |
Repeating todos |
is:done updated:>=7d |
Done todos in notes changed in the last week |
is:backlog |
Todos put off in the backlog |
is:open OR is:backlog |
Open todos and the backlog together |
Search lists every filter.
Daily notes
A daily note is your note for one day, headed with the date, as in # 2026-10-11. The app makes it the first time it is needed, such as when you open today's note or check off a repeating todo. It goes in the Daily folder in your Private, which only you see.
A new daily note starts with a list of the notes made that day. The list is a line of the note, /search(created:2026-10-11) with the note's own date, and it keeps itself up to date as you make notes. Change the line, move it, or delete it as you would any other. Search shows what else such a list can hold. A daily note made before this has no list. To give it one, type the same line with its date.
Open it from Today in the sidebar, or with these commands:
- Go to Today
- Open yesterday's daily note and Open tomorrow's daily note
- Open the previous daily note and Open the next daily note, from a daily note
Four settings change how daily notes behave:
| Setting | Default | What it does |
|---|---|---|
daily.folder |
Daily |
The top-level folder new daily notes go in |
daily.private |
true |
Whether a new daily note is hidden from other members |
daily.listMade |
true |
Whether a new daily note starts with a list of the notes made that day |
daily.timeZone |
none, which is UTC | The time zone an agent uses for "today" when it doesn't say the day |
A todo's words are filed only where everyone who reads the daily note can read the todo. That is when your daily note is private and shared with nobody, or when neither note is private and neither they nor their folders have a grant or a share link. Anywhere else the copy is a link alone, without its words.