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

# Tasks overview

> Standalone work units assigned to agents

A **task** is a unit of work: title, markdown instructions, optional input files, and an assigned **agent**. The Bridge executes the task in the agent workspace; results stream back to the app.

## Where tasks live

| View           | Route                                  |
| -------------- | -------------------------------------- |
| Board (Kanban) | `/projects/{projectId}/tasks`          |
| List           | `/projects/{projectId}/tasks/list`     |
| Detail         | `/projects/{projectId}/tasks/{taskId}` |
| Create         | `/projects/{projectId}/tasks/new`      |

## Sources of tasks

| Source           | How it appears                                             |
| ---------------- | ---------------------------------------------------------- |
| **Manual**       | You create from dashboard, setup wizard, or **+ New task** |
| **Routine run**  | One task per scheduled or manual run                       |
| **Workflow run** | One task per active step in the graph                      |

## Agent execution flow

1. Task moves to **Inbox** (ready for the Bridge)
2. Bridge picks it up → **In progress**
3. Terminal state: **Done**, **Blocked**, or **Failed**
4. Optional: **Archive** when finished

<CardGroup cols={2}>
  <Card title="Kanban & states" icon="columns" href="/tasks/kanban-and-states">
    Columns, transitions, and action buttons.
  </Card>

  <Card title="Task detail" icon="file-lines" href="/tasks/task-detail">
    Instructions, artifacts, agent card, workflow link.
  </Card>
</CardGroup>

## Requirements

* **Bridge connected** to dispatch and receive updates
* At least one **agent** in the project