# Desktop and Terminal

> Open an agent’s graphical desktop or a shell on its machine to watch work, verify results, or finish a sign-in, from the task panel or Settings → Agents.

Section: Your agents · Updated: 2026-11-19 · Canonical: https://nested.me/docs/desktop-terminal

Each agent runs on its own machine in your cluster. Desktop shows that machine’s graphical session; Terminal opens a shell on it. Use them when watching or running a command is faster than reading a chat summary — for example, to confirm a tool is installed or to finish a sign-in that needs a browser.

## Before you start

- The agent must be running. Until it is, Nested shows: “This agent is not running yet. Desktop and Terminal open when the deployment is ready.”

## Steps

1. Open Desktop or Terminal from the task panel’s **Session** section (on desktop, each view opens as a tab beside **Chat**; select **Connect** to start it), from **Settings → Agents → More actions** (**Open the desktop of {name}** or **Open the terminal of {name}**), or with **Open Desktop** on a sign-in card when the vendor login needs a browser.
2. In the full-screen session view, switch between **Desktop** and **Terminal** with the tabs.
3. Select **Back to chat** to return, or **Close session** to end it.

> [!NOTE]
> An agent allows a limited number of open sessions. If Nested says too many are open, close one and try again.

## Example

The agent says it installed a CLI. Open **Terminal** from the task panel and run the CLI’s version command to confirm before you continue the task.

## Questions

### Why are Desktop and Terminal disabled?

The agent is not running yet, or it stopped. Start it, wait until it is ready, and the buttons become available.

## Related

- [Agent sign-in, accounts, and auto-stop](https://nested.me/docs/agent-accounts)
- [The task panel, changes, and worktrees](https://nested.me/docs/task-panel)
- [Site logins](https://nested.me/docs/site-logins)
