Skip to content
blastbeat

Quick add syntax

Type one line in Quick add. blastbeat reads the date, time, Priority, Project and Labels out of it, and what is left becomes the Task’s title.

Q
Call dentistFri · 10:00P2Home
Title
Call dentist
Due
Fri · 10:00 (2026-10-16)
Priority
High (P2)
Project
Home
Labels
None
  • Due a date or a time
  • Priority p1 to p4, or !
  • Project #Name
  • Label @name

The demo runs the same parser as the app. Its clock is fixed at Wednesday, 2026-10-14, and its Projects are Launch, Home, Garden, Reading list and Labels are errands, waiting, deep work.

How a line is read

Quick add looks for a few kinds of words and colors each one as you type. Whatever it recognizes leaves the title. Everything else stays in it.

Every blastbeat app uses the same parser, and this page runs it too. Nothing you type here is sent anywhere.

If a kind appears twice, the last one wins. Two dates give you the second date. Two Projects give you the second Project. Labels are the exception: every Label you name is added.

Due dates

Dates count from today in your timezone. These examples use a fixed clock, 2026-10-14, which is a Wednesday.

Due dates
WriteExampleQuick add reads
todayPay rent todayTitle “Pay rent”, Due 2026-10-14 (Wed)
tomorrowCall the bank tomorrowTitle “Call the bank”, Due 2026-10-15 (Thu)
next weekDraft the roadmap next weekTitle “Draft the roadmap”, Due 2026-10-19 (Mon)
mon … sun, monday … sundayReview notes fridayTitle “Review notes”, Due 2026-10-16 (Fri)
oct 28, october 28thRenew passport oct 28Title “Renew passport”, Due 2026-10-28 (Wed)
2026-11-02File expenses 2026-11-02Title “File expenses”, Due 2026-11-02 (Mon)

A weekday means its next turn, and today if today is that day. next week means the coming Monday. A month and day that has already passed this year means next year, so oct 2 typed in October 2026 gives 2027-10-02.

Due times

Due times
WriteExampleQuick add reads
4pm, 9 amStand-up 9amTitle “Stand-up”, Due 2026-10-14 (Wed) at 09:00
16:30Dentist friday 16:30Title “Dentist”, Due 2026-10-16 (Fri) at 16:30

4pm needs am or pm and a whole hour. For minutes, use the 24-hour form, 16:30. A time with no date is due today.

Priority

Priority
WriteExampleQuick add reads
p1Send the invoice p1Title “Send the invoice”, Priority P1
p2, p3, p4Tidy the desk p3Title “Tidy the desk”, Priority P3
!p1 … !p4Book the venue !p2Title “Book the venue”, Priority P2
!!!Fix the login bug !!!Title “Fix the login bug”, Priority P1
!!Reply to the landlord !!Title “Reply to the landlord”, Priority P2
!Order printer ink !Title “Order printer ink”, Priority P3

Priority runs from P1, Urgent, to P4, Normal. P4 is the default, so a line with no Priority has none. !!! is P1, !! is P2 and ! is P3.

Projects

Projects
WriteExampleQuick add reads
#LaunchDraft the post #LaunchTitle “Draft the post”, Project Launch
#Reading listFinish chapter 4 #Reading listTitle “Finish chapter 4”, Project Reading list
#NowhereCall Sam #NowhereTitle “Call Sam #Nowhere”

# names a Project that already exists. The match ignores case and takes the whole name, spaces included, so #Reading list works without quotes. When two names start the same way, the longer one wins.

A #name that matches no Project is not an error. It stays in the title as plain text. Quick add does not create Projects.

A Task goes to the Project you name. With no #name, it goes to the Project you are looking at when you press Q, and to the Inbox if you are looking at something else.

Labels

Labels
WriteExampleQuick add reads
@errandsPick up the parcel @errandsTitle “Pick up the parcel”, Label errands
@deep workOutline the talk @deep workTitle “Outline the talk”, Label deep work
@errands @waitingChase the refund @errands @waitingTitle “Chase the refund”, Label errands, Label waiting

@ names a Label that already exists. Like Projects, the match ignores case and takes the whole name, so @deep work works. A Task can carry as many Labels as you write.

Suggestions

Type # or @ and Quick add lists the matching Projects or Labels. Pick one with ↑ ↓, then Tab or ↵.

After three letters of today, tomorrow, next week or a weekday, Quick add offers to finish the word. Tab accepts it.

Esc closes the suggestions first, and then Quick add.

Adding the Task

↵ adds the Task and closes Quick add. ⇧↵ adds it and keeps Quick add open for the next one.

Below the line, buttons set the Project, Due date, Priority and Labels without typing. The Due date, Priority and Label buttons write their token into the line, so you can see what they did and edit it. The Project button files the Task without one.

Quick add opens with a start already in the line on some pages. On Today it begins with today, on High Priority with p1, and on a Label’s page with that Label.