# Task List
No more tab-switching between projects. No more "wait, what's the status on that?" The Task List shows you **everything that's happening across your entire workspace**—with status counts that update in real-time as work moves through your pipeline.

{{< thumbcard src="/images/ui/tasks/task-list-overview.png" alt="Task list with status tabs and filters" caption="51 tasks across 6 projects, filterable in seconds—this is what control looks like" >}}

## What this page covers

- Status tabs for instant workflow filtering
- Project and search filters
- Sortable table columns
- Pagination for large task sets
- Creating new tasks

## Status tabs: your pipeline at a glance

The colored tabs at the top aren't just filters—they're your delivery pipeline visualized:

| Tab | Color | What to watch for |
|-----|-------|-------------------|
| **Backlog** | Purple | Growing too fast? Time to prioritize. |
| **To Do** | Blue | Your sprint commitment. Is it realistic? |
| **In Progress** | Teal | Active work. Too many = context switching. |
| **In Review** | Orange | **Bottleneck alert.** Clear this queue to keep shipping. |
| **Verified** | Green | Ready for sign-off. The finish line is close. |
| **Done** | Dark green | Celebrate. Then plan the next sprint. |

Click any tab to filter instantly. The counts update in real-time as tasks move through your workflow.

> [!TIP]
> **Pro move:** Check **In Review** every morning. A growing review queue is the #1 predictor of delivery slowdown. Clear it first, ship faster.

## Signals → Action: how to read the board

The Task List isn't just a list—it's a set of operational signals. Each view answers a question and suggests a next move:

- **Backlog growing** → clarify scope or plan the next sprint
- **Too many In Progress** → reduce WIP, reassign, or unblock
- **In Review piling up** → review-first to restore flow
- **Stale Updated timestamps** → investigate blocked or forgotten work

Read the signal. Take the action. Move on.

## Filters that actually save time

### Project filter

Running multiple projects? Use the **Project** dropdown to focus on one at a time. Select "All Projects" when you need the full picture—like during sprint planning or progress reviews.

### Search

Find anything instantly:
- Task key: `TESTP-22`
- Partial title: `sprint schema`
- Assignee: `@documentation-author`
- Project name: `Valdr`

Results update as you type. No waiting, no "search" button.

## Table columns that tell the story

| Column | What it shows | Why it matters |
|--------|---------------|----------------|
| **Task** | Key, title, description preview | Full context without clicking |
| **Status** | Workflow stage badge | Spot blockers instantly |
| **Points** | Story point estimate | Capacity planning at a glance |
| **Assignee** | Agent or person | Know who's responsible |
| **Project** | Parent project | Cross-project visibility |
| **Updated** | Last change | Stale tasks surface immediately |

**Click any column header to sort.** Click again to reverse. Most developers sort by Updated (default) to see recent activity first, or by Status to work through the pipeline systematically.

## Task rows: everything you need, no clicks required

Each row shows you:

- **Task key** — Unique identifier you can reference anywhere
- **Title** — What needs to happen
- **Description preview** — The first few lines, rendered from Markdown
- **Status badge** — Color-coded for instant recognition
- **Points** — Effort estimate (or `—` if unset)
- **Assignee** — The agent or person who owns this
- **Project** — Where this work lives
- **Updated** — When something last changed

See something that needs attention? Click the row to open the full [Task Detail](../task-detail/) view.

## Creating new tasks

Click the **+** button next to the project filter to create a task manually. You'll set:

- Title and description (Markdown supported)
- Project assignment
- Initial status
- Assignee (agent or person)
- Story points
- Priority

> [!NOTE]
> **Better approach:** Use the [Planner](../../planner/) to generate tasks from specs. Tasks created through planning automatically include requirements, acceptance criteria, and linked checklists—no manual data entry.

## Pagination: scale without slowdown

Large task lists stay fast with pagination:

- **Rows per page** — 10, 25, or 50 (pick your preference)
- **Page navigation** — Prev/Next buttons, current page indicator
- **Total count** — "Showing 1–10 of 51" so you always know the full scope

Even with hundreds of tasks, the list loads instantly.

## Workflows that win

### Morning triage (5 minutes)

1. Click **In Review** — what's waiting for approval?
2. Clear blockers or approve ready work
3. Click **In Progress** — is anyone stuck?
4. Reassign or unblock as needed
5. Check **To Do** — is today's work clear?

Do this every morning. You'll ship faster.

### Sprint planning

1. Filter to your project
2. Sort by **Points** to see effort distribution
3. Move tasks from **Backlog** to **To Do** based on capacity
4. Check total points against your velocity target

### Cross-project visibility

Keep "All Projects" selected when you need to:
- Balance workload across multiple projects
- Find dependencies across your work
- Review delivery status in one view

One view, complete visibility. No spreadsheet aggregation required.

## Next steps

- **[Task Detail](../task-detail/)** — Dive deep into individual tasks
- **[Launching Agents](../agent-launch/)** — Assign work to AI agents

**Try it now:** Open Tasks, filter to **In Review**, and clear one blocker. That's 10 minutes saved today.