piperhex/remoteai/cua-spaces

Claude Code and agent skill by piperhex/remoteai

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

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.

Install

npx vskill@latest install piperhex/remoteai/cua-spaces

SKILL.md

cua Spaces

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.

Get a Space

ToolUse
list_spacesSee the Spaces you can use. Start here.
create_spaceA new Space: on = local (free, the user's machine), aws, gcp or modal (the user's own cloud account, billed there), 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_spaceRegister an existing machine by URL and token, or forget one without deleting it.
delete_spaceDelete a Space's sandbox and stop its cost.
stop_space / start_spaceTurn 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 Space in the user's own cloud account costs money: delete the ones you created when the task ends.

Work in it

ToolUse
space_bashRun a shell command (space, command, optional timeout).
space_writeWrite text to a file.
upload / downloadCopy files or folders in and out.
send_fileDrop a host file into the Space's Downloads (sha256 verified).
list_tools / call_toolReach MCP services running inside the Space.

Show it to the user

ToolUse
open_space_viewerOpen the full desktop viewer.
show_space_pip / hide_space_pipPicture-in-picture on the user's screen.
list_space_windows / stream_space_windowShow one window from the Space.
stream_endpointGet a ticketed media URL for the desktop or a window.

Agents, apps and network

ToolUse
agent_capabilitiesWhich agent harnesses the Space supports.
agent_startStart an agent run (space, agent, prompt).
agent_status / agent_message / agent_stop / agent_listFollow, steer and stop runs.
teleport_manifestPreview what moving an app session would copy.
teleport_appMove a signed-in app session (tabs, profile) into the Space.
hotspot_start / hotspot_status / hotspot_stopShare the host's network with a Space.

Set up a host over ssh (Tailscale or LAN)

To host Spaces on a machine you reach only over ssh (a spare Mac mini on the user's Tailscale, or the LAN):

  1. ssh into it (Tailscale is only the ssh transport, the same as any LAN or

internet address).

  1. Run the install script non-interactively:

curl -fsSL https://cua.ai/install.sh | sh -s -- -y --select spaces,host --no-onboarding.

  1. Sign in on the mini: 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).

  1. cua host setup --profile spare --name "<name>" hosts Spaces only (no

desktop sharing), through the cua.ai relay.

  1. Tell the user: the mini needs an active GUI login session (cua-spacesd

runs as a LaunchAgent in the Aqua session, so it won't start at the login window; auto-login is recommended for a headless mini), and it needs a one-time grant of Screen Recording and Accessibility to cua-spacesd in System Settings.

  1. From the laptop: 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.

Rules

  • Run teleport_manifest and tell the user what will move before

teleport_app; sensitive items need their explicit acknowledgement.

  • Only start a hotspot when the Space needs the host's network (VPN,

intranet), and stop it afterwards.

  • Name the Space you used in your answer.

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
1,098
Repository forks
41
7-day trend score
0

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/piperhex/remoteai/cua-spaces/badge)](https://verified-skill.com/skills/piperhex/remoteai/cua-spaces)

Something wrong with this skill or its page? Tell us.