cua teleport
Move a desktop app session into a sandbox.
Move a desktop app session into a sandbox.
| Command | Description |
|---|---|
cua teleport providers | List the apps this machine can teleport (JSON). |
cua teleport manifest | Describe what teleporting an app would move (JSON). |
cua teleport push | Teleport an app session into a sandbox. |
Every command also accepts the global options.
Move a desktop app session (tabs, profile, sign-in) into a sandbox.
cua teleport [OPTIONS] <COMMAND>cua teleport providers#List the apps this machine can teleport (JSON).
cua teleport providers [OPTIONS]Examples
cua teleport providerscua teleport manifest#Describe what teleporting an app would move (JSON).
cua teleport manifest [OPTIONS] --app <APP>| Flag | Type | Default | Description |
|---|---|---|---|
--app | string | required | App: a bundle id or app name ("com.google.Chrome", "Slack", "claude-code"). |
--scope | string | full | tabs (open tabs and session state) or full (the whole profile). |
--profile | string | Chrome profile to capture: a name ("Profile 1") or a path. | |
--display-name | string | Display name for the app (UI only). |
Examples
cua teleport manifest --app com.google.Chrome --scope tabscua teleport push#Teleport an app session into a sandbox.
cua teleport push [OPTIONS] --app <APP>| Flag | Short | Type | Default | Env var | Description |
|---|---|---|---|---|---|
--app | string | required | App: a bundle id or app name ("com.google.Chrome", "Slack", "claude-code"). | ||
--scope | string | full | tabs (open tabs and session state) or full (the whole profile). | ||
--profile | string | Chrome profile to capture: a name ("Profile 1") or a path. | |||
--display-name | string | Display name for the app (UI only). | |||
--sandbox | -s | string | Destination sandbox (name). | ||
--url | string | Destination cua-spacesd URL instead of a sandbox. | |||
--token | string | CUA_ENV_TOKEN | Token for --url. | ||
--include | string | Send exactly this manifest item (repeatable; see manifest). Default: the provider's default selection, which leaves credentials-heavy or bulky items (cookies, transcripts) out unless named here. | |||
--all | boolean | false | Send every item the scope offers. | ||
--no-launch | boolean | false | Do not launch the app in the sandbox after importing. | ||
--progress | boolean | false | Print progress <sent> <total> lines while uploading. | ||
--relay-plaintext-ack | boolean | false | Send over a relay: destination even though this Space's image predates end-to-end sealing (S1): without this, such a send refuses before reading or uploading anything. Set it only after you understand that relay.cua.ai (or a self-hosted cua-relay) could read this delivery in the clear; local and direct destinations are unaffected either way. |
Examples
# Chrome's open tabs into the sandbox dev
cua teleport push --app com.google.Chrome --scope tabs --sandbox dev
# The whole Slack profile, every item
cua teleport push --app Slack --sandbox dev --all| Code | Meaning |
|---|---|
0 | Success. |
1 | Failure, or cua do reported an error. |
2 | Invalid argument, or an ambiguous sandbox name (qualify it: local:NAME, cloud:NAME). |
3 | Not found: sandbox, window, skill or image (or an image not published yet). |
4 | Not supported, or not configured (for example no Fleet credentials). |
5 | No cua-spacesd answered, or a transport failure. |
6 | Unauthenticated or permission denied (by Cua, Fleet or your cloud account). |
7 | Not enough free disk space (see cua cache). |
130 | Cancelled (Ctrl-C during a create): what it made was removed. |