@dashup/connector 0.1.3 → 0.1.4

package/README.md

@@ -8,23 +8,16 @@ With Node 24:
 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`:
+To keep `dashup` as a command, install it with `npm install -g @dashup/connector`. The package bundles the workspace code; screen and input need the native helper from `packages/desktop`, which it does not include.
 
-```sh
-pnpm install
-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` 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`.
+`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. To pair without the prompt, as an agent can, name the account with `--account you@example.com`; a phone signed in to any other account is refused. Without a terminal, the code opens in a browser on this computer instead of printing, because it carries the pairing's encryption key and an agent's output leaves the computer. Pairing then exits, and `dashup install` keeps Dashup running. Where no browser can open, pairing needs a terminal. 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
 
 ```sh
-pnpm --filter @dashup/connector dashup doctor
-pnpm --filter @dashup/connector dashup projects
-pnpm --filter @dashup/connector dashup alert --project PROJECT_ID --title "Dashup is connected"
+dashup doctor
+dashup projects
+dashup alert --project PROJECT_ID --title "Dashup is connected"
 ```
 
 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.
@@ -63,10 +56,10 @@ Live discovery is bounded to 100 sessions per endpoint. OpenCode supplies the la
 The default history and native-host path needs no wrapper or editor configuration. For an explicitly configured external ACP agent, use the connector as the editor's stdio wrapper; it uses the official ACP SDK's protocol contracts:
 
 ```sh
-node /absolute/path/to/dashup/apps/connector/dist/index.js acp -- /absolute/path/to/original-agent ORIGINAL_ARGUMENTS
+dashup acp -- /absolute/path/to/original-agent ORIGINAL_ARGUMENTS
 ```
 
-Set the editor's existing agent command to Node, with the arguments above. Start the connector first and launch the agent through that editor configuration. The proxy starts the original command once and forwards the editor's own ACP stream. Phone messages and approval choices go to that same process and session. Only native approval choices are offered, including native file scope when the agent provides it. The proxy does not create another session when opening a phone thread.
+Install `dashup` globally and set the editor's existing agent command to it, with the arguments above. Start the connector first and launch the agent through that editor configuration. The proxy starts the original command once and forwards the editor's own ACP stream. Phone messages and approval choices go to that same process and session. Only native approval choices are offered, including native file scope when the agent provides it. The proxy does not create another session when opening a phone thread.
 
 The wrapper and connector must run on the same execution host. For SSH projects, confirm where that particular external agent runs before configuring its command; [Zed treats external-agent runtime and authentication as agent-owned](https://zed.dev/docs/ai/external-agents#remote-projects). Pair the development machine separately if it owns the wrapper process. Reading the PC's saved SSH project does not attach to a remote agent process.
 
@@ -78,8 +71,8 @@ Build the native WebRTC helper on the computer, following [desktop build require
 
 ```sh
 pnpm --filter @dashup/desktop build
