tryharness 0.1.0 → 0.3.0

package/README.md

@@ -7,13 +7,16 @@ npx tryharness
 ```
 
 Prints a short code — approve it in Harness (Settings, Connections, Connect a machine).
-Then it sets up everything it finds on this machine: memory access for your coding
-agents (Claude Code, Codex), automatic session sharing with a one-time history import,
-and the bridge that lets Harness send tasks to your agents (Claude Code, pi, opencode).
+Then it sets up everything it finds on this machine: memory access, automatic sharing
+for new sessions, accurate connection status, and task delegation for Claude Code,
+Codex, pi, and opencode. Setup does not import old history, so it finishes quickly.
 
 Other commands: `npx tryharness bridge` (start the task bridge again),
-`npx tryharness backfill` (re-import recent Claude Code sessions),
+`npx tryharness sync --agent all` (explicitly import existing sessions),
 `npx tryharness drain` (retry session reports that missed).
 
+Use `npx tryharness --agent codex` (or another agent name) to connect only one
+installed agent. Plain `npx tryharness` connects all detected agents.
+
 No tokens to copy: approval releases the credential directly to the waiting command.
 Everything your agents share stays between your machine and your browser.

package/cli.mjs

@@ -1,20 +1,24 @@
 #!/usr/bin/env node
 // tryharness: thin bootstrap. The real logic lives on the Harness server and is fetched
 // fresh on every run, so this package never needs republishing to pick up improvements
-// (a cached copy in ~/.harness runs when offline). Commands:
+// (a cached copy in ~/.harness runs when offline). Works on Node 18+ — when the runtime
+// lacks a built-in WebSocket (added in Node 22), the bundled `ws` package fills it in,
+// which is why scripts run IN-PROCESS here instead of being spawned. Commands:
 //   npx tryharness            pair this machine + set up every detected agent
+//   npx tryharness --agent codex   set up only one detected agent
 //   npx tryharness bridge     start the task bridge (after pairing)
-//   npx tryharness backfill   re-import recent Claude Code sessions
+//   npx tryharness sync       explicitly import existing agent sessions
 //   npx tryharness drain      retry any session reports that missed
 import fs from "node:fs";
 import path from "node:path";
 import os from "node:os";
-import { spawn } from "node:child_process";
+import { pathToFileURL } from "node:url";
 
 const HARNESS_DIR = path.join(os.homedir(), ".harness");
 const COMMANDS = {
   connect: { file: "connect.mjs", args: [] },
   bridge: { file: "bridge.mjs", args: [] },
+  sync: { file: "report-session.mjs", args: ["--backfill"] },
   backfill: { file: "report-session.mjs", args: ["--backfill"] },
   drain: { file: "report-session.mjs", args: ["--drain"] },
 };
@@ -23,7 +27,7 @@ const argv = process.argv.slice(2);
 const sub = argv[0] && !argv[0].startsWith("-") ? argv.shift() : "connect";
 const command = COMMANDS[sub];
 if (!command) {
-  console.error("unknown command: " + sub + " (try: connect | bridge | backfill | drain)");
+  console.error("unknown command: " + sub + " (try: connect | bridge | sync | drain)");
   process.exit(1);
 }
 
@@ -39,7 +43,9 @@ const origin = (originIndex !== -1 && argv[originIndex + 1] ? argv[originIndex +
 const dest = path.join(HARNESS_DIR, command.file);
 fs.mkdirSync(HARNESS_DIR, { recursive: true });
 try {
-  const res = await fetch(origin + "/" + command.file);
+  // 15s cap: a fetch that dials the server mid-restart can otherwise hang forever
+  // with zero output. On timeout the cached copy runs, same as any other fetch failure.
+  const res = await fetch(origin + "/" + command.file, { signal: AbortSignal.timeout(15000) });
   if (!res.ok) throw new Error("HTTP " + res.status);
   fs.writeFileSync(dest, await res.text());
 } catch (error) {
@@ -50,5 +56,14 @@ try {
   console.error("could not refresh from " + origin + " - running the cached copy");
 }
 
-const child = spawn(process.execPath, [dest, ...command.args, ...argv], { stdio: "inherit" });
-child.on("close", (code) => process.exit(code ?? 0));
+// Older LTS Node (18/20): provide WebSocket from the bundled `ws` package so the bridge
+// works everywhere npx does.
+if (typeof globalThis.WebSocket === "undefined") {
+  const { WebSocket } = await import("ws");
+  globalThis.WebSocket = WebSocket;
+}
+
+// Run the script in-process (so the polyfill above applies), with argv shaped exactly
+// as a direct `node <script> <args>` run would see it.
+process.argv = [process.argv[0], dest, ...command.args, ...argv];
+await import(pathToFileURL(dest).href);

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "tryharness",
-  "version": "0.1.0",
-  "description": "Connect this machine to Harness: pair with a code, link your coding agents (Claude Code, Codex, opencode, pi), share session history, and accept delegated tasks.",
+  "version": "0.3.0",
+  "description": "Connect Claude Code, Codex, opencode, and pi to Harness memory, session history, status, and delegated tasks.",
   "bin": {
     "tryharness": "cli.mjs"
   },
   "type": "module",
   "engines": {
-    "node": ">=20"
+    "node": ">=18"
   },
   "files": [
     "cli.mjs",
@@ -16,8 +16,14 @@
   "keywords": [
     "harness",
     "coding-agents",
-    "claude-code"
+    "claude-code",
+    "codex",
+    "opencode",
+    "pi"
   ],
   "homepage": "https://tryharness.ai",
-  "license": "MIT"
+  "license": "MIT",
+  "dependencies": {
+    "ws": "^8.18.0"
+  }
 }