Tasks

FoldNotes has rich task support with four states, due dates, priorities, project tracking, and a kanban-style Task Board.

Task Syntax

Tasks are lines starting with a checkbox:

- [ ] Not started
- [/] In progress
- [x] Done
- [-] Cancelled

Click a checkbox to cycle through states: Not Started → In Progress → Done → Cancelled → Not Started.

When a task is marked as done, FoldNotes automatically adds a done: date.

Task Metadata

Add metadata after the task text using key:value syntax (no spaces around the colon):

- [ ] Review draft due:2026-04-15 priority:high
- [x] Send report done:2026-04-03
- [ ] Call dentist due:2026-04-10 priority:low
- [ ] Deploy feature project:alpha due:2026-04-20

Due Dates

due:YYYY-MM-DD sets a due date. Tasks become overdue after 5 PM on the due date in your local timezone. Overdue tasks are highlighted in the sidebar task indicator.

You can also set due dates via the command palette: place your cursor on a task line, type /, and select Due Date to open a date picker.

Priorities

priority:high, priority:medium, or priority:low sets the task's priority level. High-priority tasks are marked with !! in task lists.

Completion Dates

done:YYYY-MM-DD is added automatically when you check a task. It's removed if you uncheck it.

Projects

project:name assigns a task to a project. Projects are used for filtering in the Task Board and CLI:

fn tasks --project alpha          # Tasks in the "alpha" project

Task Indicators

The sidebar shows a task circle next to notes that contain tasks:

• Green arc — completed tasks
• Blue arc — remaining active tasks
• Red arc — overdue tasks

The label shows the count (e.g. "3/7" meaning 3 done out of 7 total).

Task Board

The Task Board (macOS) provides a kanban-style view of tasks across your entire collection. Open it with Shift+Cmd+B or View > Task Board.

Grouping modes

The board supports four grouping modes, selected from the toolbar:

Mode	Columns
Status (default)	Not Started, In Progress, Done, Cancelled
Priority	High, Medium, Low, None
Due Date	Overdue, Today, Tomorrow, This Week, Later, No Date
Project	One column per project, plus a "No Project" column

Card actions

• Drag cards between columns to change task status (when grouping by status)
• Click a card to jump to its location in the editor
• Multi-select with Cmd click or Shift click for range selection
• Cards show due date, priority, and project pills alongside the task text

Sorting

Within each column, cards can be sorted by:

• Due date (default)
• Priority (highest first)
• Source note (alphabetically)
• Status (when not grouping by status)

Calendar overlay

Toggle the calendar overlay to see tasks plotted on a monthly calendar, grouped by due date. Navigate between months and click a day to filter the task list.

Filtering

Use the filter bar to narrow tasks by status, project, tag, or a text search.

Inspector Tasks Tab

The Inspector's Tasks tab shows all tasks from the current note, grouped by status. Click a task to jump to its location in the editor. This gives you a birds-eye view of your to-do items.

Cross-Note Task Queries

Use the command line tool to query tasks across all notes:

fn tasks --overdue              # All overdue tasks
fn tasks --due-today            # Tasks due today
fn tasks --priority high        # High priority tasks
fn tasks --note "Project Plan"  # Tasks in a specific note
fn tasks --status in-progress   # Filter by status
fn tasks --project alpha        # Filter by project

Task Notifications

FoldNotes can send system notifications when tasks are due. See Task Notifications for details.