-pnpm --filter @dashup/connector dashup permissions --screen
-pnpm --filter @dashup/connector dashup permissions --screen --control
+dashup permissions --screen
+dashup permissions --screen --control
 ```
 
 Run `permissions` without flags to disable access. Video and input use a WebRTC peer connection; SDP, ICE candidates, and DTLS fingerprints travel inside paired-device encrypted envelopes. Only one screen session is active at a time. The relay does not carry decoded frames. Set `DASHUP_DESKTOP_BIN` if the helper lives outside its workspace build path.
@@ -88,15 +81,15 @@ macOS requires Screen Recording and Accessibility permission. Windows uses the s
 
 ## Start at login
 
-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.
+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; without a desktop session, as over SSH, install also turns on lingering so the service keeps running after you log out. 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.
 
-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.
+`dashup uninstall` stops Dashup and removes the startup entry and its `app/` copy; the computer stays paired. `dashup stop` leaves the service stopped until the next sign-in; a crash restarts it.
 
 ## Local state and checks
 
 `~/.dashup/connector.json` holds this computer's secret, pairing keys, encrypted outbox, and replay counters. It is written atomically with private Unix permissions; it is not currently protected by an OS credential vault. Do not share or copy it to another connector. `DASHUP_CONFIG` selects a separate state file. `DASHUP_ZED_DATA` and `DASHUP_VSCODE_DATA` select custom editor data directories. Native history discovery honors `CLAUDE_CONFIG_DIR`, `CODEX_HOME`, and XDG paths. The selected conversation is parsed locally on demand; Dashup does not create another plaintext transcript database.
 
-For isolated development fixtures, `DASHUP_LIVE_DISCOVERY=0` disables automatic process discovery. Explicit `DASHUP_OPENCODE_ENDPOINT`, `DASHUP_CODEX_SOCKET`, and `DASHUP_AHP_DATA` overrides allow local test endpoints without modifying editor configuration. They are not required for ordinary discovery.
+From a checkout, run `pnpm install` and `pnpm exec turbo build --filter=@dashup/connector...` with pnpm 10.34.5, then use `pnpm --filter @dashup/connector dashup` in place of `dashup`. For isolated development fixtures, `DASHUP_LIVE_DISCOVERY=0` disables automatic process discovery. Explicit `DASHUP_OPENCODE_ENDPOINT`, `DASHUP_CODEX_SOCKET`, and `DASHUP_AHP_DATA` overrides allow local test endpoints without modifying editor configuration. They are not required for ordinary discovery.
 
 ```sh
 pnpm --filter @dashup/connector test

package/dist/index.js

