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

# Tasks

Tasks are the unit of work in CodeXpert. Each task captures the instruction, execution context, terminal output, and resulting change sets.

## Create a task

When you start a task, you provide:

* A clear instruction (goal + constraints)
* Repository and branch context
* Optional attachments or references

CodeXpert creates a task and begins execution in the selected environment.

## Task lifecycle

A task moves through these states:

* `queued`: waiting to start
* `running`: actively executing
* `idle`: ready for follow-up actions
* `failed`: execution stopped with an error
* `archived`: moved out of active view

## What a task records

Each task includes:

* Instruction, status, and timestamps
* Repository and branch context
* Terminal output from the sandbox
* One or more change sets

## Pull request actions

From the latest change set you can:

* Create a pull request
* Open the existing pull request
* Copy a patch or git apply command

## Archive tasks

Archive tasks after review to keep your active list focused. You can still open archived tasks later for reference.

## Best practices

* Write instructions as a short goal plus constraints.
* Sync after major steps to capture clean change sets.
* Review diffs before opening a pull request.