claude-remote-cli 0.2.0 → 0.3.0

package/README.md

@@ -34,16 +34,49 @@ Tested on **macOS** and **Linux**. Windows is not currently tested — file watc
 ## CLI Usage
 
 ```
-claude-remote-cli [options]
+Usage: claude-remote-cli [options]
+       claude-remote-cli <command>
+
+Commands:
+  install            Install as a background service (survives reboot)
+  uninstall          Stop and remove the background service
+  status             Show whether the service is running
 
 Options:
+  --bg               Shortcut: install and start as background service
   --port <port>      Override server port (default: 3456)
   --host <host>      Override bind address (default: 0.0.0.0)
-  --config <path>    Path to config.json
+  --config <path>    Path to config.json (default: ~/.config/claude-remote-cli/config.json)
   --version, -v      Show version
   --help, -h         Show this help
 ```
 
+## Background Service
+
+Run as a persistent service that starts on login and restarts on crash:
+
+```bash
+claude-remote-cli --bg
+```
+
+Or with custom options:
+
+```bash
+claude-remote-cli install --port 4000
+```
+
+Manage the service:
+
+```bash
+claude-remote-cli status      # Check if running
+claude-remote-cli uninstall   # Stop and remove
+```
+
+- **macOS**: Uses launchd (`~/Library/LaunchAgents/`)
+- **Linux**: Uses systemd user units (`~/.config/systemd/user/`)
+- **Logs (macOS)**: `~/.config/claude-remote-cli/logs/`
+- **Logs (Linux)**: `journalctl --user -u claude-remote-cli -f`
+
 ## Configuration
 
 Config is stored at `~/.config/claude-remote-cli/config.json` (created on first run).

package/bin/claude-remote-cli.js

