Sandscape CLI
The local-dev round-trip for Sandscape games — login, pull, edit, and push with your own tools. AI asset generation stays on the Sandscape platform.
Bring a Sandscape game onto your machine, edit it with the tools you already use, and send the result back without giving up the platform workflow.
It ships the sandscape-cli Agent Skill, so any coding agent — Claude Code,
Codex, Cursor, or OpenCode — can drive the whole loop for you.
Start with your coding agent
Paste this into your coding agent. It installs the skill and guides you through a one-time browser login.
Ensure Node.js (>= 18) is installed.
Install the Sandscape skill globally:
npx -y @sandscape/cli@latest skill install
Then use it to build or edit a Sandscape game. It will walk you through a
one-time browser login (open the link it shows and approve) — then you're set.Prefer the terminal? The same workflow is available directly through npx; see
Installation.
AI generation stays on the platform
You can't generate AI assets (3D models, images, audio) locally — that runs on Sandscape, where it's coin-metered. Edit code and hand-authored files locally and push them; generate or regenerate assets in the Sandscape web app, then pull them down.
Choose your path
Install the skill
Set up Claude Code, Codex, Cursor, or OpenCode in one command.
Make your first round-trip
Clone or pull a game, edit locally, then push it back safely.
Import your own game
Bring an existing game folder into Sandscape with init.
Browse the CLI reference
Commands, flags, exit codes, JSON events, and troubleshooting.
Lightweight by design
The CLI installs instantly and runs anywhere Node.js 18+ is available — it has no
runtime dependencies, so npx @sandscape/cli never pulls a dependency tree.