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…
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
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.
Run recoup orgs list --json [--account $RECOUP_ACCOUNT_ID] to get all organizations
For each organization, run recoup artists list --org {organization_id} --json [--account $RECOUP_ACCOUNT_ID] to get its artists
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
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:
---
artistName: {Artist Name}
artistSlug: {artist-slug}
artistId: {uuid-from-recoupable}
---
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 Recoupdon't have the plugin yet? install it then click "run inline in claude" again.