Projects and tasks

Use projects, tasks, statuses, priorities, assignees, labels, dependencies, milestones, and recurring work.

Projects hold execution work. Tasks are the units that move across board and list views.

Task fields

Tasks can include:

• Title and Markdown description
• Status
• Priority
• One or more assignees
• Project, team, milestone, and labels
• Start date and due date
• Dependencies
• Subtasks
• Attachments
• Recurrence

Statuses

Default statuses are:

Status	Meaning
backlog	Not ready for active work
todo	Ready to pick up
in_progress	Actively being worked
done	Completed
cancelled	Closed without completion

Projects can define custom board columns. The API accepts the project’s configured status values, and cancelled is always valid.

The current CLI validates --status against the default set: backlog, todo, in_progress, done, and cancelled. Use the API for custom project statuses until CLI support is added.

Priorities

Value	Label
0	Urgent
1	High
2	Medium
3	Low

Assignees

Tasks support multiple assignees. Use one assignee when ownership is clear. Use multiple assignees for collaborative work where all participants need notifications and visibility.

Dependencies

Dependencies express blocking relationships. A task can be blocked by another task or can block another task.

Use dependencies when task order matters:

Design approval -> Landing page implementation -> Launch announcement

Atoll rejects circular dependencies and duplicate dependency links.

Recurring tasks

Recurring tasks can repeat daily, weekly, monthly, or yearly. When a recurring task is marked done, Atoll creates the next instance based on the recurrence interval.

Archive before delete

Archive tasks when you want reversible removal from active lists.

Permanent delete is restricted to owners/admins and should be used sparingly.

atoll issue archive ATOLL-42
atoll issue unarchive ATOLL-42