Creating Todos
Todos are the fundamental unit of work in Taskvault. A todo can be as simple as a title, or as detailed as a multi-assignee task with subtasks, tags, dependencies, a start date, a due date, and watchers.
At a glance
- ✓Quick-add with just a title — press N and Enter in under two seconds
- ✓Expand the form to set due date, assignee, priority, tags, and more
- ✓Marking done awards XP and counts toward your daily streak
- ✓Every todo has a permanent shareable URL at /t/[id]
Adding a todo
- 1
Open the quick-add form
In any project's Todos view, click Add Todo or press N. The quick-add form appears at the top of the list.
- 2
Type a title and save
Type the title and press Enter to save immediately with defaults. This is the fastest path — no other fields are required.
- 3
Expand for more fields (optional)
Click the expand icon before saving to open the full form and set due date, assignee, priority, tags, list, milestone, and more.
Todo fields
Title
Required. What the work is.
Description
Rich text area for context, links, or acceptance criteria. Supports @mentions.
Status
todo · in_progress · done · canceled
Priority
Low · Medium · High · Urgent — affects sort order and overdue reporting.
Assignee
Any project member. Assignees are notified when the todo is assigned and when it is due.
Start date
When work should begin. Todos with a future start date stay in the Upcoming section until the date arrives.
Due date
When the work must be done. Overdue todos are surfaced in the dashboard and reports.
Tags
Global, colour-coded labels that can be used to filter across projects.
List
Which named section inside the project this todo belongs to.
Milestone
Links the todo to a project milestone and shows it in the Timeline view.
Watchers
Additional members who receive a notification when the todo is marked done.
Statuses explained
Todo
Work not yet started
In Progress
Actively being worked on
Done
Awards XP + streak credit
Canceled
No XP awarded
✨ Info
done todo revokes the XP credit. XP is awarded once per todo lifecycle to prevent gaming the system.Bulk actions
Select multiple todos using the checkboxes that appear on hover. The bulk action bar lets you mark selected todos as done, cancel them, change their assignee, reschedule due dates, or move them to a different list in one action.
💡 Tip