Work inside cua Spaces through the cua MCP server. A Space is a remote or local computer the user can watch; you can run commands in it, move files in and out, show its desktop or a single window on the user's screen, start coding agents inside it, teleport a signed-in app session into it, and share the host's network with it. Use when the user mentions Spaces, asks you to do work "in a Space", or wants a task isolated but visible.
インストールする前に、エージェントに与えられる指示の中身を確認できます。
Spaces are exposed as MCP tools by the cua MCP server (cua mcp). If the
tools below are missing, ask the user to run cua agents setup or
cua auth login.
| Tool | Use |
|---|---|
list_spaces | See the Spaces you can use. Start here. |
create_space | A new Space: on = local (free, the user's machine), cloud (metered), or host:<name> (one of the user's machines set up with cua host setup); reuse: true returns a reachable one first. |
add_space / remove_space | Register an existing machine by URL and token, or forget one without deleting it. |
delete_space | Delete a Space's sandbox and stop metering. |
stop_space / start_space | Turn a local Space (or one your machines provide) off and back on: suspended or stopped, as power in list_spaces says. |
Prefer an existing Space. A cloud Space costs money: delete the ones you created when the task ends.
| Tool | Use |
|---|---|
space_bash | Run a shell command (space, command, optional timeout). |
space_write | Write text to a file. |
upload / download | Copy files or folders in and out. |
send_file | Drop a host file into the Space's Downloads (sha256 verified). |
list_tools / call_tool | Reach MCP services running inside the Space. |
| Tool | Use |
|---|---|
open_space_viewer | Open the full desktop viewer. |
show_space_pip / hide_space_pip | Picture-in-picture on the user's screen. |
list_space_windows / stream_space_window | Show one window from the Space. |
stream_endpoint | Get a ticketed media URL for the desktop or a window. |
| Tool | Use |
|---|---|
agent_capabilities | Which agent harnesses the Space supports. |
agent_start | Start an agent run (space, agent, prompt). |
agent_status / agent_message / agent_stop / agent_list | Follow, steer and stop runs. |
teleport_manifest | Preview what moving an app session would copy. |
teleport_app | Move a signed-in app session (tabs, profile) into the Space. |
hotspot_start / hotspot_status / hotspot_stop | Share the host's network with a Space. |
To host Spaces on a machine you reach only over ssh (a spare Mac mini on the user's Tailscale, or the LAN):
curl -fsSL https://cua.ai/install.sh | sh -s -- -y --select spaces,host --no-onboarding.cua auth login --remote prints a device code and a
URL. Show both to the user and have them approve it (on another signed-in
device or at the URL).cua host setup --profile spare --name "<name>" hosts Spaces only (no
desktop sharing), through the cua.ai relay.create_space(on="host:<name>", count=2), or
cua spaces create macos:26 --on "<name>" --count 2.host:<name> only resolves machines set up with cua host setup (they
register with the relay). direct:<addr> attaches one Space that is already
running at that address (add_space) and cannot host new ones.
teleport_manifest and tell the user what will move before
teleport_app; sensitive items need their explicit acknowledgement.まだレビューはありません。使ってみた感想をお寄せください。
概要と使いどころ
Drive a native GUI app (macOS, Windows, Linux) via the cua-driver CLI (default) or MCP server; snapshot its accessibility tree, act through snapshot-bound element tokens, native menu paths, exact window geometry, or pixel coordinates, and verify from fresh state. Use when the user asks you to operate, drive, automate, or perform a GUI task in a real application on the host, or to continue, resume, or recall recent Cua activity.
日本語の概要は準備中です。原文の説明を表示しています。
Create, use and clean up cua sandboxes (disposable Linux or macOS computers) locally or in the Cua cloud with the `cua` CLI or the cua SDK, and browse the web inside one. Use when a task needs an isolated machine to run code, test an app, drive a desktop GUI, browse or test a website, fill a web form, take a web page screenshot, or reproduce something without touching the user's own computer.
日本語の概要は準備中です。原文の説明を表示しています。
Use Cua Volume, the one volume every Space and agent of this user shares. Inside a Space it is mounted as a folder (/volume on Linux, ~/Cua Volume on macOS), so any program reads and writes it directly. Use it for anything that must outlive this Space - your memory and outputs in your agent home, shared reference in public/ - and to hand files to the user or to other agents. Use when the user mentions the volume, Cua Volume, shared files, your home or memory, or saving results.
日本語の概要は準備中です。原文の説明を表示しています。
Use when you need to visually interact with a GUI: test buttons, fill forms, verify visual layouts, fuzz web pages, automate user flows, take screenshots, or perform end-to-end QA on any application. Works on cloud VMs, Docker containers, local machines, and sandboxes. Needs the `cua` CLI (curl -fsSL https://cua.ai/install.sh | sh).
日本語の概要は準備中です。原文の説明を表示しています。
Build or adapt a bounded computer-use loop where Cua Driver observes and acts, TypeSafe Jev selects only from application-owned candidate IDs, and the caller validates and verifies every action. Use for the jev-use recipe or similar Jev integrations; do not use it to add model logic or credentials to Cua Driver.
日本語の概要は準備中です。原文の説明を表示しています。
Poll and rank open GitHub issues, RFCs, and pull requests for maintainer work, or start one explicitly selected item. Use when a user asks what to work on, requests backlog priorities, says "poll work," wants actionable issues or pull requests, or says "start
日本語の概要は準備中です。原文の説明を表示しています。