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

# Remote desktop: view, full screen, and take control of the cloud server

> View the cloud server desktop in real time, view it full screen, take control of the keyboard and mouse yourself (the Agent does not pause), plus connection problems and the desktop traffic and view limits.

The **remote desktop** shows you in real time what is happening on the cloud server's screen. By default it is view only. When you need to act yourself (for example, signing in to a website or completing two-factor verification), you can **take control** of the keyboard and mouse. Taking control **does not pause the Agent**: the Agent keeps running, and your actions may happen at the same time as its actions. When you are done, click **View only** to hand back the keyboard and mouse.

## Availability

| Platform | Support | Notes |
| - | - | - |
| Desktop app | Supported | View, full screen, take control |
| Web app | Supported | View, full screen, take control |
| Mobile web | Partial | View only, cannot take control |

Requires [Plus](https://docs.aihubmix.com/en/cloud/plus/plus-plan.md) and a running cloud server.

## Entry points

* The **Cloud server** button in the session top bar, or the shortcut `` ⌃` `` (`` Ctrl+` `` on Windows), opens the **Cloud server** tab in the right drawer.
* **View cloud server** (opens view only) or **Take control** (opens and takes control directly) in **Needs you on the cloud server**.
* The desktop preview or **Open desktop** on the Cloud server page: opens directly in full screen.

## View the desktop in the drawer

The drawer shows the live screen, the connection status, and the system, egress IP, and region. **Manage cloud server ›** opens the Cloud server page. The bottom right of the view shows who is currently in control: **You have control**, **Waiting for you**, or **Agent is working**.

* When you have no cloud server, the drawer offers a **Get a cloud server** button. When the cloud server is not running, it tells you the desktop is available once the cloud server is running.
* The view only screen does not support the clipboard, so you cannot copy content from the remote desktop.

## Full screen

* Click the drawer's full screen button, double-click the view in view only mode, or press `⇧⌘F` (`Ctrl+Shift+F` on Windows) to enter full screen. **Open desktop** on the Cloud server page also opens full screen directly.
* The full screen top bar shows who is in control, plus **Take control** / **View only** and **Exit full screen**.
* Press `Esc` or click **Exit full screen** to exit. When focus is in the remote desktop, `Esc` is sent to the cloud server, so click **Exit full screen** instead.

## Take control of the cloud server

### Steps to take control

1. Click **Take control** in the drawer or the full screen top bar.
2. If sessions are running on the cloud server, **Take control of the cloud server?** appears first. It lists the running sessions and reminds you that the Agent does not pause. Click **Take control** to continue, or **Cancel**.
3. After you take control, the top bar shows the time in control and **View only**, and the view label changes to **You have control**.

You cannot take control while disconnected or after reaching a limit.

### End control

| How it ends | Result |
| - | - |
| Click **View only** | The keyboard and mouse are handed back, and the view returns to view only |
| No input for 30 minutes, or the connection drops | Ends automatically and returns to view only |
| Taking control in another window or on another device | The one that took control last gets the keyboard and mouse, and this one returns to view only. Click **Take control** to switch back when needed |

After control ends, each session that ran on the cloud server during that time gets a record **You used the cloud server for N minutes. The agent wasn’t affected.** The Agent also learns that you just used the desktop the next time you send a message.

## When the Agent asks you to act on the cloud server

When the Agent reaches a step you must complete yourself (for example, signing in to an account or entering a two-factor code), **Needs you on the cloud server** appears above the composer.

* Click **Take control** to open the drawer and take control directly (or click **View cloud server** to open it view only).
* When done, click **Resolved** and the Agent continues. If it is no longer needed, click **Not now**.

See [User intervention](https://docs.aihubmix.com/en/cloud/sessions/user-intervention.md).

## Connection states

| What you see | What you can do |
| - | - |
| **Connecting to the cloud server…**, **Desktop starting, connecting shortly…**, **Getting the desktop ready**, **Reconnecting…** | Wait. It connects automatically |
| **The desktop isn’t ready yet** | Click **Retry** |
| **Can’t reach the cloud server** or **The desktop didn’t connect…** | Close other desktop windows, then click **Try again** |
| **Desktop traffic or window limit reached…** | Close other desktop windows, or click **Try again** later |
| **Today’s desktop traffic is used up…** | Open it again the next day. Agents and tasks are not affected |
| **Desktop unavailable** | After recovery, it shows **The desktop is back. You can reconnect** |
| **This cloud server doesn’t support the desktop yet** | Nothing to do. The platform upgrades it automatically |

* While disconnected, timed out, or limited, the Agent keeps working on the cloud server. You just cannot see the screen for now.
* The refresh icon on the right of the status line reconnects manually.

## Desktop traffic and views

* Remote desktop traffic is counted per day. The **Traffic** row on the Cloud server page shows today's usage and the limit (as shown in the interface). It resets every day at 00:00 UTC, and you receive an in-app notification when usage reaches a certain percentage.
* A cloud server can have at most 3 desktop views open at once.
* The drawer tab uses desktop traffic only while it is visible.
* Desktop traffic affects only the remote desktop view. It does not affect the Agent or running sessions.

## Notes and limitations

* Taking control does not pause the Agent. When you need the Agent to wait for you, have it ask you in the session, or stop the current turn first.
* Mobile web is view only and cannot take control.
* Sessions whose run mode is **On your device** can also open the cloud server drawer, but their actions do not appear in the view.

## FAQ

### Does the Agent stop and wait for me after I take control?

No. Taking control only gives you the keyboard and mouse. The Agent keeps running, and your actions may happen at the same time as its actions.

### Why can I only view, not act, in this window?

You took control of the cloud server in another window or on another device, so this one switched to view only automatically. Click **Take control** to switch control back.

### If the view disconnects, does the session stop?

No. The view connection and the running session are separate. The Agent keeps working while disconnected.

## Related

* [Cloud server overview](https://docs.aihubmix.com/en/cloud/cloud-host/overview.md)
* [Cloud server admin access](https://docs.aihubmix.com/en/cloud/cloud-host/admin-permission.md)
* [User intervention](https://docs.aihubmix.com/en/cloud/sessions/user-intervention.md)
* [Right drawer](https://docs.aihubmix.com/en/cloud/interface/right-drawer.md)


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