agentvibes 2.0.17 → 2.0.20

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 (341) hide show
  1. package/.bmad-core/agent-teams/team-all.yaml +15 -0
  2. package/.bmad-core/agent-teams/team-fullstack.yaml +19 -0
  3. package/.bmad-core/agent-teams/team-ide-minimal.yaml +11 -0
  4. package/.bmad-core/agent-teams/team-no-ui.yaml +14 -0
  5. package/.bmad-core/agents/analyst.md +84 -0
  6. package/.bmad-core/agents/architect.md +85 -0
  7. package/.bmad-core/agents/bmad-master.md +110 -0
  8. package/.bmad-core/agents/bmad-orchestrator.md +147 -0
  9. package/.bmad-core/agents/dev.md +81 -0
  10. package/.bmad-core/agents/pm.md +84 -0
  11. package/.bmad-core/agents/po.md +79 -0
  12. package/.bmad-core/agents/qa.md +87 -0
  13. package/.bmad-core/agents/sm.md +65 -0
  14. package/.bmad-core/agents/ux-expert.md +69 -0
  15. package/.bmad-core/checklists/architect-checklist.md +440 -0
  16. package/.bmad-core/checklists/change-checklist.md +184 -0
  17. package/.bmad-core/checklists/pm-checklist.md +372 -0
  18. package/.bmad-core/checklists/po-master-checklist.md +434 -0
  19. package/.bmad-core/checklists/story-dod-checklist.md +96 -0
  20. package/.bmad-core/checklists/story-draft-checklist.md +155 -0
  21. package/.bmad-core/core-config.yaml +22 -0
  22. package/.bmad-core/data/bmad-kb.md +809 -0
  23. package/.bmad-core/data/brainstorming-techniques.md +38 -0
  24. package/.bmad-core/data/elicitation-methods.md +156 -0
  25. package/.bmad-core/data/technical-preferences.md +5 -0
  26. package/.bmad-core/data/test-levels-framework.md +148 -0
  27. package/.bmad-core/data/test-priorities-matrix.md +174 -0
  28. package/.bmad-core/enhanced-ide-development-workflow.md +248 -0
  29. package/.bmad-core/install-manifest.yaml +230 -0
  30. package/.bmad-core/tasks/advanced-elicitation.md +119 -0
  31. package/.bmad-core/tasks/apply-qa-fixes.md +150 -0
  32. package/.bmad-core/tasks/brownfield-create-epic.md +162 -0
  33. package/.bmad-core/tasks/brownfield-create-story.md +149 -0
  34. package/.bmad-core/tasks/correct-course.md +72 -0
  35. package/.bmad-core/tasks/create-brownfield-story.md +314 -0
  36. package/.bmad-core/tasks/create-deep-research-prompt.md +280 -0
  37. package/.bmad-core/tasks/create-doc.md +103 -0
  38. package/.bmad-core/tasks/create-next-story.md +114 -0
  39. package/.bmad-core/tasks/document-project.md +345 -0
  40. package/.bmad-core/tasks/execute-checklist.md +88 -0
  41. package/.bmad-core/tasks/facilitate-brainstorming-session.md +138 -0
  42. package/.bmad-core/tasks/generate-ai-frontend-prompt.md +53 -0
  43. package/.bmad-core/tasks/index-docs.md +175 -0
  44. package/.bmad-core/tasks/kb-mode-interaction.md +77 -0
  45. package/.bmad-core/tasks/nfr-assess.md +345 -0
  46. package/.bmad-core/tasks/qa-gate.md +163 -0
  47. package/.bmad-core/tasks/review-story.md +316 -0
  48. package/.bmad-core/tasks/risk-profile.md +355 -0
  49. package/.bmad-core/tasks/shard-doc.md +187 -0
  50. package/.bmad-core/tasks/test-design.md +176 -0
  51. package/.bmad-core/tasks/trace-requirements.md +266 -0
  52. package/.bmad-core/tasks/validate-next-story.md +136 -0
  53. package/.bmad-core/templates/architecture-tmpl.yaml +651 -0
  54. package/.bmad-core/templates/brainstorming-output-tmpl.yaml +156 -0
  55. package/.bmad-core/templates/brownfield-architecture-tmpl.yaml +477 -0
  56. package/.bmad-core/templates/brownfield-prd-tmpl.yaml +281 -0
  57. package/.bmad-core/templates/competitor-analysis-tmpl.yaml +307 -0
  58. package/.bmad-core/templates/front-end-architecture-tmpl.yaml +219 -0
  59. package/.bmad-core/templates/front-end-spec-tmpl.yaml +350 -0
  60. package/.bmad-core/templates/fullstack-architecture-tmpl.yaml +824 -0
  61. package/.bmad-core/templates/market-research-tmpl.yaml +253 -0
  62. package/.bmad-core/templates/prd-tmpl.yaml +203 -0
  63. package/.bmad-core/templates/project-brief-tmpl.yaml +222 -0
  64. package/.bmad-core/templates/qa-gate-tmpl.yaml +103 -0
  65. package/.bmad-core/templates/story-tmpl.yaml +138 -0
  66. package/.bmad-core/user-guide.md +577 -0
  67. package/.bmad-core/utils/bmad-doc-template.md +327 -0
  68. package/.bmad-core/utils/workflow-management.md +71 -0
  69. package/.bmad-core/workflows/brownfield-fullstack.yaml +298 -0
  70. package/.bmad-core/workflows/brownfield-service.yaml +188 -0
  71. package/.bmad-core/workflows/brownfield-ui.yaml +198 -0
  72. package/.bmad-core/workflows/greenfield-fullstack.yaml +241 -0
  73. package/.bmad-core/workflows/greenfield-service.yaml +207 -0
  74. package/.bmad-core/workflows/greenfield-ui.yaml +236 -0
  75. package/.bmad-core/working-in-the-brownfield.md +606 -0
  76. package/.claude/activation-instructions +54 -0
  77. package/.claude/commands/BMad/agents/analyst.md +88 -0
  78. package/.claude/commands/BMad/agents/architect.md +89 -0
  79. package/.claude/commands/BMad/agents/bmad-master.md +114 -0
  80. package/.claude/commands/BMad/agents/bmad-orchestrator.md +151 -0
  81. package/.claude/commands/BMad/agents/dev.md +85 -0
  82. package/.claude/commands/BMad/agents/pm.md +88 -0
  83. package/.claude/commands/BMad/agents/po.md +83 -0
  84. package/.claude/commands/BMad/agents/qa.md +91 -0
  85. package/.claude/commands/BMad/agents/sm.md +69 -0
  86. package/.claude/commands/BMad/agents/ux-expert.md +73 -0
  87. package/.claude/commands/BMad/tasks/advanced-elicitation.md +123 -0
  88. package/.claude/commands/BMad/tasks/apply-qa-fixes.md +154 -0
  89. package/.claude/commands/BMad/tasks/brownfield-create-epic.md +166 -0
  90. package/.claude/commands/BMad/tasks/brownfield-create-story.md +153 -0
  91. package/.claude/commands/BMad/tasks/correct-course.md +76 -0
  92. package/.claude/commands/BMad/tasks/create-brownfield-story.md +318 -0
  93. package/.claude/commands/BMad/tasks/create-deep-research-prompt.md +284 -0
  94. package/.claude/commands/BMad/tasks/create-doc.md +107 -0
  95. package/.claude/commands/BMad/tasks/create-next-story.md +118 -0
  96. package/.claude/commands/BMad/tasks/document-project.md +349 -0
  97. package/.claude/commands/BMad/tasks/execute-checklist.md +92 -0
  98. package/.claude/commands/BMad/tasks/facilitate-brainstorming-session.md +142 -0
  99. package/.claude/commands/BMad/tasks/generate-ai-frontend-prompt.md +57 -0
  100. package/.claude/commands/BMad/tasks/index-docs.md +179 -0
  101. package/.claude/commands/BMad/tasks/kb-mode-interaction.md +81 -0
  102. package/.claude/commands/BMad/tasks/nfr-assess.md +349 -0
  103. package/.claude/commands/BMad/tasks/qa-gate.md +167 -0
  104. package/.claude/commands/BMad/tasks/review-story.md +320 -0
  105. package/.claude/commands/BMad/tasks/risk-profile.md +359 -0
  106. package/.claude/commands/BMad/tasks/shard-doc.md +191 -0
  107. package/.claude/commands/BMad/tasks/test-design.md +180 -0
  108. package/.claude/commands/BMad/tasks/trace-requirements.md +270 -0
  109. package/.claude/commands/BMad/tasks/validate-next-story.md +140 -0
  110. package/.claude/github-star-reminder.txt +1 -1
  111. package/.claude/hooks/bmad-tts-injector.sh +33 -4
  112. package/.claude/hooks/bmad-voice-manager.sh +146 -10
  113. package/.claude/hooks/check-output-style.sh +60 -8
  114. package/.claude/hooks/github-star-reminder.sh +67 -7
  115. package/.claude/hooks/language-manager.sh +34 -2
  116. package/.claude/hooks/learn-manager.sh +34 -2
  117. package/.claude/hooks/personality-manager.sh +34 -1
  118. package/.claude/hooks/piper-download-voices.sh +131 -9
  119. package/.claude/hooks/piper-installer.sh +38 -4
  120. package/.claude/hooks/piper-voice-manager.sh +102 -36
  121. package/.claude/hooks/play-tts-elevenlabs.sh +32 -6
  122. package/.claude/hooks/play-tts-piper.sh +79 -18
  123. package/.claude/hooks/play-tts.sh +34 -3
  124. package/.claude/hooks/provider-commands.sh +36 -1
  125. package/.claude/hooks/provider-manager.sh +32 -1
  126. package/.claude/hooks/replay-target-audio.sh +34 -3
  127. package/.claude/hooks/sentiment-manager.sh +39 -1
  128. package/.claude/hooks/speed-manager.sh +36 -2
  129. package/.claude/hooks/voice-manager.sh +85 -6
  130. package/.claude/hooks/voices-config.sh +39 -2
  131. package/README.md +77 -137
  132. package/RELEASE_NOTES.md +269 -0
  133. package/RELEASE_NOTES_v2.0.17_DRAFT.md +650 -0
  134. package/agentvibes.org/.claude/audio/tts-padded-1760744118.mp3 +0 -0
  135. package/agentvibes.org/.claude/audio/tts-padded-1760748535.mp3 +0 -0
  136. package/agentvibes.org/.claude/audio/tts-padded-1760748676.mp3 +0 -0
  137. package/agentvibes.org/.claude/audio/tts-padded-1760750748.mp3 +0 -0
  138. package/agentvibes.org/.claude/audio/tts-padded-1760750947.mp3 +0 -0
  139. package/agentvibes.org/.claude/audio/tts-padded-1760752718.mp3 +0 -0
  140. package/agentvibes.org/.claude/audio/tts-padded-1760752907.mp3 +0 -0
  141. package/agentvibes.org/.claude/audio/tts-padded-1760753017.mp3 +0 -0
  142. package/agentvibes.org/.claude/audio/tts-padded-1760753045.mp3 +0 -0
  143. package/agentvibes.org/.claude/audio/tts-padded-1760753241.mp3 +0 -0
  144. package/agentvibes.org/.claude/audio/tts-padded-1760753315.mp3 +0 -0
  145. package/agentvibes.org/.claude/audio/tts-padded-1760753382.mp3 +0 -0
  146. package/agentvibes.org/.claude/audio/tts-padded-1760753408.mp3 +0 -0
  147. package/agentvibes.org/.claude/audio/tts-padded-1760753426.mp3 +0 -0
  148. package/agentvibes.org/.claude/audio/tts-padded-1760753446.mp3 +0 -0
  149. package/agentvibes.org/.claude/audio/tts-padded-1760753541.mp3 +0 -0
  150. package/agentvibes.org/.claude/audio/tts-padded-1760753553.mp3 +0 -0
  151. package/agentvibes.org/.claude/audio/tts-padded-1760753577.mp3 +0 -0
  152. package/agentvibes.org/.claude/commands/agent-vibes/add.md +21 -0
  153. package/agentvibes.org/.claude/commands/agent-vibes/agent-vibes.md +68 -0
  154. package/agentvibes.org/.claude/commands/agent-vibes/bmad.md +196 -0
  155. package/agentvibes.org/.claude/commands/agent-vibes/commands.json +77 -0
  156. package/agentvibes.org/.claude/commands/agent-vibes/get.md +9 -0
  157. package/agentvibes.org/.claude/commands/agent-vibes/language.md +23 -0
  158. package/agentvibes.org/.claude/commands/agent-vibes/learn.md +67 -0
  159. package/agentvibes.org/.claude/commands/agent-vibes/list.md +13 -0
  160. package/agentvibes.org/.claude/commands/agent-vibes/personality.md +79 -0
  161. package/agentvibes.org/.claude/commands/agent-vibes/preview.md +17 -0
  162. package/agentvibes.org/.claude/commands/agent-vibes/provider.md +54 -0
  163. package/agentvibes.org/.claude/commands/agent-vibes/replay-target.md +14 -0
  164. package/agentvibes.org/.claude/commands/agent-vibes/replay.md +19 -0
  165. package/agentvibes.org/.claude/commands/agent-vibes/sample.md +12 -0
  166. package/agentvibes.org/.claude/commands/agent-vibes/sentiment.md +52 -0
  167. package/agentvibes.org/.claude/commands/agent-vibes/set-language.md +47 -0
  168. package/agentvibes.org/.claude/commands/agent-vibes/set-pretext.md +65 -0
  169. package/agentvibes.org/.claude/commands/agent-vibes/set-speed.md +41 -0
  170. package/agentvibes.org/.claude/commands/agent-vibes/switch.md +53 -0
  171. package/agentvibes.org/.claude/commands/agent-vibes/target-voice.md +26 -0
  172. package/agentvibes.org/.claude/commands/agent-vibes/target.md +30 -0
  173. package/agentvibes.org/.claude/commands/agent-vibes/update.md +20 -0
  174. package/agentvibes.org/.claude/commands/agent-vibes/version.md +10 -0
  175. package/agentvibes.org/.claude/commands/agent-vibes/whoami.md +7 -0
  176. package/agentvibes.org/.claude/hooks/bmad-tts-injector.sh +386 -0
  177. package/agentvibes.org/.claude/hooks/bmad-voice-manager.sh +375 -0
  178. package/agentvibes.org/.claude/hooks/check-output-style.sh +60 -0
  179. package/agentvibes.org/.claude/hooks/github-star-reminder.sh +94 -0
  180. package/agentvibes.org/.claude/hooks/language-manager.sh +360 -0
  181. package/agentvibes.org/.claude/hooks/learn-manager.sh +443 -0
  182. package/agentvibes.org/.claude/hooks/personality-manager.sh +324 -0
  183. package/agentvibes.org/.claude/hooks/piper-download-voices.sh +133 -0
  184. package/agentvibes.org/.claude/hooks/piper-installer.sh +144 -0
  185. package/agentvibes.org/.claude/hooks/piper-voice-manager.sh +227 -0
  186. package/agentvibes.org/.claude/hooks/play-tts-elevenlabs.sh +376 -0
  187. package/agentvibes.org/.claude/hooks/play-tts-piper.sh +281 -0
  188. package/agentvibes.org/.claude/hooks/play-tts.sh +69 -0
  189. package/agentvibes.org/.claude/hooks/provider-commands.sh +505 -0
  190. package/agentvibes.org/.claude/hooks/provider-manager.sh +248 -0
  191. package/agentvibes.org/.claude/hooks/replay-target-audio.sh +64 -0
  192. package/agentvibes.org/.claude/hooks/sentiment-manager.sh +163 -0
  193. package/agentvibes.org/.claude/hooks/speed-manager.sh +259 -0
  194. package/agentvibes.org/.claude/hooks/voice-manager.sh +477 -0
  195. package/agentvibes.org/.claude/hooks/voices-config.sh +33 -0
  196. package/agentvibes.org/.claude/journal/2025-10-07.html +373 -0
  197. package/agentvibes.org/.claude/journal/index.html +91 -0
  198. package/agentvibes.org/.claude/output-styles/agent-vibes.md +203 -0
  199. package/agentvibes.org/.claude/personalities/angry.md +17 -0
  200. package/agentvibes.org/.claude/personalities/annoying.md +17 -0
  201. package/agentvibes.org/.claude/personalities/crass.md +17 -0
  202. package/agentvibes.org/.claude/personalities/dramatic.md +17 -0
  203. package/agentvibes.org/.claude/personalities/dry-humor.md +53 -0
  204. package/agentvibes.org/.claude/personalities/flirty.md +23 -0
  205. package/agentvibes.org/.claude/personalities/funny.md +17 -0
  206. package/agentvibes.org/.claude/personalities/grandpa.md +35 -0
  207. package/agentvibes.org/.claude/personalities/millennial.md +17 -0
  208. package/agentvibes.org/.claude/personalities/moody.md +17 -0
  209. package/agentvibes.org/.claude/personalities/normal.md +19 -0
  210. package/agentvibes.org/.claude/personalities/pirate.md +17 -0
  211. package/agentvibes.org/.claude/personalities/poetic.md +17 -0
  212. package/agentvibes.org/.claude/personalities/professional.md +17 -0
  213. package/agentvibes.org/.claude/personalities/robot.md +17 -0
  214. package/agentvibes.org/.claude/personalities/sarcastic.md +41 -0
  215. package/agentvibes.org/.claude/personalities/sassy.md +17 -0
  216. package/agentvibes.org/.claude/personalities/surfer-dude.md +17 -0
  217. package/agentvibes.org/.claude/personalities/zen.md +17 -0
  218. package/agentvibes.org/.claude/piper-voices-dir.txt +1 -0
  219. package/agentvibes.org/.claude/plugins/bmad-voices.md +42 -0
  220. package/agentvibes.org/.claude/tts-provider.txt +1 -0
  221. package/agentvibes.org/.mcp-minimal.json +60 -0
  222. package/agentvibes.org/CHANGELOG.md +56 -0
  223. package/agentvibes.org/README.md +93 -0
  224. package/agentvibes.org/app/(auth)/layout.tsx +15 -0
  225. package/agentvibes.org/app/(auth)/reset-password/page.tsx +45 -0
  226. package/agentvibes.org/app/(auth)/signin/page.tsx +82 -0
  227. package/agentvibes.org/app/(auth)/signup/page.tsx +104 -0
  228. package/agentvibes.org/app/(default)/blog/[slug]/page.tsx +128 -0
  229. package/agentvibes.org/app/(default)/blog/page.tsx +95 -0
  230. package/agentvibes.org/app/(default)/layout.tsx +31 -0
  231. package/agentvibes.org/app/(default)/page.tsx +20 -0
  232. package/agentvibes.org/app/api/hello/route.ts +3 -0
  233. package/agentvibes.org/app/css/additional-styles/theme.css +82 -0
  234. package/agentvibes.org/app/css/additional-styles/utility-patterns.css +55 -0
  235. package/agentvibes.org/app/css/style.css +100 -0
  236. package/agentvibes.org/app/layout.tsx +63 -0
  237. package/agentvibes.org/components/code-block.tsx +27 -0
  238. package/agentvibes.org/components/cta.tsx +58 -0
  239. package/agentvibes.org/components/features.tsx +256 -0
  240. package/agentvibes.org/components/hero-home.tsx +133 -0
  241. package/agentvibes.org/components/mdx-components.tsx +128 -0
  242. package/agentvibes.org/components/modal-video.tsx +137 -0
  243. package/agentvibes.org/components/page-illustration.tsx +55 -0
  244. package/agentvibes.org/components/spotlight.tsx +77 -0
  245. package/agentvibes.org/components/testimonials.tsx +282 -0
  246. package/agentvibes.org/components/ui/footer.tsx +82 -0
  247. package/agentvibes.org/components/ui/header.tsx +68 -0
  248. package/agentvibes.org/components/ui/logo.tsx +10 -0
  249. package/agentvibes.org/components/workflows.tsx +176 -0
  250. package/agentvibes.org/content/blog/discovering-new-piper-voices.mdx +253 -0
  251. package/agentvibes.org/content/blog/getting-started-agentvibes.mdx +228 -0
  252. package/agentvibes.org/content/blog/introducing-agentvibes-v2.mdx +250 -0
  253. package/agentvibes.org/content/blog/language-learning-with-agentvibes.mdx +142 -0
  254. package/agentvibes.org/content/blog/voice-personalities-guide.mdx +119 -0
  255. package/agentvibes.org/lib/blog.ts +73 -0
  256. package/agentvibes.org/next.config.js +6 -0
  257. package/agentvibes.org/package-lock.json +4285 -0
  258. package/agentvibes.org/package.json +40 -0
  259. package/agentvibes.org/pnpm-lock.yaml +1141 -0
  260. package/agentvibes.org/postcss.config.js +5 -0
  261. package/agentvibes.org/public/audio/02-sarcastic.mp3 +0 -0
  262. package/agentvibes.org/public/audio/03-angry.mp3 +0 -0
  263. package/agentvibes.org/public/audio/04-grandpa.mp3 +0 -0
  264. package/agentvibes.org/public/audio/05-sarcastic-example2.mp3 +0 -0
  265. package/agentvibes.org/public/audio/french-rachel.mp3 +0 -0
  266. package/agentvibes.org/public/audio/piper-voices/speaker_0_Cori_Samuel.wav +0 -0
  267. package/agentvibes.org/public/audio/piper-voices/speaker_10_Steve_C.wav +0 -0
  268. package/agentvibes.org/public/audio/piper-voices/speaker_11_Owlivia.wav +0 -0
  269. package/agentvibes.org/public/audio/piper-voices/speaker_12_Paul_Hampton.wav +0 -0
  270. package/agentvibes.org/public/audio/piper-voices/speaker_13_Jennifer_Dorr.wav +0 -0
  271. package/agentvibes.org/public/audio/piper-voices/speaker_14_Emily_Cripps.wav +0 -0
  272. package/agentvibes.org/public/audio/piper-voices/speaker_15_Martin_Clifton.wav +0 -0
  273. package/agentvibes.org/public/audio/piper-voices/speaker_1_Kara_Shallenberg.wav +0 -0
  274. package/agentvibes.org/public/audio/piper-voices/speaker_2_Kristin_Hughes.wav +0 -0
  275. package/agentvibes.org/public/audio/piper-voices/speaker_3_Maria_Kasper.wav +0 -0
  276. package/agentvibes.org/public/audio/piper-voices/speaker_4_Mike_Pelton.wav +0 -0
  277. package/agentvibes.org/public/audio/piper-voices/speaker_5_Mark_Nelson.wav +0 -0
  278. package/agentvibes.org/public/audio/piper-voices/speaker_6_Michael_Scherer.wav +0 -0
  279. package/agentvibes.org/public/audio/piper-voices/speaker_7_James_K_White.wav +0 -0
  280. package/agentvibes.org/public/audio/piper-voices/speaker_8_Rose_Ibex.wav +0 -0
  281. package/agentvibes.org/public/audio/piper-voices/speaker_9_progressingamerica.wav +0 -0
  282. package/agentvibes.org/public/audio/spanish-antoni.mp3 +0 -0
  283. package/agentvibes.org/public/favicon.ico +0 -0
  284. package/agentvibes.org/public/fonts/nacelle-italic.woff2 +0 -0
  285. package/agentvibes.org/public/fonts/nacelle-regular.woff2 +0 -0
  286. package/agentvibes.org/public/fonts/nacelle-semibold.woff2 +0 -0
  287. package/agentvibes.org/public/fonts/nacelle-semibolditalic.woff2 +0 -0
  288. package/agentvibes.org/public/images/blurred-shape-gray.svg +1 -0
  289. package/agentvibes.org/public/images/blurred-shape.svg +1 -0
  290. package/agentvibes.org/public/images/client-logo-01.svg +1 -0
  291. package/agentvibes.org/public/images/client-logo-02.svg +1 -0
  292. package/agentvibes.org/public/images/client-logo-03.svg +1 -0
  293. package/agentvibes.org/public/images/client-logo-04.svg +1 -0
  294. package/agentvibes.org/public/images/client-logo-05.svg +1 -0
  295. package/agentvibes.org/public/images/client-logo-06.svg +1 -0
  296. package/agentvibes.org/public/images/client-logo-07.svg +1 -0
  297. package/agentvibes.org/public/images/client-logo-08.svg +1 -0
  298. package/agentvibes.org/public/images/client-logo-09.svg +1 -0
  299. package/agentvibes.org/public/images/features.png +0 -0
  300. package/agentvibes.org/public/images/footer-illustration.svg +1 -0
  301. package/agentvibes.org/public/images/hero-image-01.jpg +0 -0
  302. package/agentvibes.org/public/images/logo.svg +1 -0
  303. package/agentvibes.org/public/images/page-illustration.svg +1 -0
  304. package/agentvibes.org/public/images/secondary-illustration.svg +1 -0
  305. package/agentvibes.org/public/images/testimonial-01.jpg +0 -0
  306. package/agentvibes.org/public/images/testimonial-02.jpg +0 -0
  307. package/agentvibes.org/public/images/testimonial-03.jpg +0 -0
  308. package/agentvibes.org/public/images/testimonial-04.jpg +0 -0
  309. package/agentvibes.org/public/images/testimonial-05.jpg +0 -0
  310. package/agentvibes.org/public/images/testimonial-06.jpg +0 -0
  311. package/agentvibes.org/public/images/testimonial-07.jpg +0 -0
  312. package/agentvibes.org/public/images/testimonial-08.jpg +0 -0
  313. package/agentvibes.org/public/images/testimonial-09.jpg +0 -0
  314. package/agentvibes.org/public/images/workflow-01.png +0 -0
  315. package/agentvibes.org/public/images/workflow-02.png +0 -0
  316. package/agentvibes.org/public/images/workflow-03.png +0 -0
  317. package/agentvibes.org/public/videos/video.mp4 +0 -0
  318. package/agentvibes.org/tsconfig.json +28 -0
  319. package/agentvibes.org/utils/useMasonry.tsx +67 -0
  320. package/agentvibes.org/utils/useMousePosition.tsx +27 -0
  321. package/docs/ai-optimized-documentation-standards.md +78 -4
  322. package/docs/bryce-beattie-voice-licensing.md +131 -0
  323. package/docs/commands.md +21 -1
  324. package/docs/mcp-setup.md +1 -6
  325. package/github-star-reminder.txt +1 -0
  326. package/linkedin/vibe-coding-and-pulseaudio.md +121 -0
  327. package/mcp-server/WINDOWS_SETUP.md +182 -199
  328. package/mcp-server/docs/elevenlabs-setup.md +213 -0
  329. package/mcp-server/docs/troubleshooting-audio.md +316 -0
  330. package/mcp-server/server.py +38 -4
  331. package/mcp-server/test_server.py +38 -3
  332. package/package.json +1 -1
  333. package/scripts/audio-tunnel.config +17 -0
  334. package/test/helpers/test-helper.bash +31 -4
  335. package/test/unit/personality-manager.bats +22 -6
  336. package/test/unit/play-tts.bats +21 -3
  337. package/test/unit/provider-manager.bats +508 -0
  338. package/test/unit/speed-manager.bats +436 -0
  339. package/test/unit/voice-manager.bats +4 -1
  340. package/.claude/piper-voices/en_US-lessac-medium.onnx +0 -0
  341. package/.claude/piper-voices/en_US-lessac-medium.onnx.json +0 -493
