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

# New session: project, run method, permissions, and model

> Starting a session from the new chat page: choosing a project, a run environment (cloud server or your device), permissions and models, and the confirmations that may appear before the first send.

The **new chat page** is where you start a **session** in AIHubMix Cloud. Choose a project and run environment, write what you want done in the message box, and send it. The session is created and the agent starts working. To add requirements in a session that has already started, see [Composer](https://docs.aihubmix.com/en/cloud/sessions/composer.md).

## Where this applies

| Form | Support | Notes |
| - | - | - |
| Desktop app | Supported | |
| Web app | Supported | You can also choose **Run on your device**. A device's execution authorization can only be changed in the app on that device |
| Mobile web | Supported | |

## Entry points

* The **New chat** button in the sidebar, or `⌘N`.
* `⌥⌘O`: opens the new chat page with **No project** selected.
* The **＋** that appears when you hover over a project row in the sidebar, or **New task in this project** on the project page: opens the new chat page with that project preselected.

On Windows, replace `⌘` with `Ctrl` and `⌥` with `Alt` (the same applies below).

## Parts of the new chat page

| Area | Notes |
| - | - |
| Greeting | A short sentence, such as **What’s on your mind?**. It is only a hint |
| Tag bar | Project button and run environment button. Shown only before the first message is sent |
| Message box | Permissions at the bottom left; model and reasoning effort, and send at the bottom right. See [Composer](https://docs.aihubmix.com/en/cloud/sessions/composer.md) |
| Notice line | When you have Plus but the cloud server is not currently running, it shows **No cloud server is running yet… we’ll guide you through setup when you create a project or send a message.** |

The session starts in the project's current working directory. The new chat page has no branch selection.

## Steps

1. Click **New chat**. The project defaults to **No project**.
2. (Optional) Choose a project.
3. (Optional) Choose a run environment: **Cloud server** or a device under **Run on your device**.
4. (Optional) Adjust permissions, model, and reasoning effort.
5. Write what you want done (you can also send only attachments), then press `Enter` to send (`Shift+Enter` for a new line).
6. The session appears in the sidebar. Once the session is created, you go to the session page automatically and the agent starts working.

The first time you send with **Full access**, or the first time you send on the cloud server, a confirmation may appear first. See "Confirmations before sending" below.

## Choose a project

Click the project button (`⌥⇧⌘O`) to open the menu. You can search projects, choose a project, choose **New project**, or choose **No project**. On the new chat page, you can also use `⌥⌘1`–`⌥⌘9` to pick projects 1–9 directly.

* Each project has a line of source text below it, such as a GitHub repository name or **Local · folder name**. Projects not fully set up show **Setting up · not ready yet**.
* You can also choose a local project on another computer; the session runs on that device. When that device is offline, it is marked **Device offline**.
* The new chat page does not remember the last project you chose. Each time you click **New chat**, it goes back to **No project**.

### No project

A session with **No project** is not linked to a project. It runs in a temporary working directory, which suits Q\&A, writing a script, organizing material, and similar tasks. It appears in the sidebar's **Chats** group and can be moved into a project later; see [Messages and session actions](https://docs.aihubmix.com/en/cloud/sessions/messages.md).

## Choose a run environment

The **run environment** determines on which machine the agent reads and writes files and runs commands. The agent itself always runs in the cloud:

| Run method | Label in the interface | Meaning |
| - | - | - |
| **Cloud server** | **Cloud server** | Runs entirely on your cloud server, without involving your computer |
| **On your device** | A device under **Run on your device** | The agent in the cloud remotely controls that computer and runs with its environment and files |

* The default is **Cloud server**. Local projects default to running on the device where the project is.
* Devices that cannot be chosen are grayed out with the reason (such as **Device offline** or **Execution disabled**).
* The run device is chosen when the session is created and cannot be changed later. To use a different device, create a new session.

For default rules, reasons a device cannot be chosen, device authorization, and the execution log, see [Run environment](https://docs.aihubmix.com/en/cloud/projects/run-environment.md).

## Choose permissions

**Permissions** determine whether the agent asks you before taking actions. Click the permission button at the bottom left of the message box (`Ctrl+Shift+S`):

| Option | Description |
| - | - |
| **Ask for approval** | Always ask before editing outside the environment or using the internet |
| **Approve for me** | Only ask for actions detected as potentially unsafe |
| **Full access** | Unrestricted internet and file access inside the cloud environment |

* New sessions default to **Full access**. Each new session starts from the default and does not remember your last choice.
* When running on a device, permissions cannot exceed the device's permission limit, and levels above it are grayed out. Change the limit under **Machines & access** in the app on that device.
* You can also change permissions at any time in a session that has already started. Repair tasks and archived sessions cannot be changed.
* For how to handle requests for your approval, see [Needs your input](https://docs.aihubmix.com/en/cloud/sessions/user-intervention.md).

### Confirmation for turning on full access

When running on a device and you switch to **Full access**, **Turn on full access?** appears. It explains that the agent will be able to run commands, access the internet, and create and modify any files without asking for your consent, and notes the risks such as loss or leakage of sensitive data and prompt injection (including that the agent can read all of this project's secrets). Only clicking **Confirm** switches it. Clicking **Cancel** or pressing `Esc` keeps the original permission.

## Choose a model and reasoning effort

The bottom right of the message box has the model button and the reasoning effort button. A new session uses your account's default selection or your selection when you last created a session. For full details, see [Harness and models](https://docs.aihubmix.com/en/cloud/models/harness-and-models.md).

## Confirmations before sending

The dialogs below appear only the first time. Clicking **Cancel** in any of them does not send the message, and the text and attachments stay in the message box.

### Full access by default (first send with full access)

The **Full access by default** dialog explains that the agent can run commands, install dependencies, modify files in the cloud environment, access the internet and connected services, and read all of this project's secrets. It also notes that you can switch to **Ask for approval** or **Approve for me** at any time at the bottom left of the message box. Click **Got it, start the task** to send; the dialog does not appear again.

### Cloud server admin access (first send on the cloud server)

When cloud server admin access is turned on, the first time you start a session on the cloud server, **Turn on admin access on cloud server** appears and notes:

* The agent has admin access on the cloud server, and credentials stored on the cloud server can be read.
* Approval and branch restrictions are only recommendations and are no longer enforced.
* Turning it off does not undo changes already made. Accidentally modifying system files may require rebuilding the cloud server.

Click **Got it, start the task** to send and not be asked again. To turn admin access on or off, see [Cloud server admin access](https://docs.aihubmix.com/en/cloud/cloud-host/admin-permission.md).

## Rules and states

| Situation | What you see | What you can do |
| - | - | - |
| No Plus plan | A fixed reply + an upgrade card | Click **Upgrade** to subscribe. After you subscribe, the messages are sent automatically. See [Sending without Plus](https://docs.aihubmix.com/en/cloud/plus/without-plus.md) |
| Subscribed, but the cloud server is not ready yet | The cloud server setup / restore guide | Once it is ready, sending resumes automatically |
| Session creation failed | The message is marked **Not sent: reason** | Click **Retry** |
| The session was created, but attachment upload failed | Attachments stay in the message box with the message **The chat was created, but attachments failed to upload…** | Click retry on the attachment, then send |
| The selected device has not allowed execution, or the project has no linked folder on that device yet | A dialog appears in the desktop app on that device | Turn it on or choose the folder as prompted; see [Run environment](https://docs.aihubmix.com/en/cloud/projects/run-environment.md) |

For other errors, see [Errors and recovery](https://docs.aihubmix.com/en/cloud/sessions/errors-and-recovery.md).

## FAQ

### Why is the project always No project when I open the new chat page?

The new chat page does not remember the last project you chose. Use the **＋** on the project row in the sidebar or **New task in this project** on the project page; the project is then preselected automatically.

### What is the difference between running on the cloud server and on my device?

The agent runs in the cloud in both cases. With **Cloud server**, commands and files are on the cloud server, and the session continues even if you turn off your computer. With a device, that device must be online and allowed to run.

### I chose my own computer. Why is Full access grayed out?

That device has a lower permission limit set. Raise it in the app on that device.

### Can I switch to another device after the session starts?

No. To use a different device, create a new session.

## Related

* [Composer](https://docs.aihubmix.com/en/cloud/sessions/composer.md)
* [Needs your input](https://docs.aihubmix.com/en/cloud/sessions/user-intervention.md)
* [Errors and recovery](https://docs.aihubmix.com/en/cloud/sessions/errors-and-recovery.md)
* [Run environment](https://docs.aihubmix.com/en/cloud/projects/run-environment.md)
* [Harness and models](https://docs.aihubmix.com/en/cloud/models/harness-and-models.md)
* [Sending without Plus](https://docs.aihubmix.com/en/cloud/plus/without-plus.md)
* [Cloud server admin access](https://docs.aihubmix.com/en/cloud/cloud-host/admin-permission.md)


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