voicecc 1.1.7 → 1.1.8

package/bin/voicecc.js

@@ -3,30 +3,47 @@
 /**
  * CLI entry point for the voicecc command.
  *
+ * Responsibilities:
  * - On first run (no .env), launches an interactive setup wizard
  * - Copies CLAUDE.md template on first run
- * - Spawns the dashboard server
+ * - Manages the server as a background daemon (start/stop/status)
+ * - Supports subcommands: stop, logs, autostart
  */
 
 import { spawn, execSync } from "node:child_process";
-import { copyFileSync, existsSync, chownSync, mkdirSync } from "node:fs";
-import { writeFile, readFile } from "node:fs/promises";
+import { copyFileSync, existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync, openSync, closeSync } from "node:fs";
+import { writeFile } from "node:fs/promises";
 import { createInterface } from "node:readline";
 import { randomBytes } from "node:crypto";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
+import { homedir, platform } from "node:os";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const PKG_ROOT = join(__dirname, "..");
 const TSX_BIN = join(PKG_ROOT, "node_modules", ".bin", "tsx");
 const ENV_PATH = join(PKG_ROOT, ".env");
 
+const VOICECC_DIR = join(homedir(), ".voicecc");
+const PID_FILE = join(VOICECC_DIR, "voicecc.pid");
+const LOG_FILE = join(VOICECC_DIR, "voicecc.log");
+const STATUS_FILE = join(VOICECC_DIR, "status.json");
+
 process.chdir(PKG_ROOT);
 
 // ============================================================================
-// SETUP WIZARD
+// HELPER FUNCTIONS
 // ============================================================================
 
