@dashup/connector 0.1.1 → 0.1.3

package/README.md

@@ -5,8 +5,7 @@ Run beside the editor on each computer, including the PC whose Zed window connec
 With Node 24:
 
 ```sh
-npm install -g @dashup/connector
-dashup pair
+npx @dashup/connector pair
 ```
 
 From a checkout, use pnpm 10.34.5 from the workspace root and `pnpm --filter @dashup/connector dashup` in place of `dashup`:
@@ -18,7 +17,7 @@ pnpm exec turbo build --filter=@dashup/connector...
 
 The published package bundles the workspace code, and CI publishes it when the package version is new. Screen and input need the native helper from `packages/desktop`, which the package does not include.
 
-`dashup pair` prints a QR code that expires in five minutes, then keeps the connector running; scan it in the phone app under Pair a computer. The first phone adds the computer to its account, so the terminal names that account and shares nothing until you answer `y`. Later codes pair more phones on the same account without asking, including through a connector that is already running. A phone that scans an expired code gets a pairing the computer revokes, because it never kept that key. It uses `https://api.dashup.com`; for a local API, add `--api http://localhost:3000`. A physical phone needs a reachable HTTPS API. After restarting the connector, use `dashup watch`.
+`dashup pair` walks through pairing in the terminal: it shows a QR code that expires in five minutes, waits for a phone to scan it under Pair a computer, and offers to keep Dashup running in the background. The first phone adds the computer to its account, so the walkthrough names that account and shares nothing until you confirm it. Later codes pair more phones on the same account without asking, including through a connector that is already running. A phone that scans an expired code gets a pairing the computer revokes, because it never kept that key. Pairing needs a terminal: without one, an unpaired computer exits and says so. It uses `https://api.dashup.com`; for a local API, add `--api http://localhost:3000`. A physical phone needs a reachable HTTPS API. To run a paired connector in the foreground, use `dashup watch`.
 
 ## Existing projects and alerts
 
@@ -30,7 +29,7 @@ pnpm --filter @dashup/connector dashup alert --project PROJECT_ID --title "Dashu
 
 The connector automatically reads existing Claude Code, Codex, and OpenCode conversations alongside Zed workspaces and VS Code chat history. It honors the harness's existing data directory, authentication, and native session IDs. Native stores are opened read-only; discovery never launches an agent, creates or resumes a conversation, or changes editor settings. Opening the same supported harness session through Zed and its native history uses one Dashup thread when their actual session identities match. Matching directory names alone never merges local and SSH projects.
 
-A thread's time is its last conversation message in the agent's own history; editor bookkeeping such as Zed's sidebar restamps never moves it. Subagent sessions (OpenCode children, Codex spawned agents) carry their parent thread. Tool calls are joined with their results into one step with status, duration and, for file edits, a unified diff. Saved history has unknown live status and read-only controls. File changes publish project metadata and can produce a rate-limited “updated” alert. A workspace becomes a project once it has a conversation. After a scan that read every source, the connector publishes its list of projects, which retires any project it published earlier and left off. Each phone read request reads a thread's native history once and publishes a snapshot of separately encrypted message fragments to the database. The phone reads bounded latest and earlier pages; realtime thread updates carry only summary and approval metadata. Native history remains the source, and an incomplete upload never replaces the previous published snapshot. Native live interfaces provide actual status and pending choices. Tool integrations can also queue explicit encrypted alerts with `alert`.
+A thread's time is its last conversation message in the agent's own history; editor bookkeeping such as Zed's sidebar restamps never moves it. Subagent sessions (OpenCode children, Codex spawned agents) carry their parent thread. Tool calls are joined with their results into one step with status, duration and, for file edits, a unified diff. Saved history has unknown live status and read-only controls. File changes publish project metadata; only an approval, a question, an error or a finished turn sends an alert. A workspace becomes a project once it has a conversation. After every change the connector publishes its overview: every project, and the conversations Home shows (anything that needs the person or is working, then the newest 20). The phone renders Home from the overview alone and decodes a project's full snapshot only when a page opens it. Only a scan that read every source retires a project it published earlier and left off. Each phone read request reads a thread's native history once and publishes a snapshot of separately encrypted message fragments to the database. The phone reads bounded latest and earlier pages; realtime thread updates carry only summary and approval metadata. Native history remains the source, and an incomplete upload never replaces the previous published snapshot. Native live interfaces provide actual status and pending choices. Tool integrations can also queue explicit encrypted alerts with `alert`.
 
 Project paths, SSH details, thread content, approvals, and alerts are encrypted separately for every paired phone. The encrypted outbox survives a connector restart. Parcae handles realtime delivery and reconnect; replay counters are saved before commands execute. Revoking a pairing stops its viewer and discards its connector key and queued content.
 
@@ -89,16 +88,9 @@ macOS requires Screen Recording and Accessibility permission. Windows uses the s
 
 ## Start at login
 
-After pairing, stop the foreground connector and install the built entry point:
+Answering yes to the walkthrough's background question, or running `dashup install` on a paired computer, registers a macOS LaunchAgent, Windows Startup entry, or Linux user systemd service and starts it, taking over from any connector already running for that state file. The service runs `watch` with the state file it was paired with (`DASHUP_CONFIG`). Linux requires a user systemd session. Under npx or pnpm dlx, whose caches can be cleared, the service runs a copy of that install kept in `app/` beside the state file; a checkout or global install runs in place. The Node executable must stay at its installed location. Signed desktop installers are not included.
 
