Task basics
How tasks work in PerspecTask, covering statuses, priority, sorting, Due Tasks, pinned tasks, Blocked by, search and the free plan limits.
A task in PerspecTask has a title, an optional description, a status, a priority and a place in time: a day, week, month, quarter, year, or your whole life. Tasks nest into subtasks, and one task can sit under several parents. This page covers the parts you use every day.
Statuses
Every task has one of seven statuses. Five are open, two are done.
| Status | Open or done | What it means |
|---|---|---|
| Inbox | Open | The default for a new task. Not sorted into a workflow step yet. |
| Ready | Open | Ready to start. |
| In Progress | Open | Being worked on now. |
| Waiting | Open | Waiting for something, often for you to review it. Agents set this when they hand a task back. |
| Delegated | Open | Handed to someone else. |
| Completed | Done | Finished. Tick the task's checkbox to complete it. |
| Cancelled | Done | Dropped. Press C on the task, or pick "Cancel Task" in the task menu. The same action reactivates it. |
Set an open status from the Status submenu in the task menu, or rest the pointer on the task and press ⇧1 to ⇧5 (Shift+1 to Shift+5 on Windows), in the order of the table. In the API, CLI and MCP server, Inbox is called ACTIVE.
A pinned task in the sidebar shows a badge with the number of its subtasks in Waiting, so work that needs your attention is easy to spot.
Priority
A task has priority 1, 2 or 3, or no priority.
| Priority | Meaning | Color |
|---|---|---|
| 1 | High | Red |
| 2 | Medium | Yellow |
| 3 | Low | Sky blue |
| None | No priority | Neutral (no color) |
Set it from the Priority submenu in the task menu, or rest the pointer on the task and press 1, 2, 3, or 0 to remove it. When you sort by priority, tasks with no priority come after priority 3.
Sorting
A period column, the subtasks in a task's window, and the Task Perspective page each have their own sort button. The choice is remembered for that list.
| Option | Order |
|---|---|
| Manual (drag & drop) | The order you drag tasks into. Other options turn off dragging. |
| Priority (High to Low) / (Low to High) | By priority 1, 2, 3, then no priority (or the reverse). |
| Status (workflow order) | Inbox, Ready, In Progress, Waiting, Delegated, Completed, Cancelled, with priority as the tie-break. |
| Most Important / Least Important | By how many parents a task has, and how many ancestors above those. A task that moves several goals forward comes first. |
| Children (Most to Least) / (Least to Most) | By the number of direct subtasks. |
| Created (Newest) / (Oldest) | By creation date. |
| Name | Alphabetically, A to Z or Z to A. |
The "Keep Completed at the End" setting in the Settings menu keeps finished tasks at the bottom of a list, whichever sort is on. The Bullets page has its own ordering keys, listed in Keyboard shortcuts.
Due Tasks
The Due Tasks page (/due-tasks, "Due Tasks" in the sidebar) lists open tasks whose period has already passed. It has five columns: Daily, Weekly, Monthly, Quarterly and Yearly. A daily task is due once its day is before today, a weekly task once its week is before this week (weeks start on Monday), and so on. Tasks planned for your whole life never show up here.
Each column shows how many tasks it holds and sorts them by date, oldest first. The arrow button flips that to newest first. Move one task to the current period with the button next to it, or move a whole column at once with the button in its header (it asks first). The sidebar shows the total count next to "Due Tasks". Completed and cancelled tasks are never due.
Pinned tasks
Pin a task to keep it in the Pinned group in the sidebar. Press P with the pointer on the task, or pick "Pin to sidebar" in the task menu. Click a pinned task to open it in the kanban view, drag it to reorder the list, or right-click it for the full task menu.
A pinned task with subtasks shows a progress bar under its title. The Pinned Display option in the Settings menu switches every pinned task to an activity strip instead ("Last 9 days + planned"). To change one task only, open its ⋯ menu and pick Display. The same ⋯ menu has Unpin. While encrypted tasks are locked, a pinned encrypted task shows a placeholder instead of its title.
Blocked by
"Blocked by" lists the tasks that should be done before this one. Open it from the task menu ("Blocked by...") or press B with the pointer on the task, then search for a task and add it.
It is a reminder, not a rule. PerspecTask never stops you from completing a task that still has open blockers. A task row shows "Blocked by 2 tasks" while some of its blockers are unfinished. A blocker that is completed or cancelled no longer counts. On the Gantt board, blockers appear as arrows between bars.
Search
Press ⌘K (Ctrl+K on Windows) anywhere to open search. It looks for your words in task titles and descriptions and runs in your browser. Encrypted tasks can only match while they are unlocked.
Type at least 2 characters. A task matches when every word you type appears in its title or description. Open tasks come before finished ones, then exact phrase matches, then the tasks with the most matches. Search shows the first 15 results. With an empty field it shows the 5 most recently created tasks. Esc clears the text, and a second Esc closes search.
Free plan limits
The free plan has two limits:
- 5 direct subtasks per task. Adding a sixth child to the same parent needs Pro.
- 5 tasks per period. A single day, week, month, quarter or year holds at most 5 tasks, and the same goes for your whole-life list. The count includes completed and cancelled tasks in that period.
When you hit a limit, the app shows the upgrade dialog. Neither limit applies during a Pro trial or on Pro.
More on tasks
- Multiple parents: one task under several parents, and how progress rolls up.
- End-to-end encryption: what is encrypted and how locking works.
- Timer and Work Cycles: tracking the time spent on tasks.
- Graph View: a task and its subtasks as a tree.
- Streaks: days in a row with a finished task.
- GitHub integration: linking pull requests to tasks.
- Keyboard shortcuts: every shortcut in the app.