Playroom
Manage playrooms, interactive AI agent runtimes hosted in a Playhouse.
Alpha
Playrooms are in active development. Commands, flags, and output may change between releases.
What it is
A playroom is a remote workspace in the cloud that you reach over SSH. It usually runs an AI coding agent (for example, opencode), but you can treat it as a normal Linux box too: a shell, a code editor over SSH, a place to clone a repo and run things.
Playrooms run inside a Playhouse a shared Kubernetes cluster that Avisi Cloud sets up to host them. You don't manage the Playhouse; you just pick one and create playrooms in it.
Your laptop Playhouse (Kubernetes cluster)
┌───────────┐ ┌──────────────────────────────┐
│ acloud │ │ playroom-a │
│ CLI │ ──SSH via TS──► │ playroom-b (agent+shell) │
│ │ │ ... │
└───────────┘ └──────────────────────────────┘Why use it
Fast
No local setup. Spin up a ready-to-use environment in seconds.
Disposable
Run a one-shot task in a fresh sandbox and throw it away.
Isolated
Each playroom has its own storage and Kubernetes permissions. Work in one can't touch another.
Consistent
Everyone gets the same pre-built image with the same tools.
Safe for secrets
Tokens and SSH keys are opt-in; nothing leaks into the sandbox unless you explicitly forward it.
Agent-ready
AI coding tools like claude and opencode are pre-installed. The only thing you bring is a login.
Typical uses: running an AI agent against a repo, trying risky commands without touching your laptop, remote development from a thin client, or short automated tasks that clean up after themselves.
Key concepts
Playhouse
The shared cluster that hosts playrooms. You select it with -p.
Playroom
Your personal workspace (one pod) inside a Playhouse.
Owner
The email tied to a playroom. Others can't delete it by accident.
Persistent vs ephemeral
Whether your home directory survives a restart.
Options
Prop
Type
Options inherited from parent commands
Prop
Type
Quick links to commands
playroom connect
SSH into a playroom
playroom create
Create a new playroom in a Playhouse
playroom delete
Delete a playroom from a Playhouse
playroom list
List playrooms in a Playhouse
playroom open
Open a playroom in your preferred editor
playroom play
Spin up a playroom seeded with a local directory
playroom start
Start a stopped playroom
playroom stop
Stop a playroom, keeping its storage
playroom update
Change a running playroom's settings in place
SEE ALSO
- Getting started: from zero to a running playroom end-to-end
- How it works: Kubernetes internals, lifecycle, storage, and secrets
- Commands: all acloud playroom subcommands
- acloud: a command-line interface for Avisi Cloud