mcpField
S
setup-sandbox

setup-sandbox

github.com/recoupableProductivity01.6k installsUpdated 31w ago
Repository

About setup-sandbox

setup-sandbox is a skill for creating organization and artist folders for a Recoupable account, aimed at agents managing artist workspaces. It uses the recoup CLI to fetch records and adds a RECOUP.md marker to each new artist directory.

Key features

  1. 01Read account ID configuration
  2. 02Fetch organizations with recoup CLI
  3. 03List artists in each organization
  4. 04Create artist folders and RECOUP.md
  5. 05Commit and push folder changes

Use cases

  1. 01Initialize artist workspaces for an account
  2. 02Create standard folders for new artists
  3. 03Commit newly created sandbox structure

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/recoupable/setup-sandbox --skill setup-sandbox

After installing, type/setup-sandboxin Claude Code to confirm it loaded.

Details

From the project README

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:

---
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 Recoup

Comments

Markdown supported