tryharness 0.7.1 → 0.7.3

package/cli.mjs

@@ -11,6 +11,7 @@ import { paths } from "./lib/paths.mjs";
 import { currentRuntime, installRuntime } from "./lib/runtime-install.mjs";
 import { ensureModel, modelPresent } from "./lib/embedder.mjs";
 import { installService, serviceInfo, uninstallService } from "./lib/service.mjs";
+import { canShowDesktop, desktopSource, desktopTarget, installDesktop, openDesktop, retireDesktop } from "./lib/desktop.mjs";
 
 const SOURCE_ROOT = path.dirname(fileURLToPath(import.meta.url));
 const PACKAGE = readJson(path.join(SOURCE_ROOT, "package.json"), { version: "0.4.3" });
@@ -158,6 +159,7 @@ async function connect() {
   const service = installService({ runtimeRoot });
   const ready = await waitForDaemon();
   console.log(`daemon: ready via ${service.manager} and connected to Harness`);
+  if (!has("--no-desktop")) desktop();
   // The context space's embedder lives with the daemon and comes down with setup, so the machine
   // can search a task by meaning before the first task exists. About 110 MB, once.
   try {
@@ -175,6 +177,23 @@ async function connect() {
   console.log("Done. You can close this terminal.");
 }
 
+// The desktop app: installed from this machine's platform package and opened. Never fatal; the
+// daemon works without it.
+function desktop() {
+  if (!canShowDesktop({})) { console.log("desktop: skipped (no screen on this login)"); return false; }
+  const source = desktopSource({ sourceRoot: SOURCE_ROOT });
+  if (!source) { console.log(`desktop: no app for ${process.platform} ${process.arch} yet`); return false; }
+  try {
+    const { target, updated } = installDesktop({ source, target: desktopTarget({ source }) });
+    openDesktop({ target });
+    console.log(`desktop: ${updated ? "installed and opened" : "opened"}. The Harness mark is at the top right of your screen; it starts when you log in.`);
+    return true;
+  } catch (error) {
+    console.log(`desktop: not opened (${error.message})`);
+    return false;
+  }
+}
+
 async function status() {
   const fallback = readJson(paths.status, null);
   let current;
@@ -522,6 +541,7 @@ function logs() {
 
 async function disconnect() {
   uninstallService();
+  retireDesktop({});
   try { await daemonRequest({ command: "shutdown" }, 2_000); } catch {}
   removeAgentConfigurations();
   try { fs.renameSync(paths.config, paths.config + `.disconnected-${Date.now()}`); } catch {}
@@ -530,11 +550,11 @@ async function disconnect() {
 }
 
 function help() {
-  console.log(`tryharness ${VERSION}\n\nCommands:\n  tryharness                 set up everything and start the daemon\n  tryharness status          show daemon, bridge, agent, and index health\n  tryharness doctor          diagnose the complete connection\n  tryharness sync [--agent]  rescan local coding history in the background\n  tryharness task <id> --follow\n                             follow a delegated agent run in this terminal\n  tryharness board [--all]   list open work on the machine's task board\n  tryharness board post --for <agent> --objective <text> [--file <brief.md>]\n  tryharness board show <id>\n  tryharness board post --for codex --objective <text> --run --workspace <dir>\n                             the daemon runs it and reports back on the task\n  tryharness board run <id>  authorize a run an agent asked for\n  tryharness board release <id>\n  tryharness board agents    when each agent last read the board\n  tryharness board --watch   follow the board in this terminal\n  tryharness notify on|off   desktop notifications for what waits on you\n  tryharness board send <task> <message>   send a held reply to another person's agent\n  tryharness board auto <task> on|off      auto-send replies on that thread\n  tryharness board end <task> --outcome <text>\n  tryharness board context <task> <query>  search everything written about a task\n  tryharness goal set --objective <text> [--team a,b] [--workspace <dir>]   a goal your agents work together in one room\n  tryharness goal [list | show <id> | stop <id> | resume <id>]\n  tryharness room <goal> | room post <goal> <text>\n  tryharness connect <handle/agent> --about <text>   ask another person's agent to work an issue with yours\n  tryharness mcp grok-bot    print the MCP snippet that puts Grok Bot on the board\n  tryharness logs [--follow]\n  tryharness disconnect\n`);
+  console.log(`tryharness ${VERSION}\n\nCommands:\n  tryharness                 set up everything and start the daemon\n  tryharness desktop         open the Harness desktop app (setup opens it too; --no-desktop skips it)\n  tryharness status          show daemon, bridge, agent, and index health\n  tryharness doctor          diagnose the complete connection\n  tryharness sync [--agent]  rescan local coding history in the background\n  tryharness task <id> --follow\n                             follow a delegated agent run in this terminal\n  tryharness board [--all]   list open work on the machine's task board\n  tryharness board post --for <agent> --objective <text> [--file <brief.md>]\n  tryharness board show <id>\n  tryharness board post --for codex --objective <text> --run --workspace <dir>\n                             the daemon runs it and reports back on the task\n  tryharness board run <id>  authorize a run an agent asked for\n  tryharness board release <id>\n  tryharness board agents    when each agent last read the board\n  tryharness board --watch   follow the board in this terminal\n  tryharness notify on|off   desktop notifications for what waits on you\n  tryharness board send <task> <message>   send a held reply to another person's agent\n  tryharness board auto <task> on|off      auto-send replies on that thread\n  tryharness board end <task> --outcome <text>\n  tryharness board context <task> <query>  search everything written about a task\n  tryharness goal set --objective <text> [--team a,b] [--workspace <dir>]   a goal your agents work together in one room\n  tryharness goal [list | show <id> | stop <id> | resume <id>]\n  tryharness room <goal> | room post <goal> <text>\n  tryharness connect <handle/agent> --about <text>   ask another person's agent to work an issue with yours\n  tryharness mcp grok-bot    print the MCP snippet that puts Grok Bot on the board\n  tryharness logs [--follow]\n  tryharness disconnect\n`);
 }
 
 try {
-  if (command === "setup" || (command === "connect" && !argv[0])) await connect();
+  if (command === "setup" || (command === "connect" && (!argv[0] || argv[0].startsWith("-")))) await connect();
   else if (command === "status" || command === "bridge") await status();
   else if (command === "doctor") await doctor();
   else if (command === "sync" || command === "backfill" || command === "drain") await sync();
@@ -545,6 +565,7 @@ try {
   else if (command === "mcp") await mcpSnippet();
   else if (command === "notify") await notify();
   else if (command === "connect") await connectAgent();
+  else if (command === "desktop") { if (!desktop()) process.exitCode = 1; }
   else if (command === "logs") logs();
   else if (command === "disconnect") await disconnect();
   else if (command === "daemon") { const { startDaemon } = await import("./lib/daemon.mjs"); await startDaemon(); }

package/lib/desktop.mjs

@@ -0,0 +1,105 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { spawn } from "node:child_process";
+import { createRequire } from "node:module";
+import { run } from "./commands.mjs";
+import { ensureDir, readJson, writeJsonAtomic } from "./files.mjs";
+import { paths } from "./paths.mjs";
+
+// The desktop app ships as one optional npm package per platform (tryharness-desktop-<os>-<cpu>),
+// so `npx tryharness` brings the build for this machine and nothing else. Setup copies it out of
+// npm's temporary cache to a place it keeps, opens it, and the app registers itself to start at
+// login from there.
+
+const marker = () => path.join(paths.home, "desktop.json");
+
+export function desktopPackageName(platform = process.platform, arch = process.arch) {
+  return `tryharness-desktop-${platform}-${arch}`;
+}
+
+/** The app inside this machine's platform package, or null when there is none for it. */
+export function desktopSource({ sourceRoot, env = process.env, platform = process.platform, arch = process.arch }) {
+  if (env.HARNESS_DESKTOP_APP) return { app: path.resolve(env.HARNESS_DESKTOP_APP), version: env.HARNESS_DESKTOP_VERSION || "dev" };
+  let packageJson;
+  try { packageJson = createRequire(path.join(sourceRoot, "package.json")).resolve(`${desktopPackageName(platform, arch)}/package.json`); }
+  catch { return null; }
+  const meta = readJson(packageJson, {});
+  const app = path.join(path.dirname(packageJson), String(meta.harnessDesktop || ""));
+  return meta.harnessDesktop && fs.existsSync(app) ? { app, version: String(meta.version) } : null;
+}
+
+/** Where the app is kept. On a Mac that is ~/Applications, so Spotlight and Launchpad find it. */
+export function desktopTarget({ source, env = process.env, platform = process.platform, homeDir = os.homedir() }) {
+  const file = path.basename(source.app);
+  if (platform === "darwin" && !env.HARNESS_HOME) return path.join(homeDir, "Applications", file);
+  return path.join(paths.home, "desktop", file);
+}
+
+function executables(target, platform) {
+  if (platform === "darwin") {
+    const dir = path.join(target, "Contents", "MacOS");
+    return fs.existsSync(dir) ? fs.readdirSync(dir).map((name) => path.join(dir, name)) : [];
+  }
+  return [target];
+}
+
+export function quitDesktop({ target, platform = process.platform, execute = run }) {
+  if (platform === "win32") { execute("taskkill", ["/F", "/IM", path.basename(target)]); return; }
+  const exes = executables(target, platform);
+  for (const exe of exes) execute("pkill", ["-f", exe]);
+  // Opening it again before the old one has gone fails on macOS (LaunchServices error -600).
+  for (let i = 0; i < 50 && exes.some((exe) => execute("pgrep", ["-f", exe]).ok); i++) {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 100);
+  }
+}
+
+/** Copies the app into place unless this version is already there. Returns where it is. */
+export function installDesktop({ source, target, platform = process.platform, execute = run }) {
+  const installed = readJson(marker(), {});
+  if (installed.version === source.version && installed.path === target && fs.existsSync(target)) return { target, updated: false };
+  // Replacing a running app's files under it is how it crashes; it is quit first and reopened after.
+  if (fs.existsSync(target)) quitDesktop({ target, platform, execute });
+  ensureDir(path.dirname(target));
+  const staging = `${target}.staging-${process.pid}`;
+  fs.rmSync(staging, { recursive: true, force: true });
+  fs.cpSync(source.app, staging, { recursive: true, verbatimSymlinks: true });
+  // npm does not promise to keep a file's executable bit.
+  for (const exe of executables(staging, platform)) fs.chmodSync(exe, 0o755);
+  fs.rmSync(target, { recursive: true, force: true });
+  fs.renameSync(staging, target);
+  writeJsonAtomic(marker(), { version: source.version, path: target });
+  return { target, updated: true };
+}
+
+/** Whether this login can show a window at all: not a server reached over SSH. */
+export function canShowDesktop({ env = process.env, platform = process.platform }) {
+  if (platform === "linux") return Boolean(env.DISPLAY || env.WAYLAND_DISPLAY);
+  return platform === "darwin" || platform === "win32";
+}
+
+export function openDesktop({ target, platform = process.platform, execute = run }) {
+  if (platform === "darwin") {
+    // Just after the old copy quits, LaunchServices can still refuse (error -600) for a moment.
+    let opened = execute("open", [target]);
+    for (let i = 0; i < 20 && !opened.ok && /-600/.test(opened.stderr); i++) {
+      Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 250);
+      opened = execute("open", [target]);
+    }
+    if (!opened.ok) throw new Error(opened.stderr.trim() || opened.error || "open failed");
+    return;
+  }
+  const child = spawn(target, [], { detached: true, stdio: "ignore" });
+  child.on("error", () => {});
+  child.unref();
+}
+
+/** Disconnecting stops the app and takes it out of login items; the app itself stays. */
+export function retireDesktop({ platform = process.platform, execute = run, homeDir = os.homedir() }) {
+  const installed = readJson(marker(), {});
+  if (installed.path) quitDesktop({ target: installed.path, platform, execute });
+  // Where the app's own login item lives (tauri-plugin-autostart, named after the product).
+  if (platform === "darwin") fs.rmSync(path.join(homeDir, "Library", "LaunchAgents", "Harness.plist"), { force: true });
+  else if (platform === "linux") fs.rmSync(path.join(homeDir, ".config", "autostart", "Harness.desktop"), { force: true });
+  else if (platform === "win32") execute("reg", ["delete", "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Run", "/v", "Harness", "/f"]);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tryharness",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "description": "Harness Relay: the daemon that turns the agents on this machine into your personal swarm. Memory, history, and work handed between any of them.",
   "bin": {
     "tryharness": "cli.mjs"
@@ -33,5 +33,11 @@
     "ws": "^8.18.3",
     "@huggingface/tokenizers": "^0.1.3",
     "onnxruntime-web": "1.26.0-dev.20260416-b7804b056c"
+  },
+  "optionalDependencies": {
+    "tryharness-desktop-darwin-arm64": "0.7.3",
+    "tryharness-desktop-darwin-x64": "0.7.3",
+    "tryharness-desktop-linux-x64": "0.7.3",
+    "tryharness-desktop-win32-x64": "0.7.3"
   }
 }