Back to Ruflo

Music

plugins/ruflo-music/commands/music.md

3.38.211.7 KB
Original Source

$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.