Files
verdande/docs/quick-add.md
T
Kristian WindandClaude Opus 5 7c9bde2cfd docs(phase6): documentation site, landing page and open-source scaffolding
Material for MkDocs under docs/, covering self-hosting, the Rune, the
quick-add and filter languages, importing from Todoist, CalDAV,
mail-to-task, MCP, the AI layer and the API. The version is pinned: the
maintainers have announced that MkDocs 2.0 removes the plugin system
with no migration path, and an unpinned install would break this build
on the day it lands.

The landing page shows the quick-add parser as actual text rather than a
screenshot of it — that is the thing worth showing, and it reads better
as the real thing. It shares the app's design tokens, so the site and
what it describes look like one project.

MIT licence, contributing guide, security policy and issue templates.
Pages deployment is behind workflow_dispatch, so the docs build on every
push but nothing is published until the owner chooses to.

Co-Authored-By: Claude Opus 5 <[email protected]>
2026-08-17 08:08:36 +02:00

2.7 KiB

Quick add

One line in, a fully-formed task out.

betal moms i morgen kl 10 p1 #Firma @regnskab

becomes a task called betal moms, due tomorrow at 10:00, priority 1, in the Firma project, labelled regnskab.

The parts it understands are tinted underneath the text as you type, so you can see it being read before you commit to it.

What it reads

You type It means
#Firma Put it in that project. #"Q3 rapport" for a name with spaces.
@regnskab Add that label. As many as you like.
p1 … p4 Priority. !!!, !! and ! also work.
i dag, i morgen, i overmorgen Today, tomorrow, the day after.
mandag, på fredag The next such weekday.
næste mandag Next week's Monday, counted from Monday — not merely the next one to come round.
om 3 dage, om en uge, næste måned Relative dates.
15. marts, 15/3, 2026-03-15 Written dates. Day first.
kl 10, kl 14:30, klokken 16 A clock time.
hver mandag, hverdage, hver 2. uge Makes it repeat.

English works everywhere Danish does: tomorrow, next friday, in 3 days, every 2 weeks, at 10am, weekdays.

Mixing the two

ring til Anders on friday kl 14 #Arbejde

Both languages are read at once rather than behind a setting, because people mix them mid-sentence. The only thing the language setting decides is a bare hour after English at: at 3 means three in the afternoon, while Danish kl 3 means three in the morning — Danish has no am/pm habit and the 24-hour clock is what people mean.

Repeating tasks

vand planterne hver mandag
standup hverdage kl 9
betal husleje den 1. i måneden
review every 2 weeks

Stored as an RFC 5545 RRULE, so a task exported to Apple Reminders keeps repeating there.

Ticking off a repeating task moves it to its next occurrence rather than closing it. The same task keeps its id, so its sub-tasks and comments stay attached — a weekly review is one thing that recurs, not fifty-two things. The completion is still recorded, so "what did I get done this week" includes the chores that repeat.

Dates it cannot read

Anything it does not recognise stays in the title. A task with a clumsy title beats an error message and a lost thought.

!!! tip "Numeric dates are day-first" 15/3 is the fifteenth of March. That is how both Danish and British English write it, and guessing month-first would silently move a date by months rather than failing visibly.

The shortcuts

Press ++q++ to jump to the quick-add box from anywhere, ++t++ for Today, ++u++ for Upcoming, ++cmd+k++ to search, and ++question++ for the full list.