Stunt Double Studio
Files and commands
The files
Everything lives in .stuntdouble/ at the project root. Commit all of it
except .live/, which setup adds to .gitignore.
| Path | What it holds |
|---|---|
stuntdouble.json | Project settings: local_base_url, headless, and the workspace a cloud push goes to |
actors/<slug>.json | One actor: name, description, instructions and knowledge |
checklists/<slug>.json | One checklist: its actor, URL, instructions and checks |
runs/<stamp>-<checklist>/ | One run: run.json, activity.jsonl and shots/ |
.live/ | The state of a run in progress. Not committed |
Actors and checklists use the same fields as the hosted server, with slugs in
place of ids, so a cloud push sends them unchanged. Each
check has a key that never changes, since verdicts and cloud ids follow it.
Studio writes the runs/ folders. Don't edit them by hand.
Commands in Claude Code
| Command | What it does |
|---|---|
/stuntdouble:setup | Checks your machine, then writes an actor and a checklist for this project |
/stuntdouble:run <checklist> | Runs a checklist in your local Chrome |
/stuntdouble:run <checklist> resume | Carries on a run that stopped before it finished |
/stuntdouble:open | Opens the viewer |
/stuntdouble:cloud <checklist> | Moves a checklist to a workspace and starts a cloud run |
/stuntdouble:doctor | Checks Node, Chrome, the viewer port and how local runs are billed |
The CLI
The stuntdouble package takes these commands:
npx stuntdouble studio # open Studio in your browser (--port, --no-open)
npx stuntdouble run <checklist> # run one on your model connection (--resume, --max-steps, --cloud)
npx stuntdouble login | logout # sign in or out for cloud runs (--workspace <slug>)
npx -y stuntdouble mcp # the local MCP server over stdio (your agent starts this)
npx stuntdouble view # the read-only viewer over this folder's .stuntdouble/
npx -y stuntdouble doctor # check Node, Chrome, the viewer port and billingstudio and view also take a folder: npx stuntdouble studio path/to/project.
In a terminal, npx stuntdouble on its own opens Studio.