package/README.md CHANGED
@@ -11,7 +11,20 @@
11
11
  [![Publish](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml/badge.svg)](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml)
12
12
  [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
13
13
 
14
- **Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.0.17
14
+ **Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.0.19
15
+
16
+ ---
17
+
18
+ ## 🚀 Quick Links
19
+
20
+ | I want to... | Go here |
21
+ |--------------|---------|
22
+ | **Install AgentVibes** | [Quick Start Guide](docs/quick-start.md) |
23
+ | **Set up on Windows (Claude Desktop)** | [Windows Setup Guide](mcp-server/WINDOWS_SETUP.md) |
24
+ | **Use natural language** | [MCP Setup](docs/mcp-setup.md) |
25
+ | **Switch voices** | [Voice Library](docs/voice-library.md) |
26
+ | **Learn Spanish while coding** | [Language Learning Mode](docs/language-learning-mode.md) |
27
+ | **Fix issues** | [Troubleshooting](docs/troubleshooting.md) |
15
28
 
16
29
  ---
17
30
 
@@ -42,43 +55,42 @@ Whether you're coding in Claude Code, chatting in Claude Desktop, or using Warp
42
55
  ## 📑 Table of Contents
43
56
 
44
57
  ### Getting Started
45
- - [🚀 Quick Start](#claude-code-quick-start) - Install in 3 steps
46
- - [✨ What is AgentVibes?](#what-is-agentvibes) - Overview & key features
47
- - [📰 Latest Release](#latest-release) - What's new
58
+ - [🚀 Quick Start](#-quick-start) - Install in 3 steps
59
+ - [✨ What is AgentVibes?](#-what-is-agentvibes) - Overview & key features
60
+ - [📰 Latest Release](#-latest-release) - What's new
61
+ - [🪟 Windows Setup Guide for Claude Desktop](mcp-server/WINDOWS_SETUP.md) - Complete Windows installation with WSL & Python
48
62
 
49
63
  ### AgentVibes MCP (Natural Language Control)
50
- - [🎙️ AgentVibes MCP Overview](#agentvibes-mcp-easiest-way-to-use-agentvibes) - **Easiest way** - Natural language commands
51
- - [For Claude Desktop](#for-claude-desktop) - Windows/WSL setup, Python requirements
52
- - [For Warp Terminal](#for-warp-terminal) - Warp configuration
53
- - [For Claude Code](#for-claude-code) - Project-specific setup
54
- - [📦 What Gets Installed](#where-settings-are-saved) - MCP dependencies & settings
64
+ - [🎙️ AgentVibes MCP Overview](#%EF%B8%8F-agentvibes-mcp) - **Easiest way** - Natural language commands
65
+ - [For Claude Desktop](docs/mcp-setup.md#for-claude-desktop) - Windows/WSL setup, Python requirements
66
+ - [For Warp Terminal](docs/mcp-setup.md#for-warp-terminal) - Warp configuration
67
+ - [For Claude Code](docs/mcp-setup.md#for-claude-code) - Project-specific setup
55
68
 
56
69
  ### Core Features
57
- - [🎤 Commands Reference](#commands-reference) - All available commands
58
- - [📚 Language Learning Mode](#language-learning-mode) - **NEW!** Learn Spanish while you program
59
- - [🎭 Personalities vs Sentiments](#personalities-vs-sentiments) - Two systems explained
60
- - [🗣️ Voice Library](#voice-library) - 27+ professional voices
61
- - [🌍 Multilingual Support](#change-language) - Speak in 30+ languages
62
- - [🔌 BMAD Plugin](#bmad-plugin) - Auto voice switching for BMAD agents
70
+ - [🎤 Commands Reference](#-commands-reference) - All available commands
71
+ - [📚 Language Learning Mode](#-language-learning-mode) - **NEW!** Learn Spanish while you program
72
+ - [🎭 Personalities vs Sentiments](#-personalities-vs-sentiments) - Two systems explained
73
+ - [🗣️ Voice Library](#%EF%B8%8F-voice-library) - 27+ professional voices
74
+ - [🔌 BMAD Plugin](#-bmad-plugin) - Auto voice switching for BMAD agents
63
75
 
64
76
  ### Advanced Topics
65
- - [📦 Installation Structure](#installation-structure) - What gets installed
66
- - [💡 Usage Examples](#usage-examples) - Common workflows
67
- - [🔧 Advanced Features](#advanced-features) - Custom voices & personalities
68
- - [🔊 Remote Audio Setup](#remote-audio-setup) - Play TTS from remote servers
69
- - [❓ Troubleshooting](#troubleshooting) - Common issues & fixes
77
+ - [📦 Installation Structure](#-installation-structure) - What gets installed
78
+ - [💡 Common Workflows](#-common-workflows) - Quick examples
79
+ - [🔧 Advanced Features](#-advanced-features) - Custom voices & personalities
80
+ - [🔊 Remote Audio Setup](#-remote-audio-setup) - Play TTS from remote servers
81
+ - [❓ Troubleshooting](#-troubleshooting) - Common issues & fixes
70
82
 
71
83
  ### Additional Resources
72
- - [🔗 Useful Links](#useful-links) - Voice typing & AI tools
73
- - [🔄 Updating](#updating) - Keep AgentVibes current
74
- - [🙏 Credits](#credits) - Acknowledgments
75
- - [🤝 Contributing](#contributing) - Show support
84
+ - [🔗 Useful Links](#-useful-links) - Voice typing & AI tools
85
+ - [🔄 Updating](#-updating) - Keep AgentVibes current
86
+ - [🙏 Credits](#-credits) - Acknowledgments
87
+ - [🤝 Contributing](#-contributing) - Show support
76
88
 
77
89
  ---
78
90
 
79
91
  ## 📰 Latest Release
80
92
 
81
- **[v2.0.17-beta - Release Notes](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.0.17-beta)** 🎉
93
+ **[v2.0.17-beta - Release Notes](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.0.19-beta)** 🎉
82
94
 
83
95
  **NEW: Automatic SSH Audio Optimization!** AgentVibes now automatically detects remote SSH sessions and optimizes audio for perfect playback - no more static or clicking sounds!
84
96
 
@@ -94,9 +106,23 @@ Plus: **Language Learning Mode** (e.g., Learn Spanish while you program!) with d
94
106
 
95
107
  [→ View Full Release Notes](RELEASE_NOTES_V2.md) | [→ View All Releases](https://github.com/paulpreibisch/AgentVibes/releases)
96
108
 
109
+ [↑ Back to top](#-table-of-contents)
110
+
97
111
  ---
98
112
 
99
- ## 🎙️ AgentVibes MCP (Easiest Way to Use AgentVibes!)
113
+ ## 🎙️ AgentVibes MCP
114
+
115
+ Agent Vibes was originally created to give the Claude Code assistant a voice! Simply install it with an npx command in your terminal, and Claude Code can talk back to you.
116
+
117
+ We've now enhanced this capability by adding an MCP (Model Context Protocol) server. This integration exposes Agent Vibes' functionality directly to your AI assistant, allowing you to configure and control Agent Vibes using natural language instead of typing "/" slash commands.
118
+
119
+ Setting it up is straightforward: just add the MCP server to your Claude Code configuration files.
120
+
121
+ But the convenience doesn't stop there. With the MCP server in place, Claude Desktop can now use Agent Vibes too! We've even tested it successfully with Warp, an AI assistant that helps you navigate Windows and other operating systems.
122
+
123
+ We're thrilled about this expansion because it means Claude Desktop and Warp can finally talk back as well!
124
+
125
+ If you decide to use the MCP server on Claude Desktop, after configuration, give Claude Desktop this command: "every time i give you a command, speak the acknowledgement using agentvibes and the confirmation about what you completed, when done"—and watch the magic happen!
100
126
 
101
127
  **🎯 Control AgentVibes with natural language - no slash commands to remember!**
102
128
 
@@ -120,11 +146,11 @@ Get AgentVibes running in 3 steps: **Install** → **Choose Provider** (Piper/El
120
146
 
121
147
  ---
122
148
 
123
- ## 🎭 Multi-Provider Support
149
+ ## 🎭 Choose Your Voice Provider
124
150
 
125
- Choose between **ElevenLabs** (150+ premium voices) or **Piper TTS** (50+ free voices, works offline).
151
+ **ElevenLabs** (premium AI voices) or **Piper TTS** (free, works offline) - pick one and switch anytime.
126
152
 
127
- **[→ View Complete Provider Guide](docs/providers.md)** - Full comparison, features, setup, and switching instructions
153
+ **[→ Provider Comparison Guide](docs/providers.md)**
128
154
 
129
155
  [↑ Back to top](#-table-of-contents)
130
156
 
@@ -169,30 +195,12 @@ Every task acknowledgment plays **twice** - first in English, then in your targe
169
195
 
170
196
  ## 🎭 Personalities vs Sentiments
171
197
 
172
- **Two ways to add personality to Claude's voice:**
173
-
174
- ### 🎪 Personalities (Voice + Style)
175
- Changes **both** voice AND how Claude talks. Each personality has a dedicated voice.
198
+ **Two ways to add personality:**
176
199
 
177
- **Examples:** `sarcastic`, `pirate`, `grandpa`, `flirty`, `zen`, `robot`
200
+ - **🎪 Personalities** - Changes BOTH voice AND speaking style (e.g., `pirate` personality = Pirate Marshal voice + pirate speak)
201
+ - **💭 Sentiments** - Keeps your current voice, only changes speaking style (e.g., Aria voice + sarcastic sentiment)
178
202
 
179
- ```bash
180
- /agent-vibes:personality pirate # Uses Pirate Marshal voice + pirate speak
181
- ```
182
-
183
- ### 💭 Sentiments (Style Only)
184
- Applies personality style to **your current voice** without changing it.
185
-
186
- ```bash
187
- /agent-vibes:switch Aria # Set voice
188
- /agent-vibes:sentiment sarcastic # Add sarcasm to Aria
189
- ```
190
-
191
- **Key Difference:**
192
- - **Personality** = Changes voice + style
193
- - **Sentiment** = Keeps your voice + adds style
194
-
195
- **[→ View Complete Personalities Guide](docs/personalities.md)** - All 19 personalities, voice mappings, and how to create custom ones
203
+ **[→ Complete Personalities Guide](docs/personalities.md)** - All 19 personalities, create custom ones
196
204
 
197
205
  [↑ Back to top](#-table-of-contents)
198
206
 
@@ -234,75 +242,26 @@ The BMAD plugin detects when you activate a BMAD agent (e.g., `/BMad:agents:pm`)
234
242
 
235
243
  ---
236
244
 
237
- ## 💡 Usage Examples
238
-
239
- ### Switch Voices
245
+ ## 💡 Common Workflows
240
246
 
241
247
  ```bash
248
+ # Switch voices
242
249
  /agent-vibes:list # See all voices
243
- /agent-vibes:switch Aria # Switch to Aria
244
- /agent-vibes:switch "Cowboy Bob" # Switch to Cowboy Bob
245
- /agent-vibes:whoami # Check current setup
246
- ```
250
+ /agent-vibes:switch Aria # Change voice
247
251
 
248
- ### Try Personalities
249
-
250
- ```bash
251
- /agent-vibes:personality sarcastic # Sarcastic + Jessica Anne Bogart
252
- /agent-vibes:personality pirate # Pirate + Pirate Marshal
253
- /agent-vibes:personality dry-humor # British wit + Aria
252
+ # Try personalities
253
+ /agent-vibes:personality pirate # Pirate voice + style
254
254
  /agent-vibes:personality list # See all 19 personalities
255
- ```
256
255
 
257
- ### Use Sentiments
256
+ # Speak in other languages
257
+ /agent-vibes:set-language spanish # Speak in Spanish
258
+ /agent-vibes:set-language list # See 30+ languages
258
259
 
259
- ```bash
260
- /agent-vibes:switch Aria # Set to Aria voice
261
- /agent-vibes:sentiment sarcastic # Add sarcasm to Aria
262
- /agent-vibes:sentiment clear # Remove sentiment
263
- ```
264
-
265
- ### Audio Replay
266
-
267
- ```bash
260
+ # Replay audio
268
261
  /agent-vibes:replay # Replay last message
269
- /agent-vibes:replay 3 # Replay 3rd-to-last
270
262
  ```
271
263
 
272
- ### Voice Preview
273
-
274
- ```bash
275
- /agent-vibes:preview # Hear first 3 voices
276
- /agent-vibes:preview 10 # Hear first 10
277
- /agent-vibes:preview last 5 # Hear last 5
278
- ```
279
-
280
- ### Change Language
281
-
282
- Make Claude speak in **30+ languages** using multilingual voices:
283
-
284
- ```bash
285
- # Set to Spanish
286
- /agent-vibes:set-language spanish
287
-
288
- # Set to French
289
- /agent-vibes:set-language french
290
-
291
- # Set to German
292
- /agent-vibes:set-language german
293
-
294
- # See all supported languages
295
- /agent-vibes:set-language list
296
-
297
- # Reset to English
298
- /agent-vibes:set-language english
299
- ```
300
-
301
- **Supported Languages:**
302
- - Spanish, French, German, Italian, Portuguese
303
- - Chinese, Japanese, Korean, Hindi, Arabic
304
- - Polish, Dutch, Turkish, Swedish, Russian
305
- - And 15+ more!
264
+ **💡 Tip:** Using MCP? Just say "Switch to Aria voice" or "Speak in Spanish" instead of typing commands.
306
265
 
307
266
  [↑ Back to top](#-table-of-contents)
308
267
 
@@ -332,35 +291,13 @@ AgentVibes supports **custom personalities**, **custom voices**, and **integrati
332
291
 
333
292
  ## 🔊 Remote Audio Setup
334
293
 
335
- **Running AgentVibes on a remote server but want to hear TTS on your local machine?**
336
-
337
- We've got you covered! AgentVibes now includes **automatic SSH audio tunnel detection and optimization** for seamless remote audio playback.
338
-
339
- ### 🎯 Automatic SSH Audio Optimization (v2.0.17+)
340
-
341
- **NEW:** AgentVibes automatically detects SSH sessions and optimizes audio for remote playback!
342
-
343
- **What it does:**
344
- - ✅ **Auto-detects** remote SSH sessions (VS Code Remote SSH, regular SSH, cloud environments)
345
- - ✅ **Auto-converts** audio to 48kHz stereo WAV format for SSH tunnel compatibility
346
- - ✅ **Eliminates static/clicking** sounds that occur with default audio formats
347
- - ✅ **Zero configuration** - works out of the box
348
-
349
- **How it works:**
350
- 1. AgentVibes checks for SSH environment variables (`SSH_CONNECTION`, `SSH_CLIENT`, `VSCODE_IPC_HOOK_CLI`)
351
- 2. If detected, it converts ElevenLabs audio (44.1kHz mono MP3) to 48kHz stereo WAV
352
- 3. Audio plays clearly through your SSH tunnel without static or distortion
353
-
354
- **Supported scenarios:**
355
- - 🖥️ **VS Code Remote SSH** - Code from local VS Code, run TTS on remote server
356
- - 🔐 **Regular SSH** - Standard SSH connections with audio tunneling
357
- - ☁️ **Cloud Dev Environments** - AWS, Azure, GCP instances with SSH access
358
-
359
- ### 📚 Full Remote Audio Setup Guide
294
+ **Running AgentVibes on a remote server?** No problem!
360
295
 
361
- For detailed PulseAudio SSH tunnel configuration:
296
+ **Auto-detects SSH sessions** - Works with VS Code Remote SSH, regular SSH, cloud dev environments
297
+ ✅ **Zero configuration** - Audio optimizes automatically
298
+ ✅ **No static/clicking** - Clean playback through SSH tunnels
362
299
 
363
- **[→ Remote Audio Setup Guide](docs/remote-audio-setup.md)**
300
+ **[→ Remote Audio Setup Guide](docs/remote-audio-setup.md)** - Full PulseAudio configuration details
364
301
 
365
302
  [↑ Back to top](#-table-of-contents)
366
303
 
@@ -374,6 +311,8 @@ For detailed PulseAudio SSH tunnel configuration:
374
311
  - 🗣️ **[OpenWhisper (Azure)](https://learn.microsoft.com/en-us/azure/ai-services/speech-service/whisper-overview)** - Microsoft's speech-to-text service
375
312
  - 🎙️ **[ElevenLabs](https://elevenlabs.io/)** - Premium AI voice synthesis
376
313
  - 🆓 **[Piper TTS](https://github.com/rhasspy/piper)** - Free offline neural TTS
314
+ - 🎨 **[Custom Piper Voices by Bryce Beattie](https://brycebeattie.com/files/tts/)** - High-quality community Piper voices (Kristin, Jenny)
315
+ - 🛠️ **[Create Custom Piper TTS Voice](https://ssamjh.nz/create-custom-piper-tts-voice/)** - Tutorial for training your own Piper voices
377
316
  - 🤖 **[Claude Code](https://claude.com/claude-code)** - AI coding assistant
378
317
  - 🎭 **[BMAD METHOD](https://github.com/bmad-code-org/BMAD-METHOD)** - Multi-agent framework
379
318
 
@@ -481,6 +420,7 @@ npm update -g agentvibes && agentvibes update --yes
481
420
  **Special Thanks:**
482
421
  - 💡 [Claude Code Hooks Mastery](https://github.com/disler/claude-code-hooks-mastery) by [@disler](https://github.com/disler) - Hooks inspiration
483
422
  - 🤖 [BMAD METHOD](https://github.com/bmad-code-org/BMAD-METHOD) - Multi-agent framework with auto voice switching integration
423
+ - 🎨 [Bryce Beattie](https://brycebeattie.com/files/tts/) - Custom high-quality Piper voices (Kristin, Jenny)
484
424
 
485
425
  [↑ Back to top](#-table-of-contents)
486
426
 
package/RELEASE_NOTES.md CHANGED
@@ -1,3 +1,272 @@
1
+ # 🎤 AgentVibes v2.0.18 Release Notes
2
+
3
+ ## 📦 v2.0.18 - Multi-Speaker Voices & HuggingFace Integration (2025-10-17)
4
+
5
+ ### 🎯 Overview
6
+
7
+ This release introduces **multi-speaker voice support** for Piper TTS, allowing users to select from 16 different voice personalities within a single voice model. Additionally, all custom voices are now hosted on **HuggingFace** for reliable, free access.
8
+
9
+ **Release Date:** October 17, 2025
10
+ **Git Tag:** v2.0.18
11
+ **Commits Since v2.0.17:** 14 commits
12
+ **Files Changed:** 72 files, +38,462 insertions, -544 deletions
13
+
14
+ ---
15
+
16
+ ## 🌟 **New Features**
17
+
18
+ ### **1. Multi-Speaker Voice Support** 🎭
19
+
20
+ AgentVibes now supports Piper voices that contain multiple speakers in one model:
21
+
22
+ **New Format:** `voicename#speakerID`
23
+
24
+ ```bash
25
+ # Switch to specific speaker
26
+ /agent-vibes:switch 16Speakers#0 # Cori Samuel
27
+ /agent-vibes:switch 16Speakers#2 # Kristin Hughes
28
+ /agent-vibes:switch 16Speakers#15 # Martin Clifton
29
+ ```
30
+
31
+ **Features:**
32
+ - Auto-detection of multi-speaker voices via JSON metadata
33
+ - Enhanced voice listing shows all speakers with names
34
+ - Current speaker marked with `▶` indicator
35
+ - Supports 0-based speaker indexing
36
+ - Seamless switching between speakers
37
+
38
+ **16Speakers Voice Personalities:**
39
+ 1. Cori Samuel (ID 0)
40
+ 2. Kara Shallenberg (ID 1)
41
+ 3. Kristin Hughes (ID 2)
42
+ 4. Maria Kasper (ID 3)
43
+ 5. Mike Pelton (ID 4)
44
+ 6. Mark Nelson (ID 5)
45
+ 7. Michael Scherer (ID 6)
46
+ 8. James K White (ID 7)
47
+ 9. Rose Ibex (ID 8)
48
+ 10. progressingamerica (ID 9)
49
+ 11. Steve C (ID 10)
50
+ 12. Owlivia (ID 11)
51
+ 13. Paul Hampton (ID 12)
52
+ 14. Jennifer Dorr (ID 13)
53
+ 15. Emily Cripps (ID 14)
54
+ 16. Martin Clifton (ID 15)
55
+
56
+ ### **2. HuggingFace Voice Repository** 🤗
57
+
58
+ All custom AgentVibes voices are now hosted on HuggingFace:
59
+
60
+ **Repository:** https://huggingface.co/agentvibes/piper-custom-voices
61
+
62
+ **Available Voices:**
63
+ - **16Speakers.onnx** (77MB) - Multi-speaker voice with 16 personalities
64
+ - **kristin.onnx** (64MB) - US English female (Public Domain)
65
+ - **jenny.onnx** (64MB) - UK English female, Irish accent (CC BY)
66
+
67
+ **Benefits:**
68
+ - ✅ Free, reliable CDN hosting
69
+ - ✅ Version-controlled voice models
70
+ - ✅ Automatic downloads during installation
71
+ - ✅ Preview audio samples included
72
+ - ✅ Community-accessible
73
+
74
+ ### **3. Enhanced Voice Listing** 📋
75
+
76
+ The `/agent-vibes:list` command now intelligently displays multi-speaker voices:
77
+
78
+ **Before:**
79
+ ```
80
+ en_US-lessac-medium
81
+ 16Speakers
82
+ kristin
83
+ ```
84
+
85
+ **After:**
86
+ ```
87
+ en_US-lessac-medium
88
+
89
+ 📢 16Speakers (Multi-speaker: 16 voices)
90
+ 0️. Cori_Samuel
91
+ 1️. Kara_Shallenberg
92
+ ▶ 2️. Kristin_Hughes (current)
93
+ ...
94
+
95
+ kristin
96
+ ```
97
+
98
+ **Features:**
99
+ - Groups speakers under parent voice
100
+ - Shows speaker names and IDs
101
+ - Marks current speaker selection
102
+ - Automatic detection via `num_speakers` in JSON
103
+
104
+ ---
105
+
106
+ ## 🔧 **Technical Improvements**
107
+
108
+ ### Voice Manager Enhancements
109
+ - **Multi-speaker detection** - Reads `num_speakers` from voice JSON
110
+ - **Speaker listing** - Displays all speakers with formatted names
111
+ - **Current speaker tracking** - Parses `voicename#speakerID` format
112
+ - **Custom voice fallback** - Supports non-standard voice paths
113
+
114
+ ### Piper TTS Provider Updates
115
+ - **Speaker ID parsing** - Extracts speaker from `voicename#speakerID`
116
+ - **Error suppression** - Hides voice path errors for custom voices
117
+ - **Custom voice path support** - Bypasses standard voice manager
118
+ - **Speaker parameter** - Passes `--speaker ID` to piper command
119
+
120
+ ### Download Script Integration
121
+ - **HuggingFace URLs** - Updated from DigitalOcean to HuggingFace
122
+ - **16Speakers download** - Added to custom voice list
123
+ - **Attribution updates** - Credits AgentVibes + Bryce Beattie
124
+ - **Usage instructions** - Shows multi-speaker format examples
125
+
126
+ ---
127
+
128
+ ## 📚 **Documentation Updates**
129
+
130
+ ### New Documentation
131
+ - `docs/bryce-beattie-voice-licensing.md` - Voice licensing information
132
+ - `docs/huggingface-setup-guide.md` - HuggingFace upload guide
133
+ - `mcp-server/voices/README.md` - Voice repository documentation
134
+
135
+ ### Updated Documentation
136
+ - `docs/commands.md` - Added multi-speaker voice section
137
+ - `docs/commands.md` - Added `/agent-vibes:switch <voice>#<speaker>` command
138
+ - `.claude/hooks/piper-download-voices.sh` - HuggingFace integration
139
+
140
+ ### Command Examples Added
141
+ ```bash
142
+ # List all speakers
143
+ /agent-vibes:list
144
+
145
+ # Switch to specific speaker
146
+ /agent-vibes:switch 16Speakers#0 # Cori Samuel
147
+ /agent-vibes:switch 16Speakers#15 # Martin Clifton
148
+
149
+ # Preview voices
150
+ /agent-vibes:preview
151
+ ```
152
+
153
+ ---
154
+
155
+ ## 🐛 **Bug Fixes**
156
+
157
+ ### Voice Path Error Handling
158
+ - **Fixed:** Error messages for custom voices not in standard paths
159
+ - **Solution:** Added `2>/dev/null` to suppress stderr from `get_voice_path`
160
+ - **Impact:** Cleaner output when using custom voices
161
+
162
+ ### Voice Detection
163
+ - **Fixed:** Custom voices not recognized by voice manager
164
+ - **Solution:** Added fallback to `~/.local/share/piper/voices/` directory
165
+ - **Impact:** 16Speakers and other custom voices now work seamlessly
166
+
167
+ ---
168
+
169
+ ## 📦 **Installation**
170
+
171
+ ### Fresh Install
172
+ ```bash
173
+ npx agentvibes install
174
+ ```
175
+
176
+ The installer will automatically offer to download:
177
+ - Standard Piper voices (lessac, amy, joe, ryan, libritts)
178
+ - **Custom voices: Kristin, Jenny, 16Speakers (NEW!)**
179
+
180
+ ### Update Existing Installation
181
+ ```bash
182
+ npx agentvibes update
183
+ ```
184
+
185
+ Then download new voices:
186
+ ```bash
187
+ .claude/hooks/piper-download-voices.sh
188
+ ```
189
+
190
+ Or download manually from HuggingFace:
191
+ ```bash
192
+ # Download 16Speakers
193
+ wget https://huggingface.co/agentvibes/piper-custom-voices/resolve/main/16Speakers.onnx
194
+ wget https://huggingface.co/agentvibes/piper-custom-voices/resolve/main/16Speakers.onnx.json
195
+ ```
196
+
197
+ ---
198
+
199
+ ## 🎨 **Voice Attribution**
200
+
201
+ All custom voices created by **Bryce Beattie** (https://brycebeattie.com/files/tts/)
202
+
203
+ ### Licensing
204
+ - **Kristin**: Public Domain (LibriVox recordings)
205
+ - **16Speakers**: Public Domain (LibriVox recordings)
206
+ - **Jenny**: CC BY (Dioco dataset - attribution required)
207
+
208
+ ### Creator's Permission
209
+ > "Feel free to use these for any legal and ethical purpose. If somebody wants to upload these to HuggingFace or somewhere similar, you have my blessing." — Bryce Beattie
210
+
211
+ ---
212
+
213
+ ## 📝 **Breaking Changes**
214
+
215
+ None. All changes are backward compatible.
216
+
217
+ ---
218
+
219
+ ## 🔗 **Links**
220
+
221
+ - **NPM Package**: https://www.npmjs.com/package/agentvibes
222
+ - **GitHub Repository**: https://github.com/paulpreibisch/AgentVibes
223
+ - **HuggingFace Voices**: https://huggingface.co/agentvibes/piper-custom-voices
224
+ - **Documentation**: https://github.com/paulpreibisch/AgentVibes/blob/master/README.md
225
+ - **Voice Creator**: https://brycebeattie.com/files/tts/
226
+
227
+ ---
228
+
229
+ ## 🙏 **Credits**
230
+
231
+ - **Voice Models**: Bryce Beattie
232
+ - **Multi-Speaker Implementation**: Paul Preibisch with Claude AI
233
+ - **HuggingFace Integration**: AgentVibes Team
234
+ - **Piper TTS**: rhasspy project
235
+
236
+ ---
237
+
238
+ ## 📊 **Statistics**
239
+
240
+ - **Total Voice Files Added**: 35 files
241
+ - **Voice Model Size**: 205 MB total (16Speakers: 77MB, Kristin: 64MB, Jenny: 64MB)
242
+ - **Preview Audio Samples**: 16 WAV files included
243
+ - **Documentation Files**: 3 new guides
244
+ - **Code Changes**: 72 files modified, +38,462 lines
245
+
246
+ ---
247
+
248
+ ## 🚀 **What's Next**
249
+
250
+ Future releases may include:
251
+ - Additional multi-speaker voices
252
+ - Voice browsing/preview command
253
+ - Voice quality ratings
254
+ - Community voice submissions
255
+ - Per-speaker speed control
256
+
257
+ ---
258
+
259
+ **Enjoy the new multi-speaker voices! 🎤✨**
260
+
261
+ Choose from 16 different personalities with a simple command:
262
+ ```bash
263
+ /agent-vibes:switch 16Speakers#2 # Kristin Hughes
264
+ ```
265
+
266
+
267
+ ---
268
+
269
+
1
270
  # 🎤 AgentVibes Release Notes
2
271
 
3
272
  ## 📦 v2.0.17 - Major Feature Release (2025-10-17)