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

# Tasks

> The work tracked for your agents in one list, as a table or a board, with each task's card, runs and timeline.

**Tasks** shows the work tracked for your agents by the [tasks capability](https://docs.agenium.io/capabilities/tasks.md): one list across agents, each task's card with its description, fields, runs and timeline, and a jump from a run to its session.

An agent whose tasks capability is off, or which holds no granted tasks connection, simply contributes no tasks; its page says so quietly and leads to the capability's view, where **Give access** grants one.

## Table or board

Choose either in the toolbar.

* The **table** has a column per fact: the title with a second line, status, assignee, when the task was created, when it is due to be picked up, and its type. Choose which columns show. Sort by clicking a column header. Where the columns do not fit, the whole table scrolls sideways; drag the title column's edge to set its width, and double-click the edge to return it to fitting.
* The **board** has a fixed-width column per status and scrolls sideways.

Under each title a quiet line shows the project, then marks: **Blocked** while a task it waits on is still open (press it to open that task), a count of the task's runs, and its cost when above zero.

The agent's icon on rows and cards is small or large, as you choose in [Settings > Tasks](https://docs.agenium.io/app/settings.md#tasks).

## Filters

* **Status**: one button with a list inside. Choose any set of statuses, or a preset: **All active** (To do, In progress, Waiting; the default) or **All ended** (Complete, Closed).
* **Period**: the last 24 hours, 7 days, 30 days (the default), or all time, by when a task was last updated.
* **Search**, last on the right.

A counter shows how many tasks are shown of all. While a change is applied, a thin line runs along the top of the list and the rows already shown stay, slightly dimmed, until the new ones replace them.

## A task's card

Pressing a task opens its card over the right side of the list; the list keeps its width, and you can pick another task beside the card. Drag the card's left edge to size it.

* **Top bar**: the task's id (its last 12 characters, the whole id copied on press), a **Discuss** split button, and close. **Discuss** starts a new session about the task in its agent's folder, its composer opening with the task's id for you to add a question.
* **Header**: the title, the project, the assignee, the status, the run count, the cost and the type.
* **Objective** and **Description** in full.
* **Fields**: who created it, when it was created and updated, when it is due and was last touched, tags, what blocks it, and any other field the tasks capability adds. **Metadata** follows as its own list. Values worth copying, such as a branch or a link, show a copy button on hover.
* **Runs**, oldest first: when each started, the worker that ran it, a status tag when it did not end well, the model, turns, cost and duration. Pressing a run opens its session in [Sessions](https://docs.agenium.io/app/sessions.md). A run working now carries a breathing dot and its duration counts live.
* **Timeline**: the task's activity and its field changes in one line, oldest first. An update shows each changed field with its old and new value. **Expand** / **Collapse** opens or folds every entry.

> [!NOTE]
>
> Tasks is read-only in Agenium today. Commenting on a task and changing its status from the app are planned. Agents and the tasks command line change tasks; `tasks help` gives its reference.


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