setup-sandbox
Set up the initial file system for a new sandbox. Fetches the account's organizations and artists via the Recoup CLI and scaffolds the folder structure. Use when a sandbox has just been created and has no existing file system. Before running, check if the sandbox already has an orgs/ directory — if
By recoupable · 1,622 installs
npx skills add recoupable/setup-sandbox --skill setup-sandbox
Source repository · Upstream listing
Setup Sandbox
Create the folder structure for the connected account's organizations and artists.
Environment
RECOUP ACCOUNT ID — The account ID to fetch data for. Only needed when using an Org API Key. When using a Personal API Key, omit the account flag and the CLI will use the authenticated account automatically.
Steps
1. Check if RECOUP ACCOUNT ID is set. If set, use account $RECOUP ACCOUNT ID on all CLI commands below. If not set, omit the account flag.
2. Run recoup orgs list json [ account $RECOUP ACCOUNT ID] to get all organizations
3. For each organization, run recoup artists list org {organization id} json [ account $RECOUP ACCOUNT ID] to get its artists
4. Create the folder structure and a RECOUP.md marker in each artist folder:
Use artistSlug from the CLI response as the exact directory name — never append UUIDs, IDs, or suffixes
If orgs/{org}/artists/{artist slug}/ already exists, skip it
mkdir p orgs/{org}/artists/{artist slug} for each new artist
Write a RECOUP.md using the template below
5. Commit and push:
git add A && git commit m "setup: create org and artist folders" && git push origin main
RECOUP.md
Every artist directory has a RECOUP.md at its root. This is the identity file — it connects the workspace to the Recoupable platform. The existence of this file means the workspace is active.
Fill it with data from the CLI response:
Fields:
artistName — display name from the CLI (e.g. Gatsby Grace )
artistSlug — lowercase kebab case folder name (e.g. gatsby grace )
artistId — the UUID from Recoup