agentvibes 5.13.1 → 5.15.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "5.13.1",
+  "version": "5.15.0",
   "description": "Now your AI Agents can finally talk back! Professional TTS voice for Claude Code, Claude Desktop (via MCP), and Clawdbot with multi-provider support.",
   "homepage": "https://agentvibes.org",
   "keywords": [
@@ -37,6 +37,7 @@
     "bin/",
     "src/",
     "templates/*.sh",
+    "templates/*.ps1",
     "templates/*.md",
     "templates/audio/*.mp3",
     "mcp-server/*.py",
@@ -56,7 +57,7 @@
     ".claude/output-styles/",
     ".claude/audio/tracks/",
     ".claude/audio/ui/",
-    ".claude/config/",
+    ".claude/config/*.sample",
     ".claude/docs/",
     ".claude/language-voices.yaml",
     ".claude/settings.json",
@@ -65,10 +66,12 @@
     ".claude/verbosity.txt",
     ".claude/github-star-reminder.txt",
     ".claude/audio/voice-samples/",
-    ".agentvibes/",
+    ".agentvibes/bmad/",
     ".clawdbot/",
     ".mcp.json",
+    "!**/*.user.bak",
     "setup-windows.ps1",
+    "setup-ssh-receiver.ps1",
     "WINDOWS-SETUP.md",
     "README.md",
     "RELEASE_NOTES.md",

package/setup-ssh-receiver.ps1

@@ -0,0 +1,259 @@
+#Requires -RunAsAdministrator
+#
+# AgentVibes SSH Receiver Setup (Windows)
+# Run this in an ADMIN PowerShell:
+#   powershell -ExecutionPolicy Bypass -File setup-ssh-receiver.ps1
+#
+
+Write-Host "`n=== AgentVibes SSH Receiver Setup ===" -ForegroundColor Cyan
+Write-Host ""
+
+$Username = $env:USERNAME
+$TailscaleIp = ""
+try {
+    $TailscaleIp = (tailscale ip -4 2>$null).Trim()
+} catch {}
+
+if (-not $TailscaleIp) {
+    Write-Host "WARNING: Tailscale not found. Install Tailscale first for secure setup." -ForegroundColor Yellow
+    Write-Host "         Falling back to listen on all interfaces." -ForegroundColor Yellow
+    $TailscaleIp = "0.0.0.0"
+}
+
+# Step 1: Stop sshd
+Write-Host "[1/8] Stopping sshd..." -ForegroundColor Yellow
+Stop-Service sshd -ErrorAction SilentlyContinue
+
+# Step 2: Backup original config
+Write-Host "[2/8] Backing up original sshd_config..." -ForegroundColor Yellow
+$configPath = "C:\ProgramData\ssh\sshd_config"
+$backupPath = "C:\ProgramData\ssh\sshd_config.bak"
+if (Test-Path $configPath) {
+    # Only create the backup once — never overwrite it, so the user's original
+    # sshd_config is always recoverable even if this script is run multiple times.
+    if (-not (Test-Path $backupPath)) {
+        Copy-Item $configPath $backupPath
+        Write-Host "       Backup: $backupPath" -ForegroundColor Gray
+    } else {
+        Write-Host "       Backup already exists: $backupPath (skipped)" -ForegroundColor DarkGray
+    }
+}
+
+# Step 3: Deploy hardened config with user-specific values
+Write-Host "[3/8] Deploying hardened sshd_config..." -ForegroundColor Yellow
+$hardenedConfig = Join-Path $PSScriptRoot "templates\sshd_config_hardened"
+if (Test-Path $hardenedConfig) {
+    $config = Get-Content $hardenedConfig -Raw
+    $config = $config -replace 'YourUsername', $Username
+    $config = $config -replace 'ListenAddress 0\.0\.0\.0', "ListenAddress $TailscaleIp"
+    $receiverPath = "C:\Users\$Username\.agentvibes\play-remote.ps1"
+    $config = $config -replace 'C:\\Users\\YourUsername\\\.agentvibes\\play-remote\.ps1', $receiverPath
+    Set-Content -Path $configPath -Value $config
+    Write-Host "       Port: 45123" -ForegroundColor Green
+    Write-Host "       Listen: $TailscaleIp" -ForegroundColor Green
+    Write-Host "       Auth: Key-only, no passwords" -ForegroundColor Green
+    Write-Host "       ForceCommand: Receiver script only, no shell" -ForegroundColor Green
+} else {
+    Write-Host "       ERROR: $hardenedConfig not found!" -ForegroundColor Red
+    exit 1
+}
+
+# Step 4: Install receiver script
+Write-Host "[4/8] Installing receiver script..." -ForegroundColor Yellow
+$agentvibesDir = "$env:USERPROFILE\.agentvibes"
+if (-not (Test-Path $agentvibesDir)) {
+    New-Item -ItemType Directory -Path $agentvibesDir -Force | Out-Null
+}
+$receiverSrc = Join-Path $PSScriptRoot "templates\agentvibes-receiver.ps1"
+if (Test-Path $receiverSrc) {
+    # Stamp the installing user's home path so the receiver can find hooks/config
+    # even when sshd runs it as a different user (e.g. agentvibes-receiver)
+    $content = Get-Content $receiverSrc -Raw
+    $content = $content -replace '__OWNER_HOME__', $env:USERPROFILE
+    Set-Content -Path "$agentvibesDir\play-remote.ps1" -Value $content
+    Write-Host "       Installed to: $agentvibesDir\play-remote.ps1" -ForegroundColor Green
+    Write-Host "       Owner home:   $env:USERPROFILE" -ForegroundColor Gray
+}
+
+# Step 5: Grant agentvibes-receiver read access to required paths
+Write-Host "[5/8] Granting agentvibes-receiver permissions..." -ForegroundColor Yellow
+$ReceiverUser = "agentvibes-receiver"
+$userExists = Get-LocalUser -Name $ReceiverUser -ErrorAction SilentlyContinue
+if ($userExists) {
+    # Read+Execute on .agentvibes
+    icacls "$agentvibesDir" /grant "${ReceiverUser}:(OI)(CI)RX" /T /Q 2>$null
+    # Modify on tts-queue (receiver writes request files) - create if absent
+    $queueDir = "$agentvibesDir\tts-queue"
+    if (-not (Test-Path $queueDir)) {
+        New-Item -ItemType Directory -Path $queueDir -Force | Out-Null
+    }
+    icacls "$queueDir" /grant "${ReceiverUser}:(OI)(CI)M" /T /Q 2>$null
+    # Modify on receiver.log - touch if absent so icacls can target it
+    $logFile = "$agentvibesDir\receiver.log"
+    if (-not (Test-Path $logFile)) {
+        New-Item -ItemType File -Path $logFile -Force | Out-Null
+    }
+    icacls "$logFile" /grant "${ReceiverUser}:M" /Q 2>$null
+    # Targeted permissions on .claude subdirectories (not blanket Modify on all of .claude)
+    $claudeDir = "$env:USERPROFILE\.claude"
+    if (Test-Path $claudeDir) {
+        # RX on .claude root (needed for Test-Path checks)
+        icacls "$claudeDir" /grant "${ReceiverUser}:RX" /Q 2>$null
+        # RX on hooks (read + execute scripts)
+        $hooksDir = "$claudeDir\hooks-windows"
+        if (Test-Path $hooksDir) {
+            icacls "$hooksDir" /grant "${ReceiverUser}:(OI)(CI)RX" /T /Q 2>$null
+        }
+        # Modify on config (receiver writes voice, speed, music settings)
+        $configDir = "$claudeDir\config"
+        if (Test-Path $configDir) {
+            icacls "$configDir" /grant "${ReceiverUser}:(OI)(CI)M" /T /Q 2>$null
+        }
+        # Modify on audio output dir (receiver writes WAV files)
+        $audioDir = "$claudeDir\audio"
+        if (-not (Test-Path $audioDir)) {
+            New-Item -ItemType Directory -Path $audioDir -Force | Out-Null
+        }
+        icacls "$audioDir" /grant "${ReceiverUser}:(OI)(CI)M" /T /Q 2>$null
+        # Modify on tts-voice.txt and tts-provider.txt (receiver reads/writes these)
+        foreach ($txt in @("tts-voice.txt", "tts-provider.txt")) {
+            $f = "$claudeDir\$txt"
+            if (Test-Path $f) {
+                icacls "$f" /grant "${ReceiverUser}:M" /Q 2>$null
+            }
+        }
+    }
+    # Read+Execute on Piper install
+    $piperDir = "$env:LOCALAPPDATA\Programs\Piper"
+    if (Test-Path $piperDir) {
+        icacls "$piperDir" /grant "${ReceiverUser}:(OI)(CI)RX" /T /Q 2>$null
+    }
+    Write-Host "       Granted $ReceiverUser access to .agentvibes, .claude, Piper" -ForegroundColor Green
+} else {
+    Write-Host "       SKIP: $ReceiverUser user not found (create it first)" -ForegroundColor Yellow
+}
+
+# Step 6: Firewall rule
+Write-Host "[6/8] Adding firewall rule for port 45123 (Tailscale only)..." -ForegroundColor Yellow
+$existingRule = Get-NetFirewallRule -Name "AgentVibes-SSH-Receiver" -ErrorAction SilentlyContinue
+if ($existingRule) {
+    Remove-NetFirewallRule -Name "AgentVibes-SSH-Receiver"
+}
+New-NetFirewallRule -Name "AgentVibes-SSH-Receiver" `
+    -DisplayName "AgentVibes SSH Receiver" `
+    -Description "Allow AgentVibes TTS receiver on port 45123 from Tailscale only" `
+    -Direction Inbound `
+    -Protocol TCP `
+    -LocalPort 45123 `
+    -RemoteAddress 100.0.0.0/8 `
+    -Action Allow | Out-Null
+Write-Host "       Firewall: Allow TCP 45123 from 100.0.0.0/8 only" -ForegroundColor Green
+
+# Step 7: Set up admin authorized keys
+Write-Host "[7/8] Configuring authorized keys..." -ForegroundColor Yellow
+$adminKeysFile = "C:\ProgramData\ssh\administrators_authorized_keys"
+if (-not (Test-Path $adminKeysFile)) {
+    Write-Host "       NOTE: No SSH keys found at $adminKeysFile" -ForegroundColor Yellow
+    Write-Host "       Add your sender's public key there, then run:" -ForegroundColor Yellow
+    Write-Host "       icacls `"$adminKeysFile`" /inheritance:r /grant `"SYSTEM:F`" /grant `"BUILTIN\Administrators:F`"" -ForegroundColor Cyan
+} else {
+    & icacls $adminKeysFile /inheritance:r /grant "SYSTEM:F" /grant "BUILTIN\Administrators:F" 2>$null
+}
+# Step 7.5: Install user-session watcher (audio device access)
+# CRITICAL: SSH receiver runs in session 0 (no audio).  The receiver writes
+# to ~/.agentvibes/tts-queue/, and a watcher running in the user's
+# interactive session picks up requests and plays audio.
+Write-Host "[7.5/8] Installing user-session watcher..." -ForegroundColor Yellow
+# Copy watcher from repo source — single source of truth, no embedded heredoc
+$sourceWatcher = Join-Path $PSScriptRoot ".claude\hooks-windows\tts-watcher.ps1"
+if (-not (Test-Path $sourceWatcher)) {
+    Write-Host "       ERROR: $sourceWatcher not found — run from the AgentVibes repo root" -ForegroundColor Red
+    exit 1
+}
+$watcherDestDir = "$env:USERPROFILE\.agentvibes"
+if (-not (Test-Path $watcherDestDir)) { New-Item -ItemType Directory -Path $watcherDestDir -Force | Out-Null }
+Copy-Item -Path $sourceWatcher -Destination "$watcherDestDir\tts-watcher.ps1" -Force
+
+$vbsLauncher = @'
+Set WshShell = CreateObject("WScript.Shell")
+WshShell.Run "powershell.exe -NoProfile -ExecutionPolicy Bypass -WindowStyle Hidden -File """ & WshShell.ExpandEnvironmentStrings("%USERPROFILE%") & "\.agentvibes\tts-watcher.ps1""", 0, False
+'@
+Set-Content -Path "$env:USERPROFILE\.agentvibes\start-watcher.vbs" -Value $vbsLauncher -Encoding ASCII
+
+# Install autostart shortcut in Startup folder
+$startupDir = [Environment]::GetFolderPath('Startup')
+Copy-Item -Path "$env:USERPROFILE\.agentvibes\start-watcher.vbs" -Destination "$startupDir\agentvibes-watcher.vbs" -Force
+
+# Kill any existing watcher instances before launching - prevents double-playback
+# if setup is run more than once (each run would otherwise add another watcher process).
+$existingWatchers = Get-CimInstance Win32_Process | Where-Object { $_.CommandLine -like "*tts-watcher.ps1*" -and $_.Name -like "powershell*" }
+if ($existingWatchers) {
+    $existingWatchers | ForEach-Object { Stop-Process -Id $_.ProcessId -Force -ErrorAction SilentlyContinue }
+    Start-Sleep -Milliseconds 300  # Wait for processes to exit
+    Write-Host "       Stopped $($existingWatchers.Count) existing watcher(s)" -ForegroundColor DarkYellow
+}
+
+# Launch it now so streaming works without requiring logout/login
+Start-Process wscript.exe -ArgumentList "$env:USERPROFILE\.agentvibes\start-watcher.vbs" -WindowStyle Hidden
+Write-Host "       Watcher: installed + started + autostart enabled" -ForegroundColor Green
+
+# Step 7.6: Install Kokoro daemon autostart (only when Kokoro is available)
+# The Kokoro provider synthesizes via a resident HTTP daemon (kokoro-server.py)
+# that keeps the model on the GPU. Without it, the FIRST receiver message after
+# every reboot pays a ~12s cold model-load. A Startup-folder .vbs keeps it warm.
+Write-Host "[7.6/8] Installing Kokoro daemon autostart (if Kokoro installed)..." -ForegroundColor Yellow
+$pythonCmd = Get-Command python -ErrorAction SilentlyContinue
+$kokoroAvailable = $false
+if ($pythonCmd) {
+    # find_spec avoids importing torch (slow); exit 0 => kokoro importable
+    & $pythonCmd.Source -c "import importlib.util,sys; sys.exit(0 if importlib.util.find_spec('kokoro') else 1)" 2>$null
+    $kokoroAvailable = ($LASTEXITCODE -eq 0)
+}
+if ($kokoroAvailable) {
+    $pythonwPath = $pythonCmd.Source -replace 'python\.exe$', 'pythonw.exe'
+    if (-not (Test-Path $pythonwPath)) { $pythonwPath = $pythonCmd.Source }  # fall back to python.exe
+    $kokoroVbs = @"
+' AgentVibes - Kokoro TTS daemon launcher (autostart)
+' Keeps the Kokoro model resident on the GPU so receiver TTS latency stays low.
+Set WshShell = CreateObject("WScript.Shell")
+pythonw = "$pythonwPath"
+script = WshShell.ExpandEnvironmentStrings("%USERPROFILE%") & "\.claude\hooks-windows\kokoro-server.py"
+WshShell.Run """" & pythonw & """ """ & script & """ 7855", 0, False
+"@
+    Set-Content -Path "$env:USERPROFILE\.agentvibes\start-kokoro-server.vbs" -Value $kokoroVbs -Encoding ASCII
+    Copy-Item -Path "$env:USERPROFILE\.agentvibes\start-kokoro-server.vbs" -Destination "$startupDir\agentvibes-kokoro-server.vbs" -Force
+    # Kill only the managed daemon (this script's kokoro-server.py on the standard
+    # port 7855), then launch a fresh one so it's warm immediately. Scoping by the
+    # managed port avoids killing unrelated user-run kokoro-server.py daemons.
+    Get-CimInstance Win32_Process | Where-Object { $_.CommandLine -like "*kokoro-server.py*7855*" } |
+        ForEach-Object { Stop-Process -Id $_.ProcessId -Force -ErrorAction SilentlyContinue }
+    Start-Process wscript.exe -ArgumentList "$env:USERPROFILE\.agentvibes\start-kokoro-server.vbs" -WindowStyle Hidden
+    Write-Host "       Kokoro daemon: installed + started + autostart enabled (pythonw: $pythonwPath)" -ForegroundColor Green
+} else {
+    Write-Host "       SKIP: Kokoro not installed (pip install kokoro soundfile numpy to enable)" -ForegroundColor DarkYellow
+}
+
+# Step 8: Start sshd
+Write-Host "[8/8] Starting sshd..." -ForegroundColor Yellow
+Start-Service sshd
+$status = (Get-Service sshd).Status
+if ($status -eq "Running") {
+    Write-Host "       sshd: Running" -ForegroundColor Green
+} else {
+    Write-Host "       sshd: $status (check Event Viewer)" -ForegroundColor Red
+    exit 1
+}
+
+Write-Host ""
+Write-Host "=== Setup Complete ===" -ForegroundColor Cyan
+Write-Host ""
+Write-Host "Security:" -ForegroundColor White
+Write-Host "  Port:       45123" -ForegroundColor Gray
+Write-Host "  Interface:  $TailscaleIp (Tailscale)" -ForegroundColor Gray
+Write-Host "  Auth:       SSH key only" -ForegroundColor Gray
+Write-Host "  Access:     Receiver script only (no shell)" -ForegroundColor Gray
+Write-Host "  Firewall:   Tailscale IPs only (100.x.x.x)" -ForegroundColor Gray
+Write-Host ""
+Write-Host "To test from sender:" -ForegroundColor White
+Write-Host "  echo `"hello`" | base64 | ssh -p 45123 $Username@$TailscaleIp" -ForegroundColor Cyan
+Write-Host ""

package/setup-windows.ps1

@@ -322,41 +322,51 @@ if (-not (Test-Path $HooksDir)) {
     New-Item -ItemType Directory -Path $HooksDir -Force | Out-Null
 }
 
-# Script info: filename, description
-$HookScriptInfo = @(
-    @{ Name = "play-tts.ps1"; Desc = "Main TTS router - dispatches to active provider" },
-    @{ Name = "play-tts-soprano.ps1"; Desc = "Soprano neural voice provider (fastest)" },
-    @{ Name = "play-tts-windows-piper.ps1"; Desc = "Piper offline neural voice provider" },
-    @{ Name = "play-tts-windows-sapi.ps1"; Desc = "Windows built-in SAPI voice provider" },
-    @{ Name = "provider-manager.ps1"; Desc = "Switch between TTS providers" },
-    @{ Name = "voice-manager-windows.ps1"; Desc = "Browse and select voice models" },
-    @{ Name = "audio-cache-utils.ps1"; Desc = "Manage TTS audio file cache" },
-    @{ Name = "session-start-tts.ps1"; Desc = "Auto-activates TTS when Claude starts" }
-)
-
+# Friendly descriptions for the well-known scripts; any other *.ps1 in the
+# source dir still gets installed (with a generic label) rather than dropped.
+$HookDescriptions = @{
+    "play-tts.ps1"               = "Main TTS router - dispatches to active provider"
+    "play-tts-soprano.ps1"       = "Soprano neural voice provider (fastest)"
+    "play-tts-windows-piper.ps1" = "Piper offline neural voice provider"
+    "play-tts-windows-sapi.ps1"  = "Windows built-in SAPI voice provider"
+    "provider-manager.ps1"       = "Switch between TTS providers"
+    "voice-manager-windows.ps1"  = "Browse and select voice models"
+    "audio-cache-utils.ps1"      = "Manage TTS audio file cache"
+    "session-start-tts.ps1"      = "Auto-activates TTS when Claude starts"
+}
+
+# One timestamp per run so this run's backups group together and never collide.
+$BackupStamp = (Get-Date -Format 'yyyyMMdd-HHmmss')
+
+# Copy EVERY hook script, not a hand-maintained whitelist — a partial list
+# produced mixed-generation installs (new router + stale providers/watcher).
 $CopiedCount = 0
-foreach ($info in $HookScriptInfo) {
-    $script = $info.Name
-    $SourceFile = Join-Path $SourceHooksDir $script
+foreach ($SourceFile in (Get-ChildItem -Path $SourceHooksDir -Filter *.ps1 -File)) {
+    $script = $SourceFile.Name
     $DestFile = Join-Path $HooksDir $script
+    $desc = if ($HookDescriptions.ContainsKey($script)) { $HookDescriptions[$script] } else { "AgentVibes hook script" }
 
-    if (Test-Path $SourceFile) {
-        # Skip if source and destination are the same file (running from project root)
-        $resolvedSrc = (Resolve-Path $SourceFile).Path
-        $resolvedDst = if (Test-Path $DestFile) { (Resolve-Path $DestFile).Path } else { "" }
-        if ($resolvedSrc -eq $resolvedDst) {
-            Write-Item "[OK]" $script $info.Desc
-        } else {
-            Copy-Item -Path $SourceFile -Destination $DestFile -Force
-            Write-Item "[OK]" $script $info.Desc
-        }
+    # Skip if source and destination are the same file (running from project root)
+    $resolvedSrc = $SourceFile.FullName
+    $resolvedDst = if (Test-Path $DestFile) { (Resolve-Path $DestFile).Path } else { "" }
+    if ($resolvedSrc -eq $resolvedDst) {
+        Write-Item "[OK]" $script $desc
         $CopiedCount++
+        continue
     }
-    else {
-        Write-Host "    [!!] " -ForegroundColor Yellow -NoNewline
-        Write-Host "$($script.PadRight(30))" -ForegroundColor White -NoNewline
-        Write-Host "not found" -ForegroundColor Yellow
+
+    # Non-Destructive rule: back up an existing, differing file before overwrite
+    # so a user-modified hook is always recoverable (timestamped, every run).
+    if (Test-Path $DestFile) {
+        $srcHash = (Get-FileHash -Path $resolvedSrc -Algorithm SHA256).Hash
+        $dstHash = (Get-FileHash -Path $DestFile -Algorithm SHA256).Hash
+        if ($srcHash -ne $dstHash) {
+            Copy-Item -Path $DestFile -Destination "$DestFile.user.bak.$BackupStamp" -ErrorAction SilentlyContinue
+        }
     }
+    Copy-Item -Path $SourceFile.FullName -Destination $DestFile -Force
+    Write-Item "[OK]" $script $desc
+    $CopiedCount++
 }
 
 if ($CopiedCount -eq 0) {

package/src/cli/list-personalities.js

@@ -1,110 +1,110 @@
-#!/usr/bin/env node
-/**
- * Personality List Display - Beautiful multi-column personality listing
- * Called by personality-manager.sh to display personalities with boxen formatting
- */
-
-import { formatPersonalitiesList } from '../utils/list-formatter.js';
-import fs from 'fs';
-import path from 'path';
-import os from 'os';
-
-/**
- * Get personality description from markdown file
- */
-function getPersonalityDescription(filePath) {
-  try {
-    const content = fs.readFileSync(filePath, 'utf8');
-
-    // Try to extract description from frontmatter or first paragraph
-    const descMatch = content.match(/description:\s*(.+)/i);
-    if (descMatch) {
-      return descMatch[1].trim();
-    }
-
-    // Try to get first line after frontmatter
-    const lines = content.split('\n');
-    let inFrontmatter = false;
-    let frontmatterCount = 0;
-
-    for (const line of lines) {
-      if (line.trim() === '---') {
-        frontmatterCount++;
-        inFrontmatter = frontmatterCount === 1;
-        continue;
-      }
-
-      if (!inFrontmatter && frontmatterCount >= 2 && line.trim()) {
-        // First non-empty line after frontmatter
-        return line.trim().replace(/^#+\s*/, '').substring(0, 50);
-      }
-    }
-
-    return '';
-  } catch (error) {
-    return '';
-  }
-}
-
-/**
- * Get all personalities from directory
- */
-function getPersonalities(personalitiesDir, currentPersonality) {
-  const personalities = [];
-
-  if (!fs.existsSync(personalitiesDir)) {
-    return personalities;
-  }
-
-  const files = fs.readdirSync(personalitiesDir);
-  for (const file of files) {
-    if (file.endsWith('.md')) {
-      const name = path.basename(file, '.md');
-      const filePath = path.join(personalitiesDir, file);
-      const description = getPersonalityDescription(filePath);
-
-      personalities.push({
-        name,
-        description,
-        current: name === currentPersonality
-      });
-    }
-  }
-
-  // Add special 'random' option
-  personalities.push({
-    name: 'random',
-    description: 'Picks randomly each time',
-    current: currentPersonality === 'random'
-  });
-
-  return personalities.sort((a, b) => {
-    // Keep 'random' at the end
-    if (a.name === 'random') return 1;
-    if (b.name === 'random') return -1;
-    return a.name.localeCompare(b.name);
-  });
-}
-
-/**
- * Main function
- */
-function main() {
-  const args = process.argv.slice(2);
-
-  // Parse arguments
-  const personalitiesDir = args[0] || path.join(os.homedir(), '.claude', 'personalities');
-  const currentPersonality = args[1] || 'normal';
-
-  const personalities = getPersonalities(personalitiesDir, currentPersonality);
-
-  // Display with boxen
-  const output = formatPersonalitiesList(personalities, {
-    columns: 2,
-    showUsage: true
-  });
-
-  console.log(output);
-}
-
-main();
+#!/usr/bin/env node
+/**
+ * Personality List Display - Beautiful multi-column personality listing
+ * Called by personality-manager.sh to display personalities with boxen formatting
+ */
+
+import { formatPersonalitiesList } from '../utils/list-formatter.js';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+
+/**
+ * Get personality description from markdown file
+ */
+function getPersonalityDescription(filePath) {
+  try {
+    const content = fs.readFileSync(filePath, 'utf8');
+
+    // Try to extract description from frontmatter or first paragraph
+    const descMatch = content.match(/description:\s*(.+)/i);
+    if (descMatch) {
+      return descMatch[1].trim();
+    }
+
+    // Try to get first line after frontmatter
+    const lines = content.split('\n');
+    let inFrontmatter = false;
+    let frontmatterCount = 0;
+
+    for (const line of lines) {
+      if (line.trim() === '---') {
+        frontmatterCount++;
+        inFrontmatter = frontmatterCount === 1;
+        continue;
+      }
+
+      if (!inFrontmatter && frontmatterCount >= 2 && line.trim()) {
+        // First non-empty line after frontmatter
+        return line.trim().replace(/^#+\s*/, '').substring(0, 50);
+      }
+    }
+
+    return '';
+  } catch (error) {
+    return '';
+  }
+}
+
+/**
+ * Get all personalities from directory
+ */
+function getPersonalities(personalitiesDir, currentPersonality) {
+  const personalities = [];
+
+  if (!fs.existsSync(personalitiesDir)) {
+    return personalities;
+  }
+
+  const files = fs.readdirSync(personalitiesDir);
+  for (const file of files) {
+    if (file.endsWith('.md')) {
+      const name = path.basename(file, '.md');
+      const filePath = path.join(personalitiesDir, file);
+      const description = getPersonalityDescription(filePath);
+
+      personalities.push({
+        name,
+        description,
+        current: name === currentPersonality
+      });
+    }
+  }
+
+  // Add special 'random' option
+  personalities.push({
+    name: 'random',
+    description: 'Picks randomly each time',
+    current: currentPersonality === 'random'
+  });
+
+  return personalities.sort((a, b) => {
+    // Keep 'random' at the end
+    if (a.name === 'random') return 1;
+    if (b.name === 'random') return -1;
+    return a.name.localeCompare(b.name);
+  });
+}
+
+/**
+ * Main function
+ */
+function main() {
+  const args = process.argv.slice(2);
+
+  // Parse arguments
+  const personalitiesDir = args[0] || path.join(os.homedir(), '.claude', 'personalities');
+  const currentPersonality = args[1] || 'normal';
+
+  const personalities = getPersonalities(personalitiesDir, currentPersonality);
+
+  // Display with boxen
+  const output = formatPersonalitiesList(personalities, {
+    columns: 2,
+    showUsage: true
+  });
+
+  console.log(output);
+}
+
+main();