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

# Start a session

> Write a task, choose the project, run location, model, and permissions, add attachments or screenshots, and hand the work to the agent.

A **session** is the complete record of you and the agent working on one piece of work. This page covers how to start a session and which options you can adjust before sending. For how to work together after the session starts, see [Work with the agent](https://docs.aihubmix.com/en/cloud/sessions/work-with-agent.md).

## Start a session

**1. Open a new chat**

Click **New chat** at the top of the sidebar, or press `⌘N` (`Ctrl+N` on Windows). If you start from **＋** next to a project in the sidebar or from **New task in this project** on a project page, that project is selected for you.

**2. Write what you want done**

Describe the task in the input box, for example "Fix the misaligned input field on the sign-in page in Safari, and add tests." Press `Shift+Enter` for a new line. Type `/` at the start to insert a slash command. For how to write clear tasks, see [Write good tasks](https://docs.aihubmix.com/en/cloud/sessions/writing-tasks.md).

**3. Confirm the project and run location**

The current project and run location appear above the input box. Click them to change, as described below.

**4. Adjust permissions and model as needed**

Permissions are at the bottom left of the input box. The model and effort are at the bottom right.

**5. Send**

Press `Enter` or click the send button. The session appears in the sidebar, the page opens the session, and the agent starts working.

![Input box on the new chat page](https://mintcdn.com/aihubmix/ADcIS2RBGw_ogRXt/images/cloud/en/home.png?fit=max\&auto=format\&n=ADcIS2RBGw_ogRXt\&q=85\&s=049b3a780d55363ae4c591ef0758e101)

New chat: the project and run location are above the input box, and permissions and model are below it

> [!NOTE]
>
> Sending a session requires Plus. If you haven't activated it yet, click the upgrade button in the reply to subscribe, and your message is sent automatically. See [Plus plan and usage](https://docs.aihubmix.com/en/cloud/account/plus.md).

## Choose a project

Click the project button above the input box to search for and select a project, or click **New project**. A new chat doesn't remember your last choice and always starts with **No project**. Pressing `⌥⌘O` (`Ctrl+Alt+O` on Windows) also opens a new chat with no project directly.

* **Choose a project**: The session starts in the project's current working directory. For how to create and configure projects, see [Projects and environment setup](https://docs.aihubmix.com/en/cloud/environments/projects.md).
* **No project**: The session runs in a temporary working directory, which suits Q\&A, writing a script, or organizing information. You can move it into a project later. See [Manage sessions](https://docs.aihubmix.com/en/cloud/sessions/manage-sessions.md).

When you choose a local project on another computer, the session runs on that computer.

## Choose a run location

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

* **Cloud server**: Runs on your [cloud server](https://docs.aihubmix.com/en/cloud/environments/cloud-host.md) from start to finish without going through your computer, and keeps going when you shut down your computer. New sessions use this by default.
* **Run on your device**: After you choose a device, the agent in the cloud remotely uses that computer's environment and files. The computer must be online and allow execution. Local projects run on the device where the project is located by default.

The run location is set when you send, and you can't change it after the session starts. To use a different machine, create a new session. For why a device can't be selected and how to authorize it, see [Run on your device](https://docs.aihubmix.com/en/cloud/environments/your-device.md).

## Choose a model

Click the model button at the bottom right of the input box to choose a model. The button next to it adjusts effort (reasoning effort). New sessions use your account's default choice or the choice from the last session you created. For how the models differ and how to choose, see [Choose a model](https://docs.aihubmix.com/en/cloud/models/choose-a-model.md).

## Choose permissions

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

| Permission | What the agent does |
| - | - |
| **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 default to **Full access** and always start from the default without remembering your last choice. You can change it in the same place at any time after the session starts.

![Permissions menu](https://mintcdn.com/aihubmix/ADcIS2RBGw_ogRXt/images/cloud/en/permission-menu.png?fit=max\&auto=format\&n=ADcIS2RBGw_ogRXt\&q=85\&s=c507b54ffe41f3881d4155b9eac737be)

Choose permissions at the bottom left of the input box

### About full access

With full access, the agent can run commands, install dependencies, modify files, access the internet and connected services, and read all secrets for this project without asking you. This is the most efficient option, but it carries risks such as sensitive data leaks and prompt injection. For when it's appropriate, see [Write good tasks](https://docs.aihubmix.com/en/cloud/sessions/writing-tasks.md).

* The first time you send with full access, an explanation appears. Click **Got it, start the task** to send. It doesn't appear again.
* When running on your device, switching to full access requires clicking **Confirm** in a dialog first.
* When running on your device, permissions can't exceed the limit set for that device, and options above it can't be selected. The limit can only be changed in the desktop app on that device.
* When cloud server admin privileges are turned on, the first time you send on the cloud server you're asked to confirm. See [Cloud server](https://docs.aihubmix.com/en/cloud/environments/cloud-host.md).

If you click **Cancel** in these dialogs, the message isn't sent, and the text and attachments stay in the input box.

## Add attachments and screenshots

Click **＋** at the bottom left of the input box (`⌘U`, `Ctrl+U` on Windows) and choose **Upload files or images** or **Take a screenshot**. You can also drag files onto the input box or paste them. You can send attachments without any text.

| Limit | Maximum |
| - | - |
| Attachments per message | 10 |
| Single image (PNG, JPEG, WebP, GIF) | 5 MB |
| Other single file | 25 MB |
| Total attachment size per message | 100 MB |

Files over the limits and empty files aren't added. The rest are added as usual. HEIC, HEIF, and TIFF images are converted to JPEG automatically. You can't send until attachments are ready.

> [!NOTE]
>
> When a session runs on **this computer**, files added in the desktop app go to the agent directly without uploading and don't count toward the 100 MB limit. When you add attachments in the web app to a session running on a device, you can only add images. Add files in the desktop app.

Images captured with **Take a screenshot** become attachments directly:

* **macOS desktop app**: Drag to select an area, press the Space bar to capture a window instead, or press `Esc` to cancel. The first time you capture another app's window, the system asks you to grant screen recording permission.
* **Windows desktop app**: Captures the screen the app is on.
* **Web app**: Choose a view in the browser's screen sharing picker, and a single frame from that moment is captured. If the browser doesn't support screen sharing, this option is unavailable.

If you run into problems when sending, see [FAQ and troubleshooting](https://docs.aihubmix.com/en/cloud/reference/troubleshooting.md).


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