> For the complete documentation index, see [llms.txt](https://dsg-3.gitbook.io/dsg-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dsg-3.gitbook.io/dsg-docs/agent-user-guide-en.md).

# Agent user guide — English

A no-code DSG ONE guide for Cloud Computer access, Native Linux commands, approvals and evidence

**Updated:** 24 October 2026

[Open DSG ONE Cloud Computer](https://dsg-one-cloud-computer-dmsmbp.v2.appdeploy.ai/) · [Open AWS Workroom](https://dsg.pics/dsg/workroom)

## Use Cloud Computer

1. Click **Continue with Google**
2. Click **Connect DSG** until **OAUTH VERIFIED** and **DSG OAuth VERIFIED** are visible
3. Select **Check DSG Native status** and click **Run check**
4. Open **Job timeline** for the provider result and Evidence

The latest live test verified Linux machine 2 as dsg-linux-desktop-crd-20261020 and kept Cinema machine 1 separate.

## Send a Native Linux command

1. Select **Send Native Linux command (approval required)**
2. Click **Check permission**
3. Click **Prepare plan and request approval**
4. Open the request from the same Job, inspect target and payload, then approve it as the owner
5. Return to AppDeploy and click **Check approval and continue**
6. Expand **Result and evidence**

The verified path is route.desktop-native.shell-exec → node.desktop-native with a Signed Permit. The latest acceptance returned real Linux output and returncode=0.

## Runtime states

| State             | Meaning                                                       |
| ----------------- | ------------------------------------------------------------- |
| PASS/COMPLETED    | Provider result and verifiable Evidence are present           |
| WAITING\_APPROVAL | The owner must approve the exact request                      |
| BLOCKED           | A policy or security gate denied the request                  |
| FAILED            | The adapter or provider failed                                |
| OUTCOME\_UNKNOWN  | The destination result is unknown; do not retry automatically |

## Boundaries

* desktop\_gui=true is a capability readback, not proof of a GUI action
* A governed route for desktop\_launch, desktop\_screenshot or desktop\_click with Plan/Approval/Evidence is not yet verified
* Cinema connected/status does not prove a Meta login or a successful browser action
* Never send passwords, OTPs, Tokens, PINs or start-host codes in chat
* GitBook Git Sync remains blocked by Git provider permission/authentication; this documentation update uses a GitBook Change Request with an audit trail

Operating principle: no permission, no action; no provider result, no completion claim; no Evidence, no closure.
