> ## 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.

# Code Xpert

CodeXpert is an AI coding workspace that helps you plan tasks, explore changes, and ship pull requests with confidence. It pairs a chat-first experience with a structured task timeline, live file change diffs, and a clear audit of what happened during execution.

<img src="https://mintcdn.com/xpertai/sb2phIuTOB102_G5/public/img/code/code-xpert-arch.png?fit=max&auto=format&n=sb2phIuTOB102_G5&q=85&s=7df6fa229c51c928570976ba0329ac01" alt="Code Xpert" width="3356" height="1804" data-path="public/img/code/code-xpert-arch.png" />

CodeXpert adopts a layered decoupled architecture:

* **[CodeXpert](https://code.xpertai.cn/) Web and CodeXpert Server** form the frontend and backend system, responsible for user interaction and session management.
* The core **[XpertAI Agent Server](https://app.xpertai.cn/)** serves as the intelligent agent orchestration platform, scheduling coding agents, managing thread contexts, and invoking **LLMs (third-party or local large models)** for reasoning and code generation.
* All code execution and testing tasks run safely in isolated **[Sandbox](/en/ai/agent/sandbox)** environments.
* The system can connect to **GitHub and other code repository platforms** to enable code pulling, commits, and PR interactions, forming a complete closed-loop architecture from intelligent reasoning, code generation, safe execution, to repository collaboration.

## What you can do

* Create coding tasks with instructions and attachments.
* Run tasks in a dedicated environment while watching terminal output.
* Review file diffs, line changes, and change set summaries.
* Create or open pull requests from the latest change set.
* Archive completed tasks for a clean active list.

## Core concepts

### Tasks

Tasks are the unit of work. Each task tracks:

* Instruction and status
* Repository and branch context
* Change sets and file diffs
* Terminal output from the execution environment

### Change sets

Every sync captures a change set that includes:

* File change list
* Unified and split diffs
* Line additions and deletions
* Optional pull request metadata

### Environments

Environments define how CodeXpert runs your work:

* Repository connection and default branch
* Setup scripts and preinstalled packages
* Network access and runtime settings

## Typical workflow

1. Connect a repository and select a branch.
2. Create a task with a clear instruction.
3. Watch execution progress and terminal logs.
4. Review diffs and summarize results.
5. Create a pull request or continue iterating.

## Key UI surfaces

### Task page

The task page brings together:

* Task header with repo, branch, and change stats
* Chat panel for iterative guidance
* Terminal output from sandboxed commands
* File diff viewer (split or unified)
* Pull request actions and copy helpers

<img src="https://mintcdn.com/xpertai/45WonGqFbi9kan0G/public/img/code/start-task.png?fit=max&auto=format&n=45WonGqFbi9kan0G&q=85&s=ad914b03acbe1d88a6a0eb281ff3cebe" alt="Start Tasks" width="2968" height="1694" data-path="public/img/code/start-task.png" />

### Settings

Configure your workspace to match your workflow:

* Environments (runtime, setup, caching)
* Connectors (repository access)
* Code review preferences
* Token usage:

<img src="https://mintcdn.com/xpertai/45WonGqFbi9kan0G/public/img/code/token-usage.png?fit=max&auto=format&n=45WonGqFbi9kan0G&q=85&s=2e5c24b9fbe4d3ec6faf21bf4fc13386" alt="Usage" width="2978" height="1702" data-path="public/img/code/token-usage.png" />

## Best practices

* Write instructions as a short goal plus constraints.
* Sync after major steps to capture clean change sets.
* Use the diff viewer to validate impact before PR.
* Archive finished tasks to keep focus on active work.