playroom play

Create a fresh playroom seeded with a local directory, connect over SSH, and optionally run a command, all in one step.

Alpha

This command is in active development. Flags and behaviour may change between releases.

Create a fresh playroom, copy a local directory into it, then connect over SSH, optionally running a single command before exiting.

play is the fastest way to get a remote AI agent working on your local code without any manual setup steps.

acloud playroom play [DIR] [-- CMD ARGS...] [flags]

How it works

Creates a fresh playroom named basename-random4 (e.g. my-api-a3f9). Multiple runs from the same directory create independent sandboxes.

Copies DIR (default: current working directory) into /home/playroom/workspace/basename inside the playroom. Skip with --no-copy.

Connects over SSH with the uploaded directory as the working directory. Opens an interactive shell if no CMD is given, or runs CMD and exits.

If --rm was passed, deletes the playroom (and clears it from cache) once the session or command exits.

Examples

# drop into a shell at your current directory (playroom persists after exit)
acloud playroom play -p playhouse-demo --env GITLAB_TOKEN

# run claude, then auto-delete the playroom on exit
acloud playroom play -p playhouse-demo --env ANTHROPIC_API_KEY --rm -- claude

# skip the PVC entirely for faster spin-up (nothing persists across restarts)
acloud playroom play -p playhouse-demo --env ANTHROPIC_API_KEY --rm --ephemeral -- claude

# use a different directory instead of the current one
acloud playroom play ~/work/api -p playhouse-demo --env ANTHROPIC_API_KEY -- claude

Options

Prop

Type

Options inherited from parent commands