-```sh
-node apps/connector/dist/index.js stop
-node apps/connector/dist/index.js install
-```
-
-Installation registers a macOS LaunchAgent, Windows Startup entry, or Linux user systemd service. Linux requires a user systemd session. These source startup paths require the checkout and Node executable to remain at their installed locations. Signed desktop installers are not included.
-
-Remove startup with `launchctl unload ~/Library/LaunchAgents/com.dashup.connector.plist` and delete that file on macOS; delete `%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\Dashup.vbs` on Windows; or run `systemctl --user disable --now dashup.service` and delete `~/.config/systemd/user/dashup.service` on Linux. A macOS KeepAlive job restarts after `stop`; unload it when stopping the service.
+Remove startup with `launchctl unload ~/Library/LaunchAgents/com.dashup.connector.plist` and delete that file on macOS; delete `%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\Dashup.vbs` on Windows; or run `systemctl --user disable --now dashup.service` and delete `~/.config/systemd/user/dashup.service` on Linux. `dashup stop` leaves the service stopped until the next sign-in; a crash restarts it.
 
 ## Local state and checks
 

package/dist/index.js

@@ -42,7 +42,7 @@ var require_XMLHttpRequest = __commonJS({
     "use strict";
     var fs = __require("fs");
     var Url = __require("url");
-    var spawn4 = __require("child_process").spawn;
+    var spawn5 = __require("child_process").spawn;
     module.exports = XMLHttpRequest3;
     XMLHttpRequest3.XMLHttpRequest = XMLHttpRequest3;
     function XMLHttpRequest3(opts) {
@@ -338,7 +338,7 @@ var require_XMLHttpRequest = __commonJS({
           var syncFile = ".node-xmlhttprequest-sync-" + process.pid;
           fs.writeFileSync(syncFile, "", "utf8");
           var execString = "var http = require('http'), https = require('https'), fs = require('fs');var doRequest = http" + (ssl ? "s" : "") + ".request;var options = " + JSON.stringify(options) + ";var responseText = '';var responseData = Buffer.alloc(0);var req = doRequest(options, function(response) {response.on('data', function(chunk) {  var data = Buffer.from(chunk);  responseText += data.toString('utf8');  responseData = Buffer.concat([responseData, data]);});response.on('end', function() {fs.writeFileSync('" + contentFile + "', JSON.stringify({err: null, data: {statusCode: response.statusCode, headers: response.headers, text: responseText, data: responseData.toString('base64')}}), 'utf8');fs.unlinkSync('" + syncFile + "');});response.on('error', function(error) {fs.writeFileSync('" + contentFile + "', 'NODE-XMLHTTPREQUEST-ERROR:' + JSON.stringify(error), 'utf8');fs.unlinkSync('" + syncFile + "');});}).on('error', function(error) {fs.writeFileSync('" + contentFile + "', 'NODE-XMLHTTPREQUEST-ERROR:' + JSON.stringify(error), 'utf8');fs.unlinkSync('" + syncFile + "');});" + (data ? "req.write('" + JSON.stringify(data).slice(1, -1).replace(/'/g, "\\'") + "');" : "") + "req.end();";
-          var syncProc = spawn4(process.argv[0], ["-e", execString]);
+          var syncProc = spawn5(process.argv[0], ["-e", execString]);
           var statusText;
           while (fs.existsSync(syncFile)) {
           }
@@ -1028,7 +1028,7 @@ var require_node = __commonJS({
     var tty = __require("tty");
     var util = __require("util");
     exports.init = init;
-    exports.log = log2;
+    exports.log = log4;
     exports.formatArgs = formatArgs;
     exports.save = save;
     exports.load = load;
@@ -1163,7 +1163,7 @@ var require_node = __commonJS({
       }
       return (/* @__PURE__ */ new Date()).toISOString() + " ";
     }
-    function log2(...args2) {
+    function log4(...args2) {
       return process.stderr.write(util.formatWithOptions(exports.inspectOpts, ...args2) + "\n");
     }
     function save(namespaces) {
@@ -2707,6 +2707,7 @@ var require_pluralize = __commonJS({
 // src/index.ts
 import { randomBytes as randomBytes5, timingSafeEqual } from "node:crypto";
 import { createServer } from "node:http";
+import * as ui2 from "@clack/prompts";
 import { z as z3 } from "zod";
 
 // ../../packages/protocol/src/index.ts
@@ -4004,61 +4005,84 @@ async function proxyAcp(config2, executable, args2) {
 // src/pair.ts
 import { hostname } from "node:os";
 import { randomBytes as randomBytes2, createHash as createHash2 } from "node:crypto";
-import { createInterface as createInterface2 } from "node:readline/promises";
 import QRCode from "qrcode";
+import * as ui from "@clack/prompts";
 import { z } from "zod";
+
+// package.json
+var version = "0.1.3";
+
+// src/pair.ts
 var Invitation = z.object({
   code: z.string().regex(/^[a-f0-9]{16}$/),
   key: z.string().regex(/^[a-f0-9]{64}$/),
   text: z.string().min(1)
 }).strict();
+var interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY);
+var intro2 = () => ui.intro(`Dashup ${version}`);
 function invitation(config2, secret = config2.secret) {
   const code = randomBytes2(8).toString("hex");
   const key = newSecret(randomBytes2);
   const computer = createHash2("sha256").update(secret).digest("hex");
   return { code, key, text: formatPairingCode({ api: config2.api, computer, code, key }) };
 }
-async function scanned(config2, { code, text: text3 }, secret = config2.secret) {
+async function scanned(config2, { code, text: text3 }, done, secret = config2.secret) {
   const qr = await QRCode.toString(text3, {
     type: "terminal",
     small: true,
     errorCorrectionLevel: "L"
   });
-  process.stdout.write(
-    `
+  const rows = qr.split("\n").filter((row) => row.replace(/\x1b\[\d+m/g, ""));
+  if (interactive) {
+    ui.log.step("Scan this in the Dashup app under Pair a computer. It expires in 5 minutes.");
+    ui.log.message("Can't scan? Paste this code instead:", { spacing: 0 });
+    process.stdout.write(`   ${text3}
+`);
+    ui.log.message(rows);
+  } else {
+    process.stdout.write(
+      `
 Pairing code: ${text3}
 
-${qr}
+${rows.join("\n")}
 Scan this in the Dashup app (Pair a computer). It expires in 5 minutes.
 `
-  );
-  for (const deadline = Date.now() + PAIRING_TTL_MS; Date.now() < deadline; ) {
-    await new Promise((resolve3) => setTimeout(resolve3, 1e3));
-    const response = await fetch(`${config2.api}/v1/dashup/pairings?code=${code}`, {
-      headers: { Authorization: `Bearer ${secret}` }
-    });
-    if (response.status === 401 || response.status === 404) continue;
-    const value2 = await response.json();
-    if (!response.ok || !value2.success)
-      throw new Error(value2.error ?? `Dashup request failed (${response.status})`);
-    return value2.result;
-  }
-  throw new Error("The pairing code expired. Run dashup pair for a new one.");
-}
-async function confirm(question) {
-  const prompt = createInterface2({ input: process.stdin, output: process.stdout });
-  const answer = await new Promise((resolve3) => {
-    prompt.once("close", () => resolve3(""));
-    prompt.once("SIGINT", () => prompt.close());
-    prompt.question(question).then(resolve3, () => resolve3(""));
-  });
-  prompt.close();
-  return /^y(es)?$/i.test(answer.trim());
+    );
+  }
+  const waiting = interactive ? ui.spinner() : void 0;
+  waiting?.start("Waiting for your phone");
+  try {
+    for (const deadline = Date.now() + PAIRING_TTL_MS; Date.now() < deadline; ) {
+      await new Promise((resolve3) => setTimeout(resolve3, 1e3));
+      const response = await fetch(`${config2.api}/v1/dashup/pairings?code=${code}`, {
+        headers: { Authorization: `Bearer ${secret}` }
+      });
+      if (response.status === 401 || response.status === 404) continue;
+      const value2 = await response.json();
+      if (!response.ok || !value2.success)
+        throw new Error(value2.error ?? `Dashup request failed (${response.status})`);
+      if (waiting) waiting.stop(done(value2.result.email));
+      else process.stdout.write(`${done(value2.result.email)}.
+`);
+      return value2.result;
+    }
+    throw new Error("The pairing code expired. Run dashup pair for a new one.");
+  } catch (error) {
+    if (!waiting) throw error;
+    waiting.error(error instanceof Error ? error.message : "Pairing failed");
+    throw Object.assign(error, { reported: true });
+  }
 }
+var reported = (error) => error?.reported === true;
 async function link(config2) {
   const secret = newSecret(randomBytes2);
   const invite = invitation(config2, secret);
-  const { pairing, email } = await scanned(config2, invite, secret);
+  const { pairing, email } = await scanned(
+    config2,
+    invite,
+    (account) => `Scanned by ${account}`,
+    secret
+  );
   const linked = { ...config2, secret };
   const platform = process.platform === "win32" ? "windows" : process.platform === "darwin" ? "macos" : "linux";
   const { device } = await api(linked, "/dashup/devices", {
@@ -4067,11 +4091,15 @@ async function link(config2) {
     kind: "desktop",
     platform
   });
-  if (!await confirm(`
-${email} scanned the code. Pair this computer with that account? (y/N) `)) {
+  const confirmed = await ui.confirm({
+    message: `Pair this computer with ${email}?`,
+    initialValue: false
+  });
+  if (confirmed !== true) {
     await api(linked, `/dashup/pairings/${pairing.id}`, void 0, "DELETE").catch(() => {
     });
-    throw new Error("Pairing cancelled. Nothing was shared.");
+    ui.cancel("Pairing cancelled. Nothing was shared.");
+    return false;
   }
   Object.assign(config2, {
     secret,
@@ -4082,12 +4110,13 @@ ${email} scanned the code. Pair this computer with that account? (y/N) `)) {
     unconfirmed: {}
   });
   saveConfig(config2);
+  return true;
 }
 
 // src/viewer.ts
 import { existsSync as existsSync2 } from "node:fs";
 import { fileURLToPath } from "node:url";
-import { createInterface as createInterface3 } from "node:readline";
+import { createInterface as createInterface2 } from "node:readline";
 import { spawn as spawn2 } from "node:child_process";
 
 // src/screen.ts
@@ -4268,7 +4297,7 @@ var Viewer = class _Viewer {
       const child = spawn2(DESKTOP_BIN, [], { stdio: ["pipe", "pipe", "pipe"], windowsHide: true });
       this.process = child;
       let events = Promise.resolve();
-      createInterface3({ input: child.stdout }).on("error", () => this.failed(child)).on("line", (line) => {
+      createInterface2({ input: child.stdout }).on("error", () => this.failed(child)).on("line", (line) => {
         events = events.then(() => {
           if (this.process === child) return this.receive(line);
         }).catch(() => {
@@ -5947,7 +5976,7 @@ var Polling = class extends Transport {
    */
   pause(onPause) {
     this.readyState = "pausing";
-    const pause = () => {
+    const pause2 = () => {
       debug2("paused");
       this.readyState = "paused";
       onPause();
@@ -5959,7 +5988,7 @@ var Polling = class extends Transport {
         total++;
         this.once("pollComplete", function() {
           debug2("pre-pause polling complete");
-          --total || pause();
+          --total || pause2();
         });
       }
       if (!this.writable) {
@@ -5967,11 +5996,11 @@ var Polling = class extends Transport {
         total++;
         this.once("drain", function() {
           debug2("pre-pause writing complete");
-          --total || pause();
+          --total || pause2();
         });
       }
     } else {
-      pause();
+      pause2();
     }
   }
   /**
@@ -15035,14 +15064,14 @@ var Model = class _Model extends import_index2.default {
         continue;
       }
       const pathStart = op.path.indexOf("/", 1);
-      const relative = {
+      const relative2 = {
         ...op,
         path: op.path.slice(pathStart),
         ...from ? { from: from.slice(from.indexOf("/", 1)) } : {}
       };
       const grouped = refOps.get(segments[0]);
-      if (grouped) grouped.push(relative);
-      else refOps.set(segments[0], [relative]);
+      if (grouped) grouped.push(relative2);
+      else refOps.set(segments[0], [relative2]);
     }
     let didRefChange = false;
     const changedRefOps = [];
@@ -15217,7 +15246,7 @@ function prefix(ansi) {
   const code = codes[ansi] ?? "";
   return [`${code}${tag}\x1B[0m`];
 }
-var log = {
+var log2 = {
   warn: (...args2) => isDev && console.warn(...prefix("#fb3"), ...args2),
   error: (...args2) => isDev && console.error(...prefix("#f44"), ...args2),
   debug: (...args2) => isDev && console.debug(...prefix("#888"), ...args2)
@@ -15257,7 +15286,7 @@ var SessionMachine = class {
     this.state.status = nextStatus;
     this.state.userId = userId;
     this.state.version++;
-    log.debug(
+    log2.debug(
       userId ? `session: authenticated ${userId}` : "session: anonymous"
     );
     this._fireReady();
@@ -15272,7 +15301,7 @@ var SessionMachine = class {
     this.state.status = "terminated";
     this.state.userId = null;
     this.state.version++;
-    log.debug("session: terminated");
+    log2.debug("session: terminated");
     this._fireReady();
     this._notify();
   }
@@ -15324,7 +15353,7 @@ var ConnectionMachine = class {
     this.state.status = status2;
     this.state.lastError = err2;
     this.state.version++;
-    log.debug(
+    log2.debug(
       `connection: ${status2}${err2 ? ` (${err2.message})` : ""}`
     );
     for (const fn of this._listeners) fn();
@@ -15454,7 +15483,7 @@ var SocketTransport = class extends import_index2.default {
           this.helloState = "resolved";
           const userId = response.userId ?? null;
           const ms = (performance.now() - t0).toFixed(0);
-          log.debug(
+          log2.debug(
             `hello: ${userId ? `userId=${userId}` : "anonymous"} (${ms}ms)`
           );
           this.session.resolve(userId);
@@ -15465,7 +15494,7 @@ var SocketTransport = class extends import_index2.default {
       },
       (err2) => {
         const error = err2 instanceof Error ? err2 : new Error(String(err2));
-        log.warn(`hello: token resolution failed (${error.message})`);
+        log2.warn(`hello: token resolution failed (${error.message})`);
         this._rejectHandshake(generation, error);
       }
     );
@@ -15685,12 +15714,12 @@ var SocketTransport = class extends import_index2.default {
     const t0 = performance.now();
     const fullPath = `/${this.version}${path}`;
     const timeoutMs = options?.timeout ?? DEFAULT_TIMEOUT;
-    log.debug(`\u2192 ${method.toUpperCase()} ${fullPath}`);
+    log2.debug(`\u2192 ${method.toUpperCase()} ${fullPath}`);
     return new Promise((resolve3, reject) => {
       const timeout = setTimeout(() => {
         this.socket.off(id);
         this.pendingCalls.delete(id);
-        log.debug(
+        log2.debug(
           `\u2717 ${method.toUpperCase()} ${fullPath} timeout (${(timeoutMs / 1e3).toFixed(0)}s)`
         );
         reject(new Error(`RPC timeout: ${method} ${path}`));
@@ -15704,10 +15733,10 @@ var SocketTransport = class extends import_index2.default {
           const uncompressed = pako.ungzip(msg, { to: "string" });
           const parsed = (0, import_compress_json.decompress)(JSON.parse(uncompressed));
           if (parsed.success) {
-            log.debug(`\u2190 ${method.toUpperCase()} ${fullPath} (${ms}ms)`);
+            log2.debug(`\u2190 ${method.toUpperCase()} ${fullPath} (${ms}ms)`);
             resolve3(parsed.result);
           } else {
-            log.debug(
+            log2.debug(
               `\u2717 ${method.toUpperCase()} ${fullPath} (${ms}ms) ${parsed.error || parsed.message}`
             );
             const details = parsed.error && typeof parsed.error === "object" ? parsed.error : parsed;
@@ -15723,7 +15752,7 @@ var SocketTransport = class extends import_index2.default {
             reject(error);
           }
         } catch (err2) {
-          log.debug(
+          log2.debug(
             `\u2717 ${method.toUpperCase()} ${fullPath} (${ms}ms) parse error`
           );
           reject(err2);
@@ -16187,7 +16216,6 @@ var Device = class extends Model {
   name = "";
   kind = "desktop";
   platform = "linux";
-  lastSeenAt = /* @__PURE__ */ new Date();
   pushToken = "";
   pushProvider = "";
   // A computer signs in with the secret this hashes; phones sign in with an account session.
@@ -16344,11 +16372,6 @@ import { connect } from "node:net";
 import { randomUUID as randomUUID2 } from "node:crypto";
 import { join as join4, isAbsolute as isAbsolute2 } from "node:path";
 import { stat, readdir, readFile } from "node:fs/promises";
-
-// package.json
-var version = "0.1.1";
-
-// src/harness/codex.ts
 var REQUEST_MS = 4e3;
 var MAX_BYTES = 8 * 1024 * 1024;
 var MAX_SESSIONS = 100;
@@ -18079,7 +18102,7 @@ var NativeQueue = class {
 
 // src/connector.ts
 var EPHEMERAL_TTL_MS = 6e4;
-var HISTORY_ALERT_INTERVAL_MS = 6e4;
+var HOME_RECENT = 20;
 var Command = z2.object({
   type: z2.literal("command"),
   requestId: z2.string().min(1),
@@ -18153,9 +18176,10 @@ var Connector = class {
   releases = [];
   announced = /* @__PURE__ */ new Set();
   listed = /* @__PURE__ */ new Map();
+  listedProjects = /* @__PURE__ */ new Map();
+  overviewQueued = false;
   snapshots = /* @__PURE__ */ new Set();
   nativeSnapshots = /* @__PURE__ */ new Map();
-  updatedAlerts = /* @__PURE__ */ new Map();
   queueReceipts = /* @__PURE__ */ new Map();
   // The content key behind each pairing code on show, until a phone pairs with it.
   invitations = /* @__PURE__ */ new Map();
@@ -18321,6 +18345,7 @@ var Connector = class {
       );
     this.config.outbox.push(envelope);
     saveConfig(this.config);
+    if (content.type === "project" || content.type === "thread-state") this.refreshOverview();
     await this.flush();
   }
   discardLegacySnapshots() {
@@ -18360,13 +18385,48 @@ var Connector = class {
       await this.send(pair, { type: "project", project });
     await this.listProjects(pair);
   }
-  // Only a scan that read every source can tell which projects are gone.
+  // The phone renders Home from this alone; it opens a project's full snapshot only on demand.
+  overview() {
+    const projects = [...this.discovery.projects.values()];
+    const sessions = projects.flatMap((project) => project.threads.map((thread) => ({
+      projectId: project.id,
+      thread,
+      approvals: this.threadState(project, thread).approvals
+    }))).sort((a, b) => b.thread.updatedAt.localeCompare(a.thread.updatedAt));
+    const busy = ({ thread, approvals }) => approvals.length > 0 || thread.status === "attention" || thread.status === "working";
+    if (!this.discovery.warnings.length) this.listedProjects.clear();
+    for (const { threads, ...project } of projects) {
+      const started = threads.filter((thread) => !thread.parent);
+      this.listedProjects.set(project.id, {
+        ...project,
+        active: started.reduce((newest, thread) => thread.updatedAt > newest ? thread.updatedAt : newest, ""),
+        started: started.length
+      });
+    }
+    return {
+      type: "projects",
+      projects: [...this.listedProjects.values()],
+      sessions: [
+        ...sessions.filter(busy),
+        ...sessions.filter((session) => !busy(session) && !session.thread.parent).slice(0, HOME_RECENT)
+      ]
+    };
+  }
   async listProjects(pair) {
-    const ids = [...this.discovery.projects.keys()].sort();
-    const list2 = JSON.stringify(ids);
-    if (this.discovery.warnings.length || this.listed.get(pair.id) === list2) return;
-    await this.send(pair, { type: "projects", ids });
-    this.listed.set(pair.id, list2);
+    const overview = this.overview();
+    const text3 = JSON.stringify(overview);
+    if (this.listed.get(pair.id) === text3) return;
+    await this.send(pair, overview);
+    this.listed.set(pair.id, text3);
+  }
+  // Each change of a project or thread brings the overview up to date once it settles.
+  refreshOverview() {
+    if (this.overviewQueued) return;
+    this.overviewQueued = true;
+    this.work = this.work.then(async () => {
+      this.overviewQueued = false;
+      for (const pair of this.activePairs()) await this.listProjects(pair);
+    }).catch((error) => this.report(error));
   }
   queueChange() {
     const run5 = this.work.then(() => this.changed());
@@ -18408,26 +18468,9 @@ var Connector = class {
     this.stopWatching();
     this.stopWatching = this.discovery.watch(this.rescan);
     for (const project of projects) {
-      const old = previous.get(project.id);
-      if (JSON.stringify(old) === JSON.stringify(project)) continue;
+      if (JSON.stringify(previous.get(project.id)) === JSON.stringify(project)) continue;
       for (const pair of this.activePairs()) await this.send(pair, { type: "project", project });
-      for (const thread of project.threads) {
-        const before = old?.threads.find((item) => item.id === thread.id);
-        if (before && before.updatedAt !== thread.updatedAt && !this.discovery.locations.get(thread.id)?.live && !this.attached(thread)) {
-          const last = this.updatedAlerts.get(thread.id) ?? 0;
-          if (Date.now() - last < HISTORY_ALERT_INTERVAL_MS) continue;
-          this.updatedAlerts.set(thread.id, Date.now());
-          await this.attention(
-            project.id,
-            thread.id,
-            thread.title,
-            "The existing thread was updated.",
-            "updated"
-          );
-        }
-      }
     }
-    for (const pair of this.activePairs()) await this.listProjects(pair);
     for (const { project, thread, session } of live) {
       const snapshot = this.threadState(project, thread);
       const prior = this.nativeSnapshots.get(thread.id);
@@ -18446,6 +18489,7 @@ var Connector = class {
           "complete"
         );
     }
+    for (const pair of this.activePairs()) await this.listProjects(pair);
     await this.publishQueueReceipts();
   }
   refreshQueues() {
@@ -18745,63 +18789,81 @@ var Connector = class {
 };
 
 // src/install.ts
+import { existsSync as existsSync6 } from "node:fs";
 import { homedir as homedir6 } from "node:os";
-import { dirname as dirname5, join as join8 } from "node:path";
-import { fileURLToPath as fileURLToPath3 } from "node:url";
 import { promisify as promisify4 } from "node:util";
-import { execFile as execFile4 } from "node:child_process";
-import { mkdir, writeFile } from "node:fs/promises";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
+import { execFile as execFile4, spawn as spawn4 } from "node:child_process";
+import { cp, mkdir, rm, writeFile } from "node:fs/promises";
+import { dirname as dirname5, join as join8, relative, sep } from "node:path";
 var run4 = promisify4(execFile4);
 var xml = (value2) => value2.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
-async function installStartup() {
-  const entry = fileURLToPath3(import.meta.url);
-  if (!entry.endsWith("/dist/index.js") && !entry.endsWith("\\dist\\index.js"))
-    throw new Error(
-      "Build the connector before installing startup: pnpm --filter @dashup/connector build"
-    );
-  const node = process.execPath;
-  if (process.platform === "darwin") {
-    const path = join8(homedir6(), "Library/LaunchAgents/com.dashup.connector.plist");
-    await mkdir(dirname5(path), { recursive: true });
-    await writeFile(
-      path,
-      `<?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>com.dashup.connector</string><key>ProgramArguments</key><array><string>${xml(node)}</string><string>${xml(entry)}</string><string>watch</string></array><key>RunAtLoad</key><true/><key>KeepAlive</key><true/></dict></plist>`
-    );
-    await run4("launchctl", ["load", path]);
-  } else if (process.platform === "win32") {
-    const path = join8(
-      process.env.APPDATA ?? join8(homedir6(), "AppData/Roaming"),
-      "Microsoft/Windows/Start Menu/Programs/Startup/Dashup.vbs"
-    );
-    const quote = (value2) => '""' + value2.replaceAll('"', '""') + '""';
-    await writeFile(
-      path,
-      `CreateObject("WScript.Shell").Run "${quote(node)} ${quote(entry)} watch", 0, False\r
-`
-    );
-  } else {
-    const path = join8(homedir6(), ".config/systemd/user/dashup.service");
-    await mkdir(dirname5(path), { recursive: true });
-    const quote = (value2) => '"' + value2.replaceAll("\\", "\\\\").replaceAll('"', '\\"').replaceAll("%", "%%") + '"';
-    await writeFile(
-      path,
-      `[Unit]
+var NODE_FLAGS = ["--disable-warning=ExperimentalWarning"];
+var serviceFile = () => process.platform === "darwin" ? join8(homedir6(), "Library/LaunchAgents/com.dashup.connector.plist") : process.platform === "win32" ? join8(
+  process.env.APPDATA ?? join8(homedir6(), "AppData/Roaming"),
+  "Microsoft/Windows/Start Menu/Programs/Startup/Dashup.vbs"
+) : join8(homedir6(), ".config/systemd/user/dashup.service");
+var startupInstalled = () => existsSync6(serviceFile());
+function service(platform, node, entry, config2) {
+  const command2 = [node, ...NODE_FLAGS, entry];
+  if (platform === "darwin")
+    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>com.dashup.connector</string><key>EnvironmentVariables</key><dict><key>DASHUP_CONFIG</key><string>${xml(config2)}</string></dict><key>ProgramArguments</key><array>${[...command2, "watch"].map((value2) => `<string>${xml(value2)}</string>`).join("")}</array><key>RunAtLoad</key><true/><key>KeepAlive</key><dict><key>SuccessfulExit</key><false/></dict></dict></plist>`;
+  if (platform === "win32") {
+    const quote2 = (value2) => '""' + value2.replaceAll('"', '""') + '""';
+    return `Set shell = CreateObject("WScript.Shell")\r
+shell.Environment("Process")("DASHUP_CONFIG") = "${config2.replaceAll('"', '""')}"\r
+shell.Run "${command2.map(quote2).join(" ")} watch", 0, False\r
+`;
+  }
+  const quote = (value2) => '"' + value2.replaceAll("\\", "\\\\").replaceAll('"', '\\"').replaceAll("%", "%%") + '"';
+  return `[Unit]
 Description=Dashup desktop connector
 After=network-online.target
 
 [Service]
-ExecStart=${quote(node)} ${quote(entry)} watch
+Environment=${quote(`DASHUP_CONFIG=${config2}`)}
+ExecStart=${command2.map(quote).join(" ")} watch
 Restart=on-failure
 RestartSec=5
 
 [Install]
 WantedBy=default.target
-`
+`;
+}
+async function durableEntry() {
+  const entry = fileURLToPath3(import.meta.url);
+  if (!entry.endsWith(`${sep}dist${sep}index.js`))
+    throw new Error(
+      "Build the connector before installing startup: pnpm --filter @dashup/connector build"
     );
+  if (!["_npx", "dlx"].some((cache2) => entry.includes(`${sep}${cache2}${sep}`))) return entry;
+  const root = entry.slice(0, entry.indexOf(`${sep}node_modules${sep}`));
+  const app = join8(dirname5(configPath()), "app");
+  await rm(app, { recursive: true, force: true });
+  await cp(join8(root, "node_modules"), join8(app, "node_modules"), {
+    recursive: true,
+    verbatimSymlinks: true
+  });
+  return join8(app, relative(root, entry));
+}
+async function installStartup() {
+  const path = serviceFile();
+  await mkdir(dirname5(path), { recursive: true });
+  await writeFile(
+    path,
+    service(process.platform, process.execPath, await durableEntry(), configPath())
+  );
+  if (process.platform === "darwin") {
+    await run4("launchctl", ["unload", path]).catch(() => {
+    });
+    await run4("launchctl", ["load", path]);
+  } else if (process.platform === "win32") {
+    spawn4("wscript.exe", [path], { detached: true, stdio: "ignore" }).unref();
+  } else {
     await run4("systemctl", ["--user", "daemon-reload"]);
-    await run4("systemctl", ["--user", "enable", "--now", "dashup.service"]);
+    await run4("systemctl", ["--user", "enable", "dashup.service"]);
+    await run4("systemctl", ["--user", "restart", "dashup.service"]);
   }
-  process.stdout.write("Dashup will start when you sign in to this computer.\n");
 }
 
 // src/index.ts
@@ -18820,6 +18882,42 @@ var refused = (error) => {
   if (error.cause?.code === "ECONNREFUSED") return null;
   throw error;
 };
+var pause = (ms) => new Promise((resolve3) => setTimeout(resolve3, ms));
+async function answering(expected) {
+  for (let tries = 0; tries < 40; tries++) {
+    const status2 = await running("/status", { signal: AbortSignal.timeout(1e3) }).catch(
+      () => null
+    );
+    if (Boolean(status2?.ok) === expected) return true;
+    await pause(250);
+  }
+  return false;
+}
+var BACKGROUND = "Run Dashup in the background and start it when you sign in?";
+var DONE2 = "Your projects appear on your phone.";
+async function background() {
+  const waiting = interactive ? ui2.spinner() : void 0;
+  waiting?.start("Starting Dashup in the background");
+  let failure = "Dashup did not start in the background. Run dashup watch to see why.";
+  try {
+    await running("/stop", { method: "POST" }).catch(() => null);
+    await answering(false);
+    await installStartup();
+    if (await answering(true)) {
+      const message = "Dashup runs in the background and starts when you sign in.";
+      if (waiting) waiting.stop(message);
+      else process.stdout.write(`${message}
+`);
+      return true;
+    }
+  } catch (error) {
+    if (error instanceof Error) failure = error.message;
+  }
+  if (waiting) waiting.error(failure);
+  else process.stderr.write(`${failure}
+`);
+  return false;
+}
 var authorized = (request2) => {
   const expected = Buffer.from(`Bearer ${config.localSecret}`);
   const actual = Buffer.from(request2.headers.authorization ?? "");
@@ -18830,7 +18928,7 @@ var Attention = z3.object({
   threadId: z3.string().default(""),
   title: z3.string().min(1).max(200),
   body: z3.string().max(4e3).default(""),
-  reason: z3.enum(["input", "approval", "error", "complete", "updated"]).default("input")
+  reason: z3.enum(["input", "approval", "error", "complete"]).default("input")
 }).strict();
 async function main() {
   if (option("--api")) {
@@ -18843,7 +18941,11 @@ async function main() {
       throw new Error("Use a separate DASHUP_CONFIG file to connect a different server");
     config.api = url2.origin;
   }
-  if (command === "install") return installStartup();
+  if (command === "install") {
+    if (!config.secret) throw new Error("Pair this computer first: run dashup pair.");
+    if (!await background()) process.exitCode = 1;
+    return;
+  }
   if (command === "stop") {
     const response = await running("/stop", { method: "POST" }).catch(refused);
     if (!response) throw new Error("Dashup is not running on this computer");
@@ -18938,10 +19040,18 @@ async function main() {
     );
     return;
   }
-  const pairPhone = async (invite) => {
-    const { email } = await scanned(config, invite);
-    process.stdout.write(`Paired a phone signed in as ${email}.
-`);
+  const pairPhone = (invite) => scanned(config, invite, (email) => `Paired a phone signed in as ${email}`);
+  const keepRunning = async (stopHere) => {
+    if (!interactive) return;
+    const answer = startupInstalled() || await ui2.confirm({ message: BACKGROUND });
+    if (answer === true) {
+      stopHere();
+      const started = await background();
+      ui2.outro(started ? DONE2 : "Run dashup to keep Dashup running in this terminal.");
+      process.exit(started ? 0 : 1);
+    }
+    ui2.log.info("Dashup runs in this terminal. Keep it open; Ctrl+C stops it.");
+    ui2.outro(DONE2);
   };
   const status2 = await running("/status", { signal: AbortSignal.timeout(1e3) }).catch(refused);
   if (status2?.ok) {
@@ -18956,8 +19066,17 @@ async function main() {
       throw new Error(
         "An older Dashup connector is running. Run dashup stop, then run dashup pair with the updated connector."
       );
-    return pairPhone(invite.data);
+    if (interactive) intro2();
+    await pairPhone(invite.data);
+    if (interactive && !startupInstalled()) {
+      const answer = await ui2.confirm({ message: BACKGROUND });
+      if (answer === true && !await background()) process.exitCode = 1;
+    }
+    if (interactive) ui2.outro(DONE2);
+    process.exit();
   }
+  if (!config.secret && !interactive)
+    throw new Error("Run dashup pair in a terminal to pair this computer.");
   let connector;
   const server = createServer(async (request2, response) => {
     if (!authorized(request2)) {
@@ -19036,12 +19155,26 @@ async function main() {
     });
   try {
     const linking = !config.secret;
-    if (linking) await link(config);
+    if (linking) {
+      intro2();
+      if (!await link(config)) process.exit(1);
+      await keepRunning(() => server.close());
+    }
     connector = new Connector(config);
     await connector.start();
-    if (command === "pair" && !linking)
-      pairPhone(connector.invite()).catch((error) => process.stderr.write(`${error instanceof Error ? error.message : "Pairing failed"}
-`));
+    if (command === "pair" && !linking) {
+      if (interactive) intro2();
+      const paired = await pairPhone(connector.invite()).catch((error) => {
+        if (!reported(error))
+          process.stderr.write(`${error instanceof Error ? error.message : "Pairing failed"}
+`);
+      });
+      if (paired)
+        await keepRunning(() => {
+          connector?.stop();
+          server.close();
+        });
+    }
   } catch (error) {
     connector?.stop();
     server.close();
@@ -19049,7 +19182,8 @@ async function main() {
   }
 }
 main().catch((error) => {
-  process.stderr.write(`${error instanceof Error ? error.message : "Dashup failed"}
+  if (!reported(error))
+    process.stderr.write(`${error instanceof Error ? error.message : "Dashup failed"}
 `);
   process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dashup/connector",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "type": "module",
   "bin": {
     "dashup": "dist/index.js"
@@ -16,6 +16,7 @@
   },
   "dependencies": {
     "@agentclientprotocol/sdk": "1.9.0",
+    "@clack/prompts": "^1.8.1",
     "@microsoft/agent-host-protocol": "1.0.0",
     "qrcode": "^1.5.4",
     "ws": "^8.21.3",
@@ -29,10 +30,10 @@
     "tsx": "^4.22.4",
     "typescript": "^5.9.3",
     "@dashup/models": "0.1.0",
-    "@dashup/typescript-config": "0.0.0",
     "@dashup/protocol": "0.1.0",
-    "@parcae/sdk": "0.8.1",
-    "@parcae/lynx": "0.1.0"
+    "@dashup/typescript-config": "0.0.0",
+    "@parcae/lynx": "0.1.0",
+    "@parcae/sdk": "0.8.1"
   },
   "scripts": {
     "dashup": "tsx src/index.ts",
@@ -40,7 +41,7 @@
     "start": "node dist/index.js watch",
     "build": "tsup",
     "check-types": "tsc --noEmit",
-    "test": "node --import tsx --test tests/connector.test.ts tests/history.test.ts tests/harness-history.test.ts tests/harness-live.test.ts tests/harness-queue.test.ts tests/harness-vscode.test.ts tests/stop.test.ts tests/viewer.test.ts",
+    "test": "node --import tsx --test tests/connector.test.ts tests/history.test.ts tests/harness-history.test.ts tests/harness-live.test.ts tests/harness-queue.test.ts tests/harness-vscode.test.ts tests/install.test.ts tests/stop.test.ts tests/viewer.test.ts",
     "test:workflow": "node --import tsx tests/workflow.test.ts"
   }
 }