Getting Started
Last updated: 2026-08-28
A quick overview of how ToDone works and how to get the most out of it.
Tasks
A task is the core unit of work. Each task has a title and can optionally include:
- Body — markdown-formatted notes or description
- Priority — Urgent, High, Medium, Low, or Lowest
- Due date, scheduled date, and start date
- Duration — estimated time in minutes (used for calendar blocking)
- Category — for grouping related tasks
- Recurrence — repeating patterns like "every week" or "every Monday"
Quick-add syntax
When creating a task, you can use inline shortcuts:
@Workassigns the task to the "Work" category#highsets the priority to High
For example: Review PR #42 @Work #high
Stages
Stages represent your workflow columns — like TODO, DOING, and DONE. They appear as columns in the Kanban view.
- Each stage has a name, color, and position.
- One or more stages can be marked as complete — moving a task there sets its completion date automatically.
- You can customize your stages in Settings.
Categories
Categories let you group tasks by project, area, or context. Each category has a name and color. You can filter tasks by category and view them in the Category Focus view.
Views
ToDone offers ten views, switchable via the toolbar or keyboard shortcuts 0–9:
| View | Description |
|---|---|
| Now | Curated short-list of pinned tasks, with related work grouped underneath each one |
| Dashboard | Insights and analytics for your workspace |
| Today | Inbox of recently added tasks, plus due/overdue tasks and a time-blocked calendar |
| Timeline | Tasks laid out chronologically |
| Gantt | Tasks laid out as a Gantt chart against their dates |
| List | All tasks in a flat, sortable list |
| Kanban (Status) | Tasks grouped by stage in columns |
| Priority | Tasks grouped by priority level |
| Kanban (Category) | Tasks grouped by category in columns |
| Category Focus | Deep-dive into a single category |
Calendar Blocking
If you connect Google Calendar, you can block time for tasks directly from ToDone. The app will find open slots on your calendar and create events for you.
Calendar blocking requires signing in with Google (SSO). It is not available for email/password accounts.
Importing Tasks
You can import tasks from markdown files using the Obsidian Tasks format. Use the import modal (press I) or the API endpoint.
The importer understands priority emojis (🔺 ⏫ 🔼 🔽 ⏬), date signifiers (📅 ⏳ 🛫), and recurrence patterns (🔁).
API Access
ToDone has a full REST API for automation and integrations. Create an API key in Settings and see the API Reference for details.