+/**
+ * Ensure the ~/.voicecc directory exists.
+ */
+function ensureVoiceccDir() {
+  if (!existsSync(VOICECC_DIR)) {
+    mkdirSync(VOICECC_DIR, { recursive: true });
+  }
+}
+
 /**
  * Prompt the user for a single line of input.
  *
@@ -64,6 +81,75 @@ function generatePassword() {
   return randomBytes(18).toString("base64url");
 }
 
+/**
+ * Check if the daemon is currently running.
+ *
+ * @returns true if the PID file exists and the process is alive
+ */
+function isRunning() {
+  if (!existsSync(PID_FILE)) return false;
+
+  const pid = parseInt(readFileSync(PID_FILE, "utf-8").trim(), 10);
+  if (isNaN(pid)) return false;
+
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    // Process not found, clean up stale PID file
+    unlinkSync(PID_FILE);
+    return false;
+  }
+}
+
+/**
+ * Read the status.json written by the server.
+ *
+ * @returns parsed status object or null if unavailable
+ */
+function readStatus() {
+  try {
+    return JSON.parse(readFileSync(STATUS_FILE, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Display server info banner.
+ */
+function showInfo() {
+  const status = readStatus();
+
+  console.log("");
+  console.log("========================================");
+  console.log("          VOICECC RUNNING               ");
+  console.log("========================================");
+  console.log("");
+
+  if (status) {
+    console.log(`  Dashboard:  http://localhost:${status.dashboardPort}`);
+    console.log(`  Tunnel:     ${status.tunnelUrl ?? "disabled"}`);
+  } else {
+    console.log("  Server is starting up...");
+    console.log("  Run 'voicecc' again in a few seconds to see details.");
+  }
+
+  console.log("");
+  console.log("  Logs:       voicecc logs");
+  console.log("  Stop:       voicecc stop");
+  console.log("");
+  console.log("  TIP: Run 'voicecc autostart' to start VoiceCC");
+  console.log("  automatically on reboot.");
+  console.log("");
+  console.log("========================================");
+  console.log("");
+}
+
+// ============================================================================
+// SETUP WIZARD
+// ============================================================================
+
 /**
  * Run the first-run setup wizard.
  * Prompts for ElevenLabs API key and dashboard password configuration.
@@ -195,10 +281,248 @@ function chownPkgRoot() {
   execSync(`chown -R ${VOICECC_USER}:${VOICECC_USER} ${PKG_ROOT}`, { stdio: "inherit" });
 }
 
+// ============================================================================
+// SUBCOMMANDS
+// ============================================================================
+
+/**
+ * Stop the running daemon.
+ */
+function stopDaemon() {
+  if (!isRunning()) {
+    console.log("VoiceCC is not running.");
+    process.exit(0);
+  }
+
+  const pid = parseInt(readFileSync(PID_FILE, "utf-8").trim(), 10);
+  console.log(`Stopping VoiceCC (PID ${pid})...`);
+
+  try {
+    process.kill(pid, "SIGTERM");
+  } catch {
+    // Already dead
+  }
+
+  // Clean up
+  try { unlinkSync(PID_FILE); } catch { /* ignore */ }
+  try { unlinkSync(STATUS_FILE); } catch { /* ignore */ }
+
+  console.log("VoiceCC stopped.");
+}
+
+/**
+ * Tail the log file.
+ */
+function showLogs() {
+  if (!existsSync(LOG_FILE)) {
+    console.log("No log file found. Has VoiceCC been started?");
+    process.exit(1);
+  }
+
+  const child = spawn("tail", ["-f", LOG_FILE], { stdio: "inherit" });
+  process.on("SIGINT", () => child.kill("SIGINT"));
+  child.on("exit", (code) => process.exit(code ?? 0));
+}
+
+/**
+ * Set up auto-start on reboot using systemd (Linux) or launchd (macOS).
+ */
+function setupAutostart() {
+  const os = platform();
+
+  if (os === "linux") {
+    setupSystemdAutostart();
+  } else if (os === "darwin") {
+    setupLaunchdAutostart();
+  } else {
+    console.log(`Autostart is not supported on ${os}.`);
+    process.exit(1);
+  }
+}
+
+/**
+ * Install a systemd service for auto-start on Linux.
+ * Requires sudo for writing to /etc/systemd/system.
+ */
+function setupSystemdAutostart() {
+  const user = execSync("whoami", { encoding: "utf-8" }).trim();
+
+  const serviceContent = `[Unit]
+Description=VoiceCC Voice Server
+After=network.target
+
+[Service]
+Type=simple
+User=${user}
+ExecStart=${TSX_BIN} server/index.ts
+Restart=on-failure
+RestartSec=5
+Environment=HOME=${homedir()}
+Environment=PATH=/usr/local/bin:/usr/bin:/bin
+WorkingDirectory=${PKG_ROOT}
+
+[Install]
+WantedBy=multi-user.target
+`;
+
+  const tmpPath = join(VOICECC_DIR, "voicecc.service");
+  writeFileSync(tmpPath, serviceContent);
+
+  console.log("Installing systemd service (sudo required)...");
+  console.log("");
+
+  try {
+    execSync(`sudo cp ${tmpPath} /etc/systemd/system/voicecc.service`, { stdio: "inherit" });
+    execSync("sudo systemctl daemon-reload", { stdio: "inherit" });
+    execSync("sudo systemctl enable voicecc", { stdio: "inherit" });
+    console.log("");
+    console.log("Autostart enabled! VoiceCC will start on reboot.");
+    console.log("The systemd service manages the daemon separately.");
+    console.log("");
+    console.log("  sudo systemctl start voicecc    Start now via systemd");
+    console.log("  sudo systemctl stop voicecc     Stop via systemd");
+    console.log("  sudo systemctl status voicecc   Check status");
+    console.log("");
+  } catch {
+    console.log("Failed to install systemd service. Check sudo permissions.");
+    process.exit(1);
+  } finally {
+    try { unlinkSync(tmpPath); } catch { /* ignore */ }
+  }
+}
+
+/**
+ * Install a launchd agent for auto-start on macOS.
+ * No sudo required (user-level agent).
+ */
+function setupLaunchdAutostart() {
+  const plistName = "com.voicecc.server";
+  const plistDir = join(homedir(), "Library", "LaunchAgents");
+  const plistPath = join(plistDir, `${plistName}.plist`);
+
+  const plistContent = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${plistName}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${TSX_BIN}</string>
+    <string>server/index.ts</string>
+  </array>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>WorkingDirectory</key>
+  <string>${PKG_ROOT}</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>HOME</key>
+    <string>${homedir()}</string>
+    <key>PATH</key>
+    <string>/usr/local/bin:/usr/bin:/bin:/opt/homebrew/bin</string>
+  </dict>
+  <key>StandardOutPath</key>
+  <string>${LOG_FILE}</string>
+  <key>StandardErrorPath</key>
+  <string>${LOG_FILE}</string>
+</dict>
+</plist>
+`;
+
+  if (!existsSync(plistDir)) {
+    mkdirSync(plistDir, { recursive: true });
+  }
+
+  try {
+    // Unload existing if present
+    if (existsSync(plistPath)) {
+      try {
+        execSync(`launchctl unload ${plistPath}`, { stdio: "ignore" });
+      } catch { /* ignore */ }
+    }
+
+    writeFileSync(plistPath, plistContent);
+    execSync(`launchctl load ${plistPath}`, { stdio: "inherit" });
+
+    console.log("");
+    console.log("Autostart enabled! VoiceCC will start on login.");
+    console.log("");
+    console.log(`  Plist: ${plistPath}`);
+    console.log("");
+    console.log("  To disable autostart:");
+    console.log(`    launchctl unload ${plistPath}`);
+    console.log("");
+  } catch (err) {
+    console.log(`Failed to install launchd agent: ${err.message}`);
+    process.exit(1);
+  }
+}
+
+/**
+ * Start the server as a detached background daemon.
+ */
+function startDaemon() {
+  ensureVoiceccDir();
+
+  // Clean up stale status file
+  try { unlinkSync(STATUS_FILE); } catch { /* ignore */ }
+
+  const logFd = openSync(LOG_FILE, "a");
+
+  const isRoot = process.getuid && process.getuid() === 0;
+
+  let child;
+  if (isRoot) {
+    ensureNonRootUser();
+    chownPkgRoot();
+    console.log(`Dropping root privileges, running as '${VOICECC_USER}'...`);
+    child = spawn("su", ["-", VOICECC_USER, "-c", `cd ${PKG_ROOT} && ${TSX_BIN} server/index.ts`], {
+      cwd: PKG_ROOT,
+      detached: true,
+      stdio: ["ignore", logFd, logFd],
+    });
+  } else {
+    child = spawn(TSX_BIN, ["server/index.ts"], {
+      cwd: PKG_ROOT,
+      detached: true,
+      stdio: ["ignore", logFd, logFd],
+    });
+  }
+
+  // Write PID file
+  writeFileSync(PID_FILE, String(child.pid));
+
+  // Detach parent from child
+  child.unref();
+  closeSync(logFd);
+}
+
 // ============================================================================
 // MAIN ENTRYPOINT
 // ============================================================================
 
+const subcommand = process.argv[2];
+
+// Handle subcommands
+if (subcommand === "stop") {
+  stopDaemon();
+  process.exit(0);
+}
+
+if (subcommand === "logs") {
+  showLogs();
+  // showLogs doesn't return (tail -f)
+}
+
+if (subcommand === "autostart") {
+  ensureVoiceccDir();
+  setupAutostart();
+  process.exit(0);
+}
+
 // Copy CLAUDE.md template if available
 const claudeMdSrc = join("init", "CLAUDE.md");
 if (existsSync(claudeMdSrc)) {
@@ -210,29 +534,15 @@ if (!existsSync(ENV_PATH)) {
   await runSetupWizard();
 }
 
-// If running as root, re-exec as a non-root user
-const isRoot = process.getuid && process.getuid() === 0;
-if (isRoot) {
-  ensureNonRootUser();
-  chownPkgRoot();
-
-  console.log(`Dropping root privileges, running as '${VOICECC_USER}'...`);
-  const child = spawn("su", ["-", VOICECC_USER, "-c", `cd ${PKG_ROOT} && ${TSX_BIN} server/index.ts`], {
-    cwd: PKG_ROOT,
-    stdio: "inherit",
-  });
+// If already running, show info and exit
+if (isRunning()) {
+  showInfo();
+  process.exit(0);
+}
 
-  process.on("SIGINT", () => child.kill("SIGINT"));
-  process.on("SIGTERM", () => child.kill("SIGTERM"));
-  child.on("exit", (code) => process.exit(code ?? 1));
-} else {
-  // Start the dashboard directly
-  const child = spawn(TSX_BIN, ["server/index.ts"], {
-    cwd: PKG_ROOT,
-    stdio: "inherit",
-  });
+// Start the daemon
+startDaemon();
 
-  process.on("SIGINT", () => child.kill("SIGINT"));
-  process.on("SIGTERM", () => child.kill("SIGTERM"));
-  child.on("exit", (code) => process.exit(code ?? 1));
-}
+// Wait briefly for server to write status.json, then show info
+await new Promise((resolve) => setTimeout(resolve, 3000));
+showInfo();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "voicecc",
-  "version": "1.1.7",
+  "version": "1.1.8",
   "description": "Voice mode plugin for Claude Code -- hands-free interaction via ElevenLabs STT/TTS and VAD",
   "type": "module",
   "bin": {

package/server/index.ts

@@ -10,6 +10,10 @@
 
 import "dotenv/config";
 
+import { writeFileSync, unlinkSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
 import { startDashboard } from "../dashboard/server.js";
 import { readEnv } from "./services/env.js";
 import { startTunnel, isTunnelRunning, getTunnelUrl } from "./services/tunnel.js";
@@ -18,6 +22,39 @@ import { startBrowserCallServer } from "./services/browser-call-manager.js";
 import { startHeartbeat } from "./services/heartbeat.js";
 import { startVoiceServer } from "./voice/voice-server.js";
 
+const STATUS_FILE = join(homedir(), ".voicecc", "status.json");
+
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+
+/**
+ * Write server status to ~/.voicecc/status.json so the CLI can display info.
+ *
+ * @param dashboardPort - the port the dashboard is running on
+ * @param tunnelUrl - the tunnel URL, or null if disabled
+ */
+function writeStatusFile(dashboardPort: number, tunnelUrl: string | null): void {
+  const status = {
+    dashboardPort,
+    tunnelUrl,
+    startedAt: new Date().toISOString(),
+  };
+  try {
+    mkdirSync(join(homedir(), ".voicecc"), { recursive: true });
+    writeFileSync(STATUS_FILE, JSON.stringify(status, null, 2));
+  } catch {
+    console.error("Failed to write status file");
+  }
+}
+
+/**
+ * Remove the status file on shutdown.
+ */
+function cleanupStatusFile(): void {
+  try { unlinkSync(STATUS_FILE); } catch { /* ignore */ }
+}
+
 // ============================================================================
 // MAIN ENTRYPOINT
 // ============================================================================
@@ -67,8 +104,15 @@ async function main(): Promise<void> {
     }
   }
 
-  // Print startup banner
+  // Write status file so the CLI can display server info
   const tunnelUrl = getTunnelUrl();
+  writeStatusFile(dashboardPort, tunnelUrl);
+
+  // Clean up status file on shutdown
+  process.on("SIGTERM", () => { cleanupStatusFile(); process.exit(0); });
+  process.on("SIGINT", () => { cleanupStatusFile(); process.exit(0); });
+
+  // Print startup banner
   console.log("");
   console.log("========================================");
   console.log("             VOICECC RUNNING            ");
@@ -77,8 +121,6 @@ async function main(): Promise<void> {
   console.log(`  Dashboard:  http://localhost:${dashboardPort}`);
   console.log(`  Tunnel:     ${tunnelUrl ?? "disabled"}`);
   console.log("");
-  console.log("  Press Ctrl+C to stop.");
-  console.log("");
 }
 
 // ============================================================================