Installation

There are two ways to install the Sandscape skill into your coding agent. Both drop the same sandscape-cli skill into the agent's global skills directory (Claude Code, Codex, Cursor, OpenCode), and both need Node.js 18 or newer.

Self-contained (recommended)

No third-party installer — just the Sandscape CLI itself:

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.

Via the skills ecosystem

If you already use the skills CLI:

Ensure Node.js (>= 18) is installed.
Install Sandscape Skills:
  npx -y skills@latest add sandscape-labs/skills -g -y
Then use them to build or edit a Sandscape game.

Either way, the skill then drives a hands-off login and the local pull → edit → push loop.

The skill is instructions, not a binary

Installing the skill loads the guidance into your agent — it does not put a sandscape command on your PATH. The CLI runs through npx. Throughout these docs, commands are written as bare sandscape … for brevity; read that as npx -y @sandscape/cli@latest … (or a real sandscape if you installed one globally — they're interchangeable). So sandscape pull means npx -y @sandscape/cli@latest pull.

Where the skill lands

skill install drops the sandscape-cli skill into each detected agent's global skills directory (~/.claude/skills, ~/.codex/skills, ~/.cursor/skills, ~/.config/opencode/skills) plus the cross-tool ~/.agents/skills. Flags let you narrow or redirect it:

• --all — install into every known directory (the four above plus .agents).
• --harness claude,codex,… — restrict to specific agents.
• --here [dir] — install into a project's .claude/ + .agents/ instead of globally.