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.
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#
- 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.
- In the full-screen session view, switch between Desktop and Terminal with the tabs.
- 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.