linkshell-cli 0.5.42 → 0.6.0

package/dist/wire/src/updates.js

@@ -0,0 +1,210 @@
+import { z } from "zod";
+import { permissionOptionSchema, sessionDriverSchema, sessionStateSchema, toolKindSchema } from "./model.js";
+// Session updates mirror ACP's `SessionUpdate` shapes (discriminated by
+// `sessionUpdate`) so one renderer works for every agent. LinkShell-specific
+// updates use the `ls_` prefix.
+export const contentBlockSchema = z.discriminatedUnion("type", [
+    z.object({ type: z.literal("text"), text: z.string() }),
+    z.object({
+        type: z.literal("image"),
+        mimeType: z.string(),
+        data: z.string().optional(),
+        uri: z.string().optional(),
+    }),
+    z.object({
+        type: z.literal("resource_link"),
+        uri: z.string(),
+        name: z.string(),
+        /** What the link names: a file (default), a skill the user invoked, or another agent. */
+        kind: z.enum(["file", "skill", "agent"]).optional(),
+    }),
+]);
+export const toolCallStatusSchema = z.enum(["pending", "in_progress", "completed", "failed"]);
+export const toolCallContentSchema = z.discriminatedUnion("type", [
+    z.object({ type: z.literal("content"), content: contentBlockSchema }),
+    /** ACP diff: full before/after text. */
+    z.object({
+        type: z.literal("diff"),
+        path: z.string(),
+        oldText: z.string().nullable().optional(),
+        newText: z.string(),
+    }),
+    /** Unified diff, for agents (Codex) that report patches rather than file text. */
+    z.object({
+        type: z.literal("patch"),
+        path: z.string(),
+        change: z.enum(["add", "delete", "update"]),
+        movePath: z.string().optional(),
+        diff: z.string(),
+    }),
+    z.object({ type: z.literal("terminal"), terminalId: z.string() }),
+]);
+export const toolCallLocationSchema = z.object({
+    path: z.string(),
+    line: z.number().int().optional(),
+});
+/**
+ * What a tool call is, when the agent tells us more than ACP's coarse `kind`.
+ * Host drivers fill it from each agent's own tool names; clients render it the
+ * same way for every agent and fall back to `title` + `kind` without it.
+ */
+export const toolDetailSchema = z.discriminatedUnion("type", [
+    z.object({ type: z.literal("mcp"), server: z.string(), tool: z.string() }),
+    z.object({
+        type: z.literal("subagent"),
+        /** spawn starts a sub-agent (its work nests under this call); the rest talk to one. */
+        action: z.enum(["spawn", "message", "wait", "stop", "resume", "list"]).default("spawn"),
+        task: z.string().optional(),
+        /** The sub-agent's role or type, e.g. "Explore". */
+        agentType: z.string().optional(),
+        model: z.string().optional(),
+    }),
+    z.object({ type: z.literal("skill"), name: z.string(), description: z.string().optional() }),
+    z.object({ type: z.literal("web_search"), query: z.string().optional() }),
+    z.object({ type: z.literal("image_generation"), prompt: z.string().optional() }),
+    z.object({ type: z.literal("compaction") }),
+    z.object({ type: z.literal("review"), phase: z.enum(["started", "finished"]) }),
+]);
+export const planEntrySchema = z.object({
+    content: z.string(),
+    priority: z.enum(["high", "medium", "low"]).default("medium"),
+    status: z.enum(["pending", "in_progress", "completed"]),
+});
+export const stopReasonSchema = z.enum(["end_turn", "cancelled", "error", "max_tokens", "refusal"]);
+export const sessionConfigOptionSchema = z.object({
+    /** Agent-defined id; "model" and "mode" are the common ones. */
+    id: z.string(),
+    name: z.string(),
+    category: z.enum(["model", "mode", "effort", "other"]).default("other"),
+    current: z.string(),
+    values: z.array(z.object({ value: z.string(), name: z.string(), description: z.string().optional() })),
+});
+export const sessionUpdateSchema = z.discriminatedUnion("sessionUpdate", [
+    z.object({
+        sessionUpdate: z.literal("user_message_chunk"),
+        messageId: z.string().optional(),
+        content: contentBlockSchema,
+    }),
+    z.object({
+        sessionUpdate: z.literal("agent_message_chunk"),
+        parentToolCallId: z.string().optional(),
+        messageId: z.string(),
+        content: contentBlockSchema,
+    }),
+    z.object({
+        sessionUpdate: z.literal("agent_thought_chunk"),
+        parentToolCallId: z.string().optional(),
+        messageId: z.string(),
+        content: contentBlockSchema,
+    }),
+    z.object({
+        sessionUpdate: z.literal("tool_call"),
+        toolCallId: z.string(),
+        /** Set when a sub-agent made this call: the sub-agent's own (spawn) tool call. */
+        parentToolCallId: z.string().optional(),
+        title: z.string(),
+        kind: toolKindSchema,
+        status: toolCallStatusSchema,
+        rawInput: z.unknown().optional(),
+        content: z.array(toolCallContentSchema).optional(),
+        locations: z.array(toolCallLocationSchema).optional(),
+        detail: toolDetailSchema.optional(),
+    }),
+    z.object({
+        sessionUpdate: z.literal("tool_call_update"),
+        toolCallId: z.string(),
+        parentToolCallId: z.string().optional(),
+        status: toolCallStatusSchema.optional(),
+        title: z.string().optional(),
+        detail: toolDetailSchema.optional(),
+        /** Replaces the tool call's content when present. */
+        content: z.array(toolCallContentSchema).optional(),
+        /** Streamed output appended to the tool call's running output. */
+        appendOutput: z.string().optional(),
+        rawOutput: z.unknown().optional(),
+    }),
+    z.object({
+        sessionUpdate: z.literal("plan"),
+        entries: z.array(planEntrySchema),
+    }),
+    z.object({
+        sessionUpdate: z.literal("available_commands_update"),
+        availableCommands: z.array(z.object({ name: z.string(), description: z.string(), hint: z.string().optional() })),
+    }),
+    z.object({
+        sessionUpdate: z.literal("current_mode_update"),
+        currentModeId: z.string(),
+    }),
+    z.object({
+        sessionUpdate: z.literal("session_info_update"),
+        title: z.string().optional(),
+        model: z.string().optional(),
+    }),
+    z.object({
+        sessionUpdate: z.literal("usage_update"),
+        usedTokens: z.number().optional(),
+        contextWindow: z.number().optional(),
+    }),
+    // ── LinkShell extensions ──
+    z.object({
+        sessionUpdate: z.literal("ls_message_done"),
+        parentToolCallId: z.string().optional(),
+        messageId: z.string(),
+        role: z.enum(["agent", "thought", "user"]),
+    }),
+    /** Selectable session settings (model, permission mode, effort…) as the agent reports them. */
+    z.object({
+        sessionUpdate: z.literal("ls_config"),
+        options: z.array(sessionConfigOptionSchema),
+    }),
+    z.object({
+        sessionUpdate: z.literal("ls_notice"),
+        level: z.enum(["info", "warning"]),
+        title: z.string(),
+        detail: z.string().optional(),
+    }),
+    z.object({
+        sessionUpdate: z.literal("ls_turn"),
+        /** A sub-agent's turn: whether the sub-agent under this call is working. */
+        parentToolCallId: z.string().optional(),
+        state: z.enum(["started", "ended"]),
+        turnId: z.string().optional(),
+        stopReason: stopReasonSchema.optional(),
+    }),
+    z.object({
+        sessionUpdate: z.literal("ls_permission"),
+        requestId: z.string(),
+        toolCallId: z.string().optional(),
+        title: z.string(),
+        detail: z.string().optional(),
+        options: z.array(permissionOptionSchema).min(1),
+    }),
+    z.object({
+        sessionUpdate: z.literal("ls_permission_resolved"),
+        requestId: z.string(),
+        optionId: z.string().optional(),
+    }),
+    z.object({
+        sessionUpdate: z.literal("ls_driver"),
+        driver: sessionDriverSchema,
+        deviceId: z.string().optional(),
+    }),
+    z.object({
+        sessionUpdate: z.literal("ls_status"),
+        state: sessionStateSchema,
+    }),
+    z.object({
+        sessionUpdate: z.literal("ls_error"),
+        code: z.string(),
+        message: z.string(),
+        hint: z.string().optional(),
+    }),
+]);
+/** One entry in a session's append-only event log. */
+export const sessionEventSchema = z.object({
+    sessionId: z.string(),
+    seq: z.number().int().positive(),
+    ts: z.number(),
+    update: sessionUpdateSchema,
+});
+//# sourceMappingURL=updates.js.map

