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, walk the filesystem when this is a real sandbox — a populated artists/ tree is authoritative for the sandbox, and the API would answer the broader "what can this account access across everything" question instead.

The filesystem is only authoritative when it exists. If artists/ is missing or empty — e.g. you're an API-key install rather than an open-agents sandbox — the filesystem can't answer the question. Do not report an empty roster; fall back to the API via the recoup-api skill's Roster discovery (GET /organizations → GET /artists?org_id=…), which lists the artists the credential can actually see.

# 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