Skip to content
Browse the docs

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.

Updated 1 min readView as Markdown

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.

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.