Overview
The Avisi Playground: Playhouses and Playrooms. What each is, how they differ, and when to use which.
Alpha
The Playground is in active development. Commands, flags, and output may change between releases.
The Avisi Playground is two things that work together: a Playhouse (a persistent, shared cluster that AME sets up for you) and the Playrooms that run inside it: disposable, per-user workspaces you reach over SSH, usually running an AI coding agent.
Playhouse (Kubernetes cluster, persistent)
┌───────────────────────────────────────────────┐
│ Playroom my-room (one pod, your box) │
│ Playroom api-spike (one pod, a teammate) │
│ Playroom … │
└───────────────────────────────────────────────┘You create a Playhouse once, then everyone creates and throws away Playrooms inside it.
The two concepts
Playhouse
The shared environment: an opinionated Kubernetes cluster that hosts Playrooms. Long-lived infrastructure: you create it and delete it, and it stays up in between.
Playroom
Your personal workspace: a single pod inside a Playhouse, reached over SSH. Easy to create, safe to disassemble again, and where the AI agent actually runs.
How they differ
| Playhouse | Playroom | |
|---|---|---|
| What it is | A Kubernetes cluster | A single pod inside a Playhouse |
| Scope | Shared by a team | Personal to one user |
| Lifetime | Long-lived (persists) | Disposable |
| Lifecycle | create, delete | create/play, stop, start, delete |
| You manage it with | acloud playhouse … | acloud playroom … |
| How often you touch it | Rarely (set up once) | Constantly (many per day) |
Stopping and starting is a Playroom concept (the pod scales to zero and back). A Playhouse has no stop/start; it is either created or deleted, and stays running in between.
When to use which
Set up a Playhouse
Once per team or project, to create the shared environment Playrooms live in. Needs a Tailscale OAuth client for SSH connectivity.
Create a Playroom
Every time you want a fresh sandbox: to run an AI agent against a repo, try risky commands off your laptop, or do remote development.
Commands at a glance
Playhouse commands
create · delete · list
Playroom commands
create · play · connect · open · start · stop · delete · list