aicomputer 0.1.16 → 0.1.17

package/README.md

@@ -95,6 +95,7 @@ computer ssh
 computer ssh my-box
 computer ssh --setup
 computer mount
+computer mount --background
 computer mount status
 computer agent agents my-box
 computer agent sessions list my-box
@@ -117,8 +118,15 @@ ssh agentcomputer.ai
 ssh my-box@agentcomputer.ai
 ```
 
-Run `computer mount` to start a foreground controller that mirrors all SSH-ready
-machine homes under `~/agentcomputer/<handle>` while the command is running.
+Run `computer mount` to start the mount controller in the foreground and mirror
+all SSH-ready machine homes under `~/agentcomputer/<handle>`.
+On macOS, the foreground command also opens Finder to `~/agentcomputer` after
+the controller starts.
+
+Run `computer mount --background` to start the same controller detached from
+your terminal. It prints the controller PID immediately so you can inspect it
+later with `computer mount status`.
+
 This uses the same SSH setup as `computer ssh --setup` and requires Mutagen plus
 OpenSSH client tools (`ssh` and `scp`) to already be installed locally. The
 temporary `~/agentcomputer` root is removed when the command exits.

package/dist/index.js

@@ -2460,7 +2460,7 @@ _computer() {
     'open:Open in browser'
     'ssh:SSH into a computer'
     'ports:Manage published ports'
-    'mount:Mirror SSH-ready machine homes into ~/agentcomputer while running'
+    'mount:Mirror SSH-ready machine homes into ~/agentcomputer'
     'agent:Manage cloud agent sessions'
     'acp:Run a local ACP bridge for remote agent sessions'
     'rm:Delete a computer'
@@ -2600,6 +2600,7 @@ _computer() {
           ;;
         mount)
           _arguments -C \\
+            '--background[Run the mount controller in the background and print its PID]' \\
             '--alias[SSH host alias]:alias:' \\
             '--host[SSH gateway host]:host:' \\
             '--port[SSH gateway port]:port:' \\
@@ -2771,9 +2772,9 @@ var BASH_SCRIPT = `_computer() {
       ;;
     mount)
       if [[ $cword -eq 2 ]]; then
-        COMPREPLY=($(compgen -W "$mount_commands" -- "$cur"))
+        COMPREPLY=($(compgen -W "$mount_commands --background --alias --host --port --poll-interval --connect-timeout" -- "$cur"))
       elif [[ $cword -ge 3 ]]; then
-        COMPREPLY=($(compgen -W "--alias --host --port --poll-interval --connect-timeout" -- "$cur"))
+        COMPREPLY=($(compgen -W "--background --alias --host --port --poll-interval --connect-timeout" -- "$cur"))
       fi
       ;;
     ports)
@@ -3987,7 +3988,8 @@ function printNextStep(machineHandle) {
 }
 
 // src/commands/mount.ts
-import { Command as Command10 } from "commander";
+import { spawn as spawn4 } from "child_process";
+import { Command as Command10, Option } from "commander";
 import chalk8 from "chalk";
 import ora9 from "ora";
 
@@ -4004,7 +4006,8 @@ function getMountControllerState(rootPath = defaultMountServiceConfig().rootPath
   }
   return { running: true, pid: lock.pid };
 }
