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

# Todos & Backlog

> Capture planned work as todos and manage a prioritized backlog.

## Overview

**Todos** let you capture and organize planned work without consuming compute. Write your instructions now, refine them, and launch as running tasks when ready.

## Todos vs tasks

|               | Todo                                                                 | Task                                          |
| ------------- | -------------------------------------------------------------------- | --------------------------------------------- |
| **Purpose**   | Planned work — capture intent now, execute later                     | Active work — runs immediately in a container |
| **Container** | None (no compute used)                                               | Full isolated environment with AI agent       |
| **Editable**  | Body, priority, effort, tags, assignee, model, branch — all editable | Prompt is fixed once launched                 |
| **Cost**      | Free until launched                                                  | Consumes compute units while running          |

<Tip>
  Press <kbd>Tab</kbd> in the composer to toggle between task and todo mode.
</Tip>

## Creating a todo

1. Open the composer at the bottom of the sidebar
2. Press <kbd>Tab</kbd> to switch to **Todo** mode
3. Write your instructions
4. Press <kbd>Cmd/Ctrl + Enter</kbd> or click **Send**

The todo appears in your task list with a checkbox icon.

## Todo fields

Click a todo to open its detail pane and edit:

**Body** — Rich text with full Markdown support. Describe the work, add context, link to issues, or include code snippets. Editable at any time before launch.

**Priority** — Set urgency for sorting and triage:

| Priority   | Description                    |
| ---------- | ------------------------------ |
| **Urgent** | Needs immediate attention      |
| **High**   | Important, should be done soon |
| **Medium** | Normal priority (default)      |
| **Low**    | Nice to have, no rush          |

**Effort** — Estimate scope:

| Effort     | Description                     |
| ---------- | ------------------------------- |
| **Small**  | Quick fix or minor change       |
| **Medium** | Moderate scope                  |
| **Large**  | Significant feature or refactor |

**Tags** — Categorize and filter. Tags are shared across your workspace — type to search existing tags or create new ones.

**Assignee** — Assign to a workspace member to track ownership.

**Provider and model** — Pre-select which AI provider and model to use when launched. You can also set the remote base branch and task mode.

## Backlog sorting

| Sort         | Behavior                                     |
| ------------ | -------------------------------------------- |
| **Manual**   | Drag-and-drop ordering                       |
| **Priority** | Urgent first, then High, Medium, Low         |
| **Effort**   | Small first (quick wins), then Medium, Large |
| **Updated**  | Most recently updated first                  |

Switch sort modes from the task list controls at the top of the sidebar.

## Launching a todo

Click the **play button** on a todo's detail pane to launch it. Whim will:

1. Create an isolated branch from the todo's configured remote base branch
2. Spin up a container with the selected provider and model
3. Start the agent with the todo's body as the prompt
4. Transition the todo to an active running task

<Note>
  If provider, model, or branch aren't set on the todo, workspace defaults are
  used.
</Note>

## Bulk operations

Select multiple todos from the task list to:

* **Archive** — move selected items out of the active view
* **Complete** — mark selected items as done