Skip to main content
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

Requires Plus 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

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.

Connection states

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