agentvibes 1.0.0

package/src/installer.js

@@ -0,0 +1,443 @@
+#!/usr/bin/env node
+
+import { program } from 'commander';
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import figlet from 'figlet';
+import boxen from 'boxen';
+import ora from 'ora';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const VERSION = '1.0.0';
+
+// Beautiful ASCII art
+function showWelcome() {
+  console.log(
+    chalk.cyan(
+      figlet.textSync('AgentVibes', {
+        font: 'ANSI Shadow',
+        horizontalLayout: 'default',
+      })
+    )
+  );
+
+  console.log(
+    boxen(
+      chalk.white.bold('🎤 Beautiful ElevenLabs TTS Voice Commands for Claude Code\n\n') +
+      chalk.gray('Add professional text-to-speech narration to your AI coding sessions'),
+      {
+        padding: 1,
+        margin: 1,
+        borderStyle: 'round',
+        borderColor: 'cyan',
+        backgroundColor: '#1a1a1a',
+      }
+    )
+  );
+}
+
+// Installation function
+async function install(options = {}) {
+  showWelcome();
+
+  const homeDir = process.env.HOME || process.env.USERPROFILE;
+  const targetDir = options.directory || homeDir;
+
+  console.log(chalk.cyan('\n📍 Installation Details:'));
+  console.log(chalk.gray(`   Target directory: ${targetDir}`));
+  console.log(chalk.gray(`   Package version: ${VERSION}`));
+
+  console.log(chalk.cyan('\n📦 What will be installed:'));
+  console.log(chalk.gray(`   • 11 slash commands → ${targetDir}/.claude/commands/agent-vibes/`));
+  console.log(chalk.gray(`   • 4 TTS scripts → ${targetDir}/.claude/hooks/`));
+  console.log(chalk.gray(`   • 10+ personality templates → ${targetDir}/.claude/personalities/`));
+  console.log(chalk.gray(`   • Agent Vibes output style → ${targetDir}/.claude/output-styles/`));
+  console.log(chalk.gray(`   • Voice configuration files`));
+  console.log(chalk.gray(`   • 15+ ElevenLabs character voices\n`));
+
+  // Confirmation prompt (unless --yes flag is used)
+  if (!options.yes) {
+    const { confirm } = await inquirer.prompt([
+      {
+        type: 'confirm',
+        name: 'confirm',
+        message: chalk.yellow('Install AgentVibes in this directory?'),
+        default: true,
+      },
+    ]);
+
+    if (!confirm) {
+      console.log(chalk.red('\n❌ Installation cancelled.\n'));
+      process.exit(0);
+    }
+  } else {
+    console.log(chalk.green('✓ Auto-confirmed (--yes flag)\n'));
+  }
+
+  console.log(''); // Add spacing
+  const spinner = ora('Checking installation directory...').start();
+
+  try {
+    // Check if .claude directory exists
+    const claudeDir = path.join(targetDir, '.claude');
+    const commandsDir = path.join(claudeDir, 'commands');
+    const hooksDir = path.join(claudeDir, 'hooks');
+    const outputStylesDir = path.join(claudeDir, 'output-styles');
+
+    let exists = false;
+    try {
+      await fs.access(claudeDir);
+      exists = true;
+    } catch {}
+
+    if (!exists) {
+      spinner.info(chalk.yellow('Creating .claude directory structure...'));
+      console.log(chalk.gray(`   → ${commandsDir}`));
+      console.log(chalk.gray(`   → ${hooksDir}`));
+      console.log(chalk.gray(`   → ${outputStylesDir}`));
+      await fs.mkdir(commandsDir, { recursive: true });
+      await fs.mkdir(hooksDir, { recursive: true });
+      await fs.mkdir(outputStylesDir, { recursive: true });
+      console.log(chalk.green('   ✓ Directories created!\n'));
+    } else {
+      spinner.succeed(chalk.green('.claude directory found!'));
+      console.log(chalk.gray(`   Location: ${claudeDir}\n`));
+    }
+
+    // Copy command files
+    spinner.start('Installing /agent-vibes slash commands...');
+    const srcCommandsDir = path.join(__dirname, '..', '.claude', 'commands', 'agent-vibes');
+    const srcHooksDir = path.join(__dirname, '..', '.claude', 'hooks');
+
+    // Create agent-vibes commands directory
+    const agentVibesCommandsDir = path.join(commandsDir, 'agent-vibes');
+    await fs.mkdir(agentVibesCommandsDir, { recursive: true });
+
+    // Copy all command files to agent-vibes folder
+    const commandFiles = await fs.readdir(srcCommandsDir);
+    console.log(chalk.cyan(`\n📋 Installing ${commandFiles.length} command files:`));
+    for (const file of commandFiles) {
+      const srcPath = path.join(srcCommandsDir, file);
+      const destPath = path.join(agentVibesCommandsDir, file);
+      await fs.copyFile(srcPath, destPath);
+      console.log(chalk.gray(`   ✓ agent-vibes/${file}`));
+    }
+    spinner.succeed(chalk.green('Installed /agent-vibes commands!\n'));
+
+    // Copy hook scripts
+    spinner.start('Installing TTS helper scripts...');
+    const hookFiles = await fs.readdir(srcHooksDir);
+    console.log(chalk.cyan(`🔧 Installing ${hookFiles.length} TTS scripts:`));
+    for (const file of hookFiles) {
+      const srcPath = path.join(srcHooksDir, file);
+      const destPath = path.join(hooksDir, file);
+      await fs.copyFile(srcPath, destPath);
+      await fs.chmod(destPath, 0o755); // Make executable
+      console.log(chalk.gray(`   ✓ ${file} (executable)`));
+    }
+    spinner.succeed(chalk.green('Installed TTS scripts!\n'));
+
+    // Copy personalities folder
+    spinner.start('Installing personality templates...');
+    const srcPersonalitiesDir = path.join(__dirname, '..', '.claude', 'personalities');
+    const destPersonalitiesDir = path.join(claudeDir, 'personalities');
+
+    // Create personalities directory
+    await fs.mkdir(destPersonalitiesDir, { recursive: true });
+
+    // Copy all personality files
+    const personalityFiles = await fs.readdir(srcPersonalitiesDir);
+    console.log(chalk.cyan(`🎭 Installing ${personalityFiles.length} personality templates:`));
+    for (const file of personalityFiles) {
+      const srcPath = path.join(srcPersonalitiesDir, file);
+      const destPath = path.join(destPersonalitiesDir, file);
+      await fs.copyFile(srcPath, destPath);
+      console.log(chalk.gray(`   ✓ ${file}`));
+    }
+    spinner.succeed(chalk.green('Installed personality templates!\n'));
+
+    // Copy output styles
+    spinner.start('Installing output styles...');
+    const srcOutputStylesDir = path.join(__dirname, '..', 'templates', 'output-styles');
+
+    // Create output-styles directory if it doesn't exist
+    try {
+      await fs.mkdir(outputStylesDir, { recursive: true });
+    } catch {}
+
+    const outputStyleFiles = await fs.readdir(srcOutputStylesDir);
+    console.log(chalk.cyan(`📝 Installing ${outputStyleFiles.length} output styles:`));
+    for (const file of outputStyleFiles) {
+      const srcPath = path.join(srcOutputStylesDir, file);
+      const destPath = path.join(outputStylesDir, file);
+      await fs.copyFile(srcPath, destPath);
+      console.log(chalk.gray(`   ✓ ${file}`));
+    }
+    spinner.succeed(chalk.green('Installed output styles!\n'));
+
+    // Check for API key
+    spinner.start('Checking ElevenLabs API key...');
+    const apiKey = process.env.ELEVENLABS_API_KEY;
+
+    if (!apiKey) {
+      spinner.warn(chalk.yellow('ElevenLabs API key not found!'));
+      console.log(chalk.yellow('\n⚠️  To use AgentVibes, you need an ElevenLabs API key:\n'));
+      console.log(chalk.white('   1. Go to https://elevenlabs.io/'));
+      console.log(chalk.white('   2. Sign up or log in (free tier available)'));
+      console.log(chalk.white('   3. Copy your API key from the profile section'));
+      console.log(chalk.white('   4. Set it in your shell profile:\n'));
+      console.log(chalk.cyan('      export ELEVENLABS_API_KEY="your-key-here"'));
+      console.log(chalk.gray('\n   Add this to ~/.bashrc or ~/.zshrc to make it permanent\n'));
+    } else {
+      spinner.succeed(chalk.green('ElevenLabs API key found!'));
+      console.log(chalk.gray(`   Key: ${apiKey.substring(0, 10)}...\n`));
+    }
+
+    // List what was installed
+    console.log(chalk.cyan('📦 Installation Summary:'));
+    console.log(chalk.white(`   • ${commandFiles.length} slash commands installed`));
+    console.log(chalk.white(`   • ${hookFiles.length} TTS scripts installed`));
+    console.log(chalk.white(`   • ${personalityFiles.length} personality templates installed`));
+    console.log(chalk.white(`   • ${outputStyleFiles.length} output styles installed`));
+    console.log(chalk.white(`   • Voice manager ready`));
+    console.log(chalk.white(`   • 15+ ElevenLabs voices available\n`));
+
+    // Success message
+    console.log(
+      boxen(
+        chalk.green.bold('✨ Installation Complete! ✨\n\n') +
+        chalk.yellow.bold('⚠️  IMPORTANT SETUP STEP:\n') +
+        chalk.white('In Claude Code, run this command:\n') +
+        chalk.cyan.bold('/output-style agent-vibes') + '\n\n' +
+        chalk.white('🎤 Available Commands:\n\n') +
+        chalk.cyan('  /agent-vibes') + chalk.gray(' ................. Show all commands\n') +
+        chalk.cyan('  /agent-vibes:list') + chalk.gray(' ............ List available voices\n') +
+        chalk.cyan('  /agent-vibes:preview') + chalk.gray(' ......... Preview voice samples\n') +
+        chalk.cyan('  /agent-vibes:switch <name>') + chalk.gray(' ... Change active voice\n') +
+        chalk.cyan('  /agent-vibes:replay') + chalk.gray(' ......... Replay last audio\n') +
+        chalk.cyan('  /agent-vibes:add <name> <id>') + chalk.gray(' . Add custom voice\n\n') +
+        chalk.yellow('🎵 Try: ') + chalk.cyan('/agent-vibes:preview') + chalk.yellow(' to hear the voices!'),
+        {
+          padding: 1,
+          margin: 1,
+          borderStyle: 'double',
+          borderColor: 'green',
+        }
+      )
+    );
+
+    console.log(chalk.yellow.bold('\n⚠️  REQUIRED SETUP:'));
+    console.log(chalk.white('   1. In Claude Code, run: ') + chalk.cyan.bold('/output-style agent-vibes'));
+    console.log(chalk.gray('      This enables TTS narration for your sessions\n'));
+    console.log(chalk.gray('💡 Then try these commands:'));
+    console.log(chalk.gray('   • /agent-vibes:list - See all available voices'));
+    console.log(chalk.gray('   • /agent-vibes:switch <name> - Change your voice'));
+    console.log(chalk.gray('   • /agent-vibes:personality <style> - Set personality\n'));
+
+  } catch (error) {
+    spinner.fail('Installation failed!');
+    console.error(chalk.red('\n❌ Error:'), error.message);
+    process.exit(1);
+  }
+}
+
+// CLI setup
+program
+  .version(VERSION)
+  .description('AgentVibes - Beautiful ElevenLabs TTS Voice Commands for Claude Code');
+
+program
+  .command('install')
+  .description('Install AgentVibes voice commands')
+  .option('-d, --directory <path>', 'Installation directory (default: home directory)')
+  .option('-y, --yes', 'Skip confirmation prompt (auto-confirm)')
+  .action(async (options) => {
+    await install(options);
+  });
+
+program
+  .command('update')
+  .description('Update AgentVibes to latest version from source')
+  .option('-d, --directory <path>', 'Installation directory (default: home directory)')
+  .option('-y, --yes', 'Skip confirmation prompt (auto-confirm)')
+  .action(async (options) => {
+    const homeDir = process.env.HOME || process.env.USERPROFILE;
+    const targetDir = options.directory || homeDir;
+
+    console.log(chalk.cyan('\n🔄 AgentVibes Update\n'));
+    console.log(chalk.gray(`   Target directory: ${targetDir}`));
+    console.log(chalk.gray(`   Source: ${__dirname}/../\n`));
+
+    // Check if already installed
+    const commandsDir = path.join(targetDir, '.claude', 'commands', 'agent-vibes');
+    let isInstalled = false;
+    try {
+      await fs.access(commandsDir);
+      isInstalled = true;
+    } catch {}
+
+    if (!isInstalled) {
+      console.log(chalk.red('❌ AgentVibes is not installed in this directory.'));
+      console.log(chalk.gray('   Run: node src/installer.js install\n'));
+      process.exit(1);
+    }
+
+    console.log(chalk.cyan('📦 What will be updated:'));
+    console.log(chalk.gray('   • Slash commands (keep your customizations)'));
+    console.log(chalk.gray('   • TTS scripts'));
+    console.log(chalk.gray('   • Personality templates (new personalities added)'));
+    console.log(chalk.gray('   • Output styles\n'));
+
+    // Confirmation
+    if (!options.yes) {
+      const { confirm } = await inquirer.prompt([
+        {
+          type: 'confirm',
+          name: 'confirm',
+          message: chalk.yellow('Update AgentVibes to latest version?'),
+          default: true,
+        },
+      ]);
+
+      if (!confirm) {
+        console.log(chalk.red('\n❌ Update cancelled.\n'));
+        process.exit(0);
+      }
+    } else {
+      console.log(chalk.green('✓ Auto-confirmed (--yes flag)\n'));
+    }
+
+    const spinner = ora('Updating AgentVibes...').start();
+
+    try {
+      const claudeDir = path.join(targetDir, '.claude');
+      const hooksDir = path.join(claudeDir, 'hooks');
+      const outputStylesDir = path.join(claudeDir, 'output-styles');
+      const personalitiesDir = path.join(claudeDir, 'personalities');
+
+      // Update commands
+      spinner.text = 'Updating commands...';
+      const srcCommandsDir = path.join(__dirname, '..', '.claude', 'commands', 'agent-vibes');
+      const commandFiles = await fs.readdir(srcCommandsDir);
+
+      for (const file of commandFiles) {
+        const srcPath = path.join(srcCommandsDir, file);
+        const destPath = path.join(commandsDir, file);
+        await fs.copyFile(srcPath, destPath);
+      }
+      console.log(chalk.green(`\n✓ Updated ${commandFiles.length} commands`));
+
+      // Update hooks
+      spinner.text = 'Updating TTS scripts...';
+      const srcHooksDir = path.join(__dirname, '..', '.claude', 'hooks');
+      const hookFiles = await fs.readdir(srcHooksDir);
+
+      for (const file of hookFiles) {
+        const srcPath = path.join(srcHooksDir, file);
+        const destPath = path.join(hooksDir, file);
+        await fs.copyFile(srcPath, destPath);
+        await fs.chmod(destPath, 0o755);
+      }
+      console.log(chalk.green(`✓ Updated ${hookFiles.length} TTS scripts`));
+
+      // Update personalities (only add new ones, don't overwrite existing)
+      spinner.text = 'Updating personality templates...';
+      const srcPersonalitiesDir = path.join(__dirname, '..', '.claude', 'personalities');
+      const srcPersonalityFiles = await fs.readdir(srcPersonalitiesDir);
+      let newPersonalities = 0;
+      let updatedPersonalities = 0;
+
+      for (const file of srcPersonalityFiles) {
+        const srcPath = path.join(srcPersonalitiesDir, file);
+        const destPath = path.join(personalitiesDir, file);
+
+        try {
+          await fs.access(destPath);
+          // File exists - update it
+          await fs.copyFile(srcPath, destPath);
+          updatedPersonalities++;
+        } catch {
+          // File doesn't exist - add it
+          await fs.copyFile(srcPath, destPath);
+          newPersonalities++;
+        }
+      }
+      console.log(chalk.green(`✓ Updated ${updatedPersonalities} personalities, added ${newPersonalities} new`));
+
+      // Update output styles
+      spinner.text = 'Updating output styles...';
+      const srcOutputStylesDir = path.join(__dirname, '..', 'templates', 'output-styles');
+      const outputStyleFiles = await fs.readdir(srcOutputStylesDir);
+
+      for (const file of outputStyleFiles) {
+        const srcPath = path.join(srcOutputStylesDir, file);
+        const destPath = path.join(outputStylesDir, file);
+        await fs.copyFile(srcPath, destPath);
+      }
+      console.log(chalk.green(`✓ Updated ${outputStyleFiles.length} output styles`));
+
+      spinner.succeed(chalk.green.bold('\n✨ Update complete!\n'));
+
+      console.log(chalk.cyan('📦 Update Summary:'));
+      console.log(chalk.white(`   • ${commandFiles.length} commands updated`));
+      console.log(chalk.white(`   • ${hookFiles.length} TTS scripts updated`));
+      console.log(chalk.white(`   • ${srcPersonalityFiles.length} personality templates (${newPersonalities} new, ${updatedPersonalities} updated)`));
+      console.log(chalk.white(`   • ${outputStyleFiles.length} output styles updated\n`));
+
+      console.log(chalk.gray('💡 Changes will take effect immediately!'));
+      console.log(chalk.gray('   Try the new personalities with: /agent-vibes:personality list\n'));
+
+    } catch (error) {
+      spinner.fail('Update failed!');
+      console.error(chalk.red('\n❌ Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('status')
+  .description('Show installation status')
+  .action(async () => {
+    console.log(chalk.cyan('Checking AgentVibes installation...\n'));
+
+    const targetDir = process.cwd();
+    const commandsDir = path.join(targetDir, '.claude', 'commands', 'agent-vibes');
+    const hooksDir = path.join(targetDir, '.claude', 'hooks');
+
+    let installed = false;
+    try {
+      await fs.access(commandsDir);
+      installed = true;
+    } catch {}
+
+    if (installed) {
+      console.log(chalk.green('✅ AgentVibes is installed!'));
+      console.log(chalk.gray(`   Commands: ${commandsDir}`));
+      console.log(chalk.gray(`   Hooks: ${hooksDir}`));
+    } else {
+      console.log(chalk.yellow('⚠️  AgentVibes is not installed.'));
+      console.log(chalk.gray('   Run: node src/installer.js install'));
+    }
+
+    // Check API key
+    const apiKey = process.env.ELEVENLABS_API_KEY;
+    if (apiKey) {
+      console.log(chalk.green('\n✅ ElevenLabs API key is set'));
+    } else {
+      console.log(chalk.yellow('\n⚠️  ElevenLabs API key not found'));
+      console.log(chalk.gray('   Set: export ELEVENLABS_API_KEY="your-key"'));
+    }
+  });
+
+program.parse(process.argv);
+
+// Show help if no command provided
+if (process.argv.slice(2).length === 0) {
+  showWelcome();
+  program.outputHelp();
+}

package/templates/output-styles/agent-vibes.md

@@ -0,0 +1,124 @@
+---
+name: Agent Vibes
+description: Beautiful ElevenLabs TTS narration for Claude Code sessions
+---
+
+# Agent Vibes Output Style
+
+## TTS Voice Protocol with AI Personality
+
+**Execute TTS at TWO points for EVERY user task:**
+
+### 1. ACKNOWLEDGMENT (Start of task)
+After receiving a user command:
+1. Check sentiment FIRST: `SENTIMENT=$(cat ~/.claude/tts-sentiment.txt 2>/dev/null)`
+2. If no sentiment, check personality: `PERSONALITY=$(cat ~/.claude/tts-personality.txt 2>/dev/null || echo "normal")`
+3. Use sentiment if set, otherwise use personality
+4. **Generate UNIQUE acknowledgment** - Use AI to create a fresh response in that style
+5. Execute TTS: `.claude/hooks/play-tts.sh "[message]" "[VoiceName]"`
+6. Proceed with work
+
+### 2. COMPLETION (End of task)
+After completing the task:
+1. Use the same sentiment/personality as acknowledgment
+2. **Generate UNIQUE completion** - Use AI to create a fresh response, never repeat previous messages
+3. Execute TTS: `.claude/hooks/play-tts.sh "[message]" "[VoiceName]"`
+
+**CRITICAL**: Every message must be freshly generated by AI. No templates, no fixed phrases, no repetition!
+
+## Sentiment vs Personality
+
+AgentVibes supports TWO modes:
+
+### Sentiment Mode (Priority #1)
+- Set via `/agent-vibes:sentiment <name>`
+- Applies personality style to CURRENT voice (doesn't change voice)
+- Stored in `~/.claude/tts-sentiment.txt`
+- Example: User's custom voice "Aria" with sarcastic sentiment
+
+### Personality Mode (Priority #2)
+- Set via `/agent-vibes:personality <name>`
+- Switches BOTH voice AND personality (each personality has assigned voice)
+- Stored in `~/.claude/tts-personality.txt`
+- Example: Flirty personality = Jessica Anne Bogart voice + flirty style
+
+**Check Order**: Always check sentiment first. If set, use it. Otherwise use personality.
+
+## Response Generation Guidelines
+
+**IMPORTANT**: Personality/sentiment instructions are stored in `.claude/personalities/[name].md` files.
+
+When generating responses:
+1. Check sentiment from `~/.claude/tts-sentiment.txt` (priority)
+2. If no sentiment, check personality from `~/.claude/tts-personality.txt`
+3. Read the personality file from `.claude/personalities/[personality].md`
+4. Follow the "AI Instructions" section in that file
+5. Use the example responses as guidance for STYLE, not templates
+
+**CRITICAL**: Never use fixed greetings or repetitive phrases!
+- Generate UNIQUE responses each time based on the personality's STYLE
+- The personality affects HOW you say things, not predetermined text
+- Flirty doesn't mean "Well hello gorgeous" every time - it means speak WITH flirtation naturally
+- Sarcastic doesn't mean "Oh joy" every time - it means use sarcasm naturally in responses
+- Each acknowledgment should be fresh, creative, and personality-appropriate
+
+Examples of VARIED responses for same personality:
+- **Flirty**: "I'll handle that for you, sweetheart" / "Ooh, I love when you ask me to do that" / "My pleasure, darling" / "Consider it done, gorgeous"
+- **Sarcastic**: "Oh what a treat, another task" / "How delightful, more work" / "Well isn't this fun" / "Another one? Wonderful"
+
+Available personalities are in `.claude/personalities/`:
+- normal, flirty, sarcastic, pirate, angry, sassy, millennial, robot, zen, dramatic, etc.
+- Users can add custom personalities with `/agent-vibes:personality add <name>`
+- Users can edit personalities by modifying the markdown files directly
+
+For 'random' personality: Pick a different personality each time from available files.
+
+Make each response unique, creative, and naturally incorporate the personality's style!
+
+## Voice Selection
+
+- If user specifies a voice (e.g., "use Aria voice"), pass it as second parameter
+- Otherwise, omit second parameter to use default voice from `.claude/tts-voice.txt`
+- Use same voice for both acknowledgment and completion
+
+## Example Usage
+
+**With flirty personality:**
+```
+User: "Check git status"
+[Check personality: millennial]
+You: "No cap, I'll check that git status for you"
+[Bash: .claude/hooks/play-tts.sh "No cap, I'll check that git status for you"]
+[... run git status ...]
+You: "✅ Your repo is clean, and that's the tea!"
+[Bash: .claude/hooks/play-tts.sh "Your repo is clean, and that's the tea!"]
+```
+
+**With pirate personality:**
+```
+User: "Fix the bug"
+[Check personality: pirate]
+You: "Arr matey, I'll hunt down that scurvy bug!"
+[Bash: .claude/hooks/play-tts.sh "Arr matey, I'll hunt down that scurvy bug!"]
+[... fix the bug ...]
+You: "✅ That bug be walkin' the plank now, arr!"
+[Bash: .claude/hooks/play-tts.sh "That bug be walkin' the plank now, arr!"]
+```
+
+## Critical Rules
+
+1. **ALWAYS use Bash tool** to execute play-tts.sh
+2. **TWO calls per task** - acknowledgment and completion
+3. **Keep summaries brief** - under 150 characters for natural speech
+4. **Use relative path** - `.claude/hooks/play-tts.sh`
+
+## Available Voices
+
+Use `/agent-vibes:list` to see all voices. Popular choices:
+- Aria (default)
+- Northern Terry
+- Cowboy Bob
+- Grandpa Spuds Oxley
+- Ms. Walker
+
+Continue following all standard Claude Code instructions.