> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gloo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tasks

> Review project tasks across the workspace and narrow the list to the work that needs attention.

Use **Planning → Tasks** (`/planning/tasks`) to assign and advance work across projects. Reading requires `projects:read`; assignments and status changes require the applicable project-management authority. The board is a planning view, distinct from the personal attention queue in [My Work](https://docs.gloo.com/forge/console/my-work.md).

![Tasks (light)](https://mintcdn.com/gloo-b243725a/xyq5perq6SLByPBn/forge/images/console/planning/tasks-light.png?fit=max\&auto=format\&n=xyq5perq6SLByPBn\&q=85\&s=aa3d8e8119ef0b779852950e1e400e4d)

Tasks — Forge Console at `/planning/tasks`

## What you can do

* Narrow the board by project and priority, and show or hide cancelled work. See [Find the work to act on](#find-the-work-to-act-on).
* Assign a task to a person or an agent. See [Assign a person or agent](#assign-a-person-or-agent).
* Move a task through the transitions its current state allows. See [Change status](#change-status).

## Find the work to act on

1. Choose a project from **All projects** or leave the whole visible project set selected.
2. Choose **Urgent**, **High**, **Medium**, or **Low** from **All priorities** if you need to narrow urgency.
3. Review the board's **Ice Box**, **Backlog**, **Ready**, **Assigned**, **In Progress**, **Blocked**, **In Review**, and **Complete** columns.
4. Use **Show cancelled** to include the **Cancelled** column. **Hide cancelled** removes it again.
5. Choose **Clear filters** to reset the project and priority filters.

The current page reads a bounded set of up to 200 tasks and up to 100 projects. It is not an exhaustive export. A missing card can reflect the loaded set, filters, cancellation visibility, or your readable scope.

## Assign a person or agent

Open a card's assignee control, search workers, then choose from **People** or **Agents**. Directory search requires `workforce:read` separately from project access. Assignment still checks authority over the task; seeing a worker in the directory does not authorize a change.

Verify that the card reflects the intended assignment. Use the project chip to open its project context. The page does not provide a separate task-detail destination for every card.

## Change status

Use the card's status selector. It shows the current state and only the transitions supported from that state; the full board is not a menu of arbitrary moves. After saving, confirm the card appears in its new column.

If a transition is refused, read the error banner and refresh the current task state before repeating it. Another operator may have moved the task since you opened the selector.

## Key state to watch

* **The bounded set** — the board reads up to 200 tasks and 100 projects, so a missing card may be outside it.
* **A refused transition** — another operator may have moved the task; refresh before repeating it.

## Empty and error states

| State | Next step |
| - | - |
| **No tasks match the current filters** | Choose **Clear filters**, then check cancelled visibility. |
| **No tasks yet** | Tasks are created through Factories or the Forge API; this board does not provide a new-task form. |
| Worker picker has no directory | Check `workforce:read`; task access and worker-directory access are separate. |
| Assignment or transition fails | Retain the displayed error, check project authority, and reread the current state before retrying. |
| Board stays in loading/error state | Retry the contained Tasks region after the connection recovers. |

See [Projects](https://docs.gloo.com/forge/console/planning/projects.md), [Factories](https://docs.gloo.com/forge/console/production/factories), and [My Work](https://docs.gloo.com/forge/console/my-work.md).

## Related surfaces

* [Projects](https://docs.gloo.com/forge/console/planning/projects.md): the project a task belongs to.
* [My Work](https://docs.gloo.com/forge/console/my-work.md): the tasks assigned to you.
* [Blockers](https://docs.gloo.com/forge/console/planning/blockers.md): tasks that cannot move.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.