@@ -2706,7 +2706,7 @@ var require_pluralize = __commonJS({
 
 // src/index.ts
 import { randomBytes as randomBytes5, timingSafeEqual } from "node:crypto";
-import { createServer } from "node:http";
+import { createServer as createServer2 } from "node:http";
 import * as ui2 from "@clack/prompts";
 import { z as z3 } from "zod";
 
@@ -4004,13 +4004,16 @@ async function proxyAcp(config2, executable, args2) {
 
 // src/pair.ts
 import { hostname } from "node:os";
+import { promisify } from "node:util";
+import { createServer } from "node:http";
+import { execFile } from "node:child_process";
 import { randomBytes as randomBytes2, createHash as createHash2 } from "node:crypto";
 import QRCode from "qrcode";
 import * as ui from "@clack/prompts";
 import { z } from "zod";
 
 // package.json
-var version = "0.1.3";
+var version = "0.1.4";
 
 // src/pair.ts
 var Invitation = z.object({
@@ -4026,29 +4029,55 @@ function invitation(config2, secret = config2.secret) {
   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 }, done, secret = config2.secret) {
-  const qr = await QRCode.toString(text3, {
-    type: "terminal",
-    small: true,
-    errorCorrectionLevel: "L"
+var SCAN = "Scan this in the Dashup app under Pair a computer. It expires in 5 minutes.";
+var BROWSER = {
+  darwin: ["open"],
+  win32: ["rundll32", "url.dll,FileProtocolHandler"]
+};
+var NO_BROWSER = "No browser here can show the pairing code. Run dashup pair in a terminal on this computer.";
+async function show(text3) {
+  if (process.platform === "linux" && !process.env.DISPLAY && !process.env.WAYLAND_DISPLAY)
+    throw new Error(NO_BROWSER);
+  const path = `/${randomBytes2(16).toString("hex")}`;
+  const qr = await QRCode.toString(text3, { type: "svg", margin: 2, errorCorrectionLevel: "L" });
+  const page = `<!doctype html><meta charset="utf-8"><title>Pair with Dashup</title><style>body{margin:0;min-height:100vh;display:grid;place-items:center;background:#fff;color:#16181d;font:16px/1.5 system-ui,sans-serif}main{max-width:22rem;padding:2rem;text-align:center}svg{width:100%;margin:1rem 0}code{font-size:11px;word-break:break-all;color:#5d6470}</style><main><p>${SCAN}</p>${qr}<p>Can't scan? Paste this code instead:</p><code>${text3}</code></main>`;
+  const server = createServer((request2, response) => {
+    if (request2.url !== path) return void response.writeHead(404).end();
+    response.writeHead(200, {
+      "Content-Type": "text/html; charset=utf-8",
+      "Cache-Control": "no-store",
+      "Content-Security-Policy": "default-src 'none'; style-src 'unsafe-inline'",
+      "Referrer-Policy": "no-referrer"
+    });
+    response.end(page);
   });
-  const rows = qr.split("\n").filter((row) => row.replace(/\x1b\[\d+m/g, ""));
+  await new Promise((resolve3) => server.listen(0, "127.0.0.1", resolve3));
+  const [command2, ...args2] = BROWSER[process.platform] ?? ["xdg-open"];
+  const url2 = `http://127.0.0.1:${server.address().port}${path}`;
+  try {
+    await promisify(execFile)(command2, [...args2, url2]);
+  } catch {
+    server.close();
+    throw new Error(NO_BROWSER);
+  }
+  process.stdout.write(`Opened the pairing code in a browser on this computer. ${SCAN}
+`);
+  return () => server.close();
+}
+async function scanned(config2, { code, text: text3 }, done, secret = config2.secret) {
   if (interactive) {
-    ui.log.step("Scan this in the Dashup app under Pair a computer. It expires in 5 minutes.");
+    const qr = await QRCode.toString(text3, {
+      type: "terminal",
+      small: true,
+      errorCorrectionLevel: "L"
+    });
+    ui.log.step(SCAN);
     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}
-
-${rows.join("\n")}
-Scan this in the Dashup app (Pair a computer). It expires in 5 minutes.
-`
-    );
+    ui.log.message(qr.split("\n").filter((row) => row.replace(/\x1b\[\d+m/g, "")));
   }
+  const close = interactive ? void 0 : await show(text3);
   const waiting = interactive ? ui.spinner() : void 0;
   waiting?.start("Waiting for your phone");
   try {
@@ -4071,16 +4100,18 @@ Scan this in the Dashup app (Pair a computer). It expires in 5 minutes.
     if (!waiting) throw error;
     waiting.error(error instanceof Error ? error.message : "Pairing failed");
     throw Object.assign(error, { reported: true });
+  } finally {
+    close?.();
   }
 }
 var reported = (error) => error?.reported === true;
-async function link(config2) {
+async function link(config2, account) {
   const secret = newSecret(randomBytes2);
   const invite = invitation(config2, secret);
   const { pairing, email } = await scanned(
     config2,
     invite,
-    (account) => `Scanned by ${account}`,
+    (account2) => `Scanned by ${account2}`,
     secret
   );
   const linked = { ...config2, secret };
@@ -4091,14 +4122,13 @@ async function link(config2) {
     kind: "desktop",
     platform
   });
-  const confirmed = await ui.confirm({
-    message: `Pair this computer with ${email}?`,
-    initialValue: false
-  });
+  const confirmed = account ? email.toLowerCase() === account.toLowerCase() : 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(() => {
     });
-    ui.cancel("Pairing cancelled. Nothing was shared.");
+    ui.cancel(
+      account ? `Pairing cancelled: that phone uses ${email}, not ${account}. Nothing was shared.` : "Pairing cancelled. Nothing was shared."
+    );
     return false;
   }
   Object.assign(config2, {
@@ -4120,9 +4150,9 @@ import { createInterface as createInterface2 } from "node:readline";
 import { spawn as spawn2 } from "node:child_process";
 
 // src/screen.ts
-import { promisify } from "node:util";
-import { execFile, spawnSync } from "node:child_process";
-var run = promisify(execFile);
+import { promisify as promisify2 } from "node:util";
+import { execFile as execFile2, spawnSync } from "node:child_process";
+var run = promisify2(execFile2);
 var powershell = (source) => run("powershell.exe", [
   "-NoProfile",
   "-NonInteractive",
@@ -16704,9 +16734,9 @@ var Codex = class {
 import Socket3 from "ws";
 import { homedir as homedir5 } from "node:os";
 import { connect as connect2 } from "node:net";
-import { promisify as promisify2 } from "node:util";
+import { promisify as promisify3 } from "node:util";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
-import { execFile as execFile2 } from "node:child_process";
+import { execFile as execFile3 } from "node:child_process";
 import { createHash as createHash3, randomUUID as randomUUID3 } from "node:crypto";
 import { stat as stat2, readdir as readdir2, readFile as readFile2 } from "node:fs/promises";
 import { join as join5, dirname as dirname3, basename as basename2, isAbsolute as isAbsolute3 } from "node:path";
@@ -16719,7 +16749,7 @@ var MAX_METADATA = 64 * 1024;
 var MAX_HOSTS = 16;
 var MAX_SESSIONS2 = 100;
 var ROOT_CHANNEL = "ahp-root://";
-var run2 = promisify2(execFile2);
+var run2 = promisify3(execFile3);
 var CONFIRMATION_CHOICES = [
   { id: "approve", label: "Allow once", kind: "approve" },
   { id: "deny", label: "Reject", kind: "deny" }
@@ -17201,11 +17231,11 @@ var VSCode = class {
 
 // src/harness/opencode.ts
 import { join as join6 } from "node:path";
-import { promisify as promisify3 } from "node:util";
+import { promisify as promisify4 } from "node:util";
 import { createHash as createHash4 } from "node:crypto";
-import { execFile as execFile3 } from "node:child_process";
+import { execFile as execFile4 } from "node:child_process";
 import { stat as stat3, readlink, readdir as readdir3, readFile as readFile3 } from "node:fs/promises";
-var run3 = promisify3(execFile3);
+var run3 = promisify4(execFile4);
 var REQUEST_MS3 = 4e3;
 var MAX_BYTES3 = 8 * 1024 * 1024;
 var MAX_SESSIONS3 = 100;
@@ -18790,13 +18820,13 @@ var Connector = class {
 
 // src/install.ts
 import { existsSync as existsSync6 } from "node:fs";
-import { homedir as homedir6 } from "node:os";
-import { promisify as promisify4 } from "node:util";
+import { homedir as homedir6, userInfo } from "node:os";
+import { promisify as promisify5 } from "node:util";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
-import { execFile as execFile4, spawn as spawn4 } from "node:child_process";
+import { execFile as execFile5, 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 run4 = promisify5(execFile5);
 var xml = (value2) => value2.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
 var NODE_FLAGS = ["--disable-warning=ExperimentalWarning"];
 var serviceFile = () => process.platform === "darwin" ? join8(homedir6(), "Library/LaunchAgents/com.dashup.connector.plist") : process.platform === "win32" ? join8(
@@ -18863,8 +18893,23 @@ async function installStartup() {
     await run4("systemctl", ["--user", "daemon-reload"]);
     await run4("systemctl", ["--user", "enable", "dashup.service"]);
     await run4("systemctl", ["--user", "restart", "dashup.service"]);
+    if (!process.env.DISPLAY && !process.env.WAYLAND_DISPLAY)
+      return run4("loginctl", ["enable-linger"]).then(
+        () => void 0,
+        () => `It stops when you log out. To keep it running, run sudo loginctl enable-linger ${userInfo().username}.`
+      );
   }
 }
+async function uninstallStartup() {
+  const path = serviceFile();
+  if (process.platform === "darwin") await run4("launchctl", ["unload", path]).catch(() => {
+  });
+  else if (process.platform !== "win32")
+    await run4("systemctl", ["--user", "disable", "dashup.service"]).catch(() => {
+    });
+  await rm(path, { force: true });
+  await rm(join8(dirname5(configPath()), "app"), { recursive: true, force: true });
+}
 
 // src/index.ts
 var config = loadConfig();
@@ -18902,9 +18947,9 @@ async function background() {
   try {
     await running("/stop", { method: "POST" }).catch(() => null);
     await answering(false);
-    await installStartup();
+    const note = await installStartup();
     if (await answering(true)) {
-      const message = "Dashup runs in the background and starts when you sign in.";
+      const message = `Dashup runs in the background and starts when you sign in.${note ? ` ${note}` : ""}`;
       if (waiting) waiting.stop(message);
       else process.stdout.write(`${message}
 `);
@@ -18941,11 +18986,21 @@ async function main() {
       throw new Error("Use a separate DASHUP_CONFIG file to connect a different server");
     config.api = url2.origin;
   }
+  const account = option("--account");
+  if (account !== void 0 && !/^[^\s@]+@[^\s@]+$/.test(account))
+    throw new Error("Use --account with the email you sign in to the Dashup app with");
   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 === "uninstall") {
+    await running("/stop", { method: "POST" }).catch(() => null);
+    await answering(false);
+    await uninstallStartup();
+    process.stdout.write("Dashup no longer starts when you sign in. This computer stays paired.\n");
+    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");
@@ -19036,20 +19091,24 @@ async function main() {
   }
   if (!["pair", "watch"].includes(command)) {
     process.stdout.write(
-      "Dashup: pair | watch | projects | alert --project <id> | doctor | permissions --screen --control | stop | acp -- <original-agent-command> | install\n"
+      "Dashup: pair [--account <email>] | watch | projects | alert --project <id> | doctor | permissions --screen --control | stop | acp -- <original-agent-command> | install | uninstall\n"
     );
     return;
   }
   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) {
+    const answer = startupInstalled() || interactive && await ui2.confirm({ message: BACKGROUND }) === true;
+    if (answer) {
       stopHere();
       const started = await background();
       ui2.outro(started ? DONE2 : "Run dashup to keep Dashup running in this terminal.");
       process.exit(started ? 0 : 1);
     }
+    if (!interactive) {
+      stopHere();
+      process.stdout.write("Paired. Run dashup install to keep Dashup running in the background.\n");
+      process.exit(0);
+    }
     ui2.log.info("Dashup runs in this terminal. Keep it open; Ctrl+C stops it.");
     ui2.outro(DONE2);
   };
@@ -19075,10 +19134,12 @@ async function main() {
     if (interactive) ui2.outro(DONE2);
     process.exit();
   }
-  if (!config.secret && !interactive)
-    throw new Error("Run dashup pair in a terminal to pair this computer.");
+  if (!config.secret && !interactive && !account)
+    throw new Error(
+      "To pair this computer, run dashup pair in a terminal, or add --account with your Dashup email."
+    );
   let connector;
-  const server = createServer(async (request2, response) => {
+  const server = createServer2(async (request2, response) => {
     if (!authorized(request2)) {
       response.writeHead(403).end();
       return;
@@ -19157,7 +19218,7 @@ async function main() {
     const linking = !config.secret;
     if (linking) {
       intro2();
-      if (!await link(config)) process.exit(1);
+      if (!await link(config, account)) process.exit(1);
       await keepRunning(() => server.close());
     }
     connector = new Connector(config);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dashup/connector",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "type": "module",
   "bin": {
     "dashup": "dist/index.js"
@@ -29,10 +29,10 @@
     "tsup": "^8.5.1",
     "tsx": "^4.22.4",
     "typescript": "^5.9.3",
-    "@dashup/models": "0.1.0",
-    "@dashup/protocol": "0.1.0",
     "@dashup/typescript-config": "0.0.0",
     "@parcae/lynx": "0.1.0",
+    "@dashup/models": "0.1.0",
+    "@dashup/protocol": "0.1.0",
     "@parcae/sdk": "0.8.1"
   },
   "scripts": {