Skip to content

p-poss/dj-claude-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DJ Claude — Claude Code Plugin

Adds live music and multi-agent jam band capabilities to Claude Code. Slash commands and MCP tools for setting vibes, building layered jam sessions, and orchestrating full bands. Agents connect over HTTP to collaborate on music in real-time. No API key or browser required.

Demo

6 Claude Code agents jamming together

Watch on YouTube — 6 Claude Code agents jamming together in real-time.

Why DJ Claude?

  • Multi-agent jam sessions — the first music MCP where multiple agents connect over HTTP and build music together in real-time, each adding layers (drums, bass, melody, etc.) that compose automatically
  • Conductor mode — orchestrate a full band from a single directive, with auto-detected templates (jazz combo, rock band, electronic, ambient, and more)
  • Zero dependencies — no browser tab, no API key, no external services. Every tool works out of the box via presets, vibes, or direct Strudel code
  • 20 MCP tools, 3 resources — the most complete music toolkit available to AI agents
  • Context-aware DJ — tell it what you're coding and the music adapts

Installation

From the marketplace

Once approved on the official Claude Code plugin marketplace:

/plugin install dj-claude

Or add this repo directly as a marketplace source:

/plugin marketplace add p-poss/dj-claude-plugin
/plugin install dj-claude@dj-claude-plugin

Local (for development)

git clone https://github.com/p-poss/dj-claude-plugin
claude --plugin-dir ./dj-claude-plugin

Slash Commands

Command What it does
/dj-claude:play [prompt] Play music from a description
/dj-claude:play-preset [name] Play from 22 curated patterns
/dj-claude:vibe [mood] Set the vibe — chill, dark, hype, focus, funky, dreamy, weird, epic
/dj-claude:conduct [directive] Orchestrate a full band from one directive
/dj-claude:jam [role] [prompt] Add a layer to the jam session
/dj-claude:jam-status Show all active jam layers
/dj-claude:jam-clear [role] Remove one or all layers
/dj-claude:live-mix [prompt] Autonomous DJ set — 5-6 evolving stages
/dj-claude:connect [port] Start HTTP server for multi-agent jam sessions
/dj-claude:hush Stop all music
/dj-claude:now-playing Check what's currently playing
/dj-claude:strudel [code] Evaluate raw Strudel code directly
/dj-claude:browser Switch to browser audio for higher quality
/dj-claude:context [activity] Set coding context so music adapts
/dj-claude:preview [role] [prompt] Preview a jam layer without adding it
/dj-claude:analyze Analyze the mix for frequency balance
/dj-claude:save [name] Save the current mix as a snapshot
/dj-claude:load [name] Restore a saved snapshot
/dj-claude:list-saves List all saved snapshots
/dj-claude:export Export current Strudel code

Examples

/dj-claude:play jazzy lo-fi beats for late night coding
/dj-claude:vibe focus
/dj-claude:conduct jazz combo in C minor, late night mood
/dj-claude:jam drums four-on-the-floor house kick
/dj-claude:connect
/dj-claude:hush

Requirements

  • Audio output on the host machine
  • No API key needed — all tools work without ANTHROPIC_API_KEY via presets, direct Strudel code, or the code/layers parameters. Set the key to enable AI generation from text prompts.

Auto-Allow Permissions

By default, Claude Code prompts for permission on every MCP tool call. To let DJ Claude play music without interruptions, add this to your project's .claude/settings.json:

{
  "permissions": {
    "allow": [
      "mcp__dj-claude__play_music",
      "mcp__dj-claude__play_strudel",
      "mcp__dj-claude__set_vibe",
      "mcp__dj-claude__live_mix",
      "mcp__dj-claude__hush",
      "mcp__dj-claude__now_playing",
      "mcp__dj-claude__jam",
      "mcp__dj-claude__jam_clear",
      "mcp__dj-claude__jam_status",
      "mcp__dj-claude__set_context",
      "mcp__dj-claude__jam_preview",
      "mcp__dj-claude__mix_analysis",
      "mcp__dj-claude__conduct",
      "mcp__dj-claude__conduct_evolve",
      "mcp__dj-claude__snapshot_save",
      "mcp__dj-claude__snapshot_load",
      "mcp__dj-claude__snapshot_list",
      "mcp__dj-claude__export_code",
      "mcp__dj-claude__play_preset",
      "mcp__dj-claude__switch_audio"
    ]
  }
}

This auto-allows all music tools while still prompting for everything else.

About

Adds live music and multi-agent jam band capabilities to Claude Code

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages