Syntax help & examples
Need help writing a filter?
If you'd rather ask an AI to draft an expression for you, copy a self-contained briefing — grammar, helpers, and a real sample task — into your chat of choice:
Common task fields
task.title |
string |
|---|---|
task.completed_at |
ISO datetime, or null if open |
task.released_at |
ISO datetime, or null if not released |
task.priority |
Embedded priority — {id, name, position, color} or
null. Compare on position (1, 2, 3…) since it
survives renames; name doesn't.
|
task.energy |
Embedded energy — {id, name, position, color} or
null
|
task.category |
Embedded category — {id, name} or null |
task.waiting_on |
Embedded waiting-on entry — {id, name} or
null
|
task.tags |
array of {id, name}; use task.hasTag("name") for
membership
|
task.deadline |
ISO datetime, or null |
task.progress |
0–100, or null |
task.recurrence |
rule object or null |
task.eisenhower_urgent |
true / false / null |
Inspect a real task
The complete shape — including custom metadata keys you've added — lives on each task. Two ways to see it:
- Open any task and click Copy in the modal header to grab its JSON.
- Skim the live sample below — pulled from the first task in your list:
(loading…)
Task methods
task.isOverdue() |
true if deadline < now and task isn't completed |
|---|---|
task.inCategoryTree(name) |
true if the task's category is, or descends from, a category named
name
|
task.hasTag(name) |
true if the task carries a tag with that name |
task.isWaitingOn(name) |
true if the task is waiting on that entry |
task.isSubtask() |
true if the task is a child of another task |
Date helpers
today() |
today as YYYY-MM-DD (local time) |
|---|---|
daysFromNow(n) |
n days from today; negative for past |
Operators & methods
Comparisons: === !== == !=
< > <= >=
Logical: && || !
?? · Ternary: a ? b : c
String / array methods: .includes(x) .startsWith(x)
.endsWith(x) .toLowerCase()
Arithmetic, assignments, function calls outside the date / task helpers and
value methods above, regex literals, and any identifier other than
task are rejected.