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

# Run tasks

> Create, steer and finish tasks in the web app.

## Create a task

Click **New task**. Describe the change, then pick the repository and [executor](https://docs.bellows.cloud/guides/executors.md). You can also [attach files](https://docs.bellows.cloud/guides/attachments.md) (images, PDF, docx, txt, md, csv; up to 20 MiB each) and add [connections](https://docs.bellows.cloud/guides/connections.md). Press **Start task** or `⌘ + Enter`.

Everything here also works from the [CLI](https://docs.bellows.cloud/cli/commands.md) and the [MCP server](https://docs.bellows.cloud/mcp/tools.md).

## The inbox

**Tasks** has three tabs. **Needs attention** holds everything waiting on you: answers, reviews and failures. **Running** is work in progress. **Past** is finished work. Filter by repository or person, or search task requests.

![Tasks inbox](https://mintcdn.com/bellows/F3bOEtFaYdaW9xJ2/images/guides/06-inbox.png?fit=max\&auto=format\&n=F3bOEtFaYdaW9xJ2\&q=85\&s=63f99e34c89b15fe7f88ea245add230f)

## Task actions

| Action | When to use it |
| - | - |
| **Follow up** | The run finished, but you want more or something different. Same checkout, executor and session |
| **Answer** | The agent asked a question |
| **Retry** | The run failed for a transient reason; same prompt, new job |
| **Edit** | You'd rather fix the prompt than add to it |
| **Stop** | The run is going the wrong way |
| **Mark done** / **Reopen** | Close the task in Bellows; it doesn't merge or close the PR. Reopen to continue later |

What each status means, and what to do when a run fails: [Task lifecycle](https://docs.bellows.cloud/guides/task-lifecycle.md).


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