Artist Workspace

Every artist has a workspace — a directory that holds context, songs, and reference material. The RECOUP.md file at the root connects it to the Recoupable platform.

Artist directories live inside the sandbox at artists/{artist-slug}/. The sandbox is already scoped to a single Recoupable organization (its repo is the org), so artists live at the top level — there is no orgs/ directory.

Listing what's in the sandbox

When the account asks "what artists do I have", "list my artists", "which orgs am I in", or any other inventory question about the sandbox, walk the filesystem — it is authoritative for this sandbox. Do not call the Recoupable API for this: the API answers "what artists does this account have access to across everything", which is a different (and usually larger) set than what the sandbox was opened for.

# All artist workspaces in this sandbox
ls -d artists/*/ 2>/dev/null

# Every artist's identity file — read the frontmatter for name/slug/id
find artists -type f -name RECOUP.md 2>/dev/null

Each RECOUP.md has frontmatter (artistName, artistSlug, artistId) — read it with head or any YAML parser to get the canonical identity.