package/dist/wire/src/updates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updates.js","sourceRoot":"","sources":["../../../../wire/src/updates.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linkshell-cli",
-  "version": "0.5.42",
+  "version": "0.6.0",
   "description": "Remote terminal bridge for Claude Code / Codex / Gemini / Copilot — control from your phone",
   "type": "module",
   "main": "dist/index.js",
@@ -36,8 +36,10 @@
     "qrcode-terminal": "^0.12.0",
     "ws": "^8.18.1",
     "zod": "^3.24.3",
-    "@linkshell/gateway": "0.4.55",
-    "@linkshell/protocol": "0.4.10"
+    "@linkshell/gateway": "0.5.0",
+    "@linkshell/protocol": "0.4.10",
+    "@linkshell/host": "0.1.0",
+    "@linkshell/wire": "0.1.0"
   },
   "optionalDependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.2.128",
@@ -48,6 +50,9 @@
     "tsx": "^4.19.3",
     "vitest": "^3.2.1"
   },
+  "engines": {
+    "node": ">=22.13"
+  },
   "scripts": {
     "build": "tsc -p tsconfig.json && node scripts/copy-web.mjs",
     "postinstall": "node scripts/postinstall.mjs",

package/src/commands/host.ts

@@ -0,0 +1,283 @@
+import { spawn } from "node:child_process";
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { getValidToken } from "../auth.js";
+import * as daemon from "../utils/daemon.js";
+
+// node:sqlite prints an ExperimentalWarning on load; it is expected here and
+// only confuses users. Must run before the host (and node:sqlite) is imported.
+function silenceSqliteWarning(): void {
+  const emit = process.emitWarning.bind(process);
+  process.emitWarning = ((warning: string | Error, ...rest: unknown[]) => {
+    const message = typeof warning === "string" ? warning : warning.message;
+    if (message.includes("SQLite")) return;
+    return (emit as (...args: unknown[]) => void)(warning, ...rest);
+  }) as typeof process.emitWarning;
+}
+
+interface HostConfig {
+  /** v2 gateway base URL (ws:// or wss://). */
+  gateway?: string;
+}
+
+function configPath(home: string): string {
+  return join(home, "config.json");
+}
+
+export function readHostConfig(home: string): HostConfig {
+  try {
+    return JSON.parse(readFileSync(configPath(home), "utf8")) as HostConfig;
+  } catch {
+    return {};
+  }
+}
+
+export function writeHostConfig(home: string, config: HostConfig): void {
+  mkdirSync(home, { recursive: true });
+  writeFileSync(configPath(home), `${JSON.stringify(config, null, 2)}\n`, { mode: 0o600 });
+}
+
+/** The host keeps its state in node:sqlite, unflagged from Node 22.13. */
+export function assertHostRuntime(): void {
+  const [major = 0, minor = 0] = process.versions.node.split(".").map(Number);
+  if (major > 22 || (major === 22 && minor >= 13)) return;
+  process.stderr.write(
+    `\n  LinkShell's host needs Node.js 22.13 or newer (this is ${process.version}).\n` +
+      "  Upgrade Node (for example: nvm install 22, or brew upgrade node), then try again.\n\n",
+  );
+  process.exit(1);
+}
+
+async function loadHost() {
+  assertHostRuntime();
+  silenceSqliteWarning();
+  return import("@linkshell/host");
+}
+
+/** Runs the host in this process until SIGINT/SIGTERM. */
+export async function runHostForeground(version: string): Promise<void> {
+  const host = await loadHost();
+  const log = (message: string) => process.stderr.write(`${new Date().toISOString()} ${message}\n`);
+  process.on("uncaughtException", (error) => log(`[host] uncaught: ${error.stack ?? error.message}`));
+  process.on("unhandledRejection", (reason) =>
+    log(`[host] unhandled rejection: ${reason instanceof Error ? (reason.stack ?? reason.message) : String(reason)}`),
+  );
+  // Started from a terminal (by `linkshell`): use that environment as is.
+  // Otherwise (launchd, a bare process) recover the login shell's.
+  const env = process.env.LINKSHELL_ENV_FROM_TERMINAL === "1" ? process.env : await host.resolveLoginShellEnv();
+  const adapter = process.env.LINKSHELL_CLAUDE_ADAPTER;
+  const devPort = process.env.LINKSHELL_DEV_PORT ? Number(process.env.LINKSHELL_DEV_PORT) : undefined;
+  // Where devices reach this machine from outside the LAN. The account from
+  // `linkshell login`, if any, lets that account's devices in without pairing.
+  const gatewayUrl = process.env.LINKSHELL_GATEWAY || readHostConfig(host.defaultHome()).gateway;
+  const running = await host.startHost({
+    version,
+    env,
+    log,
+    gateway: gatewayUrl ? { url: gatewayUrl, token: async () => (await getValidToken()) ?? undefined } : undefined,
+    tcpPort: devPort,
+    claudeCommand: process.env.LINKSHELL_CLAUDE_COMMAND || undefined,
+    claudeAdapter: adapter ? { command: adapter, args: [] } : undefined,
+  });
+  daemon.savePid("host", process.pid);
+  const info = running.machineInfo();
+  log(`[host] LinkShell host ${version} listening on ${running.paths.hostSocket}`);
+  if (devPort !== undefined) log(`[host] development API on ws://127.0.0.1:${running.server.tcpAddress() ?? devPort} (loopback only)`);
+  for (const agent of info.agents) {
+    log(
+      `[host] ${agent.label}: ${agent.installed ? `v${agent.version ?? "?"}${agent.problem ? ` — ${agent.problem}` : ""}` : "not installed"}`,
+    );
+  }
+  const shutdown = async () => {
+    log("[host] shutting down");
+    daemon.removePid("host");
+    await running.stop();
+    process.exit(0);
+  };
+  process.on("SIGINT", () => void shutdown());
+  process.on("SIGTERM", () => void shutdown());
+  await new Promise(() => {});
+}
+
+/** Starts the host in the background unless one already answers. */
+export async function ensureHostRunning(): Promise<string> {
+  const host = await loadHost();
+  const { hostSocket } = host.hostPaths();
+  if (await host.isHostRunning(hostSocket)) return hostSocket;
+  daemon.spawnDaemon("host", ["host", "--_foreground-host"]);
+  const deadline = Date.now() + 20_000;
+  while (Date.now() < deadline) {
+    if (await host.isHostRunning(hostSocket)) return hostSocket;
+    await new Promise((resolve) => setTimeout(resolve, 150));
+  }
+  throw new Error(`LinkShell host did not start; see ${daemon.getLogFile("host")}`);
+}
+
+export async function printHostStatus(): Promise<void> {
+  const host = await loadHost();
+  const { hostSocket } = host.hostPaths();
+  if (!(await host.isHostRunning(hostSocket))) {
+    process.stderr.write("  LinkShell host is not running. Start it with: linkshell host --daemon\n");
+    process.exitCode = 1;
+    return;
+  }
+  const client = await host.connectHost(hostSocket);
+  try {
+    const info = await client.call("machine.info", {});
+    const { sessions } = await client.call("sessions.list", { limit: 200 });
+    process.stdout.write(`  Host ${info.hostVersion} on ${info.hostname} (${hostSocket})\n`);
+    for (const agent of info.agents) {
+      const state = agent.installed ? `v${agent.version ?? "?"}${agent.problem ? `  ⚠ ${agent.problem}` : ""}` : "not installed";
+      const auth =
+        agent.auth?.state === "ok"
+          ? `  login: ${agent.auth.method ?? "ok"}`
+          : agent.auth?.state === "missing"
+            ? `  ⚠ ${agent.auth.hint ?? "not logged in"}`
+            : "";
+      process.stdout.write(`  ${agent.label.padEnd(10)} ${agent.tier.padEnd(13)} ${state}${auth}\n`);
+    }
+    const active = sessions.filter((s) => s.state === "running" || s.state === "waiting");
+    process.stdout.write(`  Sessions: ${sessions.length} known, ${active.length} active\n`);
+    const gateway = await client.call("gateway.status", {});
+    if (gateway.status === "off") {
+      process.stdout.write("  Gateway:  off (linkshell host --gateway <url>)\n");
+    } else {
+      const account = gateway.account ? `, account ${gateway.account.email ?? gateway.account.userId}` : "";
+      const problem = gateway.error ? `  ⚠ ${gateway.error.message}` : "";
+      process.stdout.write(`  Gateway:  ${gateway.status} ${gateway.url}${account}${problem}\n`);
+      for (const device of gateway.devices) {
+        process.stdout.write(`    ${device.online ? "●" : "○"} ${device.name}  paired ${new Date(device.pairedAt).toLocaleDateString()}\n`);
+      }
+    }
+  } finally {
+    client.close();
+  }
+}
+
+interface LaunchSpec {
+  command: string;
+  args: string[];
+  env?: Record<string, string>;
+}
+
+function runChild(launch: LaunchSpec, onSpawn?: (child: import("node:child_process").ChildProcess) => void): Promise<number> {
+  const child = spawn(launch.command, launch.args, {
+    stdio: "inherit",
+    env: { ...process.env, ...launch.env },
+  });
+  onSpawn?.(child);
+  // The terminal delivers Ctrl-C to the whole foreground group; the agent handles it.
+  const ignore = () => {};
+  process.on("SIGINT", ignore);
+  process.on("SIGQUIT", ignore);
+  return new Promise<number>((resolve) => {
+    const done = (code: number) => {
+      process.off("SIGINT", ignore);
+      process.off("SIGQUIT", ignore);
+      resolve(code);
+    };
+    child.once("exit", (exitCode, signal) => done(exitCode ?? (signal ? 128 + 15 : 1)));
+    child.once("error", (error) => {
+      process.stderr.write(`linkshell: could not start ${launch.command}: ${error.message}\n`);
+      done(127);
+    });
+  });
+}
+
+/** Undo what a killed full-screen TUI may have left on: alt screen, hidden cursor, mouse/paste modes. */
+function restoreTerminal(): void {
+  if (!process.stdout.isTTY) return;
+  process.stdout.write("\x1b[?1049l\x1b[?25h\x1b[?2004l\x1b[?1000l\x1b[?1002l\x1b[?1003l\x1b[?1006l\x1b[0m\r\n");
+}
+
+/** Resolves with the first key pressed; "\u0003" for Ctrl-C. */
+function waitForKey(): Promise<string> {
+  return new Promise((resolve) => {
+    const stdin = process.stdin;
+    const raw = stdin.isTTY;
+    if (raw) stdin.setRawMode(true);
+    stdin.resume();
+    stdin.once("data", (data) => {
+      if (raw) stdin.setRawMode(false);
+      stdin.pause();
+      resolve(data.toString("utf8"));
+    });
+  });
+}
+
+/**
+ * `linkshell <agent> [args…]`: starts the agent's native UI attached to the
+ * host, so the same session is live on the desktop and on every paired device.
+ *
+ * For handoff agents (Claude) the terminal stays the session's desktop seat:
+ * when a device takes over, the TUI exits and the terminal shows the remote
+ * progress; any key brings the session back to the TUI.
+ */
+export async function runAgentShim(agent: string, args: string[]): Promise<void> {
+  const host = await loadHost();
+  const socket = await ensureHostRunning();
+  const client = await host.connectHost(socket);
+  let launch: LaunchSpec & { sessionId?: string };
+  try {
+    launch = await client.call("desktop.launch", { agent, args, cwd: process.cwd() });
+  } catch (error) {
+    client.close();
+    process.stderr.write(`linkshell: ${error instanceof Error ? error.message : String(error)}\n`);
+    process.exit(1);
+  }
+  if (!launch.sessionId) {
+    // Multi-client agents (Codex): the TUI simply joins the shared server.
+    client.close();
+    process.exit(await runChild(launch));
+  }
+
+  const sessionId = launch.sessionId;
+  let child: import("node:child_process").ChildProcess | undefined;
+  let yielded = false;
+  let showingRemote = false;
+  client.on("desktop.yield", ({ sessionId: target }) => {
+    if (target !== sessionId) return;
+    yielded = true;
+    child?.kill("SIGTERM");
+  });
+  client.on("desktop.remoteActivity", ({ sessionId: target, line }) => {
+    if (target === sessionId && showingRemote) process.stdout.write(`${line}\n`);
+  });
+
+  for (;;) {
+    yielded = false;
+    const code = await runChild(launch, (spawned) => (child = spawned));
+    if (!yielded) {
+      // The user quit the TUI: the session stays available on every device.
+      client.close();
+      process.exit(code);
+    }
+    await client.call("desktop.yielded", { sessionId }).catch(() => {});
+    restoreTerminal();
+    process.stdout.write(
+      [
+        "─".repeat(48),
+        "📱 已由手机接管，会话在手机上继续",
+        "   按任意键收回到电脑 · Ctrl-C 退出（会话留在手机上）",
+        "─".repeat(48),
+        "",
+      ].join("\n"),
+    );
+    showingRemote = true;
+    const key = await waitForKey();
+    showingRemote = false;
+    if (key === "\u0003") {
+      client.close();
+      process.exit(0);
+    }
+    process.stdout.write("↩︎ 正在收回到电脑…\n");
+    try {
+      const spec = await client.call("desktop.reclaim", { sessionId });
+      launch = { ...spec, sessionId };
+    } catch (error) {
+      process.stderr.write(`linkshell: 收回失败：${error instanceof Error ? error.message : String(error)}\n`);
+      client.close();
+      process.exit(1);
+    }
+  }
+}

package/src/commands/pair.ts

@@ -0,0 +1,47 @@
+import qrcode from "qrcode-terminal";
+
+// `linkshell pair`: show a QR code (and a code to type) that lets a phone reach
+// this computer through the gateway, then wait for it to pair.
+
+export async function runPair(): Promise<void> {
+  const { ensureHostRunning, assertHostRuntime } = await import("./host.js");
+  assertHostRuntime();
+  const { connectHost } = await import("@linkshell/host");
+  const socket = await ensureHostRunning();
+  const client = await connectHost(socket);
+  try {
+    const status = await client.call("gateway.status", {});
+    if (status.status === "off") {
+      process.stderr.write("\n  No gateway configured. Choose one first:\n\n    linkshell host --gateway wss://your-gateway\n\n");
+      process.exitCode = 1;
+      return;
+    }
+    let offer;
+    try {
+      offer = await client.call("pairing.start", {}, 20_000);
+    } catch (error) {
+      process.stderr.write(`\n  Couldn't start pairing: ${error instanceof Error ? error.message : String(error)}\n\n`);
+      process.exitCode = 1;
+      return;
+    }
+    process.stdout.write("\n  Scan with the LinkShell app (电脑 → 添加电脑):\n\n");
+    qrcode.generate(offer.link, { small: true }, (art) => process.stdout.write(`${art.replace(/^/gm, "  ")}\n`));
+    const code = `${offer.code.slice(0, 3)} ${offer.code.slice(3)}`;
+    const minutes = Math.round((offer.expiresAt - Date.now()) / 60_000);
+    process.stdout.write(`\n  Or enter the code:  ${code}   (valid ${minutes} min, gateway ${offer.gateway})\n\n  Waiting for your phone…`);
+    const device = await new Promise<{ name: string } | undefined>((resolve) => {
+      const stop = client.on("pairing.done", ({ device }) => {
+        stop();
+        resolve(device);
+      });
+      setTimeout(() => {
+        stop();
+        resolve(undefined);
+      }, offer.expiresAt - Date.now());
+      process.on("SIGINT", () => resolve(undefined));
+    });
+    process.stdout.write(device ? `\r  ✓ Paired with ${device.name}. It can reach this computer from anywhere now.\n\n` : "\r  Pairing window closed.            \n\n");
+  } finally {
+    client.close();
+  }
+}

package/src/index.ts

@@ -55,6 +55,79 @@ program
   )
   .version(pkg.version);
 
