claude-phone-local 2.0.0

package/cli/bin/cli-main.js

@@ -0,0 +1,284 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { setupCommand } from '../lib/commands/setup.js';
+import { startCommand } from '../lib/commands/start.js';
+import { stopCommand } from '../lib/commands/stop.js';
+import { statusCommand } from '../lib/commands/status.js';
+import { doctorCommand } from '../lib/commands/doctor.js';
+import { apiServerCommand } from '../lib/commands/api-server.js';
+import { deviceAddCommand } from '../lib/commands/device/add.js';
+import { deviceListCommand } from '../lib/commands/device/list.js';
+import { deviceRemoveCommand } from '../lib/commands/device/remove.js';
+import { logsCommand } from '../lib/commands/logs.js';
+import { configShowCommand } from '../lib/commands/config/show.js';
+import { configPathCommand } from '../lib/commands/config/path.js';
+import { configResetCommand } from '../lib/commands/config/reset.js';
+import { updateCommand } from '../lib/commands/update.js';
+import { backupCommand } from '../lib/commands/backup.js';
+import { restoreCommand } from '../lib/commands/restore.js';
+import { uninstallCommand } from '../lib/commands/uninstall.js';
+import { registerMcpServerWithOutput, mcpServerPath } from '../lib/mcp-register.js';
+import { loadConfig as _loadCfgForMcp } from '../lib/config.js';
+
+const program = new Command();
+
+program
+  .name('claude-phone')
+  .description('Voice interface for Claude Code via SIP - Call your AI, and your AI can call you')
+  .version('1.0.0');
+
+program
+  .command('setup')
+  .description('Interactive setup wizard for API keys, 3CX config, and devices')
+  .option('--skip-prereqs', 'Skip prerequisite checks (advanced users only)')
+  .action(async (options) => {
+    try {
+      await setupCommand(options);
+    } catch (error) {
+      console.error(chalk.red(`\n✗ Setup failed: ${error.message}\n`));
+      process.exit(1);
+    }
+  });
+
+program
+  .command('start')
+  .description('Start all services (Docker containers + claude-api-server)')
+  .action(async () => {
+    try {
+      await startCommand();
+    } catch (error) {
+      console.error(chalk.red(`\n✗ Start failed: ${error.message}\n`));
+      process.exit(1);
+    }
+  });
+
+program
+  .command('stop')
+  .description('Stop all services')
+  .action(async () => {
+    try {
+      await stopCommand();
+    } catch (error) {
+      console.error(chalk.red(`\n✗ Stop failed: ${error.message}\n`));
+      process.exit(1);
+    }
+  });
+
+program
+  .command('status')
+  .description('Show status of all services')
+  .action(async () => {
+    try {
+      await statusCommand();
+    } catch (error) {
+      console.error(chalk.red(`\n✗ Status check failed: ${error.message}\n`));
+      process.exit(1);
+    }
+  });
+
+program
+  .command('doctor')
+  .description('Run health checks on all dependencies and services')
+  .action(async () => {
+    try {
+      await doctorCommand();
+    } catch (error) {
+      console.error(chalk.red(`\n✗ Health check failed: ${error.message}\n`));
+      process.exit(1);
+    }
+  });
+
+program
+  .command('api-server')
+  .description('Start Claude API server for Pi remote connections')
+  .option('-p, --port <port>', 'Port to listen on', '3333')
+  .action(async (options) => {
+    try {
+      const port = parseInt(options.port, 10);
+      if (isNaN(port) || port < 1024 || port > 65535) {
+        console.error(chalk.red('\n✗ Port must be between 1024 and 65535\n'));
+        process.exit(1);
+      }
+      await apiServerCommand({ port });
+    } catch (error) {
+      console.error(chalk.red(`\n✗ API server failed: ${error.message}\n`));
+      process.exit(1);
+    }
+  });
+
+// Device management subcommands
+const mcp = program
+  .command('mcp')
+  .description('Manage the MCP server that lets Claude Code call you');
+
+mcp
+  .command('install')
+  .description('Register the MCP server with Claude Code')
+  .option('-t, --to <number>', 'Extension or number Claude should ring')
+  .option('-f, --force', 'Re-register even if already present')
+  .action(async (options) => {
+    let cfg = {};
+    try { cfg = await _loadCfgForMcp(); } catch { /* not set up yet - fine */ }
+    const firstDevice = cfg.devices && Object.keys(cfg.devices).length
+      ? Object.values(cfg.devices)[0]
+      : null;
+    registerMcpServerWithOutput({
+      defaultTo: options.to || cfg.sip?.callbackNumber || firstDevice?.extension || cfg.sip?.extension,
+      httpPort: cfg.server?.httpPort || 3000,
+      force: !!options.force,
+    });
+  });
+
+mcp
+  .command('path')
+  .description('Print the MCP server path (for manual registration)')
+  .action(() => console.log(mcpServerPath()));
+
+const device = program
+  .command('device')
+  .description('Manage SIP devices');
+
+device
+  .command('add')
+  .description('Add a new device')
+  .action(async () => {
+    try {
+      await deviceAddCommand();
+    } catch (error) {
+      console.error(chalk.red(`\n✗ Device add failed: ${error.message}\n`));
+      process.exit(1);
+    }
+  });
+
+device
+  .command('list')
+  .description('List all configured devices')
+  .action(async () => {
+    try {
+      await deviceListCommand();
+    } catch (error) {
+      console.error(chalk.red(`\n✗ Device list failed: ${error.message}\n`));
+      process.exit(1);
+    }
+  });
+
+device
+  .command('remove <name>')
+  .description('Remove a device by name')
+  .action(async (name) => {
+    try {
+      await deviceRemoveCommand(name);
+    } catch (error) {
+      console.error(chalk.red(`\n✗ Device remove failed: ${error.message}\n`));
+      process.exit(1);
+    }
+  });
+
+program
+  .command('logs [service]')
+  .description('Tail service logs (voice-app, api-server, or all)')
+  .action(async (service) => {
+    try {
+      await logsCommand(service);
+    } catch (error) {
+      console.error(chalk.red(`\n✗ Logs command failed: ${error.message}\n`));
+      process.exit(1);
+    }
+  });
+
+// Config management subcommands
+const config = program
+  .command('config')
+  .description('Manage configuration');
+
+config
+  .command('show')
+  .description('Display configuration with redacted secrets')
+  .action(async () => {
+    try {
+      await configShowCommand();
+    } catch (error) {
+      console.error(chalk.red(`\n✗ Config show failed: ${error.message}\n`));
+      process.exit(1);
+    }
+  });
+
+config
+  .command('path')
+  .description('Show configuration file location')
+  .action(async () => {
+    try {
+      await configPathCommand();
+    } catch (error) {
+      console.error(chalk.red(`\n✗ Config path failed: ${error.message}\n`));
+      process.exit(1);
+    }
+  });
+
+config
+  .command('reset')
+  .description('Reset configuration (creates backup)')
+  .action(async () => {
+    try {
+      await configResetCommand();
+    } catch (error) {
+      console.error(chalk.red(`\n✗ Config reset failed: ${error.message}\n`));
+      process.exit(1);
+    }
+  });
+
+program
+  .command('update')
+  .description('Update Claude Phone to latest version')
+  .action(async () => {
+    try {
+      await updateCommand();
+    } catch (error) {
+      console.error(chalk.red(`\n✗ Update failed: ${error.message}\n`));
+      process.exit(1);
+    }
+  });
+
+program
+  .command('backup')
+  .description('Create timestamped backup of configuration')
+  .action(async () => {
+    try {
+      await backupCommand();
+    } catch (error) {
+      console.error(chalk.red(`\n✗ Backup failed: ${error.message}\n`));
+      process.exit(1);
+    }
+  });
+
+program
+  .command('restore')
+  .description('Restore configuration from backup')
+  .action(async () => {
+    try {
+      await restoreCommand();
+    } catch (error) {
+      console.error(chalk.red(`\n✗ Restore failed: ${error.message}\n`));
+      process.exit(1);
+    }
+  });
+
+program
+  .command('uninstall')
+  .description('Uninstall Claude Phone completely')
+  .action(async () => {
+    try {
+      await uninstallCommand();
+    } catch (error) {
+      console.error(chalk.red(`\n✗ Uninstall failed: ${error.message}\n`));
+      process.exit(1);
+    }
+  });
+
+// Parse arguments
+program.parse(process.argv);
+
+// Show help if no command
+if (!process.argv.slice(2).length) {
+  program.outputHelp();
+}

