linkshell-cli 0.8.2 → 0.10.0

package/dist/cli/src/commands/setup.js

@@ -1,44 +1,108 @@
 import * as readline from "node:readline";
-import { hostname } from "node:os";
-import { loadConfig, saveConfig, getConfigPath } from "../config.js";
-function ask(rl, question, defaultValue) {
-    const suffix = defaultValue ? ` (${defaultValue})` : "";
-    return new Promise((resolve) => {
-        rl.question(`  ${question}${suffix}: `, (answer) => {
-            resolve(answer.trim() || defaultValue || "");
-        });
-    });
+import { isLoggedIn, loadAuth } from "../auth.js";
+import { assertHostRuntime, ensureHostRunning, joinGatewayAfterLogin, OFFICIAL_GATEWAY, readHostConfig, sameGateway, withRunningHost, writeHostConfig } from "./host.js";
+import { setUpScreen } from "./screen.js";
+// `linkshell setup`: everything a new installation needs, once, in order —
+// the host running, the screen's permissions, a phone that can reach this
+// computer. Someone who installs and never comes back to the terminal should
+// leave with all of it done: the first `linkshell host --daemon` runs this by
+// itself (see `offerSetup`).
+const green = (text) => `\x1b[32m${text}\x1b[0m`;
+const dim = (text) => `\x1b[2m${text}\x1b[0m`;
+const bold = (text) => `\x1b[1m${text}\x1b[0m`;
+function ask(question) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => rl.question(question, (answer) => {
+        rl.close();
+        resolve(answer.trim().toLowerCase());
+    }));
 }
