voicecc 1.0.7 → 1.0.9

package/README.md

@@ -39,10 +39,3 @@ The voice loop runs locally with zero external API calls except to Claude:
 6. **Narration**: Claude's response stripped of markdown and split into sentences
 7. **Text-to-speech**: Kokoro-82M via mlx-audio on Apple Silicon GPU (~8x realtime)
 8. **Speaker playback**: Audio output through VPIO at 24kHz with echo cancellation
-
-## Troubleshooting
-
-- **"sox not found"**: Install sox with `brew install sox`
-- **"espeak not installed"**: Install espeak-ng with `brew install espeak-ng`
-- **tts-server.py not ready**: Ensure the Python venv is set up correctly
-- **Mic permission denied**: Grant microphone permissions to your terminal or IDE

package/bin/voicecc.js

@@ -3,31 +3,28 @@
 /**
  * CLI entry point for the voicecc command.
  *
- * Resolves the package install directory and spawns `tsx run.ts`
- * with inherited stdio so the dashboard server runs in the foreground.
- *
- * Responsibilities:
- * - Resolve the package root from this script's location
- * - Spawn tsx with run.ts in the correct working directory
- * - Forward signals (SIGINT, SIGTERM) so Ctrl+C stops the server cleanly
+ * Checks if first-run setup is needed (compile mic-vpio, Python venv, etc.)
+ * and runs it with visible output. Then spawns `tsx run.ts` for the dashboard.
  */
 
 import { spawn } from "node:child_process";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 
-// ============================================================================
-// CONSTANTS
-// ============================================================================
-
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const PKG_ROOT = join(__dirname, "..");
 const TSX_BIN = join(PKG_ROOT, "node_modules", ".bin", "tsx");
 
-// ============================================================================
-// MAIN ENTRYPOINT
-// ============================================================================
+// Run setup if needed (first run or incomplete install)
+process.chdir(PKG_ROOT);
+const { needsSetup, runSetup } = await import("../scripts/postinstall.js");
+
+if (needsSetup()) {
+  console.log("[voicecc] Running first-time setup...\n");
+  runSetup();
+}
 
