Organize tasks

The project task list shows task number, title, task type, Plan and optional Sprint and Milestone membership, state, labels, dependencies, size (Mass for Coding agent tasks or Weight for Person tasks), assignee, and recent activity so you can decide what needs attention.

Current Plan, Sprint, and Milestone links share a compact style in the Planning column at every screen width. Select a link to inspect that record, or select the rest of the row to open the task. Sprint and Milestone links appear only when that feature is enabled. Their current membership is independent from the task's Plan, and completed participation stays in task history.

Resize a task-table column by dragging its header handle, or focus the handle, press Enter, use the arrow keys, then press Enter or Tab to finish. Widths are remembered in this browser for that table layout. Reset column widths restores the defaults without clearing filters. All enabled columns remain available; scroll horizontally when they need more room.

Task rows and details use a subtle task-type icon to distinguish work that shares a state. Hover over or focus the icon to read Coding Agent Task or Person Task. Person tasks appear in these same views, with In progress in the state filter; task type does not add a separate filter or change saved views.

Select a Tasks summary card to filter the list to that state. Working selects both Agent working and In progress; Closed shows Closed tasks only. Select the card again or choose Clear state filter to return to all states while preserving other filters. Clear all resets every task filter.

The Tasks summary shows six counts: Backlog, Queued, Working, Reviewing, Done, and Closed. Working combines Agent working and In progress. Project home's Project pulse uses the same combined Working count and shows Waiting on dependencies instead of Closed. Task rows and state filters keep Agent working and In progress separate.

On project home, Your work shows tasks assigned to you in Agent working, In progress, or Reviewing. Active work includes project-wide active tasks. Agent working and In progress share priority, followed by Reviewing and Queued; local approval waits stay first. Within each priority, newer updates come first, then the task number. Your work puts Reviewing first.

Use Search tasks above the list to find task numbers, words, or partial words in task titles and descriptions. Search ignores case, trims surrounding whitespace, and treats repeated spaces or line breaks as one space. Every space-separated term must appear somewhere in the task number, title, or readable description; terms can match across those fields. For example, #246 timeout can match task #246 with a description containing “timeouts.” Repeating a term does not require another occurrence, and punctuation is matched literally.

Description search includes readable Markdown text, link labels, and code. Formatting characters and hidden link destinations are excluded; a URL displayed as an autolink is searchable. Enter a number with or without its visible # prefix. Search does not look in labels, assignees, Plan names, comments, or work-run content.

Search combines with all selected filters before sorting and pagination. The state summary counts still describe the full project task set. Clear search removes only the search and returns to page one, preserving your other view choices.

Open Filters above the task list to see the labeled state, Plan, Sprint and Milestone (when enabled), dependency status, and label controls. The filters start collapsed, and your expanded or collapsed choice is remembered locally for each project. Choices update the list immediately. The Filters button shows the number of active filter categories, and Clear all remains available while filters are collapsed. Disclosure is not part of a shared view.

The searchable Plan filter lets you combine Unplanned, Incomplete plans, Complete plans, and individual active Plans. These Plan choices use match-any behavior with each other, then combine with label and other filter choices. Choose All Plans to reset only Plan filtering. The state filter follows the lifecycle in Understand the task workflow. The normal task view excludes Closed tasks. Turn on Show closed to add them to the list alongside whatever the other filters match: with no states selected you see all active tasks plus Closed tasks, and with states selected you see those states plus Closed tasks. Clear all turns it off again.

When Milestones are enabled, the Milestone filter selects one current Milestone, No Milestone, or All Milestones. It combines with search, Plan, state, labels, and dependency filters. Compact numbered Milestone links appear in the task's planning metadata. Filtering uses current membership; completed historical membership remains available through View Milestone change history on task details after current membership clears. Disabling Milestones hides its filter and row metadata and removes that feature's filter from the address without clearing the other view choices.

The list opens with the newest task numbers first. Select an available column header to sort, choose Tasks per page for 10, 25, or 50 tasks, and use the pagination controls to move through the results. Changing search, a filter, sort, or page size returns to the first page. Clear all resets search, every filter, task-number descending sorting, the first page, and 10 tasks per page.

Copy the page address to share the current search, filters, sort, page, and page size with someone who has access to the project. Search is stored in the q address parameter, and closed=1 preserves Show closed. Older links that use state=Closed open with Show closed turned on. Refreshing the page restores that view. Use your browser's Back and Forward controls to revisit earlier choices, including returning from a task detail page. Opening Tasks from navigation without view parameters restores your last saved view for that project.

An explicit view in the address takes precedence over your saved browser preference, including an explicit default view. Changes you make are remembered locally for that project and are also written to the address. Invalid choices are reset safely, unavailable labels and active Plans are removed after their lists load successfully, and a page beyond the results moves to the last available page. A failed filter-list load retains the address so refreshing can retry without losing those choices. Shared links do not grant project access.

When Sprints are enabled, the searchable Sprint filter offers All Sprints, No current Sprint, and numbered Planned, Current, and Complete records. Select several choices to match any of them; the result then combines with search, state, Plan, labels, and dependency filters. A specific Sprint matches current or retained previous membership. No current Sprint also includes tasks with previous Sprint history. All Sprints resets only this filter, and Clear all resets it with the other view choices.

Sprint choices are preserved in the page address and your saved project view. Unavailable choices are removed only after the Sprint list loads successfully; a failed load preserves them for retry. The compact task metadata links only its current Sprint. Task details and the edit page keep previous participation and recorded changes behind View Sprint change history beside the Sprint heading. The Sprint and Milestone dialogs share record search, change filters, expandable details, and direct paging. Completing a Sprint returns unfinished active tasks to Backlog and clears current Sprint membership while those historical identities remain discoverable.

When the project disables Sprints, the filter and row metadata disappear and Sprint URL choices are removed. Hidden Sprint choices do not restrict task results. Plan and Milestone membership remain independent.

Unplanned means the task has no Plan membership. Complete plans have at least one actionable task and every actionable task is Done. Closed tasks are excluded from the actionable denominator, so a mix of Done and Closed can be complete, while an all-Closed Plan is not. Incomplete plans contain at least one actionable task that is not Done. A task in an archived Plan remains visible under All Plans and is not included in Unplanned or the active-Plan completion choices; open its compact Plan metadata or task detail to follow the archived Plan link.

Choose Has incomplete dependencies to find tasks that are waiting on direct prerequisites. A dependency is complete only when its task is Done. A Closed dependency remains incomplete: reopen it to resume work and complete it, or remove or replace the dependency relationship before it stops blocking work. To find work ready to claim and queue, filter task state to Backlog and dependency status to No incomplete dependencies. The task detail also shows both its dependencies and active tasks that it blocks.

Hover over or focus the incomplete-dependency count in a task row to see its prerequisites. Move into the card to follow a dependency link; the card stays open while the pointer or keyboard focus is within the count or card. Press Escape or click outside to dismiss it. Plan task tables and Task Builder draft tables use the same interaction.

• Use an assignee to make responsibility visible; an unassigned task has no current owner.
• Use a Plan for one durable named grouping. A task can belong to only one Plan at a time.
• Use a Sprint for day-to-day timeboxed work and a Milestone for a dated outcome. Each membership is optional and independent of the other feature and the Plan.
• Use the task state to show where work is in the lifecycle.
• Use Mass to communicate the expected human review difficulty. It does not represent implementation duration or priority.
• Use labels for categories, areas, or initiatives that people need to filter. Project and inherited organization labels can both appear on a task.
• Use dependencies for actual ordering constraints, rather than for a loose relationship between tasks.

Open a task to edit this metadata, read its Markdown, add a general comment, or move it into the queue.