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

# New Task Attempts

> Understand when and why to create multiple task attempts for fresh restarts with different configurations.

<Frame>
  <img src="https://mintcdn.com/vibekanban/GK2sYW8cmo85M4R5/images/vk-create-new-attempt.png?fit=max&auto=format&n=GK2sYW8cmo85M4R5&q=85&s=54dc12aba907aa4540acd20156a1fbf9" alt="Create new task attempt dialog showing configuration options" width="788" height="830" data-path="images/vk-create-new-attempt.png" />
</Frame>

A task attempt represents a single session with a coding agent against a task. Most tasks only need one attempt, but you may need additional attempts for fresh restarts.

## When to Create New Task Attempts

Create a new task attempt when you want to:

* **Start from scratch** with a different approach after an unsuccessful attempt
* **Try a different coding agent** (e.g., switching from Claude to Codex)
* **Use a different agent profile or variant** for specialised behaviour
* **Work from a different base branch** to incorporate recent changes
* **Reset the conversation context** for a completely fresh start

<Tip>
  Most users will only need one attempt per task. Only create additional attempts if the first approach didn't work as expected.
</Tip>

## Creating Additional Attempts

To create a new task attempt for an existing task:

<Steps>
  <Step title="Navigate to the task">
    Open the task that needs a fresh attempt.
  </Step>

  <Step title="Click Create New Attempt">
    Click the triple dot icon in the top right of the task, then select **Create New Attempt**.
  </Step>

  <Step title="Configure the attempt">
    Choose your agent profile, variant, and base branch. These can be different from previous attempts.
  </Step>

  <Step title="Start execution">
    Click **Create Attempt** to begin a fresh execution with the new configuration.
  </Step>
</Steps>

## Impact on Subtasks

<Warning>
  Creating new task attempts affects subtasks. Subtasks are linked to specific task attempts, not tasks themselves.
</Warning>

When you create a new task attempt:

* **Existing subtasks** remain linked to their original parent attempt
* **New subtasks** created from the new attempt will use the new attempt's branch as their base

<Info>
  For more details about how subtasks work with task attempts, see [Creating Subtasks](/core-features/subtasks).
</Info>
