agentvibes 4.0.1 → 4.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (219) hide show
  1. package/.agentvibes/bmad/bmad-voices.md +69 -69
  2. package/.agentvibes/config.json +12 -0
  3. package/.claude/activation-instructions +54 -54
  4. package/.claude/audio/tracks/README.md +52 -52
  5. package/.claude/commands/agent-vibes/add.md +21 -21
  6. package/.claude/commands/agent-vibes/agent-vibes.md +101 -101
  7. package/.claude/commands/agent-vibes/agent.md +79 -79
  8. package/.claude/commands/agent-vibes/background-music.md +111 -111
  9. package/.claude/commands/agent-vibes/bmad.md +198 -198
  10. package/.claude/commands/agent-vibes/clean.md +18 -18
  11. package/.claude/commands/agent-vibes/cleanup.md +18 -18
  12. package/.claude/commands/agent-vibes/commands.json +145 -145
  13. package/.claude/commands/agent-vibes/effects.md +97 -97
  14. package/.claude/commands/agent-vibes/get.md +9 -9
  15. package/.claude/commands/agent-vibes/hide.md +91 -91
  16. package/.claude/commands/agent-vibes/language.md +23 -23
  17. package/.claude/commands/agent-vibes/learn.md +67 -67
  18. package/.claude/commands/agent-vibes/list.md +13 -13
  19. package/.claude/commands/agent-vibes/mute.md +37 -37
  20. package/.claude/commands/agent-vibes/preview.md +17 -17
  21. package/.claude/commands/agent-vibes/provider.md +68 -68
  22. package/.claude/commands/agent-vibes/replay-target.md +14 -14
  23. package/.claude/commands/agent-vibes/sample.md +12 -12
  24. package/.claude/commands/agent-vibes/set-favorite-voice.md +84 -84
  25. package/.claude/commands/agent-vibes/set-pretext.md +65 -65
  26. package/.claude/commands/agent-vibes/set-speed.md +41 -41
  27. package/.claude/commands/agent-vibes/show.md +84 -84
  28. package/.claude/commands/agent-vibes/switch.md +87 -87
  29. package/.claude/commands/agent-vibes/target-voice.md +26 -26
  30. package/.claude/commands/agent-vibes/target.md +30 -30
  31. package/.claude/commands/agent-vibes/translate.md +68 -68
  32. package/.claude/commands/agent-vibes/unmute.md +45 -45
  33. package/.claude/commands/agent-vibes/verbosity.md +89 -89
  34. package/.claude/commands/agent-vibes/whoami.md +7 -7
  35. package/.claude/commands/agent-vibes-bmad-voices.md +117 -117
  36. package/.claude/commands/agent-vibes-rdp.md +24 -24
  37. package/.claude/config/agentvibes.json +1 -0
  38. package/.claude/config/audio-effects.cfg +3 -2
  39. package/.claude/config/audio-effects.cfg.sample +52 -52
  40. package/.claude/config/background-music-volume.txt +1 -0
  41. package/.claude/config/intro-text.txt +1 -0
  42. package/.claude/config/piper-speech-rate.txt +4 -0
  43. package/.claude/config/piper-target-speech-rate.txt +1 -0
  44. package/.claude/config/reverb-level.txt +1 -0
  45. package/.claude/config/tts-speech-rate.txt +4 -0
  46. package/.claude/config/tts-target-speech-rate.txt +1 -0
  47. package/.claude/docs/TERMUX_SETUP.md +408 -408
  48. package/.claude/github-star-reminder.txt +1 -1
  49. package/.claude/hooks/README-TTS-QUEUE.md +135 -135
  50. package/.claude/hooks/audio-cache-utils.sh +246 -246
  51. package/.claude/hooks/audio-processor.sh +433 -389
  52. package/.claude/hooks/background-music-manager.sh +404 -404
  53. package/.claude/hooks/bmad-speak-enhanced.sh +165 -165
  54. package/.claude/hooks/bmad-speak.sh +269 -112
  55. package/.claude/hooks/bmad-tts-injector.sh +568 -568
  56. package/.claude/hooks/bmad-voice-manager.sh +928 -928
  57. package/.claude/hooks/clawdbot-receiver-SECURE.sh +129 -129
  58. package/.claude/hooks/clawdbot-receiver.sh +107 -107
  59. package/.claude/hooks/clean-audio-cache.sh +22 -22
  60. package/.claude/hooks/cleanup-cache.sh +106 -106
  61. package/.claude/hooks/configure-rdp-mode.sh +137 -137
  62. package/.claude/hooks/download-extra-voices.sh +244 -244
  63. package/.claude/hooks/effects-manager.sh +268 -268
  64. package/.claude/hooks/github-star-reminder.sh +154 -154
  65. package/.claude/hooks/language-manager.sh +362 -362
  66. package/.claude/hooks/learn-manager.sh +492 -492
  67. package/.claude/hooks/macos-voice-manager.sh +205 -205
  68. package/.claude/hooks/migrate-background-music.sh +125 -125
  69. package/.claude/hooks/migrate-to-agentvibes.sh +161 -161
  70. package/.claude/hooks/optimize-background-music.sh +87 -87
  71. package/.claude/hooks/path-resolver.sh +60 -60
  72. package/.claude/hooks/personality-manager.sh +448 -448
  73. package/.claude/hooks/piper-download-voices.sh +225 -225
  74. package/.claude/hooks/piper-installer.sh +292 -292
  75. package/.claude/hooks/piper-multispeaker-registry.sh +171 -171
  76. package/.claude/hooks/piper-voice-manager.sh +24 -3
  77. package/.claude/hooks/play-tts-agentvibes-receiver-for-voiceless-connections.sh +90 -90
  78. package/.claude/hooks/play-tts-enhanced.sh +105 -70
  79. package/.claude/hooks/play-tts-macos.sh +368 -345
  80. package/.claude/hooks/play-tts-piper.sh +679 -578
  81. package/.claude/hooks/play-tts-soprano.sh +356 -320
  82. package/.claude/hooks/play-tts-ssh-remote.sh +167 -88
  83. package/.claude/hooks/play-tts-termux-ssh.sh +169 -169
  84. package/.claude/hooks/play-tts.sh +301 -298
  85. package/.claude/hooks/prepare-release.sh +54 -54
  86. package/.claude/hooks/provider-commands.sh +617 -617
  87. package/.claude/hooks/provider-manager.sh +399 -399
  88. package/.claude/hooks/replay-target-audio.sh +95 -95
  89. package/.claude/hooks/requirements.txt +6 -6
  90. package/.claude/hooks/sentiment-manager.sh +201 -201
  91. package/.claude/hooks/session-start-tts.sh +81 -71
  92. package/.claude/hooks/soprano-gradio-synth.py +139 -139
  93. package/.claude/hooks/speed-manager.sh +291 -291
  94. package/.claude/hooks/stop-tts.sh +84 -0
  95. package/.claude/hooks/termux-installer.sh +261 -261
  96. package/.claude/hooks/translate-manager.sh +341 -341
  97. package/.claude/hooks/translator.py +237 -237
  98. package/.claude/hooks/tts-queue-worker.sh +145 -114
  99. package/.claude/hooks/tts-queue.sh +165 -136
  100. package/.claude/hooks/verbosity-manager.sh +178 -178
  101. package/.claude/hooks/voice-manager.sh +548 -544
  102. package/.claude/hooks-windows/audio-cache-utils.ps1 +119 -119
  103. package/.claude/hooks-windows/background-music-manager.ps1 +348 -0
  104. package/.claude/hooks-windows/clean-audio-cache.ps1 +53 -0
  105. package/.claude/hooks-windows/download-extra-voices.ps1 +185 -0
  106. package/.claude/hooks-windows/effects-manager.ps1 +294 -0
  107. package/.claude/hooks-windows/language-manager.ps1 +193 -0
  108. package/.claude/hooks-windows/learn-manager.ps1 +241 -0
  109. package/.claude/hooks-windows/personality-manager.ps1 +266 -0
  110. package/.claude/hooks-windows/play-tts-piper.ps1 +209 -0
  111. package/.claude/hooks-windows/play-tts-sapi.ps1 +108 -0
  112. package/.claude/hooks-windows/play-tts-soprano.ps1 +159 -158
  113. package/.claude/hooks-windows/play-tts-windows-piper.ps1 +50 -5
  114. package/.claude/hooks-windows/play-tts-windows-sapi.ps1 +108 -108
  115. package/.claude/hooks-windows/play-tts.ps1 +344 -266
  116. package/.claude/hooks-windows/provider-manager.ps1 +29 -10
  117. package/.claude/hooks-windows/session-start-tts.ps1 +124 -124
  118. package/.claude/hooks-windows/soprano-gradio-synth.py +153 -153
  119. package/.claude/hooks-windows/speed-manager.ps1 +166 -0
  120. package/.claude/hooks-windows/verbosity-manager.ps1 +119 -0
  121. package/.claude/hooks-windows/voice-manager-windows.ps1 +92 -8
  122. package/.claude/output-styles/agent-vibes.md +202 -202
  123. package/.claude/personalities/angry.md +14 -14
  124. package/.claude/personalities/annoying.md +14 -14
  125. package/.claude/personalities/crass.md +14 -14
  126. package/.claude/personalities/dramatic.md +14 -14
  127. package/.claude/personalities/dry-humor.md +50 -50
  128. package/.claude/personalities/flirty.md +20 -20
  129. package/.claude/personalities/funny.md +14 -14
  130. package/.claude/personalities/grandpa.md +32 -32
  131. package/.claude/personalities/millennial.md +14 -14
  132. package/.claude/personalities/moody.md +14 -14
  133. package/.claude/personalities/normal.md +16 -16
  134. package/.claude/personalities/pirate.md +14 -14
  135. package/.claude/personalities/poetic.md +14 -14
  136. package/.claude/personalities/professional.md +14 -14
  137. package/.claude/personalities/rapper.md +55 -55
  138. package/.claude/personalities/robot.md +14 -14
  139. package/.claude/personalities/sarcastic.md +38 -38
  140. package/.claude/personalities/sassy.md +14 -14
  141. package/.claude/personalities/surfer-dude.md +14 -14
  142. package/.claude/personalities/zen.md +14 -14
  143. package/.claude/settings.json +15 -15
  144. package/.claude/verbosity.txt +1 -1
  145. package/.clawdbot/README.md +105 -105
  146. package/.clawdbot/skill/SKILL.md +241 -241
  147. package/.mcp.json +12 -0
  148. package/CLAUDE.md +170 -181
  149. package/README.md +2029 -1909
  150. package/RELEASE_NOTES.md +1310 -66
  151. package/WINDOWS-SETUP.md +208 -208
  152. package/bin/agent-vibes +39 -39
  153. package/bin/agentvibes-voice-browser.js +1840 -1826
  154. package/bin/agentvibes.js +48 -2
  155. package/bin/mcp-server.js +121 -121
  156. package/bin/mcp-server.sh +206 -206
  157. package/bin/test-bmad-pr +78 -78
  158. package/mcp-server/QUICK_START.md +203 -203
  159. package/mcp-server/README.md +345 -345
  160. package/mcp-server/WINDOWS_SETUP.md +260 -260
  161. package/mcp-server/docs/troubleshooting-audio.md +313 -313
  162. package/mcp-server/examples/claude_desktop_config.json +11 -11
  163. package/mcp-server/examples/claude_desktop_config_piper.json +9 -9
  164. package/mcp-server/examples/custom_instructions.md +169 -169
  165. package/mcp-server/install-deps.js +130 -130
  166. package/mcp-server/pyproject.toml +52 -52
  167. package/mcp-server/requirements.txt +2 -2
  168. package/mcp-server/server.py +1465 -1417
  169. package/mcp-server/test_server.py +395 -395
  170. package/mcp-server/test_windows_script_parity.py +336 -0
  171. package/package.json +110 -112
  172. package/setup-windows.ps1 +815 -815
  173. package/src/bmad-detector.js +71 -71
  174. package/src/cli/list-personalities.js +110 -110
  175. package/src/cli/list-voices.js +114 -114
  176. package/src/commands/bmad-voices.js +394 -394
  177. package/src/commands/install-mcp.js +476 -476
  178. package/src/console/app.js +824 -806
  179. package/src/console/audio-env.js +20 -1
  180. package/src/console/brand-colors.js +13 -13
  181. package/src/console/constants/personalities.js +44 -0
  182. package/src/console/footer-config.js +50 -46
  183. package/src/console/modals/modal-overlay.js +247 -247
  184. package/src/console/navigation.js +62 -61
  185. package/src/console/tabs/agents-tab.js +1684 -369
  186. package/src/console/tabs/help-tab.js +261 -261
  187. package/src/console/tabs/install-tab.js +1007 -991
  188. package/src/console/tabs/music-tab.js +22 -8
  189. package/src/console/tabs/placeholder-tab.js +53 -46
  190. package/src/console/tabs/readme-tab.js +267 -267
  191. package/src/console/tabs/receiver-tab.js +1472 -0
  192. package/src/console/tabs/settings-tab.js +185 -402
  193. package/src/console/tabs/voices-tab.js +100 -21
  194. package/src/console/widgets/destroy-list.js +25 -0
  195. package/src/console/widgets/format-utils.js +89 -0
  196. package/src/console/widgets/notice.js +55 -0
  197. package/src/console/widgets/personality-picker.js +185 -0
  198. package/src/console/widgets/reverb-picker.js +94 -0
  199. package/src/console/widgets/track-picker.js +285 -0
  200. package/src/installer/music-file-input.js +304 -304
  201. package/src/installer.js +5882 -5777
  202. package/src/services/agent-voice-store.js +423 -163
  203. package/src/services/config-service.js +264 -264
  204. package/src/services/navigation-service.js +123 -123
  205. package/src/services/provider-service.js +132 -132
  206. package/src/services/verbosity-service.js +157 -157
  207. package/src/utils/audio-duration-validator.js +298 -298
  208. package/src/utils/audio-format-validator.js +277 -277
  209. package/src/utils/dependency-checker.js +469 -466
  210. package/src/utils/file-ownership-verifier.js +358 -358
  211. package/src/utils/list-formatter.js +194 -194
  212. package/src/utils/music-file-validator.js +285 -275
  213. package/src/utils/preview-list-prompt.js +136 -136
  214. package/src/utils/provider-validator.js +96 -12
  215. package/src/utils/secure-music-storage.js +412 -412
  216. package/templates/agentvibes-receiver.sh +482 -162
  217. package/templates/audio/welcome-music.mp3 +0 -0
  218. package/voice-assignments.json +8244 -8244
  219. package/.claude/config/background-music-position.txt +0 -1
