npm install @elizaos/daemon

import { installAgentService, isServiceRunning, stopService } from "@elizaos/daemon";

// Install an Eliza agent as a background service
await installAgentService({
  name: "my-eliza-agent",
  description: "My Eliza Agent",
  entryPoint: "/path/to/agent/index.js",
  workingDirectory: "/path/to/agent",
});

// Check if running
const running = await isServiceRunning("my-eliza-agent");
console.log(`Agent running: ${running}`);

// Stop the service
await stopService("my-eliza-agent");

// Install a service
installService(config: ServiceConfig): Promise<ServiceResult>

// Uninstall a service
uninstallService(name: string): Promise<ServiceResult>

// Start/stop/restart
startService(name: string): Promise<ServiceResult>
stopService(name: string): Promise<ServiceResult>
restartService(name: string): Promise<ServiceResult>

// Check status
isServiceInstalled(name: string): Promise<boolean>
isServiceRunning(name: string): Promise<boolean>
getServiceRuntime(name: string): Promise<ServiceRuntime>

interface ServiceConfig {
  /** Unique service name/identifier */
  name: string;
  /** Human-readable description */
  description?: string;
  /** Command to execute (first element is the executable) */
  command: string[];
  /** Working directory for the service */
  workingDirectory?: string;
  /** Environment variables */
  environment?: Record<string, string>;
  /** Auto-restart on failure (default: true) */
  restartOnFailure?: boolean;
  /** Restart delay in seconds (default: 5) */
  restartDelay?: number;
  /** Keep alive - restart if process exits (default: true) */
  keepAlive?: boolean;
  /** Run at system load/boot (default: true) */
  runAtLoad?: boolean;
}

import { launchdManager, systemdManager, schtasksManager } from "@elizaos/daemon";

// Use macOS-specific features
if (process.platform === "darwin") {
  const runtime = await launchdManager.getRuntime("my-service");
  console.log("Plist path:", runtime.platformInfo?.plistPath);
}