{"id":85514,"plugin_id":"plugin_connector_1p_c5b7d5df5d7081918f2c4be5a633ed5d","kind":"skill","collection_source":"plugin_package","comparison_source":null,"observed_at":"2026-11-07T06:11:00.095Z","digest":"b597aad796cd8f862dc1f7d450a7f1d1ef31a26d66cb38dcbf4fe7e29af87c21","against":null,"payload":{"description":"Use in a managed Codex Cloud chat to open a URL in shared Chrome, inspect a Linux app, show the Desktop panel, or diagnose missing computer-use tools.","included_files":[],"name":"cloud-desktop","skill_md_contents":"---\nname: cloud-desktop\ndescription: Use in a managed Codex Cloud chat to open a URL in shared Chrome, inspect a Linux app, show the Desktop panel, or diagnose missing computer-use tools.\n---\n\n# Use the shared cloud desktop\n\nWhen the chat’s environment context identifies a managed cloud executor, use\nits Chrome for “open this URL” or “check in the browser” unless the user\nnames another browser or device.\n\nChrome and native apps share one Linux display (X11). Codex can use the\ncomputer-use tools with the Desktop panel closed. Opening the panel lets the\nuser watch and take control of the same screen. Closing it disconnects the\nviewer and leaves the desktop running.\n\n## What starts on demand\n\nOn an on-demand desktop, Codex can discover the tools and check status while\nthe display stays asleep. The first valid desktop `js` call starts the display\nbefore running the code. Connecting the Desktop viewer also starts it.\nChrome has its own startup setting. When configured to start closed, it\nlaunches on the first browser operation that needs it, such as opening a tab.\n\n## Open and inspect\n\nLook for the desktop JavaScript tool (usually `cua_repl.js`) among the tools\noffered directly to this turn. Follow its first-call instructions. For a new\ntab in Chrome, `await cua.createBrowserTab(\"cdp\", url)` can be the first\naction when offered, even with the panel closed.\nUse `await cua.getState()` to discover available browsers and apps. For an\nexisting tab, follow the runtime’s tab-selection or claiming instructions.\nInspect the page before reporting what loaded. Use Sky for native windows\nor a full-screen screenshot when available.\n\n## Show the user\n\nWhen the user asks to watch or needs to act, such as completing sign-in, call\n`open_in_codex({\"target\":{\"type\":\"cloud-desktop\"}})` if offered. In supported\nCodex desktop chats, the user can also open the right side panel and choose\n**New tab (+) → Desktop**. Let the user **Take over** and select **Return\ncontrol** when finished. Pause agent input during the handoff, then inspect\nthe same page before continuing.\n\n## If control is unavailable\n\nCall `cloud_environment.environment_status({})` and match its `environment_id`\nto the selected executor. Check `capabilities[].remote_desktop`. A cold desktop\ncan report `enabled: true` with `state: unknown`. If the environment is\nstarting, recheck the tools once it is ready. Report the environment ID,\ndesktop status, and which tool was missing or which call failed. Say what\nyou could verify. If only the viewer works, offer to open it for the user.\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}