plugins/ruflo-music/commands/music.md
$ARGUMENTS
Manage AI music generation via the cogmusic MCP server. Parse subcommand from $ARGUMENTS.
Usage: /music <subcommand> [options]
Subcommands:
connect [--token cogmcp_...] -- One-time setup: register the cogmusic MCP server (see music-connect skill)generate <brief> -- Compose lyrics/prompt from a brief and generate a new track (see music-composer agent + music-generate skill)list -- List all productions in the connected account (see music-list skill)get <production-id> -- Fetch one production's metadata + audio_url (see music-get skill)stems <production-id> -- Run 4-stem separation (see music-stems skill)midi <production-id> -- Extract MIDI/score (see music-midi skill)master <production-id> -- Run a mastering (LUFS) pass (see music-master skill)Steps by subcommand:
connect: Follow the music-connect skill exactly. Do not skip the "check for an existing, working registration first" step.
generate: If the brief needs real lyric/prompt composition (anything beyond a one-line genre tag), delegate to the music-producer agent, which itself defers lyric writing to the music-composer agent before calling mcp__cogmusic__create_production. For a fully-specified brief (explicit lyrics + prompt already given), the music-generate skill alone is enough — no need to spin up the agent pipeline for that case.
list: Run the music-list skill directly — no agent needed for a read-only listing.
get / stems / midi / master: Run the matching skill directly with the given production-id. Look it up via music-list first if the user gave a title instead of an id.
If no mcp__cogmusic__* tools are loaded when any subcommand runs, run connect first and tell the user why.