package/cli/bin/postinstall.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+// Friendly next-steps message after `npm install -g claude-phone-local`.
+// Never fails the install (package.json calls this with `|| true`).
+
+console.log(`
+\x1b[36m claude-phone-local installed \x1b[0m
+
+Next steps:
+  1. claude-phone setup     # answers 3CX + local STT/TTS questions
+  2. claude-phone doctor    # checks Docker, Claude CLI, ports
+  3. claude-phone start     # builds + launches everything
+
+Setup also registers the MCP server, so Claude Code can call YOU:
+  "call me when the build finishes"
+(re-run later with: claude-phone mcp install)
+
+Needs on this machine: Docker (Desktop or Engine) and Claude Code CLI
+already logged in. Speech models and voices download automatically on
+first run - no manual steps. See README-LOCAL-MODE.md for Windows/3CX.
+`);

package/cli/lib/commands/api-server.js

@@ -0,0 +1,77 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { spawn } from 'child_process';
+import path from 'path';
+import { loadConfig, configExists } from '../config.js';
+import { getProjectRoot } from '../utils.js';
+import { savePid, removePid } from '../process-manager.js';
+
+/**
+ * API Server command - Start claude-api-server for remote connections
+ * @param {object} options - Command options
+ * @param {number} options.port - Port to listen on (default: 3333)
+ * @returns {Promise<void>}
+ */
+export async function apiServerCommand(options = {}) {
+  console.log(chalk.bold.cyan('\n🤖 Claude API Server\n'));
+
+  // Load config to get port if not provided
+  let port = options.port;
+  if (!port && configExists()) {
+    const config = await loadConfig();
+    port = config.server?.claudeApiPort || 3333;
+  }
+  if (!port) {
+    port = 3333; // Final fallback
+  }
+
+  console.log(chalk.gray(`Starting API server on port ${port}...`));
+  console.log(chalk.gray('This wraps Claude Code CLI for Pi connections.\n'));
+
+  const projectRoot = getProjectRoot();
+  const serverPath = path.join(projectRoot, 'claude-api-server', 'server.js');
+
+  const spinner = ora('Starting server...').start();
+
+  try {
+    const child = spawn('node', [serverPath], {
+      env: {
+        ...process.env,
+        PORT: port.toString()
+      },
+      stdio: 'inherit'
+    });
+
+    // Save PID
+    savePid('claude-api-server', child.pid);
+
+    spinner.succeed(chalk.green('Server started'));
+    console.log(chalk.bold.cyan(`\n📡 Listening on port ${port}\n`));
+    console.log(chalk.gray('Waiting for Pi connections...'));
+    console.log(chalk.gray('Press Ctrl+C to stop\n'));
+
+    // Handle cleanup on exit
+    const cleanup = () => {
+      removePid('claude-api-server');
+      child.kill();
+      process.exit(0);
+    };
+
+    process.on('SIGINT', cleanup);
+    process.on('SIGTERM', cleanup);
+
+    // Wait for child to exit
+    child.on('exit', (code) => {
+      removePid('claude-api-server');
+      if (code !== 0) {
+        console.log(chalk.red(`\n✗ Server exited with code ${code}\n`));
+        process.exit(code);
+      }
+    });
+
+  } catch (error) {
+    spinner.fail(chalk.red('Failed to start server'));
+    console.error(chalk.red(`Error: ${error.message}\n`));
+    throw error;
+  }
+}

