> ## Documentation Index
> Fetch the complete documentation index at: https://docs.augmentcode.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Open Desktop

> Open a virtual desktop inside a Cosmos cloud session to see and interact with graphical apps the agent runs.

## About Desktop

The **Desktop** panel opens a virtual desktop inside your Cosmos cloud session. It lets you see and interact with graphical apps the agent runs, such as a browser for a sign-in step or a visual test. Desktop is optional for normal chat and coding tasks.

The desktop runs in the session's cloud environment, separate from the desktop on your laptop. The panel sits in the right sidebar of a [Session](https://docs.augmentcode.com/cosmos/sessions-overview.md), under the **Desktop** heading.

On a shared Session, the Desktop panel and **Open Desktop** are limited to people who can modify the Session. Viewers can read the conversation while the panel stays hidden, even after the environment is running.

## Start the session first

**Open Desktop** stays disabled until the session environment is running. When nothing is set up yet, the panel shows **No desktop set up.** and **Start the session to open a desktop.**

![Desktop panel with Open Desktop disabled and the hint to start the session](https://mintcdn.com/augment-mtje7p526w/Pugq55LLsPeGSYK9/images/cosmos-desktop-session-stopped.jpg?fit=max\&auto=format\&n=Pugq55LLsPeGSYK9\&q=85\&s=b8758282d79e715b3e12a86c91d703c5)

Start or resume the Session in Cosmos. Sending a message restarts a paused Environment automatically. Once the environment is running, **Open Desktop** is available in the right sidebar for anyone who can modify the Session. See [Session lifecycle](https://docs.augmentcode.com/cosmos/sessions-overview.md#session-lifecycle).

## Open Desktop

**1. Open the right sidebar**

With the Session open and its environment running, open the right sidebar.

**2. Click Open Desktop**

In the **Desktop** section, click **Open Desktop**.

**3. Wait for setup**

Cosmos opens the **Desktop** tab as soon as setup starts. The panel shows **Installing desktop (first time only, \~1–2 min)...** while that runs. Graphical apps become usable once the desktop connects.

**4. Use the Desktop tab**

After the desktop connects, you can see and interact with graphical apps running in the session.

![Desktop panel installing the desktop, about 1–2 minutes](https://mintcdn.com/augment-mtje7p526w/Pugq55LLsPeGSYK9/images/cosmos-desktop-installing.png?fit=max\&auto=format\&n=Pugq55LLsPeGSYK9\&q=85\&s=517865920a32e4395dbb83f761dd9721)

Cosmos reuses that install on the same virtual machine. Click **Open Desktop** again to return to the **Desktop** tab. If a paused Session resumes on a fresh machine, setup can run again, because that machine may not have the desktop software yet.

> [!NOTE]
>
> Leave Desktop closed for ordinary chat and coding. The agent can still read repositories, run commands, and use its tools without it.


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