+// Start the dashboard
 const child = spawn(TSX_BIN, ["run.ts"], {
   cwd: PKG_ROOT,
   stdio: "inherit",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "voicecc",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Voice mode plugin for Claude Code -- hands-free interaction via local STT/TTS/VAD",
   "type": "module",
   "bin": {
@@ -10,8 +10,7 @@
     "start": "tsx run.ts",
     "dev:dashboard": "cd dashboard && npx vite",
     "build:dashboard": "cd dashboard && npx vite build",
-    "prepublishOnly": "npm run build:dashboard",
-    "postinstall": "node scripts/postinstall.js"
+    "prepublishOnly": "npm run build:dashboard"
   },
   "files": [
     "bin/",

package/scripts/postinstall.js

@@ -1,16 +1,11 @@
 /**
- * Postinstall script that runs after `npm install`.
+ * Setup script for voicecc.
  *
  * Compiles the mic-vpio Swift binary (macOS VPIO echo cancellation),
  * checks for required system dependencies (espeak-ng), then sets up
  * the Python virtual environment and installs TTS dependencies.
  *
- * Responsibilities:
- * - Compile the mic-vpio Swift binary for echo-cancelled audio I/O
- * - Verify espeak-ng is installed
- * - Create Python venv in sidecar/.venv (if not already present)
- * - Install Python TTS packages (mlx-audio, misaki, etc.)
- * - Download spaCy English model
+ * Called from bin/voicecc.js on first run (or when setup is incomplete).
  */
 
 import { execSync } from "child_process";
@@ -24,6 +19,7 @@ import { join } from "path";
 const VENV_DIR = join("sidecar", ".venv");
 const PIP = join(VENV_DIR, "bin", "pip");
 const PYTHON = join(VENV_DIR, "bin", "python3");
+const MIC_VPIO = join("sidecar", "mic-vpio");
 
 const PYTHON_PACKAGES = [
   "mlx-audio",
@@ -34,10 +30,24 @@ const PYTHON_PACKAGES = [
 ];
 
 // ============================================================================
-// MAIN ENTRYPOINT
+// PUBLIC API
 // ============================================================================
 
-function main() {
+/**
+ * Returns true if any setup step is incomplete.
+ */
+export function needsSetup() {
+  return (
+    !existsSync(MIC_VPIO) ||
+    !existsSync(PYTHON) ||
+    !existsSync(join("dashboard", "dist", "index.html"))
+  );
+}
+
+/**
+ * Run all setup steps. Shows progress to stdout.
+ */
+export function runSetup() {
   installClaudeMd();
   buildDashboard();
   compileMicVpio();
@@ -48,21 +58,20 @@ function main() {
 
   console.log("");
   console.log("========================================");
-  console.log("            VOICECC INSTALLED           ");
+  console.log("          VOICECC SETUP COMPLETE        ");
   console.log("========================================");
   console.log("");
-  console.log("  Run 'voicecc' in terminal to start the server!");
-  console.log("");
 }
 
 // ============================================================================
 // HELPER FUNCTIONS
 // ============================================================================
 
-/**
- * Build the dashboard frontend via Vite.
- */
 function buildDashboard() {
+  if (existsSync(join("dashboard", "dist", "index.html"))) {
+    console.log("Dashboard already built, skipping.");
+    return;
+  }
   console.log("Building dashboard...");
   try {
     run("cd dashboard && npx vite build");
@@ -74,16 +83,11 @@ function buildDashboard() {
   console.log("Dashboard built successfully");
 }
 
-/**
- * Copy the project CLAUDE.md from init/ to the project root.
- * Overwrites any existing CLAUDE.md to keep it in sync with the repo.
- */
 function installClaudeMd() {
   const src = join("init", "CLAUDE.md");
   const dest = "CLAUDE.md";
 
   if (!existsSync(src)) {
-    console.warn("init/CLAUDE.md not found, skipping.");
     return;
   }
 
@@ -91,13 +95,13 @@ function installClaudeMd() {
   console.log("Installed CLAUDE.md to project root.");
 }
 
-/**
- * Compile the mic-vpio Swift binary for macOS VPIO echo cancellation.
- * Skips compilation if the binary already exists and is newer than the source.
- */
 function compileMicVpio() {
+  if (existsSync(MIC_VPIO)) {
+    console.log("mic-vpio already compiled, skipping.");
+    return;
+  }
+
   const source = join("sidecar", "mic-vpio.swift");
-  const binary = join("sidecar", "mic-vpio");
 
   if (process.platform !== "darwin") {
     console.error("\n[voicecc] ERROR: macOS is required.");
@@ -114,7 +118,7 @@ function compileMicVpio() {
 
   console.log("Compiling mic-vpio (VPIO echo cancellation)...");
   try {
-    run(`swiftc -O -o ${binary} ${source} -framework AudioToolbox -framework CoreAudio`);
+    run(`swiftc -O -o ${MIC_VPIO} ${source} -framework AudioToolbox -framework CoreAudio`);
   } catch (err) {
     console.error("\n[voicecc] ERROR: Failed to compile mic-vpio.swift.");
     console.error("  Make sure Xcode Command Line Tools are installed: xcode-select --install\n");
@@ -123,10 +127,6 @@ function compileMicVpio() {
   console.log("mic-vpio compiled successfully");
 }
 
-/**
- * Check that required system binaries are available.
- * Exits with a clear error message if any are missing.
- */
 function checkSystemDeps() {
   const missing = [];
 
@@ -135,16 +135,13 @@ function checkSystemDeps() {
   if (missing.length > 0) {
     console.error(`\n[voicecc] ERROR: Missing system dependencies: ${missing.join(", ")}`);
     console.error(`  Install with: brew install ${missing.join(" ")}`);
-    console.error(`  Then re-run: npm install\n`);
+    console.error(`  Then re-run: voicecc\n`);
     process.exit(1);
   }
 
   console.log("System dependencies OK (espeak-ng)");
 }
 
-/**
- * Create the Python virtual environment if it doesn't exist.
- */
 function setupPythonVenv() {
   if (existsSync(PIP)) {
     console.log(`Python venv already exists at ${VENV_DIR}`);
@@ -167,9 +164,6 @@ function setupPythonVenv() {
   }
 }
 
-/**
- * Install Python TTS packages into the venv.
- */
 function installPythonPackages() {
   console.log("Installing Python TTS packages...");
   try {
@@ -178,14 +172,11 @@ function installPythonPackages() {
     console.error("\n[voicecc] ERROR: Failed to install Python TTS packages.");
     console.error("  This may be due to missing build tools or incompatible Python version.");
     console.error("  Required packages: " + PYTHON_PACKAGES.join(", "));
-    console.error("  Try deleting sidecar/.venv and re-running: npm install\n");
+    console.error("  Try deleting sidecar/.venv and re-running: voicecc\n");
     process.exit(1);
   }
 }
 
-/**
- * Download the spaCy English language model.
- */
 function downloadSpacyModel() {
   console.log("Downloading spaCy English model...");
   try {
@@ -197,12 +188,6 @@ function downloadSpacyModel() {
   }
 }
 
-/**
- * Check if a command exists on the system PATH.
- *
- * @param {string} cmd - Command name to check
- * @returns {boolean} True if the command exists
- */
 function commandExists(cmd) {
   try {
     execSync(`which ${cmd}`, { stdio: "ignore" });
@@ -212,17 +197,6 @@ function commandExists(cmd) {
   }
 }
 
-/**
- * Run a shell command with inherited stdio (output visible to user).
- *
- * @param {string} cmd - Shell command to execute
- */
 function run(cmd) {
   execSync(cmd, { stdio: "inherit" });
 }
-
-// ============================================================================
-// ENTRY POINT
-// ============================================================================
-
-main();