package/cli/lib/commands/backup.js

@@ -0,0 +1,69 @@
+import fs from 'fs';
+import path from 'path';
+import chalk from 'chalk';
+import ora from 'ora';
+import { getConfigPath, getConfigDir } from '../config.js';
+
+/**
+ * Get the backups directory path
+ * @returns {string} Path to ~/.claude-phone/backups
+ */
+function getBackupsDir() {
+  return path.join(getConfigDir(), 'backups');
+}
+
+/**
+ * Backup command - Create timestamped backup of configuration
+ * @returns {Promise<void>}
+ */
+export async function backupCommand() {
+  console.log(chalk.bold.cyan('\n💾 Backing up configuration\n'));
+
+  const configPath = getConfigPath();
+
+  // Check if config exists
+  if (!fs.existsSync(configPath)) {
+    console.log(chalk.yellow('⚠️  No configuration found to backup.'));
+    console.log(chalk.gray('Run "claude-phone setup" to create configuration.\n'));
+    return;
+  }
+
+  // Create backups directory if it doesn't exist
+  const backupsDir = getBackupsDir();
+  if (!fs.existsSync(backupsDir)) {
+    await fs.promises.mkdir(backupsDir, { recursive: true, mode: 0o700 });
+  }
+
+  // Generate timestamp for filename
+  const now = new Date();
+  const timestamp = now.toISOString()
+    .replace(/T/, '.')
+    .replace(/:/g, '')
+    .replace(/\..+/, '');
+  const backupFilename = `config.${timestamp}.json`;
+  const backupPath = path.join(backupsDir, backupFilename);
+
+  // Copy config to backup
+  const spinner = ora('Creating backup...').start();
+  try {
+    await fs.promises.copyFile(configPath, backupPath);
+
+    // Get file size
+    const stats = await fs.promises.stat(backupPath);
+    const sizeMB = (stats.size / 1024).toFixed(2);
+
+    spinner.succeed('Backup created');
+
+    // Count existing backups
+    const backups = await fs.promises.readdir(backupsDir);
+    const configBackups = backups.filter(f => f.startsWith('config.') && f.endsWith('.json'));
+
+    console.log(chalk.bold.green('\n✓ Configuration backed up successfully!\n'));
+    console.log(chalk.gray(`Location: ${backupPath}`));
+    console.log(chalk.gray(`Size: ${sizeMB} KB`));
+    console.log(chalk.gray(`Total backups: ${configBackups.length}\n`));
+  } catch (error) {
+    spinner.fail(`Backup failed: ${error.message}`);
+    throw error;
+  }
+}

