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

# Tasks App: Manage Your Simulation To-Dos

> Create, prioritize, and track tasks inside your Nebula simulation, including pre-assigned tasks from personas and the scenario engine.

The Tasks app keeps you organized throughout your simulation. Use it to track what needs to be done, set priorities, and mark work as complete. Some tasks will already be waiting for you when you enter the workspace — assigned by AI personas or generated by the scenario engine based on your role. You can also create your own tasks to stay on top of your objectives.

<Tip>
  Use the Tasks app alongside Mission Control to stay aligned. Mission Control shows your high-level objectives; the Tasks app is where you manage the specific actions required to meet them.
</Tip>

## Task status flow

Every task moves through a simple three-stage lifecycle:

```
todo → in_progress → done
```

Update a task's status as you work to keep an accurate picture of where things stand.

## Priority levels

When you create a task, you can assign one of four priority levels:

| Priority | When to use                           |
| -------- | ------------------------------------- |
| `low`    | Nice to do, but not blocking anything |
| `medium` | Should be done soon, but not urgent   |
| `high`   | Important and time-sensitive          |
| `urgent` | Requires immediate attention          |

## Viewing your tasks

Open the Tasks app to see all tasks in your session. Tasks are listed with their title, status, priority, and due date if one has been set.

## Creating a task

<Steps>
  <Step title="Open the Tasks app">
    Select the Tasks app from your workspace desktop.
  </Step>

  <Step title="Add a new task">
    Click to create a new task and enter a title (required, up to 200 characters).
  </Step>

  <Step title="Add optional details">
    Optionally add a description (up to 4,000 characters), set a priority level, and assign a due date.
  </Step>

  <Step title="Save the task">
    The task is created with a default status of `todo` and appears in your task list immediately.
  </Step>
</Steps>

## Updating a task

Select any task to update its status. You can move it from `todo` to `in_progress` when you begin working on it, then to `done` when it is complete.

<Note>
  At the moment, only status updates are supported after a task is created. If you need to track additional detail, use the description field when you first create the task.
</Note>

## Pre-assigned tasks

When your workspace is prepared, the scenario engine and AI personas may pre-assign tasks to you based on your role. These tasks reflect responsibilities your character would realistically have in the simulated organization. Treat them as signals from your scenario — completing them often connects directly to your Mission Control objectives.

<Warning>
  Ignoring pre-assigned high-priority or urgent tasks may affect your scenario progression. Check your task list when you first enter the workspace to understand what is expected of you.
</Warning>