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

# Run on your device

> Let the cloud Agent run sessions on your own computer: authorize a computer, choose a device to start a session, confirm access to sensitive locations, view the execution log, and handle disconnects and device removal.

**Running on your device** means the cloud Agent remotely controls one of your computers. It reads and writes files and runs commands on that computer, using its local environment and files, with the same result as running locally. In the app, this option is called **Run on your device**.

## Choose your device or the cloud server

Each session picks how it runs when you start it. You cannot change it afterward.

| | Your device | Cloud server |
| - | - | - |
| Where actions happen | The computer you choose | Your [cloud server](https://docs.aihubmix.com/en/cloud/environments/cloud-host.md) |
| Environment and files used | The environment and project folders on that computer | The project copy and project environment on the cloud server |
| Available projects | Local projects on that computer, or sessions outside any project | Cloud projects, or sessions outside any project |
| Supported Agents | Claude Code only for now | All |
| Requirements | The computer is online and **Allow execution** is on | Plus subscription |
| Computer shuts down or goes offline | The current task pauses and continues after reconnecting | Not affected |

For tasks that need to keep running after you close your laptop, choose the cloud server.

## Let a computer run sessions

**1. Sign in to the desktop app on the computer**

Install the desktop app and sign in with the same account. See [Download and sign in](https://docs.aihubmix.com/en/cloud/getting-started/install-and-sign-in.md). After you sign in, the computer joins your workspace automatically. The web app does not add a device.

**2. Open the machine details**

Go to **Settings › Workspace › Machines** and click the computer. The list shows each machine's operating system, client version, and online status.

**3. Turn on Allow execution**

Turn on **Allow execution** (off by default for computers), and review what is being loosened in the confirmation dialog. Once on, it stays in effect for all future sessions that run on this computer.

**4. Adjust authorization as needed**

Set the access scope, sensitive locations, and permission limit. After you save, the changes apply to new sessions right away.

![Machine list](https://mintcdn.com/aihubmix/ADcIS2RBGw_ogRXt/images/cloud/en/machines.png?fit=max\&auto=format\&n=ADcIS2RBGw_ogRXt\&q=85\&s=7e1df978d48ba5be7f5a7a9edeb30f68)

Settings › Workspace › Machines

In the machine details you can adjust:

* **Access scope**: Project folders only, selected folders, or the entire computer (default).
* **Sensitive locations**: For example SSH, Keychain, and system configuration. Choose Ask each time (default), Block access, or Allow access.
* **Permission limit**: Session permissions cannot exceed this. Choose No limit (default), Approve for me, or Ask for approval.
* **Allowed secrets**: Which workspace secrets can be used on this computer. All by default.
* **Environment variable overrides**: Environment variables to override when running on this computer. Do not put plain-text secrets here.

Loosening authorization asks you to confirm. Tightening it does not. When you turn off **Allow execution**, sessions using this computer pause. Commands run with your account's permissions on this computer.

> [!NOTE]
>
> Execution authorization can only be changed in the desktop app on that computer. Other devices and the web app can only view it.

## Choose a device to start a session

**1. Open the run environment menu**

Above the new session input box, click the run environment button next to the project.

**2. Pick a device**

Under **Run on your device**, choose a computer. Each device shows its access scope and permission limit below it.

**3. Send the task**

Write your task and send it. Once the session starts, it stays on this computer.

* Local projects default to the computer where the project lives. Everything else defaults to the cloud server.
* A device cannot be selected if it is offline, Allow execution is off, the project is not on that device, or the current Agent is not Claude Code. The menu states the reason.
* After you pick a device, permissions above its permission limit cannot be selected.
* To switch to another computer or the cloud server, start a new session.

The first time a session runs on a computer, if Allow execution is not on yet, or the project has no matching folder on that computer, the client on that computer prompts you. Click **Open Machines & access** to turn on Allow execution, or click **Allow** and choose the project folder (the folder is not synced to the cloud). Sessions outside any project use their own temporary folder.

## Confirm access to sensitive locations

When sensitive locations are set to Ask each time, the client on the running device shows the reason and the path before the Agent accesses a location such as the SSH configuration.

* **Allow once**: Allows this one time only, without changing the machine authorization.
* **Deny**: Does not allow it. If you do not respond for a while, it is treated as denied.
* **Respond later**: Hides the prompt for now, and the session is marked in the sidebar as needing your attention.

## View the execution log

At the bottom of the run environment menu, click **Execution log** to see this session's actions. In the machine details, click **View execution log** to see actions from all sessions on this computer. Each line in the log shows what the Agent did, what it acted on, and the result.

In the client on the running device, you can also stop processes, disconnect, or reconnect immediately. Elsewhere you can only view.

## What happens when the computer disconnects

When the computer shuts down, sleeps, goes offline, or quits the client, the current task pauses. After the connection returns, it continues automatically from where it stopped, and completed actions are not repeated. You can also click **Reconnect**. On other devices and in the web app, the session is marked as device offline.

A session does not move to the cloud server automatically when its device goes offline. For connection issues, see [FAQ and troubleshooting](https://docs.aihubmix.com/en/cloud/reference/troubleshooting.md).

## Remove a device

At the bottom of the machine details, click **Remove device** and confirm.

> [!WARNING]
>
> After removal, the device disconnects immediately and sessions using it are interrupted. To use this computer again later, sign in on it again.

The cloud server cannot be removed. The computer you are currently using cannot be removed here; sign out of your account to remove it.


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