@@ -9,8 +9,15 @@ const args = process.argv.slice(2);
 
 if (args.includes('--help') || args.includes('-h')) {
   console.log(`Usage: claude-remote-cli [options]
+       claude-remote-cli <command>
+
+Commands:
+  install            Install as a background service (survives reboot)
+  uninstall          Stop and remove the background service
+  status             Show whether the service is running
 
 Options:
+  --bg               Shortcut: install and start as background service
   --port <port>      Override server port (default: 3456)
   --host <host>      Override bind address (default: 0.0.0.0)
   --config <path>    Path to config.json (default: ~/.config/claude-remote-cli/config.json)
@@ -31,12 +38,54 @@ function getArg(flag) {
   return args[idx + 1];
 }
 
-// Determine config directory
-const configDir = getArg('--config')
-  ? path.dirname(getArg('--config'))
-  : path.join(process.env.HOME || process.env.USERPROFILE || '~', '.config', 'claude-remote-cli');
+function resolveConfigPath() {
+  const explicit = getArg('--config');
+  if (explicit) return explicit;
+  const { CONFIG_DIR } = require('../server/service');
+  return path.join(CONFIG_DIR, 'config.json');
+}
+
+function runServiceCommand(fn) {
+  try {
+    fn();
+  } catch (e) {
+    console.error(e.message);
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
+const command = args[0];
+if (command === 'install' || command === 'uninstall' || command === 'status' || args.includes('--bg')) {
+  const service = require('../server/service');
+
+  if (command === 'uninstall') {
+    runServiceCommand(function () { service.uninstall(); });
+  } else if (command === 'status') {
+    runServiceCommand(function () {
+      const st = service.status();
+      if (!st.installed) {
+        console.log('Service is not installed.');
+      } else if (st.running) {
+        console.log('Service is installed and running.');
+      } else {
+        console.log('Service is installed but not running.');
+      }
+    });
+  } else {
+    runServiceCommand(function () {
+      const { DEFAULTS } = require('../server/config');
+      service.install({
+        configPath: resolveConfigPath(),
+        port: getArg('--port') || String(DEFAULTS.port),
+        host: getArg('--host') || DEFAULTS.host,
+      });
+    });
+  }
+}
 
-const configPath = getArg('--config') || path.join(configDir, 'config.json');
+const configPath = resolveConfigPath();
+const configDir = path.dirname(configPath);
 
 // Ensure config directory exists
 if (!fs.existsSync(configDir)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-remote-cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Remote web interface for Claude Code CLI sessions",
   "main": "server/index.js",
   "bin": {

package/server/service.js

@@ -0,0 +1,181 @@
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+const { DEFAULTS } = require('./config');
+
+const SERVICE_LABEL = 'com.claude-remote-cli';
+const HOME = process.env.HOME || process.env.USERPROFILE || '~';
+const CONFIG_DIR = path.join(HOME, '.config', 'claude-remote-cli');
+
+function getPlatform() {
+  if (process.platform === 'darwin') return 'macos';
+  if (process.platform === 'linux') return 'linux';
+  throw new Error('Unsupported platform: ' + process.platform + '. Only macOS and Linux are supported.');
+}
+
+function getServicePaths() {
+  const platform = getPlatform();
+  if (platform === 'macos') {
+    return {
+      servicePath: path.join(HOME, 'Library', 'LaunchAgents', SERVICE_LABEL + '.plist'),
+      logDir: path.join(CONFIG_DIR, 'logs'),
+      label: SERVICE_LABEL,
+    };
+  }
+  return {
+    servicePath: path.join(HOME, '.config', 'systemd', 'user', 'claude-remote-cli.service'),
+    logDir: null,
+    label: 'claude-remote-cli',
+  };
+}
+
+function generateServiceFile(platform, opts) {
+  const { nodePath, scriptPath, configPath, port, host, logDir } = opts;
+
+  if (platform === 'macos') {
+    return `<?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>${SERVICE_LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${nodePath}</string>
+    <string>${scriptPath}</string>
+    <string>--config</string>
+    <string>${configPath}</string>
+    <string>--port</string>
+    <string>${port}</string>
+    <string>--host</string>
+    <string>${host}</string>
+  </array>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${path.join(logDir, 'stdout.log')}</string>
+  <key>StandardErrorPath</key>
+  <string>${path.join(logDir, 'stderr.log')}</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key>
+    <string>${process.env.PATH}</string>
+  </dict>
+</dict>
+</plist>`;
+  }
+
+  return `[Unit]
+Description=Claude Remote CLI
+After=network.target
+
+[Service]
+Type=simple
+ExecStart=${nodePath} ${scriptPath} --config ${configPath} --port ${port} --host ${host}
+Restart=on-failure
+RestartSec=5
+Environment=PATH=${process.env.PATH}
+
+[Install]
+WantedBy=default.target`;
+}
+
+function isInstalled() {
+  const { servicePath } = getServicePaths();
+  return fs.existsSync(servicePath);
+}
+
+function install(opts) {
+  const platform = getPlatform();
+  const { servicePath, logDir } = getServicePaths();
+
+  if (isInstalled()) {
+    throw new Error('Service is already installed. Run `claude-remote-cli uninstall` first.');
+  }
+
+  const nodePath = process.execPath;
+  const scriptPath = path.resolve(__dirname, '..', 'bin', 'claude-remote-cli.js');
+  const configPath = opts.configPath || path.join(CONFIG_DIR, 'config.json');
+  const port = opts.port || String(DEFAULTS.port);
+  const host = opts.host || DEFAULTS.host;
+
+  const content = generateServiceFile(platform, { nodePath, scriptPath, configPath, port, host, logDir });
+
+  fs.mkdirSync(path.dirname(servicePath), { recursive: true });
+  if (logDir) fs.mkdirSync(logDir, { recursive: true });
+
+  fs.writeFileSync(servicePath, content, 'utf8');
+
+  if (platform === 'macos') {
+    execSync('launchctl load -w ' + servicePath, { stdio: 'inherit' });
+  } else {
+    execSync('systemctl --user daemon-reload', { stdio: 'inherit' });
+    execSync('systemctl --user enable --now claude-remote-cli', { stdio: 'inherit' });
+  }
+
+  console.log('Service installed and started.');
+  if (logDir) {
+    console.log('Logs: ' + logDir);
+  } else {
+    console.log('Logs: journalctl --user -u claude-remote-cli -f');
+  }
+}
+
+function uninstall() {
+  const platform = getPlatform();
+  const { servicePath } = getServicePaths();
+
+  if (!isInstalled()) {
+    throw new Error('Service is not installed.');
+  }
+
+  if (platform === 'macos') {
+    try {
+      execSync('launchctl unload ' + servicePath, { stdio: 'inherit' });
+    } catch (_) {
+      // Ignore errors from already-unloaded services
+    }
+  } else {
+    try {
+      execSync('systemctl --user disable --now claude-remote-cli', { stdio: 'inherit' });
+    } catch (_) {
+      // Ignore errors from already-disabled services
+    }
+  }
+
+  fs.unlinkSync(servicePath);
+  console.log('Service uninstalled.');
+}
+
+function status() {
+  const platform = getPlatform();
+
+  if (!isInstalled()) {
+    return { installed: false, running: false };
+  }
+
+  const running = checkRunning(platform);
+  return { installed: true, running };
+}
+
+function checkRunning(platform) {
+  if (platform === 'macos') {
+    try {
+      const out = execSync('launchctl list ' + SERVICE_LABEL, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] });
+      return !out.includes('"LastExitStatus" = -1');
+    } catch (_) {
+      return false;
+    }
+  }
+
+  try {
+    execSync('systemctl --user is-active claude-remote-cli', { stdio: ['pipe', 'pipe', 'pipe'] });
+    return true;
+  } catch (_) {
+    return false;
+  }
+}
+
+module.exports = { getPlatform, getServicePaths, generateServiceFile, isInstalled, install, uninstall, status, SERVICE_LABEL, CONFIG_DIR };