Set up the CLI

The Sandscape CLI requires Node.js 18 or newer.

Use it with a coding agent

Open Claude Code, Codex, Cursor, OpenCode, or another agent that supports SKILL.md files in your game folder. Paste this prompt:

Ensure Node.js (>= 18) is installed.
Install the Sandscape skill globally:
  npx -y @sandscape/cli@latest skill install
Then use it to interface with the Sandscape platform.

The skill tells the agent how to inspect the current folder, log in, connect or clone a project, sync files, and prepare a publication. It does not give the agent permission to rewrite your game.

Most agents discover new skills when they start. Restart the agent if you installed the skill during an open session and it does not recognize sandscape-cli.

If you already use the public skills registry, you can install the same skill with:

npx -y skills@latest add sandscape-labs/skills -g -y

Run it from a terminal

Run the latest version through npx:

npx -y @sandscape/cli@latest <command>

You can also install a global sandscape command:

npm install -g @sandscape/cli
sandscape --help

Installing the skill and installing the command are separate actions. skill install adds instructions for coding agents. It does not add sandscape to your PATH.

Choose where the skill is installed

sandscape skill install
sandscape skill install --all
sandscape skill install --harness codex
sandscape skill install --here
sandscape skill install --here ./my-game

Valid harness names are claude, codex, cursor, opencode, and agents.

The global installation locations are:

clone and init also add the skill to the project. A coding agent opened in that folder can therefore use the Sandscape workflow even if the skill is not installed globally.

Troubleshooting

If npx reports an engine error, check your Node.js version:

node --version

Upgrade to Node.js 18 or newer before running the CLI.