-async function runMountDaemon(config) {
+async function runMountDaemon(config, options = {}) {
+  const { onStarted } = options;
   const paths = getMountPaths(config.rootPath);
   ensureMountDirectories(paths);
   await mkdir3(paths.rootPath, { recursive: true });
@@ -4018,6 +4021,7 @@ async function runMountDaemon(config) {
     },
     config.rootPath
   );
+  onStarted?.();
   await teardownManagedSessions(config, paths);
   let running = false;
   let queued = false;
@@ -4145,40 +4149,39 @@ function processExists(pid) {
 }
 
 // src/commands/mount.ts
-var mountCommand = new Command10("mount").description("Mirror SSH-ready machines under ~/agentcomputer while this command is running").option("--alias <alias>", "SSH host alias", "agentcomputer.ai").option("--host <host>", "SSH gateway host", "ssh.agentcomputer.ai").option("--port <port>", "SSH gateway port", "443").option("--poll-interval <ms>", "Reconcile interval in milliseconds", "5000").option("--connect-timeout <seconds>", "SSH connect timeout for Mutagen", "5").action(async (options) => {
-  const spinner = ora9("Starting machine mount controller...").start();
+var mountCommand = new Command10("mount").description("Mirror SSH-ready machines under ~/agentcomputer with a local mount controller").option("--alias <alias>", "SSH host alias", "agentcomputer.ai").option("--host <host>", "SSH gateway host", "ssh.agentcomputer.ai").option("--port <port>", "SSH gateway port", "443").option("--poll-interval <ms>", "Reconcile interval in milliseconds", "5000").option("--connect-timeout <seconds>", "SSH connect timeout for Mutagen", "5").option(
+  "--background",
+  "Run the mount controller in the background and print its PID"
+).addOption(new Option("--daemonized").hideHelp()).action(async (options) => {
+  const spinner = ora9(
+    options.background ? "Starting machine mount controller in background..." : "Starting machine mount controller..."
+  ).start();
   try {
-    const issues = getMountHostValidationIssues();
-    if (issues.length > 0) {
-      throw new Error(
-        [
-          ...issues.map((issue) => issue.message),
-          ...formatMountHostInstallGuidance(issues)
-        ].join("\n")
-      );
+    if (options.daemonized) {
+      const config2 = readMountConfig() ?? defaultMountServiceConfig();
+      await runMountDaemon(config2, {
+        onStarted: () => {
+          spinner.succeed("Machine mount controller running");
+          printMountStartSummary(config2, process.pid, "foreground");
+        }
+      });
+      return;
     }
-    const sshSetup = await ensureSSHAccessConfigured(options);
-    const config = {
-      ...defaultMountServiceConfig(),
-      alias: sshSetup.alias,
-      host: sshSetup.host,
-      port: sshSetup.port,
-      pollIntervalMs: parsePositiveInt(options.pollInterval, "poll interval"),
-      connectTimeoutSeconds: parsePositiveInt(
-        options.connectTimeout,
-        "connect timeout"
-      )
-    };
+    const config = await resolveMountServiceConfig(options);
     writeMountConfig(config);
-    spinner.succeed("Machine mount controller running");
-    console.log();
-    console.log(chalk8.dim(`  Root:        ${config.rootPath}`));
-    console.log(chalk8.dim(`  SSH alias:   ${config.alias}`));
-    console.log(chalk8.dim(`  Poll:        ${config.pollIntervalMs}ms`));
-    console.log();
-    console.log(chalk8.dim("  Press Ctrl-C to stop syncing."));
-    console.log();
-    await runMountDaemon(config);
+    if (options.background) {
+      const pid = await startMountControllerInBackground(config.rootPath);
+      spinner.succeed("Machine mount controller running in background");
+      printMountStartSummary(config, pid, "background");
+      return;
+    }
+    await runMountDaemon(config, {
+      onStarted: () => {
+        spinner.succeed("Machine mount controller running");
+        printMountStartSummary(config, process.pid, "foreground");
+        revealMountRootInFinder(config.rootPath);
+      }
+    });
   } catch (error) {
     spinner.fail(
       error instanceof Error ? error.message : "Failed to start machine mount controller"
@@ -4210,7 +4213,7 @@ var mountCommand = new Command10("mount").description("Mirror SSH-ready machines
     if (controller.running && snapshot?.mounts.length) {
       console.log();
       for (const mount of snapshot.mounts) {
-        const state = mount.state === "mounted" ? chalk8.green(mount.state) : mount.state === "reconnecting" ? chalk8.cyan(mount.state) : mount.state === "degraded" ? chalk8.yellow(mount.state) : mount.state === "pending" ? chalk8.yellow(mount.state) : chalk8.red(mount.state);
+        const state = formatMountState(mount.state);
         console.log(`  ${chalk8.white(mount.handle)}  ${state}  ${chalk8.dim(mount.mountPath)}`);
         if (mount.message) {
           console.log(`  ${chalk8.dim(mount.message)}`);
@@ -4231,6 +4234,115 @@ function parsePositiveInt(raw, label) {
   }
   return Math.round(value);
 }
+async function resolveMountServiceConfig(options) {
+  const issues = getMountHostValidationIssues();
+  if (issues.length > 0) {
+    throw new Error(
+      [
+        ...issues.map((issue) => issue.message),
+        ...formatMountHostInstallGuidance(issues)
+      ].join("\n")
+    );
+  }
+  const sshSetup = await ensureSSHAccessConfigured(options);
+  return {
+    ...defaultMountServiceConfig(),
+    alias: sshSetup.alias,
+    host: sshSetup.host,
+    port: sshSetup.port,
+    pollIntervalMs: parsePositiveInt(options.pollInterval, "poll interval"),
+    connectTimeoutSeconds: parsePositiveInt(
+      options.connectTimeout,
+      "connect timeout"
+    )
+  };
+}
+async function startMountControllerInBackground(rootPath) {
+  const controller = getMountControllerState(rootPath);
+  if (controller.running) {
+    throw new Error(`computer mount is already running (pid ${controller.pid})`);
+  }
+  const entrypoint = process.argv[1];
+  if (!entrypoint) {
+    throw new Error("unable to determine CLI entrypoint for background mount");
+  }
+  const child = spawn4(process.execPath, [entrypoint, "mount", "--daemonized"], {
+    cwd: process.cwd(),
+    detached: true,
+    env: process.env,
+    stdio: "ignore"
+  });
+  if (!child.pid) {
+    throw new Error("failed to start machine mount controller in background");
+  }
+  child.unref();
+  await waitForBackgroundMountController(rootPath, child.pid);
+  return child.pid;
+}
+async function waitForBackgroundMountController(rootPath, pid) {
+  const deadline = Date.now() + 3e3;
+  while (Date.now() < deadline) {
+    const controller = getMountControllerState(rootPath);
+    if (controller.running && controller.pid === pid) {
+      return;
+    }
+    if (!processExists2(pid)) {
+      break;
+    }
+    await new Promise((resolve) => setTimeout(resolve, 50));
+  }
+  throw new Error("failed to start machine mount controller in background");
+}
+function printMountStartSummary(config, pid, mode) {
+  console.log();
+  console.log(chalk8.dim(`  PID:         ${pid}`));
+  console.log(chalk8.dim(`  Root:        ${config.rootPath}`));
+  console.log(chalk8.dim(`  SSH alias:   ${config.alias}`));
+  console.log(chalk8.dim(`  Poll:        ${config.pollIntervalMs}ms`));
+  console.log();
+  console.log(
+    chalk8.dim(
+      mode === "background" ? "  Use `computer mount status` to inspect sync state." : "  Press Ctrl-C to stop syncing."
+    )
+  );
+  console.log();
+}
+function processExists2(pid) {
+  if (!Number.isInteger(pid) || pid <= 0) {
+    return false;
+  }
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function revealMountRootInFinder(rootPath) {
+  if (process.platform !== "darwin") {
+    return;
+  }
+  const child = spawn4("open", [rootPath], {
+    stdio: "ignore",
+    detached: true
+  });
+  child.on("error", () => {
+  });
+  child.unref();
+}
+function formatMountState(state) {
+  switch (state) {
+    case "mounted":
+      return chalk8.green(state);
+    case "reconnecting":
+      return chalk8.cyan(state);
+    case "degraded":
+    case "pending":
+      return chalk8.yellow(state);
+    default:
+      return chalk8.red(state);
+  }
+}
 
 // src/commands/logout.ts
 import { Command as Command11 } from "commander";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aicomputer",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "description": "Computer CLI - manage your Agent Computer machines from the terminal",
   "homepage": "https://agentcomputer.ai",
   "repository": {