-function defaultShell() {
-    if (process.platform === "win32") {
-        return process.env.COMSPEC ?? "cmd.exe";
+async function home() {
+    const { defaultHome } = await import("@linkshell/host");
+    return defaultHome();
+}
+/** Whether this installation has been through setup (or said no to it). */
+export async function setupDone() {
+    return readHostConfig(await home()).setup !== undefined;
+}
+async function remember(outcome) {
+    const at = await home();
+    writeHostConfig(at, { ...readHostConfig(at), setup: outcome });
+}
+/** The phone's way to this computer: an account both are signed in to, or a pairing through a gateway. */
+async function setUpPhone(out, interactive) {
+    const gateway = await withRunningHost((client) => client.call("gateway.status", {}));
+    // The account counts on LinkShell's own gateway only; with a gateway of one's own, phones are paired.
+    const official = !gateway || gateway.status === "off" || !gateway.url || sameGateway(gateway.url, OFFICIAL_GATEWAY);
+    if (isLoggedIn() && official) {
+        const email = loadAuth()?.email;
+        if (gateway?.status === "online") {
+            out(`  ${green("✓")} Signed in${email ? ` as ${email}` : ""}: this computer is online.`);
+            out(dim("    Open LinkShell on your phone and sign in with the same account — it shows up there, no pairing needed."));
+            return true;
+        }
+        // Signed in, not online yet (a host started before the login, or no subscription): say which.
+        await joinGatewayAfterLogin("pro");
+        return (await withRunningHost((client) => client.call("gateway.status", {})))?.status === "online";
+    }
+    if (gateway && gateway.status !== "off" && gateway.devices.length > 0) {
+        out(`  ${green("✓")} Paired with ${gateway.devices.map((device) => device.name).join(", ")}.`);
+        return true;
     }
-    return process.env.SHELL ?? "/bin/bash";
+    if (gateway && gateway.status !== "off") {
+        out("  This computer uses your own gateway. Pair your phone with:  linkshell pair");
+        return false;
+    }
+    if (!interactive) {
+        out("  Not connected to a phone yet: linkshell login (LinkShell account), or your own gateway and linkshell pair.");
+        return false;
+    }
+    out("  Your phone reaches this computer through your LinkShell account (Pro), from anywhere.");
+    const answer = await ask("  Sign in now? It opens your browser. [Y/n] ");
+    if (answer === "n" || answer === "no") {
+        out(dim("    Later: linkshell login — or with your own gateway: linkshell host --gateway <url>, then linkshell pair"));
+        return false;
+    }
+    const { runLogin } = await import("./login.js");
+    const result = await runLogin();
+    if (!result)
+        return false;
+    await joinGatewayAfterLogin(result.plan);
+    return (await withRunningHost((client) => client.call("gateway.status", {})))?.status === "online";
+}
+/** The whole of it. `from`: who is running it — said aloud only when it wasn't asked for. */
+export async function runSetup(version, from = "command") {
+    const out = (line = "") => process.stdout.write(`${line}\n`);
+    const interactive = process.stdin.isTTY === true && process.stdout.isTTY === true;
+    assertHostRuntime();
+    out(`\n  ${bold("LinkShell setup")}${from === "first-start" ? dim("  (first start on this computer; again any time with: linkshell setup)") : ""}\n`);
+    out(`  ${bold("1")}  The host`);
+    await ensureHostRunning();
+    out(`  ${green("✓")} Running (${version}); it keeps running in the background.\n`);
+    out(`  ${bold("2")}  The screen ${dim("— watch and control this computer from the phone")}`);
+    const screen = await setUpScreen(out, interactive);
+    out();
+    out(`  ${bold("3")}  Your phone`);
+    const phone = await setUpPhone(out, interactive);
+    out();
+    // Run where nobody could answer, it has set nothing up: the first start at a terminal still offers it.
+    if (interactive)
+        await remember("done");
+    if (screen && phone)
+        out(`  ${green("All set.")} Open LinkShell on your phone.\n`);
+    else
+        out(`  Done for now. ${[!screen && "The screen: linkshell screen", !phone && "The phone: linkshell login, or linkshell pair"].filter(Boolean).join(" · ")}\n`);
 }
-export async function runSetup() {
-    const existing = loadConfig();
-    const rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout,
-    });
-    process.stdout.write("\n  LinkShell Setup\n\n");
-    process.stdout.write("  Tip: leave Gateway URL empty to use the built-in gateway (recommended for LAN use).\n\n");
-    const gateway = await ask(rl, "Gateway URL (leave empty for built-in)", "");
-    const command = await ask(rl, "Terminal command (the shell or CLI you want to bridge)", existing.command ?? defaultShell());
-    const clientName = await ask(rl, "Client name", existing.clientName ?? hostname());
-    const hostnameName = await ask(rl, "Hostname (display name for your machine)", existing.hostname ?? hostname());
-    rl.close();
-    const config = {
-        gateway: gateway || undefined,
-        provider: "custom",
-        command: command || undefined,
-        clientName,
-        hostname: hostnameName || undefined,
-    };
-    saveConfig(config);
-    process.stdout.write(`\n  \x1b[32mConfig saved to ${getConfigPath()}\x1b[0m\n\n`);
-    process.stdout.write("  Next steps:\n");
-    process.stdout.write("    linkshell doctor    — verify your setup\n");
-    process.stdout.write("    linkshell start     — start a bridge session\n\n");
+/**
+ * The first start on a computer: the host has just been started by someone at
+ * a terminal, and nothing has ever been set up here. Rather than leave the
+ * rest for the day it is needed (by then nobody is at the computer), it is
+ * done now. Once: a second start says nothing.
+ */
+export async function offerSetup(version) {
+    if (process.stdin.isTTY !== true || process.stdout.isTTY !== true || (await setupDone()))
+        return false;
+    await runSetup(version, "first-start");
+    return true;
 }
 //# sourceMappingURL=setup.js.map

package/dist/cli/src/commands/setup.js.map

@@ -1 +1 @@
-{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../../src/commands/setup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGrE,SAAS,GAAG,CACV,EAAsB,EACtB,QAAgB,EAChB,YAAqB;IAErB,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,KAAK,YAAY,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,EAAE,CAAC,QAAQ,CAAC,KAAK,QAAQ,GAAG,MAAM,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE;YACjD,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,YAAY,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY;IACnB,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,SAAS,CAAC;IAC1C,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,WAAW,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC5B,MAAM,QAAQ,GAAG,UAAU,EAAE,CAAC;IAC9B,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IAEH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAChD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2FAA2F,CAC5F,CAAC;IAEF,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,EAAE,EAAE,wCAAwC,EAAE,EAAE,CAAC,CAAC;IAE5E,MAAM,OAAO,GAAG,MAAM,GAAG,CACvB,EAAE,EACF,wDAAwD,EACxD,QAAQ,CAAC,OAAO,IAAI,YAAY,EAAE,CACnC,CAAC;IAEF,MAAM,UAAU,GAAG,MAAM,GAAG,CAC1B,EAAE,EACF,aAAa,EACb,QAAQ,CAAC,UAAU,IAAI,QAAQ,EAAE,CAClC,CAAC;IACF,MAAM,YAAY,GAAG,MAAM,GAAG,CAC5B,EAAE,EACF,0CAA0C,EAC1C,QAAQ,CAAC,QAAQ,IAAI,QAAQ,EAAE,CAChC,CAAC;IAEF,EAAE,CAAC,KAAK,EAAE,CAAC;IAEX,MAAM,MAAM,GAAoB;QAC9B,OAAO,EAAE,OAAO,IAAI,SAAS;QAC7B,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,OAAO,IAAI,SAAS;QAC7B,UAAU;QACV,QAAQ,EAAE,YAAY,IAAI,SAAS;KACpC,CAAC;IAEF,UAAU,CAAC,MAAM,CAAC,CAAC;IAEnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,+BAA+B,aAAa,EAAE,aAAa,CAC5D,CAAC;IACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACtE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;AAC/E,CAAC"}
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../../src/commands/setup.ts"],"names":[],"mappings":"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"}

package/dist/cli/src/index.js

@@ -1,59 +1,25 @@
 #!/usr/bin/env node
 import { Command } from "commander";
-import { BridgeSession } from "./runtime/bridge-session.js";
-import { resolveProviderConfig } from "./providers.js";
-import { loadConfig } from "./config.js";
 import { runDoctor } from "./commands/doctor.js";
 import { runSetup } from "./commands/setup.js";
 import { runUpgrade } from "./commands/upgrade.js";
 import { runLogin } from "./commands/login.js";
 import { runLogout } from "./commands/logout.js";
-import { getLanIp } from "./utils/lan-ip.js";
-import { shouldKeepAwake } from "./utils/keep-awake.js";
 import { createRequire } from "node:module";
-import { fileURLToPath } from "node:url";
-import { dirname, resolve } from "node:path";
-import { existsSync, statSync } from "node:fs";
 const require = createRequire(import.meta.url);
 const pkg = require("../../../package.json");
-// Locate the bundled web-dashboard SPA and point the (embedded) gateway's
-// static server at it via WEB_DIST — BEFORE any gateway module is imported,
-// because static-web.ts freezes WEB_DIST at module-load time. This is what lets
-// the in-app WebView render for LAN / self-hosted users whose CLI runs its own
-// embedded gateway (the cloud image bundles web separately). A user-set
-// WEB_DIST always wins. Probed across published-package, monorepo-compiled, and
-// dev (tsx) layouts; the first candidate containing index.html is used.
-if (!process.env.WEB_DIST) {
-    const here = dirname(fileURLToPath(import.meta.url));
-    const candidates = [
-        resolve(here, "../../../web"), // published npm package root, and packages/cli/web (compiled)
-        resolve(here, "../../../apps/web-dashboard/dist"), // dev: tsx src/index.ts in the monorepo
-    ];
-    for (const dir of candidates) {
-        try {
-            if (existsSync(resolve(dir, "index.html")) && statSync(dir).isDirectory()) {
-                process.env.WEB_DIST = dir;
-                break;
-            }
-        }
-        catch {
-            // ignore and try the next candidate
-        }
-    }
-}
-const config = loadConfig();
 const program = new Command();
 program
     .name("linkshell")
-    .description("Your coding agents and terminals, on your phone. Run `linkshell host --daemon`, then `linkshell pair` (or `linkshell login` for the official gateway).")
+    .description("Your coding agents and terminals, on your phone. Start with `linkshell setup`.")
     .version(pkg.version);
-// ── host (v2 session daemon) ────────────────────────────────────────
+// ── host ────────────────────────────────────────────────────────────
 const hostCmd = program
     .command("host")
-    .description("Run the LinkShell host that owns agent sessions (v2)")
+    .description("Run the LinkShell host that owns agent sessions")
     .option("--daemon", "Run in background (detached)")
     .option("--dev-port <port>", "Also serve the host API on 127.0.0.1:<port> (local development clients only)")
-    .option("--gateway <url>", "Reach this computer through a v2 gateway (saved; 'off' to disable, 'default' for the official one when logged in)")
+    .option("--gateway <url>", "Reach this computer through a gateway (saved; 'off' to disable, 'default' for the official one when logged in)")
     .option("--_foreground-host", undefined) // internal
     .action(async (options) => {
     const { runHostForeground, ensureHostRunning, readHostConfig, writeHostConfig, assertHostRuntime, silenceSqliteWarning, withRunningHost, refreshGateway, describeGateway } = await import("./commands/host.js");
@@ -85,7 +51,10 @@ const hostCmd = program
         process.stderr.write(`  Log:    ${daemon.getLogFile("host")}\n`);
         process.stderr.write(`  Status: linkshell host status\n`);
         process.stderr.write(`  Stop:   linkshell host stop\n`);
-        // The screen needs setting up once, at the computer: said here, where someone is.
+        // The first start here: the rest of the setup happens now, while someone is at the computer.
+        const { offerSetup } = await import("./commands/setup.js");
+        if (await offerSetup(pkg.version))
+            process.exit(process.exitCode ?? 0);
         const { screenAccess, describeScreen, screenReady } = await import("./commands/screen.js");
         const screen = await screenAccess().catch(() => undefined);
         if (screen && (screen === "old" || !screenReady(screen)))
@@ -190,214 +159,23 @@ for (const [agent, description] of [
         await runAgentShim(agent, args ?? []);
     });
 }
-// ── start ───────────────────────────────────────────────────────────
-program
-    .command("start")
-    .description("Start a v1 bridge session (for the v1 app; with built-in or remote gateway)")
-    .option("--gateway <url>", "Gateway websocket URL (omit to start built-in gateway)", config.gateway ?? undefined)
-    .option("--pairing-gateway <url-or-host>", "Public HTTP gateway used in QR/deep link output", config.pairingGateway)
-    .option("--port <port>", "Port for built-in gateway", "8787")
-    .option("--session-id <id>", "Session identifier (auto-created if omitted)")
-    .option("--provider <provider>", "(deprecated — always custom; launch your CLI manually inside the shell)", "custom")
-    .option("--command <command>", "Shell or CLI to spawn in the PTY (default: $SHELL)", config.command)
-    .option("--client-name <name>", "Display name for this CLI", config.clientName ?? "local-cli")
-    .option("--hostname <name>", "Override hostname sent to gateway", config.hostname)
-    .option("--cols <cols>", "Initial terminal columns", String(config.cols ?? 120))
-    .option("--rows <rows>", "Initial terminal rows", String(config.rows ?? 36))
-    .option("--screen", "Enable screen sharing capability")
-    .option("--no-keep-awake", "Disable macOS keep-awake while bridge is running")
-    .option("--agent-ui", "Enable ACP Agent Workspace channel", true)
-    .option("--no-agent-ui", "Disable ACP Agent Workspace channel")
-    .option("--agent-provider <provider>", "Agent GUI provider: codex | claude | custom")
-    .option("--agent-command <command>", "ACP agent command (required for claude/custom, optional for codex)")
-    .option("--daemon", "Run in background (detached)")
-    .option("--verbose", "Enable verbose logging")
-    .option("--_foreground-bridge", undefined) // internal
-    .allowUnknownOption(true)
-    .allowExcessArguments(true)
-    .action(async (options, command) => {
-    const daemon = await import("./utils/daemon.js");
-    const keepAwake = shouldKeepAwake(options.keepAwake);
-    // Daemon mode: spawn detached child and exit
-    if (options.daemon && !options._foregroundBridge) {
-        const existingPid = daemon.readPid("bridge");
-        if (existingPid) {
-            process.stderr.write(`  Bridge already running (PID ${existingPid})\n`);
-            process.stderr.write(`  Run: linkshell stop\n\n`);
-            return;
-        }
-        // Rebuild args for the child, replacing --daemon with --_foreground-bridge
-        const childArgs = ["start", "--_foreground-bridge"];
-        if (options.gateway)
-            childArgs.push("--gateway", options.gateway);
-        if (options.pairingGateway)
-            childArgs.push("--pairing-gateway", options.pairingGateway);
-        childArgs.push("--port", String(options.port));
-        childArgs.push("--provider", options.provider);
-        if (options.command)
-            childArgs.push("--command", options.command);
-        childArgs.push("--client-name", options.clientName);
-        if (options.hostname)
-            childArgs.push("--hostname", options.hostname);
-        childArgs.push("--cols", String(options.cols));
-        childArgs.push("--rows", String(options.rows));
-        if (options.verbose)
-            childArgs.push("--verbose");
-        if (options.screen)
-            childArgs.push("--screen");
-        if (!keepAwake)
-            childArgs.push("--no-keep-awake");
-        if (options.agentUi)
-            childArgs.push("--agent-ui");
-        if (options.agentProvider)
-            childArgs.push("--agent-provider", options.agentProvider);
-        if (options.agentCommand)
-            childArgs.push("--agent-command", options.agentCommand);
-        if (options.sessionId)
-            childArgs.push("--session-id", options.sessionId);
-        // Pass through extra args
-        const extra = command.args.filter((v) => v !== "--");
-        if (extra.length)
-            childArgs.push("--", ...extra);
-        const pid = daemon.spawnDaemon("bridge", childArgs);
-        daemon.saveMetadata("bridge", { keepAwake, startedAt: Date.now() });
-        process.stderr.write(`\n  LinkShell bridge started in background\n`);
-        process.stderr.write(`  PID: ${pid}\n`);
-        process.stderr.write(`  Provider: ${options.provider}\n`);
-        process.stderr.write(`  Keep awake: ${keepAwake ? "enabled (use --no-keep-awake to disable)" : "disabled"}\n`);
-        process.stderr.write(`  Log: ${daemon.getLogFile("bridge")}\n\n`);
-        process.stderr.write(`  Stop:   linkshell stop\n`);
-        process.stderr.write(`  Status: linkshell status\n`);
-        process.stderr.write(`  Logs:   tail -f ${daemon.getLogFile("bridge")}\n\n`);
-        return;
-    }
-    // Foreground mode
-    const passthroughArgs = command.args.filter((value) => value !== "--");
-    const providerConfig = resolveProviderConfig({
-        provider: options.provider,
-        command: options.command,
-        args: passthroughArgs,
-    });
-    let gatewayUrl = options.gateway;
-    let gatewayHttpUrl;
-    let pairingGateway = options.pairingGateway;
-    let embeddedGatewayHandle;
-    if (!gatewayUrl) {
-        const { startEmbeddedGateway } = await import("@linkshell/gateway/embedded");
-        const port = Number(options.port);
-        const gw = await startEmbeddedGateway({
-            port,
-            logLevel: options.verbose ? "debug" : "warn",
-            silent: false,
-        });
-        embeddedGatewayHandle = gw;
-        gatewayUrl = gw.wsUrl;
-        gatewayHttpUrl = gw.httpUrl;
-        const lanIp = getLanIp();
-        if (!pairingGateway && lanIp !== "127.0.0.1") {
-            pairingGateway = `http://${lanIp}:${gw.port}`;
-        }
-        process.stderr.write(`\n  Built-in gateway started on port ${gw.port}\n`);
-        if (pairingGateway) {
-            process.stderr.write(`  LAN address: ${pairingGateway}\n`);
-        }
-        process.stderr.write("\n");
-    }
-    else {
-        gatewayHttpUrl = gatewayUrl
-            .replace(/\/ws\/?$/, "")
-            .replace(/^wss:/, "https:")
-            .replace(/^ws:/, "http:");
-    }
-    // Save PID for status/stop
-    daemon.savePid("bridge", process.pid);
-    daemon.saveMetadata("bridge", { keepAwake, startedAt: Date.now() });
-    // Load auth token if logged in
-    let authToken;
-    try {
-        const { getValidToken } = await import("./auth.js");
-        authToken = (await getValidToken()) ?? undefined;
-    }
-    catch { }
-    const session = new BridgeSession({
-        gatewayUrl,
-        gatewayHttpUrl,
-        pairingGateway,
-        sessionId: options.sessionId,
-        cols: Number(options.cols),
-        rows: Number(options.rows),
-        clientName: options.clientName,
-        hostname: options.hostname,
-        verbose: Boolean(options.verbose),
-        screen: Boolean(options.screen),
-        providerConfig,
-        authToken,
-        keepAwake,
-        agentUi: Boolean(options.agentUi),
-        agentProvider: options.agentProvider,
-        agentCommand: options.agentCommand,
-    });
-    const cleanup = async () => {
-        session.stop(0);
-        daemon.removePid("bridge");
-        if (embeddedGatewayHandle)
-            await embeddedGatewayHandle.close();
-    };
-    // When all PTYs exit naturally (not via a signal), the session closes its
-    // own socket but the embedded gateway loop and stale PID file would linger.
-    // Run the same process-level cleanup and then exit.
-    session.setOnAllTerminalsExited(async () => {
-        daemon.removePid("bridge");
-        if (embeddedGatewayHandle)
-            await embeddedGatewayHandle.close();
-        process.exit(process.exitCode ?? 0);
-    });
-    process.on("SIGINT", () => {
-        cleanup().then(() => process.exit(0));
-    });
-    process.on("SIGTERM", () => {
-        cleanup().then(() => process.exit(0));
-    });
-    // Global crash handlers: never die silently. In daemon mode keep the bridge
-    // alive (it has its own gateway reconnect logic); stderr is redirected to the
-    // daemon log file so the trace is recoverable.
-    const isDaemonChild = Boolean(options._foregroundBridge);
-    process.on("uncaughtException", (err) => {
-        process.stderr.write(`[bridge] uncaught exception: ${err instanceof Error ? err.stack ?? err.message : String(err)}\n`);
-        if (!isDaemonChild) {
-            cleanup().then(() => process.exit(1));
-        }
-    });
-    process.on("unhandledRejection", (reason) => {
-        process.stderr.write(`[bridge] unhandled rejection: ${reason instanceof Error ? reason.stack ?? reason.message : String(reason)}\n`);
-    });
-    await session.start();
-});
 // ── gateway ─────────────────────────────────────────────────────────
 const gatewayCmd = program
     .command("gateway")
-    .description("Manage the standalone gateway server")
+    .description("Run a gateway of your own: it relays encrypted frames between your computers and phones, and brokers pairing")
     .option("--port <port>", "Listen port", "8787")
-    .option("--log-level <level>", "Log level: debug | info | warn | error", "info")
     .option("--daemon", "Run in background (detached)")
     .option("--_foreground-gw", undefined) // internal
     .action(async (options) => {
-    const daemon = await import("./utils/daemon.js");
     if (options.daemon && !options._foregroundGw) {
+        const daemon = await import("./utils/daemon.js");
         const existingPid = daemon.readPid("gateway");
         if (existingPid) {
             process.stderr.write(`  Gateway already running (PID ${existingPid})\n`);
             process.stderr.write(`  Run: linkshell gateway stop\n\n`);
             return;
         }
-        const pid = daemon.spawnDaemon("gateway", [
-            "gateway",
-            "--_foreground-gw",
-            "--port",
-            String(options.port),
-            "--log-level",
-            options.logLevel,
-        ]);
+        const pid = daemon.spawnDaemon("gateway", ["gateway", "--_foreground-gw", "--port", String(options.port)]);
         process.stderr.write(`\n  LinkShell Gateway started in background\n`);
         process.stderr.write(`  PID: ${pid}\n`);
         process.stderr.write(`  Port: ${options.port}\n`);
@@ -407,35 +185,8 @@ const gatewayCmd = program
         process.stderr.write(`  Logs:   tail -f ${daemon.getLogFile("gateway")}\n\n`);
         return;
     }
-    // Foreground mode
-    const { startEmbeddedGateway } = await import("@linkshell/gateway/embedded");
-    const port = Number(options.port);
-    const { join } = await import("node:path");
-    (await import("./commands/host.js")).silenceSqliteWarning();
-    const gw = await startEmbeddedGateway({
-        port,
-        logLevel: options.logLevel,
-        silent: false,
-        // v2 pairings live here; keep this file to keep phones paired.
-        relayDataPath: join(daemon.linkshellDir(), "relay.db"),
-    });
-    daemon.savePid("gateway", process.pid);
-    process.stderr.write(`\n  LinkShell Gateway ${pkg.version}\n`);
-    process.stderr.write(`  Listening on http://0.0.0.0:${gw.port}\n`);
-    process.stderr.write(`  PID: ${process.pid}\n`);
-    process.stderr.write(`  Log level: ${options.logLevel}\n\n`);
-    process.stderr.write(`  Computers (v2):  linkshell host --gateway ws://this-server:${gw.port}\n`);
-    process.stderr.write(`  v1 clients:      ws://this-server:${gw.port}/ws\n`);
-    process.stderr.write(`  Health check: curl http://your-server:${gw.port}/healthz\n\n`);
-    const shutdown = async () => {
-        process.stderr.write("[gateway] shutting down...\n");
-        daemon.removePid("gateway");
-        await gw.close();
-        process.exit(0);
-    };
-    process.on("SIGINT", shutdown);
-    process.on("SIGTERM", shutdown);
-    await new Promise(() => { });
+    const { runGatewayForeground } = await import("./commands/gateway.js");
+    await runGatewayForeground(pkg.version, Number(options.port));
 });
 gatewayCmd
     .command("stop")
@@ -467,7 +218,7 @@ gatewayCmd
 // ── screen ──────────────────────────────────────────────────────────
 program
     .command("screen")
-    .description("Set this computer up for watching and controlling its screen from the phone (permissions, ffmpeg)")
+    .description("Set this computer up for watching and controlling its screen from the phone (the two macOS permissions; on Linux, ffmpeg)")
     .option("--check", "Only say what is and isn't ready")
     .action(async (options) => {
     const { runScreenSetup } = await import("./commands/screen.js");
@@ -475,19 +226,20 @@ program
     silenceSqliteWarning();
     await runScreenSetup({ check: options.check === true });
 });
-// ── stop (stops both bridge and gateway) ────────────────────────────
+// ── stop (the host and the gateway server) ──────────────────────────
 program
     .command("stop")
     .description("Stop all running LinkShell processes")
     .action(async () => {
     const { stopDaemon } = await import("./utils/daemon.js");
     const hostStopped = stopDaemon("host");
+    // A bridge left running by a 1.x install: nothing else here can end it.
     const bridgeStopped = stopDaemon("bridge");
     const gatewayStopped = stopDaemon("gateway");
     if (hostStopped)
         process.stderr.write("  Host stopped.\n");
     if (bridgeStopped)
-        process.stderr.write("  v1 bridge stopped.\n");
+        process.stderr.write("  1.x bridge stopped.\n");
     if (gatewayStopped)
         process.stderr.write("  Gateway server stopped.\n");
     if (!hostStopped && !bridgeStopped && !gatewayStopped) {
@@ -499,7 +251,7 @@ program
     .command("status")
     .description("Show the host, its gateway connection, and anything else LinkShell runs here")
     .action(async () => {
-    const { readPid, getLogFile, readMetadata } = await import("./utils/daemon.js");
+    const { readPid, getLogFile } = await import("./utils/daemon.js");
     const { printHostStatus, assertHostRuntime } = await import("./commands/host.js");
     assertHostRuntime();
     process.stdout.write("\n");
@@ -507,11 +259,6 @@ program
     const gatewayPid = readPid("gateway");
     if (gatewayPid)
         process.stdout.write(`  Gateway server: running (PID ${gatewayPid}), log ${getLogFile("gateway")}\n`);
-    const bridgePid = readPid("bridge");
-    if (bridgePid) {
-        const keepAwake = readMetadata("bridge")?.keepAwake ? ", keeps this computer awake" : "";
-        process.stdout.write(`  v1 bridge: running (PID ${bridgePid}${keepAwake}), log ${getLogFile("bridge")}\n`);
-    }
     process.stdout.write("\n");
 });
 // ── doctor / setup ──────────────────────────────────────────────────
@@ -524,9 +271,10 @@ program
 });
 program
     .command("setup")
-    .description("Configure the v1 bridge (`linkshell start`)")
+    .description("Set this computer up, once: the host, the screen's permissions, and your phone")
     .action(async () => {
-    await runSetup();
+    await runSetup(pkg.version);
+    process.exit(process.exitCode ?? 0);
 });
 program
     .command("upgrade")
@@ -551,71 +299,13 @@ program
     .action(async () => {
     await runLogout();
 });
-program
-    .command("list")
-    .description("List your v1 sessions on official gateways")
-    .action(async () => {
-    const { getValidToken, loadAuth, SUPABASE_URL, SUPABASE_ANON_KEY } = await import("./auth.js");
-    const token = await getValidToken();
-    if (!token) {
-        process.stderr.write("\n  Not logged in. Run: linkshell login\n\n");
-        return;
-    }
-    const auth = loadAuth();
-    process.stderr.write(`\n  Logged in as ${auth?.email || auth?.userId || "unknown"}\n\n`);
-    // Fetch official gateways
-    let gateways = [];
-    try {
-        const res = await fetch(`${SUPABASE_URL}/rest/v1/linkshell_official_gateways?enabled=eq.true&select=url,name,region`, {
-            headers: {
-                Authorization: `Bearer ${token}`,
-                apikey: SUPABASE_ANON_KEY,
-            },
-            signal: AbortSignal.timeout(10_000),
-        });
-        if (res.ok) {
-            gateways = (await res.json());
-        }
-    }
-    catch { }
-    if (gateways.length === 0) {
-        process.stderr.write("  No official gateways available.\n\n");
-        return;
-    }
-    process.stderr.write("  Official Gateways:\n\n");
-    for (const gw of gateways) {
-        const label = gw.region ? `${gw.name} (${gw.region})` : gw.name;
-        // Fetch user's sessions on this gateway
-        let sessions = [];
-        try {
-            const res = await fetch(`${gw.url}/sessions/mine`, {
-                headers: { Authorization: `Bearer ${token}` },
-                signal: AbortSignal.timeout(5_000),
-            });
-            if (res.ok) {
-                const body = (await res.json());
-                sessions = body.sessions;
-            }
-        }
-        catch { }
-        process.stderr.write(`  \x1b[32m✓\x1b[0m ${label}\n`);
-        const wsUrl = gw.url.replace(/\/$/, "").replace(/^https:/, "wss:").replace(/^http:/, "ws:") + "/ws";
-        process.stderr.write(`    ${wsUrl}\n`);
-        if (sessions.length === 0) {
-            process.stderr.write("    (no active sessions)\n\n");
-        }
-        else {
-            for (const s of sessions) {
-                const ago = Math.round((Date.now() - s.lastActivity) / 60_000);
-                const agoStr = ago < 1 ? "just now" : `${ago}m ago`;
-                const info = [s.provider, s.projectName].filter(Boolean).join(" · ");
-                const hostIcon = s.hasHost ? "\x1b[32m●\x1b[0m" : "\x1b[31m●\x1b[0m";
-                process.stderr.write(`    └ ${hostIcon} ${s.id.slice(0, 8)} — ${info || "unknown"} · ${agoStr}\n`);
-            }
-            process.stderr.write("\n");
-        }
-    }
-    process.stderr.write("  Connect: linkshell start --gateway <url>\n\n");
+// `linkshell` by itself, on a computer where nothing has been set up yet: the setup, rather than a page of help.
+program.action(async () => {
+    const { setupDone } = await import("./commands/setup.js");
+    if (process.stdin.isTTY !== true || process.stdout.isTTY !== true || (await setupDone()))
+        return program.help();
+    await runSetup(pkg.version);
+    process.exit(process.exitCode ?? 0);
 });
 program.parseAsync(process.argv).catch((error) => {
     const message = error instanceof Error ? error.message : String(error);