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

# Working with tasks

> Create tasks, pick a mode, follow up, and track progress — from the web app or anywhere else.

A task is one request to Twill: a bug to fix, a feature to build, a question to answer. Every task runs in its own fork of your workspace's [dev environment](/environment) and reports back where you created it.

## Creating a task

Type your request into the composer on the home screen. Twill picks the repository (or repositories) at runtime from your connected repos — you don't select one up front.

The composer also gives you:

* **Agent & model** — which coding agent runs the task (Claude Code, Codex, or OpenCode) and at what reasoning effort. Defaults come from your [routing configs](/agent-config/routing).
* **Attachments** — drop in screenshots, specs, or data files for the agent to reference.
* **Voice input** — press <kbd>Alt</kbd>+<kbd>Space</kbd> to dictate a task.
* **Skills** — type `/` to insert a [repository skill](/agent-config/repository-skills) from your codebase.

You can also create tasks from [GitHub, Slack, Linear, Notion, or Asana](/integrations/overview), the [CLI](/cli), or the [API](/api).

## Modes

| Mode         | What it does                                                                                                                  |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------- |
| **Agent**    | Implements the change and opens a PR. The default.                                                                            |
| **Plan**     | Researches first and posts a plan for your approval before writing code. See [Plans & questions](/planning).                  |
| **Ask**      | Answers questions about your codebase. Read-only, no PR.                                                                      |
| **Dev Env**  | Sets up or repairs the workspace dev environment. Changes persist for future tasks. See [Your dev environment](/environment). |
| **Schedule** | Turns your prompt into a recurring [automation](/automations).                                                                |

## Following up

Reply in the task thread — in the web app or wherever the task started — and Twill continues with full context. Follow-ups reuse the task's existing agent and environment, so iterating is fast: "also handle the empty state", "the test you added fails on CI, fix it", "revert the copy change".

When a PR linked to a task gets merged, the task is marked **Completed** automatically.

## Tracking progress

The task view streams the agent's activity live: what it's reading, running, and changing. From the task header you can also:

* **Open the live preview** of the running app inside the task's sandbox.
* **SSH in** from your terminal, VS Code, or Cursor to inspect or take over.
* **Cancel** a run that's heading the wrong way — then follow up with a correction.

Tasks are searchable from the sidebar (<kbd>⌘</kbd>+<kbd>K</kbd>), and you can archive the ones you're done with.