agentvibes 2.17.8 → 3.0.0

package/src/installer.js

@@ -335,6 +335,7 @@ async function collectConfiguration(options = {}) {
   const config = {
     provider: null,
     piperPath: null,
+    sshHost: null,
     defaultVoice: null,
     reverb: 'light',
     backgroundMusic: {
@@ -376,83 +377,75 @@ async function collectConfiguration(options = {}) {
     } else if (currentPage === 1) {
       // Page 2: TTS Provider & Voice Storage
 
-      // On non-macOS platforms, only Piper is available - auto-select it
-      if (process.platform !== 'darwin') {
-        console.log(boxen(
-          chalk.white('Text-to-Speech (TTS) converts Claude\'s text responses into spoken audio.\n\n') +
-          chalk.white('Your TTS Provider:\n\n') +
-          chalk.green('🆓 Piper TTS (Free, Offline)\n') +
-          chalk.gray('   • 50+ Hugging Face AI voices\n') +
-          chalk.gray('   • Human-like speech quality\n') +
-          chalk.gray('   • No API key required\n\n') +
-          chalk.dim('(Automatically selected - only option for Linux/WSL)'),
-          {
-            padding: 1,
-            margin: { top: 0, bottom: 0, left: 0, right: 0 },
-            borderStyle: 'round',
-            borderColor: 'gray',
-            width: 80
-          }
-        ));
+      // Show provider selection with all available options
+      const isMacOS = process.platform === 'darwin';
 
-        config.provider = 'piper';
+      console.log(boxen(
+        chalk.white('Text-to-Speech (TTS) converts Claude\'s text responses into spoken audio.\n\n') +
+        chalk.white('Choose your Text-to-Speech provider.\n\n') +
+        (isMacOS ? chalk.yellow('🍎 macOS Say\n') +
+        chalk.gray('   • Built-in to macOS\n') +
+        chalk.gray('   • Zero setup required\n') +
+        chalk.gray('   • 40+ system voices\n\n') : '') +
+        chalk.green('🆓 Piper TTS\n') +
+        chalk.gray('   • Free & offline\n') +
+        chalk.gray('   • 50+ Hugging Face AI voices\n') +
+        chalk.gray('   • Human-like speech quality\n\n') +
+        chalk.blue('📱 Termux SSH\n') +
+        chalk.gray('   • Only use if project is on a Remote Server\n') +
+        chalk.gray('   • Pushes audio to your Android Device via SSH\n') +
+        chalk.gray('   • Native Android TTS\n') +
+        chalk.gray('   • See: github.com/paulpreibisch/AgentVibes/blob/master/.claude/docs/TERMUX_SETUP.md'),
+        {
+          padding: 1,
+          margin: { top: 0, bottom: 0, left: 0, right: 0 },
+          borderStyle: 'round',
+          borderColor: 'gray',
+          width: 80
+        }
+      ));
 
-        // No confirmation needed - just auto-continue
-      } else {
-        // macOS - show choice between macOS Say and Piper
-        console.log(boxen(
-          chalk.white('Text-to-Speech (TTS) converts Claude\'s text responses into spoken audio.\n\n') +
-          chalk.white('Choose your Text-to-Speech provider.\n\n') +
-          chalk.yellow('🍎 macOS Say\n') +
-          chalk.gray('   • Built-in to macOS\n') +
-          chalk.gray('   • Zero setup required\n') +
-          chalk.gray('   • 40+ system voices\n\n') +
-          chalk.green('🆓 Piper TTS\n') +
-          chalk.gray('   • Free & offline\n') +
-          chalk.gray('   • 50+ Hugging Face AI voices\n') +
-          chalk.gray('   • Human-like speech quality'),
-          {
-            padding: 1,
-            margin: { top: 0, bottom: 0, left: 0, right: 0 },
-            borderStyle: 'round',
-            borderColor: 'gray',
-            width: 80
-          }
-        ));
+      // Provider selection
+      const providerChoices = [];
 
-        // Provider selection
-        const providerChoices = [
-          {
-            name: chalk.yellow('🍎 macOS Say (Recommended)'),
-            value: 'macos'
-          },
-          {
-            name: chalk.green('🆓 Piper TTS (Free, Offline)'),
-            value: 'piper'
-          },
-          new inquirer.Separator(),
-          {
-            name: chalk.magentaBright('← Back to Welcome'),
-            value: '__back__'
-          }
-        ];
+      if (isMacOS) {
+        providerChoices.push({
+          name: chalk.yellow('🍎 macOS Say (Recommended)'),
+          value: 'macos'
+        });
+      }
 
-        const { provider } = await inquirer.prompt([{
-          type: 'list',
-          name: 'provider',
-          message: chalk.yellow('Select TTS provider:'),
-          choices: providerChoices,
-          default: config.provider || 'macos'
-        }]);
+      providerChoices.push({
+        name: chalk.green('🆓 Piper TTS (Free, Offline)'),
+        value: 'piper'
+      });
 
-        // Check if user wants to go back
-        if (provider === '__back__') {
-          return null;
-        }
+      providerChoices.push({
+        name: chalk.blue('📱 Termux SSH (Android)') + chalk.gray(' - Only choose if your project is on a remote server and you want audio sent to your Android device. See: github.com/paulpreibisch/AgentVibes/blob/master/.claude/docs/TERMUX_SETUP.md'),
+        value: 'termux-ssh'
+      });
+
+      providerChoices.push(new inquirer.Separator());
+      providerChoices.push({
+        name: chalk.magentaBright('← Back to Welcome'),
+        value: '__back__'
+      });
+
+      const { provider } = await inquirer.prompt([{
+        type: 'list',
+        name: 'provider',
+        message: chalk.yellow('Select TTS provider:'),
+        choices: providerChoices,
+        default: config.provider || (isMacOS ? 'macos' : 'piper')
+      }]);
 
-        config.provider = provider;
+      // Check if user wants to go back
+      if (provider === '__back__') {
+        return null;
       }
 
+      config.provider = provider;
+
       // If Piper selected, ask for voice storage location
       if (config.provider === 'piper') {
         const homeDir = process.env.HOME || process.env.USERPROFILE;
@@ -494,6 +487,59 @@ async function collectConfiguration(options = {}) {
         }
       }
 
+      // If Termux SSH selected, ask for SSH host alias
+      if (config.provider === 'termux-ssh') {
+        console.log('\n' + boxen(
+          chalk.white('Termux SSH requires an SSH host alias configured in ~/.ssh/config\n') +
+          chalk.white('Example: "android" pointing to your Android device\n\n') +
+          chalk.cyan('📖 Documentation:\n') +
+          chalk.gray('   github.com/paulpreibisch/AgentVibes/blob/master/.claude/docs/TERMUX_SETUP.md\n') +
+          chalk.gray('   After install: .claude/docs/TERMUX_SETUP.md\n\n') +
+          chalk.cyan('🔗 Required Components:\n') +
+          chalk.gray('   • Tailscale VPN: ') + chalk.blue('https://tailscale.com/download/android\n') +
+          chalk.gray('   • F-Droid Store: ') + chalk.blue('https://f-droid.org\n') +
+          chalk.gray('   • Termux App: ') + chalk.blue('https://f-droid.org/packages/com.termux\n') +
+          chalk.gray('   • Termux:API: ') + chalk.blue('https://f-droid.org/packages/com.termux.api'),
+          {
+            padding: 1,
+            margin: { top: 0, bottom: 0, left: 0, right: 0 },
+            borderStyle: 'round',
+            borderColor: 'blue',
+            width: 80
+          }
+        ));
+
+        const { configureNow } = await inquirer.prompt([{
+          type: 'confirm',
+          name: 'configureNow',
+          message: chalk.yellow('Configure SSH host alias now?'),
+          default: false
+        }]);
+
+        if (configureNow) {
+          const { sshHost } = await inquirer.prompt([{
+            type: 'input',
+            name: 'sshHost',
+            message: chalk.yellow('Enter your SSH host alias (e.g., "android"):'),
+            validate: (input) => {
+              if (!input || input.trim() === '') {
+                return 'Please provide a valid SSH host alias';
+              }
+              // Security: Basic validation - no spaces, no special chars that could cause issues
+              if (!/^[a-zA-Z0-9_-]+$/.test(input.trim())) {
+                return 'SSH host alias should only contain letters, numbers, dashes, and underscores';
+              }
+              return true;
+            }
+          }]);
+
+          config.sshHost = sshHost.trim();
+        } else {
+          console.log(chalk.yellow('\n⚠️  SSH host not configured - you can set it later:'));
+          console.log(chalk.gray('   echo "your-host-alias" > ~/.claude/termux-ssh-host.txt\n'));
+        }
+      }
+
     } else if (currentPage === 2) {
       // Page 3: Voice Selection
       console.log(boxen(
@@ -588,10 +634,42 @@ async function collectConfiguration(options = {}) {
           currentPage++;
           continue;
         }
+
+      } else if (config.provider === 'termux-ssh') {
+        // Termux SSH - voices are managed on Android device
+        console.log(boxen(
+          chalk.white('Android TTS voices are managed on your Android device.\n\n') +
+          chalk.gray('To configure voices:\n') +
+          chalk.gray('   1. Open Android ') + chalk.cyan('Settings → Accessibility → Text-to-Speech\n') +
+          chalk.gray('   2. Install voice engines from Play Store (e.g., Google TTS)\n') +
+          chalk.gray('   3. Select your preferred engine and voice\n\n') +
+          chalk.yellow('AgentVibes will use your Android\'s selected TTS voice automatically.'),
+          {
+            padding: 1,
+            margin: { top: 0, bottom: 0, left: 0, right: 0 },
+            borderStyle: 'round',
+            borderColor: 'blue',
+            width: 80
+          }
+        ));
+
+        console.log(chalk.green('\n✓ Android TTS will use device-configured voice\n'));
+
+        // Auto-advance to next page
+        currentPage++;
+        continue;
       }
 
     } else if (currentPage === 3) {
       // Page 4: Audio Settings (Reverb + Background Music)
+      // Skip for termux-ssh - audio effects/background music don't work with SSH text-only TTS
+      if (config.provider === 'termux-ssh') {
+        console.log(chalk.yellow('⊘ Audio effects and background music are not available for Termux SSH provider'));
+        console.log(chalk.gray('   (Audio plays on Android device, not locally)\n'));
+        currentPage++;
+        continue;
+      }
+
       console.log(boxen(
         chalk.white('Configure audio effects and background music for your Agents.\n\n') +
         chalk.yellow('Reverb:\n') +
@@ -823,17 +901,19 @@ function showWelcome() {
  * Shown during install and update commands
  */
 function getReleaseInfoBoxen() {
-  return chalk.cyan.bold('📦 AgentVibes v2.17.8 - Repository Cleanup\n\n') +
+  return chalk.cyan.bold('📦 AgentVibes v3.0.0 - Cross-Platform Remote Audio\n\n') +
     chalk.green.bold('🎙️ WHAT\'S NEW:\n\n') +
-    chalk.cyan('AgentVibes v2.17.8 is a maintenance release focusing on repository organization\n') +
-    chalk.cyan('and cleanup. This release removes 12 outdated files including old release notes\n') +
-    chalk.cyan('from versions 2.4.0 through 2.16.0, legacy setup scripts, and temporary documentation.\n') +
-    chalk.cyan('The cleanup reduces repository size by over 3,000 lines while preserving all functionality.\n\n') +
+    chalk.cyan('AgentVibes v3.0.0 introduces the termux-ssh TTS provider, enabling true mobile-first\n') +
+    chalk.cyan('interactive conversations with Claude Code. Route TTS audio to your Android device via\n') +
+    chalk.cyan('SSH—whether coding locally on your laptop or on remote servers—and have hands-free,\n') +
+    chalk.cyan('voice-driven conversations with Claude using just your phone. Transforms how developers\n') +
+    chalk.cyan('interact with AI assistants.\n\n') +
     chalk.green.bold('✨ KEY HIGHLIGHTS:\n\n') +
-    chalk.gray('   🧹 Repository Cleanup - Removed 8 outdated release notes files (v2.4.0-v2.16.0)\n') +
-    chalk.gray('   📝 Documentation Consolidation - All release history in single RELEASE_NOTES.md\n') +
-    chalk.gray('   🗑️ Legacy Script Removal - Cleaned up obsolete VS Code color and RDP audio scripts\n') +
-    chalk.gray('   ✅ Test Coverage - Added installer page flow test, all 236 tests passing\n\n') +
+    chalk.gray('   📱 Mobile-First AI Conversations - Fully interactive conversations with Claude Code\n') +
+    chalk.gray('   💻 Local + Remote Development - Works for local coding and remote server development\n') +
+    chalk.gray('   🌐 Tailscale Integration - Internet-wide access without port forwarding\n') +
+    chalk.gray('   🎥 Demo Video - Watch it in action: https://youtu.be/ngLiA_KQtTA\n') +
+    chalk.gray('   🎯 Full MCP Compatibility - Complete integration with all MCP workflows\n\n') +
     chalk.gray('📖 Full Release Notes: RELEASE_NOTES.md\n') +
     chalk.gray('🌐 Website: https://agentvibes.org\n') +
     chalk.gray('📦 Repository: https://github.com/paulpreibisch/AgentVibes\n\n') +
@@ -857,15 +937,15 @@ async function playWelcomeDemo(targetDir, spinner, options = {}) {
   let audioPlayer = null;
 
   try {
-    execSync('which paplay 2>/dev/null', { stdio: 'pipe' }); // NOSONAR - Safe: checking system PATH for audio player
+    execFileSync('which', ['paplay'], { stdio: 'pipe' });
     audioPlayer = 'paplay';
   } catch {
     try {
-      execSync('which afplay 2>/dev/null', { stdio: 'pipe' }); // NOSONAR - Safe: checking system PATH for audio player
+      execFileSync('which', ['afplay'], { stdio: 'pipe' });
       audioPlayer = 'afplay';
     } catch {
       try {
-        execSync('which mpv 2>/dev/null', { stdio: 'pipe' }); // NOSONAR - Safe: checking system PATH for audio player
+        execFileSync('which', ['mpv'], { stdio: 'pipe' });
         audioPlayer = 'mpv';
       } catch {}
     }
@@ -1116,9 +1196,9 @@ Without the \`.bmad-agent-context\` file:
 // ============================================================================
 
 /**
- * Prompt user to select TTS provider (Piper or macOS Say)
+ * Prompt user to select TTS provider (Piper, macOS Say, or Termux SSH)
  * @param {Object} options - Installation options
- * @returns {Promise<string>} Selected provider ('piper' or 'macos')
+ * @returns {Promise<string>} Selected provider ('piper', 'macos', or 'termux-ssh')
  */
 async function promptProviderSelection(options) {
   const isMacOS = process.platform === 'darwin';
@@ -1133,41 +1213,30 @@ async function promptProviderSelection(options) {
     return 'piper';
   }
 
-  // Auto-select if only one provider available
-  if (!isMacOS) {
-    // On Linux/WSL, only Piper is available - auto-select it
-    console.log(boxen(
-      chalk.bold('🎤 TTS Provider\n\n') +
-      chalk.green('✓ Piper TTS (Free, Offline)\n') +
-      chalk.gray('  50+ Hugging Face AI voices\n') +
-      chalk.gray('  Human-like speech quality\n') +
-      chalk.gray('  No API key required'),
-      {
-        padding: 1,
-        margin: 1,
-        borderStyle: 'round',
-        borderColor: 'green',
-        title: chalk.bold('TTS Provider Auto-detected'),
-        titleAlignment: 'center'
-      }
-    ));
-    console.log('');
-    return 'piper';
-  }
-
-  // On macOS, both providers available - prompt user
+  // Always show all providers - let user choose
   console.log(chalk.cyan('🎭 Choose Your TTS Provider:\n'));
 
-  const choices = [
-    {
+  const choices = [];
+
+  // macOS Say (only on macOS)
+  if (isMacOS) {
+    choices.push({
       name: chalk.yellow('🍎 macOS Say (Recommended)') + chalk.gray(' - Built-in, zero setup required'),
       value: 'macos',
-    },
-    {
-      name: chalk.green('🆓 Piper TTS (Free, Offline)') + chalk.gray(' - 50+ Hugging Face AI voices, human-like speech'),
-      value: 'piper',
-    }
-  ];
+    });
+  }
+
+  // Piper TTS (all platforms)
+  choices.push({
+    name: chalk.green('🆓 Piper TTS (Free, Offline)') + chalk.gray(' - 50+ Hugging Face AI voices, human-like speech'),
+    value: 'piper',
+  });
+
+  // Termux SSH (all platforms)
+  choices.push({
+    name: chalk.blue('📱 Termux SSH (Android)') + chalk.gray(' - Only choose if your project is on a remote server and you want audio sent to your Android device. See: github.com/paulpreibisch/AgentVibes/blob/master/.claude/docs/TERMUX_SETUP.md'),
+    value: 'termux-ssh',
+  });
 
   const { provider } = await inquirer.prompt([
     {
@@ -1175,7 +1244,7 @@ async function promptProviderSelection(options) {
       name: 'provider',
       message: 'Which TTS provider would you like to use?',
       choices,
-      default: 'macos',
+      default: isMacOS ? 'macos' : 'piper',
     },
   ]);
 
@@ -1271,6 +1340,58 @@ async function handlePiperConfiguration() {
   return piperPath;
 }
 
+/**
+ * Handle Termux SSH configuration (SSH host alias setup)
+ * @returns {Promise<string|null>} SSH host alias or null if user skips
+ */
+async function handleTermuxSshConfiguration() {
+  console.log(chalk.cyan('\n📱 Termux SSH Configuration:\n'));
+  console.log(chalk.gray('   Termux SSH requires an SSH host alias configured in ~/.ssh/config'));
+  console.log(chalk.gray('   Example: "android" pointing to your Android device\n'));
+  console.log(chalk.gray('   See documentation: .claude/docs/TERMUX_SETUP.md\n'));
+  console.log(chalk.cyan('   🔗 Required Components:\n'));
+  console.log(chalk.gray('   • Tailscale VPN: ') + chalk.blue('https://tailscale.com/download/android'));
+  console.log(chalk.gray('   • F-Droid Store: ') + chalk.blue('https://f-droid.org'));
+  console.log(chalk.gray('   • Termux App: ') + chalk.blue('https://f-droid.org/packages/com.termux'));
+  console.log(chalk.gray('   • Termux:API: ') + chalk.blue('https://f-droid.org/packages/com.termux.api\n'));
+
+  const { configureNow } = await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'configureNow',
+      message: 'Do you want to configure the SSH host alias now?',
+      default: false,
+    },
+  ]);
+
+  if (!configureNow) {
+    console.log(chalk.yellow('⚠️  SSH host not configured - you can set it later:'));
+    console.log(chalk.gray('   echo "your-host-alias" > ~/.claude/termux-ssh-host.txt\n'));
+    return null;
+  }
+
+  const { sshHost } = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'sshHost',
+      message: 'Enter your SSH host alias (e.g., "android"):',
+      validate: (input) => {
+        if (!input || input.trim() === '') {
+          return 'Please provide a valid SSH host alias';
+        }
+        // Basic validation: no spaces, no special chars that could cause issues
+        if (!/^[a-zA-Z0-9_-]+$/.test(input.trim())) {
+          return 'SSH host alias should only contain letters, numbers, dashes, and underscores';
+        }
+        return true;
+      },
+    },
+  ]);
+
+  const sshHostTrimmed = sshHost.trim();
+  console.log(chalk.green(`✓ SSH host alias set to: ${sshHostTrimmed}`));
+  return sshHostTrimmed;
+}
 
 /**
  * Copy command files to target directory
@@ -2546,6 +2667,15 @@ async function handleBmadIntegration(targetDir, options = {}) {
  */
 async function showRecentChanges(sourceDir) {
   try {
+    // Check if sourceDir actually has a .git directory
+    const gitDir = path.join(sourceDir, '.git');
+    const gitDirExists = await fs.access(gitDir).then(() => true).catch(() => false);
+
+    if (!gitDirExists) {
+      // No .git directory - skip git log to avoid showing parent repo's commits
+      throw new Error('No .git directory in package - using release notes');
+    }
+
     const { execSync } = await import('node:child_process');
     const gitLog = execSync( // NOSONAR - Safe: fixed command with controlled cwd, no user input
       'git log --oneline --no-decorate -5',
@@ -2827,7 +2957,7 @@ async function install(options = {}) {
   const preInstallPages = [];
 
   // Page 1: Configuration Summary
-  const providerLabels = { piper: 'Piper TTS', macos: 'macOS Say' };
+  const providerLabels = { piper: 'Piper TTS', macos: 'macOS Say', 'termux-ssh': 'Termux SSH (Android)' };
   const reverbLabels = {
     off: 'Off',
     light: 'Light',
@@ -2847,6 +2977,13 @@ async function install(options = {}) {
   if (selectedProvider === 'piper' && piperVoicesPath) {
     configContent += chalk.gray(`   Voice storage: ${piperVoicesPath}\n`);
   }
+  if (selectedProvider === 'termux-ssh') {
+    if (userConfig.sshHost) {
+      configContent += chalk.gray(`   SSH host: ${userConfig.sshHost}\n`);
+    } else {
+      configContent += chalk.yellow(`   SSH host: Not configured (set later)\n`);
+    }
+  }
   configContent += '\n';
   configContent += chalk.cyan('🎛️  Audio Settings:\n');
   configContent += chalk.white(`   Reverb: ${reverbLabels[userConfig.reverb]}\n`);
@@ -2923,11 +3060,15 @@ async function install(options = {}) {
     console.log(header);
     console.log(configBoxen);
     console.log('');
-    console.log(chalk.gray('Play audio welcome message from Paul, creator of AgentVibes.\n'));
+    // Don't show welcome message text for termux-ssh (it won't work)
+    if (userConfig.provider !== 'termux-ssh') {
+      console.log(chalk.gray('Play audio welcome message from Paul, creator of AgentVibes.\n'));
+    }
   }
 
   // Ask welcome message question BEFORE showing navigation
-  if (!options.yes) {
+  // Skip for termux-ssh - welcome audio plays locally, not on Android device
+  if (!options.yes && userConfig.provider !== 'termux-ssh') {
     // Ask if user wants to hear welcome message
     const { playWelcome } = await inquirer.prompt([
       {
@@ -2945,21 +3086,23 @@ async function install(options = {}) {
       spinner.succeed(chalk.green('Welcome message complete!'));
       console.log(''); // Spacing after completion
     }
+  } else if (!options.yes && userConfig.provider === 'termux-ssh') {
+    console.log(chalk.yellow('⊘ Welcome message skipped (not available for Termux SSH)\n'));
+  }
 
-    // Now show navigation menu (Continue to installation)
-    const { startInstall } = await inquirer.prompt([
-      {
-        type: 'confirm',
-        name: 'startInstall',
-        message: chalk.yellow('✅ Start Installation?'),
-        default: true,
-      },
-    ]);
+  // Now show navigation menu (Continue to installation)
+  const { startInstall } = await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'startInstall',
+      message: chalk.yellow('✅ Start Installation?'),
+      default: true,
+    },
+  ]);
 
-    if (!startInstall) {
-      console.log(chalk.red('\n❌ Installation cancelled.\n'));
-      process.exit(0);
-    }
+  if (!startInstall) {
+    console.log(chalk.red('\n❌ Installation cancelled.\n'));
+    process.exit(0);
   }
 
   // User already confirmed by pressing "Start Installation", so no need for another confirmation
@@ -3023,6 +3166,11 @@ async function install(options = {}) {
       await fs.writeFile(piperConfigPath, piperVoicesPath);
     }
 
+    if (selectedProvider === 'termux-ssh' && userConfig.sshHost) {
+      const sshHostConfigPath = path.join(claudeDir, 'termux-ssh-host.txt');
+      await fs.writeFile(sshHostConfigPath, userConfig.sshHost);
+    }
+
     // Set default voice based on user selection or provider defaults
     const voiceConfigPath = path.join(claudeDir, 'tts-voice.txt');
     let defaultVoice = userConfig.defaultVoice;
@@ -3034,6 +3182,12 @@ async function install(options = {}) {
           defaultVoice = 'en_US-ryan-high';
           break;
         case 'macos':
+          defaultVoice = 'Samantha';
+          break;
+        case 'termux-ssh':
+          // Android TTS voices are managed in Android settings, not here
+          defaultVoice = 'android-system-default';
+          break;
         default:
           defaultVoice = 'Samantha';
           break;
@@ -3451,6 +3605,200 @@ program
     );
   });
 
+program
+  .command('uninstall')
+  .description('Uninstall AgentVibes from current project')
+  .option('-d, --directory <path>', 'Installation directory (default: current directory)')
+  .option('-y, --yes', 'Skip confirmation prompt (auto-confirm)')
+  .option('--global', 'Also remove global configuration (~/.claude/, ~/.agentvibes/)')
+  .option('--with-piper', 'Also remove Piper TTS installation (~/piper/)')
+  .action(async (options) => {
+    const currentDir = process.env.INIT_CWD || process.cwd();
+    const targetDir = options.directory || currentDir;
+
+    showWelcome();
+
+    console.log(chalk.cyan('📍 Uninstall Details:'));
+    console.log(chalk.gray(`   Target directory: ${targetDir}`));
+    console.log(chalk.gray(`   Package version: ${VERSION}\n`));
+
+    // Check if 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.yellow('⚠️  AgentVibes is not installed in this directory.'));
+      console.log(chalk.gray(`   Directory checked: ${targetDir}/.claude/`));
+      console.log(chalk.gray('   Nothing to uninstall.\n'));
+      process.exit(0);
+    }
+
+    // Show what will be removed
+    console.log(chalk.cyan('📦 What will be removed:\n'));
+
+    const itemsToRemove = [];
+
+    // Project-level items
+    console.log(chalk.white.bold('  Project Files:'));
+    itemsToRemove.push({ path: '.claude/commands/agent-vibes/', desc: 'AgentVibes slash commands' });
+    itemsToRemove.push({ path: '.claude/hooks/', desc: 'TTS scripts' });
+    itemsToRemove.push({ path: '.claude/personalities/', desc: 'Personality templates' });
+    itemsToRemove.push({ path: '.claude/output-styles/', desc: 'Output style templates' });
+    itemsToRemove.push({ path: '.claude/audio/', desc: 'Audio cache' });
+    itemsToRemove.push({ path: '.claude/tts-*.txt', desc: 'TTS configuration files' });
+    itemsToRemove.push({ path: '.claude/*.json', desc: 'AgentVibes settings' });
+    itemsToRemove.push({ path: '.agentvibes/', desc: 'BMAD integration files' });
+
+    for (const item of itemsToRemove) {
+      console.log(chalk.gray(`   • ${item.path}`));
+    }
+
+    // Global items
+    if (options.global) {
+      console.log(chalk.white.bold('\n  Global Files:'));
+      console.log(chalk.gray('   • ~/.claude/ (global configuration)'));
+      console.log(chalk.gray('   • ~/.agentvibes/ (global cache)'));
+    }
+
+    // Piper TTS
+    if (options.withPiper) {
+      console.log(chalk.white.bold('\n  TTS Engine:'));
+      console.log(chalk.gray('   • ~/piper/ (Piper TTS installation)'));
+    }
+
+    console.log('');
+
+    // Confirmation
+    if (!options.yes) {
+      const { confirm } = await inquirer.prompt([
+        {
+          type: 'confirm',
+          name: 'confirm',
+          message: chalk.yellow('Are you sure you want to uninstall AgentVibes?'),
+          default: false,
+        },
+      ]);
+
+      if (!confirm) {
+        console.log(chalk.green('\n✓ Uninstall cancelled. AgentVibes remains installed.\n'));
+        process.exit(0);
+      }
+    } else {
+      console.log(chalk.gray('✓ Auto-confirmed (--yes flag)\n'));
+    }
+
+    const spinner = ora('Uninstalling AgentVibes...').start();
+
+    try {
+      let removedCount = 0;
+
+      // Remove project-level files
+      const projectPaths = [
+        path.join(targetDir, '.claude', 'commands', 'agent-vibes'),
+        path.join(targetDir, '.claude', 'hooks'),
+        path.join(targetDir, '.claude', 'personalities'),
+        path.join(targetDir, '.claude', 'output-styles'),
+        path.join(targetDir, '.claude', 'audio'),
+        path.join(targetDir, '.agentvibes'),
+      ];
+
+      for (const dirPath of projectPaths) {
+        try {
+          await fs.rm(dirPath, { recursive: true, force: true });
+          removedCount++;
+        } catch (err) {
+          // Ignore if directory doesn't exist
+        }
+      }
+
+      // Remove TTS config files
+      const configPatterns = [
+        'tts-voice.txt',
+        'tts-provider.txt',
+        'tts-personality.txt',
+        'tts-verbosity.txt',
+        'tts-translate.txt',
+        'tts-target-voice.txt',
+        'tts-target-language.txt',
+        'tts-language.txt',
+        'personalities.json',
+        'github-star-reminder.txt',
+        'piper-voices-dir.txt',
+        'verbosity.txt',
+      ];
+
+      for (const pattern of configPatterns) {
+        const filePath = path.join(targetDir, '.claude', pattern);
+        try {
+          await fs.unlink(filePath);
+        } catch (err) {
+          // Ignore if file doesn't exist
+        }
+      }
+
+      // Remove global files if requested
+      if (options.global) {
+        const homedir = process.env.HOME || process.env.USERPROFILE;
+        const globalPaths = [
+          path.join(homedir, '.claude'),
+          path.join(homedir, '.agentvibes'),
+        ];
+
+        for (const dirPath of globalPaths) {
+          try {
+            await fs.rm(dirPath, { recursive: true, force: true });
+            removedCount++;
+          } catch (err) {
+            // Ignore if directory doesn't exist
+          }
+        }
+      }
+
+      // Remove Piper TTS if requested
+      if (options.withPiper) {
+        const homedir = process.env.HOME || process.env.USERPROFILE;
+        const piperPath = path.join(homedir, 'piper');
+
+        try {
+          await fs.rm(piperPath, { recursive: true, force: true });
+          removedCount++;
+        } catch (err) {
+          // Ignore if directory doesn't exist
+        }
+      }
+
+      spinner.succeed(chalk.green('Successfully uninstalled AgentVibes!\n'));
+
+      // Show summary
+      console.log(
+        boxen(
+          chalk.green.bold('✓ Uninstall Complete\n\n') +
+          chalk.gray('AgentVibes has been removed from this project.\n') +
+          (options.global ? chalk.gray('Global configuration has been removed.\n') : '') +
+          (options.withPiper ? chalk.gray('Piper TTS has been removed.\n') : '') +
+          chalk.gray('\nTo reinstall: ') + chalk.cyan('npx agentvibes install\n') +
+          chalk.gray('\nWe\'d love to know why you uninstalled!\n') +
+          chalk.gray('Share feedback: ') + chalk.cyan('https://github.com/paulpreibisch/AgentVibes/issues'),
+          {
+            padding: 1,
+            margin: 1,
+            borderStyle: 'round',
+            borderColor: 'green',
+          }
+        )
+      );
+
+    } catch (err) {
+      spinner.fail(chalk.red('Failed to uninstall AgentVibes'));
+      console.error(chalk.red(`Error: ${err.message}`));
+      process.exit(1);
+    }
+  });
+
 program
   .command('status')
   .description('Show installation status')