Milestones
Checkpoints within a project, with progress calculated automatically from task status.
A milestone is a checkpoint within a project — a meaningful grouping of tasks such as "MVP", "Beta", or "Launch".
Fields
| Field | Meaning |
|---|---|
| Title | The milestone name. |
| Description | What the milestone represents. |
| Target date | When the milestone is due. |
| Status | Not Started, In Progress, Completed, or Blocked. |
| Progress | A 0–100 percentage, calculated automatically. |
Progress is automatic
You do not set milestone progress by hand. It is computed from the status of the tasks assigned to the milestone (via each task's milestone_id). As tasks move toward Completed, the milestone's progress rises; as you add or reassign tasks, it recalculates.
This keeps the milestone view honest: it always reflects the real state of the underlying work.
A milestone with no tasks has nothing to roll up. Assign tasks to a milestone (in the app, or via the MCP assign_task_to_milestone tool) to make its progress meaningful.
Working with milestones
- Create milestones to structure a project into phases. AI-generated projects come with 4–6 milestones already.
- Group tasks under a milestone to have them contribute to its progress.
- Reorder / re-date as plans change; the target date is informational and drives scheduling views.
Related
- Tasks — assignment to milestones and the status workflow that drives progress.
- MCP integration —
list_milestones,get_milestone,create_milestone,update_milestone,assign_task_to_milestone.