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

# Core concepts

> Sessions, projects, cloud servers, running on your device, Harness and models, model sources, permissions, needs your input, and subagents, plus what each area of the interface does.

This page explains the concepts you'll meet repeatedly when using Cloud Agent. The two most important are **sessions** and **cloud servers**: you assign work to the agent in a session, and the agent completes it on a cloud server or on your computer.

## Sessions

A **session** is the complete record of you and the agent working on one piece of work, including your messages, the agent's steps, its replies, and its changes. A session can belong to a project or to no project. Click **New chat** in the sidebar to start a session. You can archive sessions you're done with, and when you want to try another direction, you can fork a new session from a message. See [Start a session](https://docs.aihubmix.com/en/cloud/sessions/start-a-session.md) and [Manage sessions](https://docs.aihubmix.com/en/cloud/sessions/manage-sessions.md).

## Projects

A **project** is the code directory or repository a session belongs to. There are two kinds:

* **Cloud project**: Created in the cloud, imported from GitHub, or uploaded from your computer. It runs on the cloud server, and you can configure an environment for it.
* **Local project**: A folder on your computer linked in the desktop app. Sessions run on that computer, and the folder isn't synced to the cloud.

A session that isn't in any project runs in a temporary working directory. You can move it into a project later. See [Projects and environment setup](https://docs.aihubmix.com/en/cloud/environments/projects.md).

## Cloud server and running on your device

A **cloud server** is the dedicated Linux machine with a public IP that comes with Plus. Sessions running on it keep going when you shut down your computer. You can open a remote desktop to watch what the agent does or take control yourself.

**Running on your device** (shown in the interface as **Run on your device**) is the other way to run: the agent stays in the cloud, but reading and writing files and running commands happen on the computer you choose, with the same effect as running locally. That computer must be signed in to the desktop app with **Allow execution** turned on.

| | Cloud server | On your device |
| - | - | - |
| Whose environment and files | The project copy and project environment on the cloud server | The environment and project folders on that computer |
| Available projects | Cloud projects, sessions not in any project | Local projects on that computer, sessions not in any project |
| Supported Harnesses | All | Only Claude Code for now |
| Computer shuts down or goes offline | Not affected | The current task pauses and resumes automatically after reconnecting |

You choose the run location when you create a session and can't change it afterward. See [Cloud server](https://docs.aihubmix.com/en/cloud/environments/cloud-host.md) and [Run on your device](https://docs.aihubmix.com/en/cloud/environments/your-device.md).

## Harness and models

A **Harness** is the framework that runs the agent, such as Claude Code or Codex CLI. A **model** is the large language model the Harness calls. After a session sends its first message, you can't change the Harness, but you can still change the model. **Reasoning effort** (shown in the interface as **Effort**) sets how deeply the model thinks. The available levels vary by model. See [Choose a model](https://docs.aihubmix.com/en/cloud/models/choose-a-model.md).

## Model sources

The **model source** determines who provides the model and where usage is counted.

| | Plus models | Your subscriptions | BYOK |
| - | - | - | - |
| What it is | Models included in the Plus plan | Your own ChatGPT, Claude, or other subscription accounts | API keys you add yourself |
| Where usage is counted | The Plus plan, with no extra charge | That subscription account's quota | The corresponding provider, billed at its prices |

In BYOK, AIHubMix is an ordinary gateway provider: an AIHubMix API key you add is billed the same way as any other key and is unrelated to Plus. See [Model sources](https://docs.aihubmix.com/en/cloud/models/model-sources.md).

## Permissions

**Permissions** determine whether the agent asks you before taking an action. Choose them at the bottom left of the input box:

* **Ask for approval**: Always asks you before modifying files outside the environment or accessing the internet.
* **Approve for me**: Asks only when it detects a potentially unsafe action.
* **Full access**: Accesses the internet and all files in the cloud environment without restriction. New sessions use this level by default.

You can change permissions at any time during a session.

## Needs your input

When the agent stops to wait for you to approve a command, answer a question, provide a secret, or complete something it can't do for you, such as signing in, the session **needs your input**. The request appears above the input box, and the session is also marked in the sidebar. After you handle it, the session continues automatically. See [Work with the agent](https://docs.aihubmix.com/en/cloud/sessions/work-with-agent.md).

## Subagents

A **subagent** is a helper the agent sends out within the same session to handle parts of the work in parallel. When they all finish, the results are merged back into the main session. You can view each subagent's process in the right panel, but you can't message it directly. A subagent differs from a session you fork manually: forking creates a separate, ordinary session. See [Subagents](https://docs.aihubmix.com/en/cloud/sessions/subagents.md).

## Interface overview

* **Icon bar**: The column of icons at the far left of the window. It switches between Cloud Tasks, Scheduled, Projects, Cloud servers, and Activity. The avatar at the bottom opens the account menu.
* **Sidebar**: The session list, grouped into Pinned, Cloud projects, Local projects, and Recents.
* **Session area**: The main area in the middle of the window. It shows messages between you and the agent, its steps, and the results.
* **Input box**: At the bottom of the session area. Use it to send messages, add attachments, and choose the model, reasoning effort, and permissions.
* **Right panel**: Changes, files, web previews, the cloud server's remote desktop, side chat, and subagents all open here.

> [!NOTE]
>
> Mobile web has no icon bar. The same entries are at the bottom of the sidebar. When the right panel opens, it fills the whole page.


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