Skip to content

armgit / cua

Public Imported from GitHub
0

Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.

docs: set up Cua Spaces from Dots, pi and other agents

injaneityda94f399a28f
diff --git a/docs/content/docs/spaces/guides/meta.json b/docs/content/docs/spaces/guides/meta.json
index 07a7665f44..b72d64b62d 100644
--- a/docs/content/docs/spaces/guides/meta.json
+++ b/docs/content/docs/spaces/guides/meta.json
@@ -16,6 +16,7 @@
"cua-volume",
"persistent-agents",
"create-a-space-with-the-sdk",
+ "use-grok-bot-dots-and-pi-with-spaces",
"---Keep it working---",
"troubleshoot",
"uninstall",
diff --git a/docs/content/docs/spaces/guides/use-grok-bot-dots-and-pi-with-spaces.mdx b/docs/content/docs/spaces/guides/use-grok-bot-dots-and-pi-with-spaces.mdx
new file mode 100644
index 0000000000..7bcc90d80c
--- /dev/null
+++ b/docs/content/docs/spaces/guides/use-grok-bot-dots-and-pi-with-spaces.mdx
@@ -0,0 +1,75 @@
+---
+title: Use Grok Bot, Dots and pi with Spaces
+description: "Set up Cua Spaces from Grok Bot or Dots, or use a Space as your pi workspace."
+---
+
+import { Callout } from 'fumadocs-ui/components/callout';
+
+Use Cua Spaces from your agent's Linux computer or as a workspace for pi.
+
+| You want | Use |
+| --- | --- |
+| Your agent to set up a controllable Linux VM | Grok Bot or Dots |
+| Your local pi session to work on a Space | pi with pi-cua |
+
+## Grok Bot and Dots
+
+Both agents have their own Linux computer. Paste this prompt into either agent:
+
+```text output
+set up cua spaces on your computer as a controllable linux vm (not a container), giving yourself kvm access if needed. once you've set it up, walk me through what cua spaces can do, and how to make the most of it.
+```
+
+The agent sets up a controllable Linux VM, not a container. You only need to paste the prompt. Here is a short example of what it runs.
+
+Install the CLI:
+
+```bash skip="host-install"
+curl -fsSL https://cua.ai/install.sh | sh -s -- --cli-only --yes
+```
+
+Check the runtime, create a VM, and list Spaces:
+
+```bash test="cli-shape" id="agents-local-vm"
+cua runtime doctor
+cua sb create linux --kind vm --name dev-vm
+cua spaces ls
+```
+
+QEMU needs read and write access to `/dev/kvm`. The agent can check access and grant it if needed.
+See [Install Cua](/spaces/guides/install) and [Connect your agent](/spaces/guides/connect-your-agent).
+
+## pi
+
+Use the public [pi-cua extension](https://github.com/injaneity/pi-cua) with local Spaces or [computers you add](/spaces/guides/add-a-computer).
+
+Install the extension:
+
+```bash skip="third-party-cli"
+pi install git:github.com/injaneity/pi-cua
+```
+
+Open pi and run `/space`. If pi was already open, run `/reload` first.
+
+| Command | Action |
+| --- | --- |
+| `/space` | List Spaces and open the picker. |
+| `/space <name>` | Enter a Space. |
+| `/space local` | Bring work back into your checkout and run locally. |
+| `/space create [name]` | Create a Space, after confirmation. Requires a supported local runtime. |
+| `/space delete <name>` | Delete a Space, after confirmation. |
+| `/space auth` | Check the GitHub CLI on the Space without showing credentials. |
+
+The Space needs Node.js 22+ and Git. pi is not installed on the Space. Local Spaces need no Cua account.
+
+pi stays on your computer with your extensions, skills, settings and model keys.
+On a chosen Space, workspace tools (`read`, `write`, `edit`, `bash`, `find`, `grep` and `!`) run there.
+When you return with `/space local`, Git changes come back to your checkout and workspace tools run locally again.
+
+<Callout title="Credentials stay on their own machine">
+No tokens, SSH keys or credential files are copied.
+</Callout>
+
+Linux and macOS Spaces are supported. Windows is experimental and not runtime-tested; it uses Git for Windows Bash.
+Submodules are not transferred. Transfers are limited to 200 MiB.
+Sessions on one Space share its user, files and logins.