+// ── host (v2 session daemon) ────────────────────────────────────────
+
+const hostCmd = program
+  .command("host")
+  .description("Run the LinkShell host that owns agent sessions (v2)")
+  .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)")
+  .option("--_foreground-host", undefined) // internal
+  .action(async (options) => {
+    const { runHostForeground, ensureHostRunning, readHostConfig, writeHostConfig, assertHostRuntime } = await import("./commands/host.js");
+    assertHostRuntime();
+    if (options.devPort) process.env.LINKSHELL_DEV_PORT = String(options.devPort);
+    if (options.gateway) {
+      const { defaultHome } = await import("@linkshell/host");
+      const home = defaultHome();
+      writeHostConfig(home, { ...readHostConfig(home), gateway: options.gateway === "off" ? undefined : options.gateway });
+    }
+    if (options.daemon && !options._foregroundHost) {
+      const socket = await ensureHostRunning();
+      const daemon = await import("./utils/daemon.js");
+      process.stderr.write(`\n  LinkShell host running (${socket})\n`);
+      process.stderr.write(`  Log:    ${daemon.getLogFile("host")}\n`);
+      process.stderr.write(`  Status: linkshell host status\n`);
+      process.stderr.write(`  Stop:   linkshell host stop\n\n`);
+      return;
+    }
+    await runHostForeground(pkg.version);
+  });
+
+hostCmd
+  .command("status")
+  .description("Show the host, its agents and sessions")
+  .action(async () => {
+    const { printHostStatus } = await import("./commands/host.js");
+    await printHostStatus();
+  });
+
+hostCmd
+  .command("stop")
+  .description("Stop the background host")
+  .action(async () => {
+    const daemon = await import("./utils/daemon.js");
+    process.stderr.write(daemon.stopDaemon("host") ? "  LinkShell host stopped\n" : "  LinkShell host is not running\n");
+  });
+
+program
+  .command("pair")
+  .description("Pair a phone with this computer through the gateway (shows a QR code)")
+  .action(async () => {
+    const { runPair } = await import("./commands/pair.js");
+    await runPair();
+  });
+
+// `linkshell codex …` / `linkshell claude …` start the agent's own TUI attached
+// to the host, so the session is live here and on every paired device.
+// All arguments go to the agent.
+for (const [agent, description] of [
+  ["codex", "Start Codex attached to the LinkShell host (arguments pass through)"],
+  ["claude", "Start Claude Code with phone handoff (arguments pass through)"],
+] as const) {
+  program
+    .command(agent)
+    .description(description)
+    .argument("[args...]")
+    .allowUnknownOption(true)
+    .helpOption(false)
+    .action(async (args: string[]) => {
+      const { runAgentShim } = await import("./commands/host.js");
+      await runAgentShim(agent, args ?? []);
+    });
+}
+
 // ── start ───────────────────────────────────────────────────────────
 
 program