---name: recoup-roster-list-artistsdescription: See who's on your roster — answers "what artists do I have" by walking the workspace and falling back to your live account when the filesystem is empty. Use for "what artists do I have", "list my roster", "who's on my roster", or "what's in this sandbox". To add a new artist use recoup-roster-add-artist; to work inside one artist's files use recoup-roster-manage-artist.---

Recoup — List Artists

Inventory the roster. Artist dirs live at artists/{artist-slug}/; RECOUP.md (frontmatter artistName/artistSlug/artistId) is the identity file.

Procedure

Walk the filesystem when it's a real sandbox (ls -d artists/*/, find artists -name RECOUP.md); if artists/ is missing/empty, fall back to recoup-platform-api-access roster discovery (GET /accounts/id → GET /organizations → GET /artists?org_id=…).

Never report an empty roster from a missing filesystem — an empty artists/ dir is not an empty roster; confirm against the live account first.

Guardrails

• Never invent a roster/artist — empty filesystem ≠ empty roster.
• Report names + identity (slug/id), not a raw JSON dump.