package/cli/lib/commands/config/path.js

@@ -0,0 +1,30 @@
+import chalk from 'chalk';
+import { getConfigPath, getConfigDir, configExists } from '../../config.js';
+
+/**
+ * Config path command - Show configuration file location
+ * @returns {Promise<void>}
+ */
+export async function configPathCommand() {
+  console.log(chalk.bold.cyan('\n📂 Configuration Location\n'));
+
+  const configPath = getConfigPath();
+  const configDir = getConfigDir();
+
+  if (!configExists()) {
+    console.log(chalk.red('✗ Configuration not found'));
+    console.log(chalk.gray(`  Expected location: ${configPath}\n`));
+    console.log(chalk.gray('  Run "claude-phone setup" to create configuration\n'));
+    return;
+  }
+
+  console.log(chalk.gray('Config directory:'));
+  console.log(chalk.bold(`  ${configDir}`));
+  console.log();
+  console.log(chalk.gray('Config file:'));
+  console.log(chalk.bold(`  ${configPath}`));
+  console.log();
+
+  console.log(chalk.yellow('⚠️  Warning: This file contains API keys and passwords'));
+  console.log(chalk.gray('  Do not share or commit this file to version control\n'));
+}

package/cli/lib/commands/config/reset.js

@@ -0,0 +1,73 @@
+import fs from 'fs';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { getConfigPath, getConfigDir, configExists } from '../../config.js';
+
+/**
+ * Config reset command - Reset configuration with confirmation and backup
+ * @returns {Promise<void>}
+ */
+export async function configResetCommand() {
+  console.log(chalk.bold.cyan('\n🔄 Reset Configuration\n'));
+
+  // Check if config exists
+  if (!configExists()) {
+    console.log(chalk.yellow('⚠️  No configuration found to reset\n'));
+    return;
+  }
+
+  const configPath = getConfigPath();
+  const configDir = getConfigDir();
+
+  // Confirmation prompt
+  console.log(chalk.yellow('⚠️  This will delete your current configuration:'));
+  console.log(chalk.gray(`  ${configPath}\n`));
+  console.log(chalk.gray('A backup will be created before deletion.\n'));
+
+  const { confirmed } = await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'confirmed',
+      message: 'Are you sure you want to reset?',
+      default: false
+    }
+  ]);
+
+  if (!confirmed) {
+    console.log(chalk.gray('\n✗ Reset cancelled\n'));
+    return;
+  }
+
+  try {
+    // Create backup with timestamp
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const backupPath = `${configPath}.backup-${timestamp}`;
+    await fs.promises.copyFile(configPath, backupPath);
+    console.log(chalk.green(`\n✓ Backup created: ${backupPath}`));
+
+    // Delete config file
+    await fs.promises.unlink(configPath);
+    console.log(chalk.green('✓ Configuration deleted'));
+
+    // Clean up other generated files
+    const filesToClean = [
+      'docker-compose.yml',
+      '.env',
+      'server.pid'
+    ];
+
+    for (const file of filesToClean) {
+      const filePath = `${configDir}/${file}`;
+      if (fs.existsSync(filePath)) {
+        await fs.promises.unlink(filePath);
+        console.log(chalk.gray(`  Removed: ${file}`));
+      }
+    }
+
+    console.log(chalk.bold.green('\n✓ Configuration reset complete'));
+    console.log(chalk.gray('  Run "claude-phone setup" to configure again\n'));
+  } catch (error) {
+    console.log(chalk.red(`\n✗ Reset failed: ${error.message}\n`));
+    throw error;
+  }
+}

