hatchee 0.1.0 → 0.1.2

package/dist/cli.mjs

@@ -12165,8 +12165,171 @@ async function runHook(hookPort) {
   process.exit(0);
 }
 
+// src/service.ts
+import { homedir as homedir3 } from "node:os";
+import { join as join3, dirname } from "node:path";
+import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync3, copyFileSync, chmodSync, existsSync as existsSync3, rmSync } from "node:fs";
+import { execFileSync } from "node:child_process";
+var HOME = homedir3();
+var HATCHEE_DIR = join3(HOME, ".hatchee");
+var BIN_DIR = join3(HATCHEE_DIR, "bin");
+var STABLE_BIN = join3(BIN_DIR, "hatchee.mjs");
+var LOG = join3(HATCHEE_DIR, "daemon.log");
+var LABEL = "cloud.hatchee.daemon";
+var PLIST = join3(HOME, "Library", "LaunchAgents", `${LABEL}.plist`);
+var UNIT = join3(HOME, ".config", "systemd", "user", "hatchee.service");
+function servicePath(node) {
+  return [
+    dirname(node),
+    join3(HOME, ".bun/bin"),
+    join3(HOME, ".npm-global/bin"),
+    join3(HOME, ".local/bin"),
+    "/opt/homebrew/bin",
+    "/usr/local/bin",
+    "/usr/bin",
+    "/bin",
+    "/usr/sbin",
+    "/sbin"
+  ].join(":");
+}
+function copyStableBin() {
+  mkdirSync3(BIN_DIR, { recursive: true });
+  const src = process.argv[1];
+  if (src && src !== STABLE_BIN) {
+    copyFileSync(src, STABLE_BIN);
+    chmodSync(STABLE_BIN, 493);
+  }
+}
+function plistContent(node, bin) {
+  const args = [node, bin, "up"].map((s) => `    <string>${s}</string>`).join(`
+`);
+  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>${LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+${args}
+  </array>
+  <key>RunAtLoad</key><true/>
+  <key>KeepAlive</key><true/>
+  <key>ThrottleInterval</key><integer>10</integer>
+  <key>StandardOutPath</key><string>${LOG}</string>
+  <key>StandardErrorPath</key><string>${LOG}</string>
+  <key>EnvironmentVariables</key>
+  <dict><key>PATH</key><string>${servicePath(node)}</string></dict>
+</dict>
+</plist>
+`;
+}
+function unitContent(node, bin) {
+  return `[Unit]
+Description=Hatchee — watch & approve your coding agents from your phone
+After=network-online.target
+
+[Service]
+ExecStart=${node} ${bin} up
+Restart=always
+RestartSec=10
+Environment=PATH=${servicePath(node)}
+
+[Install]
+WantedBy=default.target
+`;
+}
+function run(cmd, args) {
+  try {
+    execFileSync(cmd, args, { stdio: "pipe" });
+  } catch (e) {
+    console.log(`  · ${cmd} ${args.join(" ")} → ${String(e?.stderr || e?.message || e).trim().slice(0, 200)}`);
+  }
+}
+function installService(print = false) {
+  const node = process.execPath;
+  if (process.platform === "darwin") {
+    const content = plistContent(node, STABLE_BIN);
+    if (print) {
+      console.log(`
+  would write ${PLIST}:
+
+${content}
+  bundle → ${STABLE_BIN}
+  load → launchctl bootstrap gui/$(id -u) ${PLIST}
+`);
+      return;
+    }
+    copyStableBin();
+    mkdirSync3(dirname(PLIST), { recursive: true });
+    writeFileSync3(PLIST, content);
+    const uid = String(process.getuid?.() ?? "");
+    run("launchctl", ["bootout", `gui/${uid}/${LABEL}`]);
+    run("launchctl", ["bootstrap", `gui/${uid}`, PLIST]);
+    run("launchctl", ["enable", `gui/${uid}/${LABEL}`]);
+    console.log(`
+  ✓ Hatchee will now run in the background (launchd: ${LABEL})`);
+    console.log(`    logs    ${LOG}`);
+    console.log(`    pair    npx hatchee pair        (one terminal, once — to add a phone)`);
+    console.log(`    stop    npx hatchee uninstall-service`);
+    console.log(`
+  Don't also run \`hatchee up\` manually — the service is the single instance.
+`);
+    return;
+  }
+  if (process.platform === "linux") {
+    const content = unitContent(node, STABLE_BIN);
+    if (print) {
+      console.log(`
+  would write ${UNIT}:
+
+${content}
+  bundle → ${STABLE_BIN}
+  enable → systemctl --user enable --now hatchee.service (+ loginctl enable-linger)
+`);
+      return;
+    }
+    copyStableBin();
+    mkdirSync3(dirname(UNIT), { recursive: true });
+    writeFileSync3(UNIT, content);
+    run("systemctl", ["--user", "daemon-reload"]);
+    run("systemctl", ["--user", "enable", "--now", "hatchee.service"]);
+    run("loginctl", ["enable-linger", process.env.USER ?? ""]);
+    console.log(`
+  ✓ Hatchee will now run in the background (systemd --user: hatchee.service)`);
+    console.log(`    logs    journalctl --user -u hatchee.service -f`);
+    console.log(`    pair    npx hatchee pair`);
+    console.log(`    stop    npx hatchee uninstall-service
+`);
+    return;
+  }
+  console.log(`
+  Auto-start service isn't supported on ${process.platform} yet.`);
+  console.log(`  Run \`npx hatchee up\` in a terminal you keep open (or use WSL on Windows).
+`);
+}
+function uninstallService() {
+  if (process.platform === "darwin") {
+    const uid = String(process.getuid?.() ?? "");
+    run("launchctl", ["bootout", `gui/${uid}/${LABEL}`]);
+    if (existsSync3(PLIST))
+      rmSync(PLIST);
+    console.log(`  ✓ background service removed (launchd: ${LABEL})`);
+  } else if (process.platform === "linux") {
+    run("systemctl", ["--user", "disable", "--now", "hatchee.service"]);
+    if (existsSync3(UNIT)) {
+      rmSync(UNIT);
+      run("systemctl", ["--user", "daemon-reload"]);
+    }
+    console.log(`  ✓ background service removed (systemd --user: hatchee.service)`);
+  } else {
+    console.log(`  no background service on ${process.platform}.`);
+  }
+  if (existsSync3(STABLE_BIN))
+    rmSync(STABLE_BIN);
+}
+
 // src/cli.ts
-var VERSION2 = "0.1.0";
+var VERSION2 = "0.1.2";
 var cmd = process.argv[2] ?? "help";
 switch (cmd) {
   case "up": {
@@ -12192,6 +12355,7 @@ switch (cmd) {
     }
     console.log(`
   watching for Claude Code sessions\u2026 (run \`claude\` anywhere)`);
+    tips();
     break;
   }
   case "pair": {
@@ -12227,6 +12391,7 @@ switch (cmd) {
       console.log(`  code          ${code}   (valid 5 minutes, single use)
 `);
       console.log(`  keeping the daemon running after pairing\u2026 (^C to stop)`);
+      tips();
     });
     break;
   }
@@ -12257,6 +12422,12 @@ switch (cmd) {
     console.log(`revoked ${dev.name}`);
     break;
   }
+  case "install-service":
+    installService(process.argv[3] === "--print" || process.argv[3] === "--dry-run");
+    break;
+  case "uninstall-service":
+    uninstallService();
+    break;
   case "uninstall-hooks":
     uninstallHooks();
     console.log("hatchee hooks removed from ~/.claude/settings.json");
@@ -12269,18 +12440,36 @@ switch (cmd) {
   default:
     banner();
     console.log(`  usage:
-    hatchee up               start the daemon (installs Claude Code hooks)
-    hatchee pair             start + open a 5-minute pairing window (QR + code)
-    hatchee devices          list paired phones
-    hatchee revoke <id>      revoke a lost phone
-    hatchee uninstall-hooks  remove our hooks from ~/.claude/settings.json
-    hatchee version`);
+    hatchee pair              pair a phone \u2014 prints a QR + 6-digit code (do this first)
+    hatchee up                start watching (no new pairing) \u2014 installs Claude Code hooks
+    hatchee install-service   run in the background across logins/reboots (recommended)
+    hatchee uninstall-service stop running in the background
+    hatchee devices           list paired phones
+    hatchee revoke <id>       revoke a lost phone
+    hatchee uninstall-hooks   remove Hatchee's hooks from ~/.claude/settings.json
+    hatchee version
+
+  keep it on    npx hatchee install-service   (so it survives closing the terminal)
+  update        npx hatchee@latest pair       (npx always fetches the newest)
+  uninstall     npx hatchee uninstall-service && npx hatchee uninstall-hooks && rm -rf ~/.hatchee
+  config        ~/.hatchee/config.json        (your daemon identity + paired devices)`);
 }
 function banner() {
   console.log(`
   \uD83D\uDC23 hatchee ${VERSION2} \u2014 your coding agents, alive on your lock screen
 `);
 }
+function tips() {
+  console.log(`
+  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+   keep it on  npx hatchee install-service   (survives closing the terminal / reboot)
+   stop        ^C   (your coding agents keep running \u2014 you just stop watching)
+   update      npx hatchee@latest pair
+   uninstall   npx hatchee uninstall-service && npx hatchee uninstall-hooks
+               rm -rf ~/.hatchee              (also wipes pairing + identity)
+   help        npx hatchee
+  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`);
+}
 function safeListen(daemon) {
   try {
     daemon.listen((err) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hatchee",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Your coding agents, alive on your iPhone lock screen — Hatchee daemon. Approve Claude Code / Codex from your phone.",
   "type": "module",
   "bin": { "hatchee": "dist/cli.mjs" },