@@ -1,79 +1,79 @@
1
- # Agent Vibes - Role-Based AI Agents
2
-
3
- Activate a specialized AI agent with a specific professional role and expertise. Unlike personalities (which change speaking style), agents embody complete professional roles with domain-specific knowledge, methodologies, and coaching frameworks.
4
-
5
- ## Available Agents
6
-
7
- ### `/agent-vibes:agent negotiator`
8
- **Role**: Expert Negotiation Coach
9
- **Inspired by**: [Chris Voss](https://www.blackswanltd.com/) - Former FBI hostage negotiator
10
- **Specialty**: Tactical empathy, calibrated questions, and psychological techniques for winning negotiations
11
- **Use for**: Salary negotiations, business deals, conflict resolution, difficult conversations
12
-
13
- ### `/agent-vibes:agent health-coach`
14
- **Role**: Holistic Health & Metabolic Coach
15
- **Inspired by**: [Ben Azadi](https://benazadi.com/) - Keto expert and functional health practitioner
16
- **Specialty**: Ketogenic nutrition, metabolic flexibility, intermittent fasting, sustainable wellness
17
- **Use for**: Weight loss, energy optimization, metabolic health, nutrition guidance
18
-
19
- ### `/agent-vibes:agent motivator`
20
- **Role**: Peak Performance & Accountability Coach
21
- **Inspired by**: Tony Robbins, David Goggins, Mel Robbins, Les Brown
22
- **Specialty**: State management, mental toughness, massive action, destroying limiting beliefs
23
- **Use for**: Overcoming procrastination, building momentum, achieving goals, personal transformation
24
-
25
- ## How Agents Work
26
-
27
- 1. **Slash Command**: Type `/agent-vibes:agent <name>` to activate an agent
28
- 2. **Agent Context**: The AI loads the agent's complete professional framework
29
- 3. **Specialized Guidance**: You receive expert coaching in that domain
30
- 4. **Persistent Session**: The agent role continues until you deactivate it
31
-
32
- ## Example Usage
33
-
34
- ```bash
35
- # Activate negotiator for salary discussion
36
- /agent-vibes:agent negotiator
37
- "I need help negotiating my salary offer..."
38
-
39
- # Switch to health coach for wellness goals
40
- /agent-vibes:agent health-coach
41
- "I want to lose weight and improve my energy..."
42
-
43
- # Get motivated to overcome procrastination
44
- /agent-vibes:agent motivator
45
- "I keep putting off starting my business..."
46
- ```
47
-
48
- ## Agent vs Personality
49
-
50
- | Feature | Agents | Personalities |
51
- |---------|--------|---------------|
52
- | **Purpose** | Professional role with domain expertise | Speaking style and tone |
53
- | **Content** | Structured frameworks and methodologies | Emotional flavor and character |
54
- | **Depth** | Deep domain knowledge and coaching | Surface-level style changes |
55
- | **Examples** | Negotiator, Health Coach, Motivator | Sarcastic, Flirty, Pirate |
56
- | **Use Case** | Solve specific problems | Make interactions entertaining |
57
-
58
- You can combine both! For example:
59
- - `/agent-vibes:agent negotiator` + `/agent-vibes:personality professional`
60
- - `/agent-vibes:agent motivator` + `/agent-vibes:personality intense`
61
-
62
- ## Deactivating an Agent
63
-
64
- Simply start a new conversation or explicitly state: "Exit agent mode" or "Return to normal mode"
65
-
66
- ## Credits
67
-
68
- This feature was inspired by leading experts in their fields:
69
-
70
- - **Chris Voss**: Former FBI lead international hostage negotiator, founder of [Black Swan Group](https://www.blackswanltd.com/), author of "Never Split the Difference"
71
- - **Ben Azadi**: Functional health practitioner, keto expert, host of Keto Kamp Podcast, founder of [Ben Azadi Health](https://benazadi.com/), author of "Keto Flex"
72
- - **Tony Robbins**: Peak performance strategist and life coach
73
- - **David Goggins**: Ultra-endurance athlete and mental toughness expert
74
- - **Mel Robbins**: Motivational speaker and author of "The 5 Second Rule"
75
- - **Les Brown**: Legendary motivational speaker
76
-
77
- ---
78
-
79
- **Note**: Agents provide coaching and guidance based on proven methodologies. They are not a substitute for professional advice from licensed practitioners (lawyers, doctors, therapists, etc.).
1
+ # Agent Vibes - Role-Based AI Agents
2
+
3
+ Activate a specialized AI agent with a specific professional role and expertise. Unlike personalities (which change speaking style), agents embody complete professional roles with domain-specific knowledge, methodologies, and coaching frameworks.
4
+
5
+ ## Available Agents
6
+
7
+ ### `/agent-vibes:agent negotiator`
8
+ **Role**: Expert Negotiation Coach
9
+ **Inspired by**: [Chris Voss](https://www.blackswanltd.com/) - Former FBI hostage negotiator
10
+ **Specialty**: Tactical empathy, calibrated questions, and psychological techniques for winning negotiations
11
+ **Use for**: Salary negotiations, business deals, conflict resolution, difficult conversations
12
+
13
+ ### `/agent-vibes:agent health-coach`
14
+ **Role**: Holistic Health & Metabolic Coach
15
+ **Inspired by**: [Ben Azadi](https://benazadi.com/) - Keto expert and functional health practitioner
16
+ **Specialty**: Ketogenic nutrition, metabolic flexibility, intermittent fasting, sustainable wellness
17
+ **Use for**: Weight loss, energy optimization, metabolic health, nutrition guidance
18
+
19
+ ### `/agent-vibes:agent motivator`
20
+ **Role**: Peak Performance & Accountability Coach
21
+ **Inspired by**: Tony Robbins, David Goggins, Mel Robbins, Les Brown
22
+ **Specialty**: State management, mental toughness, massive action, destroying limiting beliefs
23
+ **Use for**: Overcoming procrastination, building momentum, achieving goals, personal transformation
24
+
25
+ ## How Agents Work
26
+
27
+ 1. **Slash Command**: Type `/agent-vibes:agent <name>` to activate an agent
28
+ 2. **Agent Context**: The AI loads the agent's complete professional framework
29
+ 3. **Specialized Guidance**: You receive expert coaching in that domain
30
+ 4. **Persistent Session**: The agent role continues until you deactivate it
31
+
32
+ ## Example Usage
33
+
34
+ ```bash
35
+ # Activate negotiator for salary discussion
36
+ /agent-vibes:agent negotiator
37
+ "I need help negotiating my salary offer..."
38
+
39
+ # Switch to health coach for wellness goals
40
+ /agent-vibes:agent health-coach
41
+ "I want to lose weight and improve my energy..."
42
+
43
+ # Get motivated to overcome procrastination
44
+ /agent-vibes:agent motivator
45
+ "I keep putting off starting my business..."
46
+ ```
47
+
48
+ ## Agent vs Personality
49
+
50
+ | Feature | Agents | Personalities |
51
+ |---------|--------|---------------|
52
+ | **Purpose** | Professional role with domain expertise | Speaking style and tone |
53
+ | **Content** | Structured frameworks and methodologies | Emotional flavor and character |
54
+ | **Depth** | Deep domain knowledge and coaching | Surface-level style changes |
55
+ | **Examples** | Negotiator, Health Coach, Motivator | Sarcastic, Flirty, Pirate |
56
+ | **Use Case** | Solve specific problems | Make interactions entertaining |
57
+
58
+ You can combine both! For example:
59
+ - `/agent-vibes:agent negotiator` + `/agent-vibes:personality professional`
60
+ - `/agent-vibes:agent motivator` + `/agent-vibes:personality intense`
61
+
62
+ ## Deactivating an Agent
63
+
64
+ Simply start a new conversation or explicitly state: "Exit agent mode" or "Return to normal mode"
65
+
66
+ ## Credits
67
+
68
+ This feature was inspired by leading experts in their fields:
69
+
70
+ - **Chris Voss**: Former FBI lead international hostage negotiator, founder of [Black Swan Group](https://www.blackswanltd.com/), author of "Never Split the Difference"
71
+ - **Ben Azadi**: Functional health practitioner, keto expert, host of Keto Kamp Podcast, founder of [Ben Azadi Health](https://benazadi.com/), author of "Keto Flex"
72
+ - **Tony Robbins**: Peak performance strategist and life coach
73
+ - **David Goggins**: Ultra-endurance athlete and mental toughness expert
74
+ - **Mel Robbins**: Motivational speaker and author of "The 5 Second Rule"
75
+ - **Les Brown**: Legendary motivational speaker
76
+
77
+ ---
78
+
79
+ **Note**: Agents provide coaching and guidance based on proven methodologies. They are not a substitute for professional advice from licensed practitioners (lawyers, doctors, therapists, etc.).
@@ -1,111 +1,111 @@
1
- ---
2
- description: Toggle background music for TTS (on/off/status)
3
- tags: [user]
4
- ---
5
-
6
- **IMPORTANT: When user requests background music changes in natural language (e.g., "change to salsa", "switch to jazz"), you MUST:**
7
-
8
- 1. Run `.claude/hooks/background-music-manager.sh list` to see all available tracks
9
- 2. Find the matching track by searching for keywords (e.g., "salsa" → "agent_vibes_salsa_v2_loop.mp3")
10
- 3. Execute `.claude/hooks/background-music-manager.sh set-default EXACT_FILENAME`
11
- 4. Test with TTS to confirm the change took effect
12
-
13
- **CRITICAL PATH INFORMATION:**
14
- - The script is ALWAYS at `.claude/hooks/background-music-manager.sh` (relative to current directory)
15
- - DO NOT use global paths like `/agent-vibes/cli.sh` or `~/.agentvibes/cli.sh`
16
- - DO NOT search for the script - it's always in the same location
17
- - Use either `bash .claude/hooks/background-music-manager.sh` OR just `.claude/hooks/background-music-manager.sh`
18
-
19
- **NEVER:**
20
- - Search for background-music-manager.sh (you already know where it is)
21
- - Use global installation paths
22
- - Manually edit config files directly
23
- - Create new config files like "background-music.cfg"
24
- - Guess filenames without listing them first
25
-
26
- Run the background music manager script with the provided command.
27
-
28
- If no arguments provided, show status. Otherwise execute:
29
- `bash .claude/hooks/background-music-manager.sh {command}`
30
-
31
- Valid commands: on, off, status, list, volume {0.0-1.0}, set-default {filename}, set-agent {agent_name} {filename}, set-all {filename}
32
-
33
- Control background music that plays behind TTS voice output.
34
-
35
- ## Usage
36
-
37
- - `/agent-vibes:background-music` - Show current status
38
- - `/agent-vibes:background-music on` - Enable background music
39
- - `/agent-vibes:background-music off` - Disable background music
40
- - `/agent-vibes:background-music volume 0.3` - Set volume (0.0-1.0)
41
- - `/agent-vibes:background-music list` - List all pre-packaged background music tracks
42
- - `/agent-vibes:background-music set-default TRACK` - Set default background music track
43
- - `/agent-vibes:background-music set-agent AGENT TRACK` - Set background music for a specific agent
44
- - `/agent-vibes:background-music set-all TRACK` - Set the same background music for all agents
45
-
46
- ## How It Works
47
-
48
- When enabled, TTS audio is mixed with ambient background music:
49
- - **Party mode** - Uses room ambiance track for multi-agent discussions
50
- - **Solo agent** - Uses agent-specific theme music (if configured)
51
-
52
- Background music:
53
- - Fades in/out smoothly
54
- - Plays at configurable volume (default 40%)
55
- - Requires `sox` and `ffmpeg` installed
56
-
57
- ## Configuration
58
-
59
- Background tracks are stored in `.claude/audio/tracks/`
60
-
61
- Agent-specific themes are configured in `.claude/config/audio-effects.cfg`:
62
- ```
63
- # Format: AGENT_NAME|SOX_EFFECTS|BACKGROUND_FILE|VOLUME
64
- John|gain -1|electronica.mp3|0.30
65
- Winston|reverb 40|ambient.mp3|0.20
66
- _party_mode||chill-ambient.mp3|0.40
67
- ```
68
-
69
- ## Requirements
70
-
71
- - `sox` - for voice effects
72
- - `ffmpeg` - for audio mixing
73
-
74
- Install on macOS: `brew install sox ffmpeg`
75
- Install on Linux/WSL: `apt install sox ffmpeg`
76
-
77
- ## Examples
78
-
79
- ```
80
- /agent-vibes:background-music on
81
- 🎵 Background music enabled at 40% volume
82
-
83
- /agent-vibes:background-music volume 0.25
84
- 🎵 Background music volume set to 25%
85
-
86
- /agent-vibes:background-music list
87
- 🎵 Available Background Music Tracks
88
- ====================================
89
-
90
- 1. Agent Vibes Arabic v2.mp3
91
- 2. Agent Vibes Bossa Nova v2.mp3
92
- 3. Agent Vibes Celtic Harp v1.mp3
93
- ...
94
-
95
- /agent-vibes:background-music set-default agent_vibes_chillwave_v2_loop.mp3
96
- ✅ Default background music set to: agent_vibes_chillwave_v2_loop.mp3
97
-
98
- /agent-vibes:background-music set-agent John optimized/agent_vibes_goa_trance_v2_loop.mp3
99
- ✅ Updated background music for John: optimized/agent_vibes_goa_trance_v2_loop.mp3
100
-
101
- /agent-vibes:background-music set-all optimized/dreamy_house_loop.mp3
102
- ✅ Updated background music for 10 agents: optimized/dreamy_house_loop.mp3
103
-
104
- /agent-vibes:background-music off
105
- 🔇 Background music disabled
106
- ```
107
-
108
- ## Related Commands
109
-
110
- - `/agent-vibes:personality` - Set voice personality style
111
- - `/agent-vibes:verbosity` - Control how much Claude speaks
1
+ ---
2
+ description: Toggle background music for TTS (on/off/status)
3
+ tags: [user]
4
+ ---
5
+
6
+ **IMPORTANT: When user requests background music changes in natural language (e.g., "change to salsa", "switch to jazz"), you MUST:**
7
+
8
+ 1. Run `.claude/hooks/background-music-manager.sh list` to see all available tracks
9
+ 2. Find the matching track by searching for keywords (e.g., "salsa" → "agent_vibes_salsa_v2_loop.mp3")
10
+ 3. Execute `.claude/hooks/background-music-manager.sh set-default EXACT_FILENAME`
11
+ 4. Test with TTS to confirm the change took effect
12
+
13
+ **CRITICAL PATH INFORMATION:**
14
+ - The script is ALWAYS at `.claude/hooks/background-music-manager.sh` (relative to current directory)
15
+ - DO NOT use global paths like `/agent-vibes/cli.sh` or `~/.agentvibes/cli.sh`
16
+ - DO NOT search for the script - it's always in the same location
17
+ - Use either `bash .claude/hooks/background-music-manager.sh` OR just `.claude/hooks/background-music-manager.sh`
18
+
19
+ **NEVER:**
20
+ - Search for background-music-manager.sh (you already know where it is)
21
+ - Use global installation paths
22
+ - Manually edit config files directly
23
+ - Create new config files like "background-music.cfg"
24
+ - Guess filenames without listing them first
25
+
26
+ Run the background music manager script with the provided command.
27
+
28
+ If no arguments provided, show status. Otherwise execute:
29
+ `bash .claude/hooks/background-music-manager.sh {command}`
30
+
31
+ Valid commands: on, off, status, list, volume {0.0-1.0}, set-default {filename}, set-agent {agent_name} {filename}, set-all {filename}
32
+
33
+ Control background music that plays behind TTS voice output.
34
+
35
+ ## Usage
36
+
37
+ - `/agent-vibes:background-music` - Show current status
38
+ - `/agent-vibes:background-music on` - Enable background music
39
+ - `/agent-vibes:background-music off` - Disable background music
40
+ - `/agent-vibes:background-music volume 0.3` - Set volume (0.0-1.0)
41
+ - `/agent-vibes:background-music list` - List all pre-packaged background music tracks
42
+ - `/agent-vibes:background-music set-default TRACK` - Set default background music track
43
+ - `/agent-vibes:background-music set-agent AGENT TRACK` - Set background music for a specific agent
44
+ - `/agent-vibes:background-music set-all TRACK` - Set the same background music for all agents
45
+
46
+ ## How It Works
47
+
48
+ When enabled, TTS audio is mixed with ambient background music:
49
+ - **Party mode** - Uses room ambiance track for multi-agent discussions
50
+ - **Solo agent** - Uses agent-specific theme music (if configured)
51
+
52
+ Background music:
53
+ - Fades in/out smoothly
54
+ - Plays at configurable volume (default 40%)
55
+ - Requires `sox` and `ffmpeg` installed
56
+
57
+ ## Configuration
58
+
59
+ Background tracks are stored in `.claude/audio/tracks/`
60
+
61
+ Agent-specific themes are configured in `.claude/config/audio-effects.cfg`:
62
+ ```
63
+ # Format: AGENT_NAME|SOX_EFFECTS|BACKGROUND_FILE|VOLUME
64
+ John|gain -1|electronica.mp3|0.30
65
+ Winston|reverb 40|ambient.mp3|0.20
66
+ _party_mode||chill-ambient.mp3|0.40
67
+ ```
68
+
69
+ ## Requirements
70
+
71
+ - `sox` - for voice effects
72
+ - `ffmpeg` - for audio mixing
73
+
74
+ Install on macOS: `brew install sox ffmpeg`
75
+ Install on Linux/WSL: `apt install sox ffmpeg`
76
+
77
+ ## Examples
78
+
79
+ ```
80
+ /agent-vibes:background-music on
81
+ 🎵 Background music enabled at 40% volume
82
+
83
+ /agent-vibes:background-music volume 0.25
84
+ 🎵 Background music volume set to 25%
85
+
86
+ /agent-vibes:background-music list
87
+ 🎵 Available Background Music Tracks
88
+ ====================================
89
+
90
+ 1. Agent Vibes Arabic v2.mp3
91
+ 2. Agent Vibes Bossa Nova v2.mp3
92
+ 3. Agent Vibes Celtic Harp v1.mp3
93
+ ...
94
+
95
+ /agent-vibes:background-music set-default agent_vibes_chillwave_v2_loop.mp3
96
+ ✅ Default background music set to: agent_vibes_chillwave_v2_loop.mp3
97
+
98
+ /agent-vibes:background-music set-agent John optimized/agent_vibes_goa_trance_v2_loop.mp3
99
+ ✅ Updated background music for John: optimized/agent_vibes_goa_trance_v2_loop.mp3
100
+
101
+ /agent-vibes:background-music set-all optimized/dreamy_house_loop.mp3
102
+ ✅ Updated background music for 10 agents: optimized/dreamy_house_loop.mp3
103
+
104
+ /agent-vibes:background-music off
105
+ 🔇 Background music disabled
106
+ ```
107
+
108
+ ## Related Commands
109
+
110
+ - `/agent-vibes:personality` - Set voice personality style
111
+ - `/agent-vibes:verbosity` - Control how much Claude speaks