package/cli/lib/commands/config/show.js

@@ -0,0 +1,86 @@
+import chalk from 'chalk';
+import { loadConfig, configExists } from '../../config.js';
+
+/**
+ * Redact sensitive values for display
+ * @param {string} value - Value to redact
+ * @returns {string} Redacted value
+ */
+function redactValue(value) {
+  if (!value || typeof value !== 'string') {
+    return '[not set]';
+  }
+
+  // For API keys (typically long strings)
+  if (value.length > 20) {
+    const prefix = value.slice(0, 4);
+    const suffix = value.slice(-4);
+    return `${prefix}...${suffix}`;
+  }
+
+  // For passwords and shorter secrets
+  return '••••••••';
+}
+
+/**
+ * Config show command - Display configuration with redacted secrets
+ * @returns {Promise<void>}
+ */
+export async function configShowCommand() {
+  console.log(chalk.bold.cyan('\n⚙️  Claude Phone Configuration\n'));
+
+  // Check if configured
+  if (!configExists()) {
+    console.log(chalk.red('✗ Configuration not found'));
+    console.log(chalk.gray('  Run "claude-phone setup" first\n'));
+    return;
+  }
+
+  const config = await loadConfig();
+
+  // Speech-to-text / text-to-speech
+  console.log(chalk.bold('STT/TTS:'));
+  if (config.api && config.api.mode === 'local') {
+    console.log(chalk.gray('  Mode: local (no API keys — faster-whisper + Piper)'));
+    console.log(chalk.gray(`  STT URL: ${config.api.local?.sttUrl || 'http://127.0.0.1:9001'}`));
+    console.log(chalk.gray(`  TTS URL: ${config.api.local?.ttsUrl || 'http://127.0.0.1:9002'}`));
+    console.log(chalk.gray(`  Whisper model: ${config.api.local?.whisperModel || 'small'}`));
+  } else {
+    console.log(chalk.gray('  Mode: cloud'));
+    console.log(chalk.gray(`  OpenAI API Key: ${redactValue(config.api?.openai?.apiKey)}`));
+    console.log(chalk.gray(`  ElevenLabs API Key: ${redactValue(config.api?.elevenlabs?.apiKey)}`));
+  }
+
+  // 3CX Configuration
+  console.log(chalk.bold('\n3CX Configuration:'));
+  console.log(chalk.gray(`  SIP Domain: ${config.sip.domain}`));
+  console.log(chalk.gray(`  SIP Registrar: ${config.sip.registrar}`));
+
+  // Server Configuration
+  console.log(chalk.bold('\nServer:'));
+  console.log(chalk.gray(`  External IP: ${config.server.externalIp}`));
+  console.log(chalk.gray(`  Voice App Port: ${config.server.voiceAppPort}`));
+  console.log(chalk.gray(`  Claude API Port: ${config.server.claudeApiPort}`));
+  console.log(chalk.gray(`  Claude API URL: ${config.server.claudeApiUrl}`));
+
+  // Devices
+  console.log(chalk.bold('\nDevices:'));
+  if (config.devices.length === 0) {
+    console.log(chalk.gray('  (none configured)'));
+  } else {
+    for (const device of config.devices) {
+      console.log(chalk.gray(`  • ${device.name} (extension ${device.extension})`));
+      console.log(chalk.gray(`    Auth ID: ${device.authId}`));
+      console.log(chalk.gray(`    Password: ${redactValue(device.password)}`));
+      console.log(chalk.gray(`    Voice ID: ${device.voiceId}`));
+      if (device.prompt) {
+        const shortPrompt = device.prompt.length > 50
+          ? device.prompt.slice(0, 50) + '...'
+          : device.prompt;
+        console.log(chalk.gray(`    Prompt: ${shortPrompt}`));
+      }
+    }
+  }
+
+  console.log(chalk.gray(`\n💡 To view the raw config file, run: claude-phone config path\n`));
+}