Tasks

The atomic unit of work in Atlas.

Overview

Tasks carry everything a unit of work needs: title, description, priority, status, due + start dates, estimates, assignees, labels, attachments, threaded comments, dependencies, subtasks, custom links, recurrence, reminders, and approval state. Every view in Atlas renders tasks one way or another.

Highlights

Subtasks with auto-propagating parent status (batch 36)
Custom tenant-defined relation kinds (blocks, derives from, enables - anything your team calls it)
Recurrence via simple enum or RRULE-style custom rules
Approval workflow (PENDING APPROVED | REJECTED)
Deterministic my-day scoring picks your Today's Focus without an LLM

Important to know

Status values are lowercase strings (todo, in_progress, done, blocked). Custom swimlanes add their own keys.
Versions are opt-in optimistic-lock. If you PATCH with a stale version the API returns 409.
Archived ≠ deleted. Archive hides from default views; delete is a soft-delete with a 30-day grace.

How to use it

Press ⌘K and type the task title to create or jump.
Open the detail drawer to set priority, add comments, link subtasks, attach files.
Assign a recurrence rule to have the task spawn a follow-up every time you mark it done.

FAQ

Why does my parent task auto-close when I mark the last subtask done?

Atlas propagates parent status forward: when all subtasks hit a "done" status, the parent closes automatically. The reverse never happens - marking a subtask back to todo never re-opens a closed parent. You can always manually reopen the parent.

Can I block a task with multiple others?

Yes. Use the Dependencies section for the canonical BLOCKS/DUPLICATES/RELATES set, or the Links section for custom tenant-authored relations (Settings Relation kinds).

How do I see tasks I'm blocked on right now?

Use the Views page, group by status, and look at the "blocked" swimlane - or run a Cmd-K scope search: `t blocked`.

All docs