Quick Add Syntax

Quick Add Syntax

Create tasks with metadata in a single line using special syntax.

---

Syntax Overview

Syntax	Meaning	Example
#tag	Add a tag	#work, #bug
!priority	Set priority	!urgent, !high
due:date	Set due date	due:tomorrow
sched:date	Set scheduled date	sched:monday
@project	Assign to project	@Work

---

Complete Example

Fix login bug #bug #security !urgent due:today @Backend

This creates:

• Title: "Fix login bug"
• Tags: bug, security
• Priority: Urgent
• Due: Today
• Project: Backend

---

Tags (#)

Add one or more tags with #:

Review PR #code-review
Update docs #docs #frontend #priority

---

Priority (!)

Set priority level:

Syntax	Priority
!urgent	Urgent (!!!!)
!high	High (!!!)
!med or !medium	Medium (!!)
!low	Low (!)

Fix crash !urgent
Refactor code !med
Update readme !low

---

Due Date (due:)

Set when the task should be completed:

Submit report due:friday
Call client due:tomorrow
Review due:2025-01-15

Date Keywords

Keyword	Meaning
today, tod	Today
tomorrow, tom	Tomorrow
yesterday	Yesterday

Weekdays

Keyword	Example
monday, mon	Next Monday
tuesday, tue	Next Tuesday
wednesday, wed	Next Wednesday
thursday, thu	Next Thursday
friday, fri	Next Friday
saturday, sat	Next Saturday
sunday, sun	Next Sunday

Relative Dates

Syntax	Meaning
in 3 days	3 days from now
in 2 weeks	2 weeks from now
in 1 month	1 month from now

Period References

Keyword	Meaning
next week	Same day next week
next month	Same day next month
next year	Same day next year

End of Period

Keyword	Meaning
eow	End of week (Sunday)
eom	End of month
eoy	End of year

Specific Days

Syntax	Meaning
1st, 2nd, 3rd	Day of current month
15th, 22nd, 31st	Day of current month

ISO Format

due:2025-01-15
due:2025-12-31

---

Scheduled Date (sched:)

Set when you plan to work on the task:

Start project sched:monday
Review code sched:next week

Uses the same date keywords as due:.

---

Project (@)

Assign to an existing project:

New feature @Frontend
Fix bug @Backend
Write tests @Testing

Note: The project must already exist.

---

Examples

Bug Report

Login fails on mobile #bug !high due:today @Backend

Meeting Prep

Prepare Q4 slides #meeting #presentation due:friday @Work

Personal Task

Buy groceries #errands due:tomorrow @Personal

Scheduled Work

Research new framework #research sched:next monday @Frontend

Multiple Tags

Update API docs #docs #api #backend !med due:eow

---

Tips

1. Order doesn't matter - Put syntax anywhere in the line
2. Title is extracted - Everything not recognized as syntax becomes the title
3. Multiple tags - Use multiple #tag entries
4. Case insensitive - !HIGH and !high both work
5. Partial matching - !urg works for urgent

---

Quick Capture Mode

Quick Capture (Ctrl+N) provides an enhanced task creation dialog with:

• Live syntax hints as you type
• Visual confirmation of parsed metadata
• Larger input area for complex tasks

Using Quick Capture

1. Press Ctrl+N to open Quick Capture
2. Type your task with quick add syntax
3. See hints update as you type
4. Press Enter to create the task
5. Press Esc to cancel

Syntax Hints

The dialog shows:

• #tag - Tag syntax reminder
• !priority - Priority levels (!urgent, !high, !med, !low)
• due:date - Date keywords (today, tomorrow, monday, etc.)
• @project - Project assignment

Example Session

┌─────────────────── Quick Capture ───────────────────┐
│                                                      │
│ Fix login bug #security !high due:tomorrow @Backend │
│                                                      │
│ Hints: #tag  !priority  due:date  @project          │
└──────────────────────────────────────────────────────┘

---

See Also

• Task-Management - Full task operations
• Projects - Creating and managing projects
• Tags - Working with tags