setup-agent 0.0.8 → 0.0.9

package/dist/agents.d.ts

@@ -0,0 +1,33 @@
+/**
+ * A coding agent a person can hand a setup to. `launch` is set when the
+ * agent has a terminal command that opens an interactive session with a
+ * first prompt; the others are handed the prompt to paste.
+ */
+export type CodingAgent = {
+    kind: string;
+    name: string;
+    launch?: {
+        /** Command names to try in order; the first one on PATH runs. */
+        commands: readonly string[];
+        args: (prompt: string) => string[];
+        install: string;
+    };
+};
+/** The coding agents people use most, in the order the picker lists them. */
+export declare const CODING_AGENTS: readonly CodingAgent[];
+/** The coding agent this process runs under, from the variables each one exports to its shell. */
+export declare const detectAgentKind: (env?: NodeJS.ProcessEnv) => string | undefined;
+/** True when a person typed the command into a terminal rather than an agent running it from its shell. */
+export declare const isDirectInvocation: (env?: NodeJS.ProcessEnv, stdin?: {
+    isTTY?: boolean | undefined;
+}, stdout?: {
+    isTTY?: boolean | undefined;
+}) => boolean;
+/** The first of `commands` found on PATH, or `undefined`. */
+export declare const findCommand: (commands: readonly string[], env?: NodeJS.ProcessEnv) => string | undefined;
+/**
+ * Starts `agent` in this terminal with `prompt` as its first message and
+ * resolves with its exit code; `undefined` when its command is not installed.
+ */
+export declare const runCodingAgent: (agent: CodingAgent, prompt: string) => Promise<number | undefined>;
+//# sourceMappingURL=agents.d.ts.map

package/dist/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE;QACP,iEAAiE;QACjE,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;QAC5B,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;QACnC,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAqG/C,CAAC;AA2CF,kGAAkG;AAClG,eAAO,MAAM,eAAe,GAC1B,MAAK,MAAM,CAAC,UAAwB,KACnC,MAAM,GAAG,SAaX,CAAC;AAEF,2GAA2G;AAC3G,eAAO,MAAM,kBAAkB,GAC7B,MAAK,MAAM,CAAC,UAAwB,EACpC,QAAO;IAAE,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAAkB,EACtD,SAAQ;IAAE,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAAmB,YAInC,CAAC;AAExB,6DAA6D;AAC7D,eAAO,MAAM,WAAW,GACtB,UAAU,SAAS,MAAM,EAAE,EAC3B,MAAK,MAAM,CAAC,UAAwB,KACnC,MAAM,GAAG,SAoBX,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,WAAW,EAClB,QAAQ,MAAM,KACb,OAAO,CAAC,MAAM,GAAG,SAAS,CAgB5B,CAAC"}

package/dist/agents.js

@@ -0,0 +1,221 @@
+import spawn from "cross-spawn";
+import { accessSync, constants } from "node:fs";
+import { delimiter, join } from "node:path";
+// src/agents.ts
+/** The coding agents people use most, in the order the picker lists them. */
+const CODING_AGENTS = [
+	{
+		kind: "claude",
+		name: "Claude Code",
+		launch: {
+			commands: ["claude"],
+			args: (prompt) => [prompt],
+			install: "npm install -g @anthropic-ai/claude-code"
+		}
+	},
+	{
+		kind: "codex",
+		name: "Codex",
+		launch: {
+			commands: ["codex"],
+			args: (prompt) => [prompt],
+			install: "npm install -g @openai/codex"
+		}
+	},
+	{
+		kind: "cursor",
+		name: "Cursor",
+		launch: {
+			commands: ["cursor-agent", "agent"],
+			args: (prompt) => [prompt],
+			install: "curl https://cursor.com/install -fsS | bash"
+		}
+	},
+	{
+		kind: "gemini",
+		name: "Gemini CLI",
+		launch: {
+			commands: ["gemini"],
+			args: (prompt) => ["-i", prompt],
+			install: "npm install -g @google/gemini-cli"
+		}
+	},
+	{
+		kind: "copilot",
+		name: "Copilot CLI",
+		launch: {
+			commands: ["copilot"],
+			args: (prompt) => ["-i", prompt],
+			install: "npm install -g @github/copilot"
+		}
+	},
+	{
+		kind: "amp",
+		name: "Amp"
+	},
+	{
+		kind: "opencode",
+		name: "OpenCode",
+		launch: {
+			commands: ["opencode"],
+			args: (prompt) => ["--prompt", prompt],
+			install: "npm install -g opencode-ai"
+		}
+	},
+	{
+		kind: "cline",
+		name: "Cline"
+	},
+	{
+		kind: "aider",
+		name: "Aider"
+	},
+	{
+		kind: "goose",
+		name: "Goose"
+	},
+	{
+		kind: "warp",
+		name: "Warp"
+	},
+	{
+		kind: "windsurf",
+		name: "Windsurf"
+	},
+	{
+		kind: "kiro",
+		name: "Kiro",
+		launch: {
+			commands: ["kiro-cli"],
+			args: (prompt) => ["chat", prompt],
+			install: "curl -fsSL https://cli.kiro.dev/install | bash"
+		}
+	},
+	{
+		kind: "junie",
+		name: "Junie"
+	},
+	{
+		kind: "qwen",
+		name: "Qwen Code",
+		launch: {
+			commands: ["qwen"],
+			args: (prompt) => ["-i", prompt],
+			install: "npm install -g @qwen-code/qwen-code"
+		}
+	},
+	{
+		kind: "roo",
+		name: "Roo Code"
+	},
+	{
+		kind: "zed",
+		name: "Zed"
+	},
+	{
+		kind: "augment",
+		name: "Augment",
+		launch: {
+			commands: ["auggie"],
+			args: (prompt) => [prompt],
+			install: "npm install -g @augmentcode/auggie"
+		}
+	},
+	{
+		kind: "droid",
+		name: "Factory Droid",
+		launch: {
+			commands: ["droid"],
+			args: (prompt) => [prompt],
+			install: "curl -fsSL https://app.factory.ai/cli | sh"
+		}
+	},
+	{
+		kind: "crush",
+		name: "Crush"
+	}
+];
+/** The variables each agent exports to the shells it runs commands in. */
+const AGENT_ENV = [
+	["claude", "CLAUDECODE"],
+	["claude", "CLAUDE_CODE"],
+	["codex", "CODEX_SANDBOX"],
+	["codex", "CODEX_SANDBOX_NETWORK_DISABLED"],
+	["codex", "CODEX_CI"],
+	["codex", "CODEX_THREAD_ID"],
+	["cursor", "CURSOR_AGENT"],
+	["gemini", "GEMINI_CLI"],
+	["qwen", "QWEN_CODE"],
+	["copilot", "COPILOT_AGENT"],
+	["copilot", "COPILOT_CLI"],
+	["opencode", "OPENCODE_CLIENT"],
+	["augment", "AUGMENT_AGENT"],
+	["junie", "JUNIE_DATA"]
+];
+/** `AI_AGENT` values name the agent first, such as `claude-code_2-1-3_agent` or `github-copilot`. */
+const AI_AGENT_PREFIXES = [
+	["claude", "claude"],
+	["codex", "codex"],
+	["cursor", "cursor"],
+	["gemini", "gemini"],
+	["github-copilot", "copilot"],
+	["github_copilot", "copilot"],
+	["copilot", "copilot"],
+	["opencode", "opencode"],
+	["augment", "augment"],
+	["auggie", "augment"],
+	["qwen", "qwen"],
+	["amp", "amp"],
+	["goose", "goose"],
+	["junie", "junie"],
+	["droid", "droid"],
+	["factory", "droid"],
+	["kiro", "kiro"],
+	["cline", "cline"],
+	["crush", "crush"]
+];
+/** The coding agent this process runs under, from the variables each one exports to its shell. */
+const detectAgentKind = (env = process.env) => {
+	const named = env.AI_AGENT?.trim().toLowerCase();
+	if (named) return AI_AGENT_PREFIXES.find(([prefix]) => named.startsWith(prefix) && (named.length === prefix.length || /[-_ ./0-9]/.test(named[prefix.length])))?.[1] ?? "other";
+	return AGENT_ENV.find(([, variable]) => env[variable])?.[0];
+};
+/** True when a person typed the command into a terminal rather than an agent running it from its shell. */
+const isDirectInvocation = (env = process.env, stdin = process.stdin, stdout = process.stdout) => detectAgentKind(env) === void 0 && stdin.isTTY === true && stdout.isTTY === true;
+/** The first of `commands` found on PATH, or `undefined`. */
+const findCommand = (commands, env = process.env) => {
+	const directories = (env.PATH ?? "").split(delimiter).filter(Boolean);
+	const extensions = process.platform === "win32" ? (env.PATHEXT ?? ".EXE;.CMD;.BAT").split(";") : [""];
+	return commands.find((command) => directories.some((directory) => extensions.some((extension) => {
+		try {
+			accessSync(join(directory, command + extension), constants.X_OK);
+			return true;
+		} catch {
+			return false;
+		}
+	})));
+};
+/**
+* Starts `agent` in this terminal with `prompt` as its first message and
+* resolves with its exit code; `undefined` when its command is not installed.
+*/
+const runCodingAgent = (agent, prompt) => {
+	const launch = agent.launch;
+	if (!launch) return Promise.resolve(void 0);
+	const command = findCommand(launch.commands);
+	if (command === void 0) return Promise.resolve(void 0);
+	const child = spawn(command, launch.args(prompt), { stdio: "inherit" });
+	return new Promise((resolve) => {
+		child.on("error", (error) => {
+			if (error.code === "ENOENT") resolve(void 0);
+			else {
+				process.stderr.write(`${error.message}\n`);
+				resolve(1);
+			}
+		});
+		child.on("exit", (status) => resolve(status ?? 1));
+	});
+};
+export { CODING_AGENTS, detectAgentKind, findCommand, isDirectInvocation, runCodingAgent };
+
+//# sourceMappingURL=agents.js.map

package/dist/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","names":[],"sources":["../src/agents.ts"],"sourcesContent":["import spawn from \"cross-spawn\";\nimport { accessSync, constants } from \"node:fs\";\nimport { delimiter, join } from \"node:path\";\n\n/**\n * A coding agent a person can hand a setup to. `launch` is set when the\n * agent has a terminal command that opens an interactive session with a\n * first prompt; the others are handed the prompt to paste.\n */\nexport type CodingAgent = {\n  kind: string;\n  name: string;\n  launch?: {\n    /** Command names to try in order; the first one on PATH runs. */\n    commands: readonly string[];\n    args: (prompt: string) => string[];\n    install: string;\n  };\n};\n\n/** The coding agents people use most, in the order the picker lists them. */\nexport const CODING_AGENTS: readonly CodingAgent[] = [\n  {\n    kind: \"claude\",\n    name: \"Claude Code\",\n    launch: {\n      commands: [\"claude\"],\n      args: (prompt) => [prompt],\n      install: \"npm install -g @anthropic-ai/claude-code\",\n    },\n  },\n  {\n    kind: \"codex\",\n    name: \"Codex\",\n    launch: {\n      commands: [\"codex\"],\n      args: (prompt) => [prompt],\n      install: \"npm install -g @openai/codex\",\n    },\n  },\n  {\n    kind: \"cursor\",\n    name: \"Cursor\",\n    launch: {\n      commands: [\"cursor-agent\", \"agent\"],\n      args: (prompt) => [prompt],\n      install: \"curl https://cursor.com/install -fsS | bash\",\n    },\n  },\n  {\n    kind: \"gemini\",\n    name: \"Gemini CLI\",\n    launch: {\n      commands: [\"gemini\"],\n      args: (prompt) => [\"-i\", prompt],\n      install: \"npm install -g @google/gemini-cli\",\n    },\n  },\n  {\n    kind: \"copilot\",\n    name: \"Copilot CLI\",\n    launch: {\n      commands: [\"copilot\"],\n      args: (prompt) => [\"-i\", prompt],\n      install: \"npm install -g @github/copilot\",\n    },\n  },\n  { kind: \"amp\", name: \"Amp\" },\n  {\n    kind: \"opencode\",\n    name: \"OpenCode\",\n    launch: {\n      commands: [\"opencode\"],\n      args: (prompt) => [\"--prompt\", prompt],\n      install: \"npm install -g opencode-ai\",\n    },\n  },\n  { kind: \"cline\", name: \"Cline\" },\n  { kind: \"aider\", name: \"Aider\" },\n  { kind: \"goose\", name: \"Goose\" },\n  { kind: \"warp\", name: \"Warp\" },\n  { kind: \"windsurf\", name: \"Windsurf\" },\n  {\n    kind: \"kiro\",\n    name: \"Kiro\",\n    launch: {\n      commands: [\"kiro-cli\"],\n      args: (prompt) => [\"chat\", prompt],\n      install: \"curl -fsSL https://cli.kiro.dev/install | bash\",\n    },\n  },\n  { kind: \"junie\", name: \"Junie\" },\n  {\n    kind: \"qwen\",\n    name: \"Qwen Code\",\n    launch: {\n      commands: [\"qwen\"],\n      args: (prompt) => [\"-i\", prompt],\n      install: \"npm install -g @qwen-code/qwen-code\",\n    },\n  },\n  { kind: \"roo\", name: \"Roo Code\" },\n  { kind: \"zed\", name: \"Zed\" },\n  {\n    kind: \"augment\",\n    name: \"Augment\",\n    launch: {\n      commands: [\"auggie\"],\n      args: (prompt) => [prompt],\n      install: \"npm install -g @augmentcode/auggie\",\n    },\n  },\n  {\n    kind: \"droid\",\n    name: \"Factory Droid\",\n    launch: {\n      commands: [\"droid\"],\n      args: (prompt) => [prompt],\n      install: \"curl -fsSL https://app.factory.ai/cli | sh\",\n    },\n  },\n  { kind: \"crush\", name: \"Crush\" },\n];\n\n/** The variables each agent exports to the shells it runs commands in. */\nconst AGENT_ENV: readonly [kind: string, variable: string][] = [\n  [\"claude\", \"CLAUDECODE\"],\n  [\"claude\", \"CLAUDE_CODE\"],\n  [\"codex\", \"CODEX_SANDBOX\"],\n  [\"codex\", \"CODEX_SANDBOX_NETWORK_DISABLED\"],\n  [\"codex\", \"CODEX_CI\"],\n  [\"codex\", \"CODEX_THREAD_ID\"],\n  [\"cursor\", \"CURSOR_AGENT\"],\n  [\"gemini\", \"GEMINI_CLI\"],\n  [\"qwen\", \"QWEN_CODE\"],\n  [\"copilot\", \"COPILOT_AGENT\"],\n  [\"copilot\", \"COPILOT_CLI\"],\n  [\"opencode\", \"OPENCODE_CLIENT\"],\n  [\"augment\", \"AUGMENT_AGENT\"],\n  [\"junie\", \"JUNIE_DATA\"],\n];\n\n/** `AI_AGENT` values name the agent first, such as `claude-code_2-1-3_agent` or `github-copilot`. */\nconst AI_AGENT_PREFIXES: readonly [prefix: string, kind: string][] = [\n  [\"claude\", \"claude\"],\n  [\"codex\", \"codex\"],\n  [\"cursor\", \"cursor\"],\n  [\"gemini\", \"gemini\"],\n  [\"github-copilot\", \"copilot\"],\n  [\"github_copilot\", \"copilot\"],\n  [\"copilot\", \"copilot\"],\n  [\"opencode\", \"opencode\"],\n  [\"augment\", \"augment\"],\n  [\"auggie\", \"augment\"],\n  [\"qwen\", \"qwen\"],\n  [\"amp\", \"amp\"],\n  [\"goose\", \"goose\"],\n  [\"junie\", \"junie\"],\n  [\"droid\", \"droid\"],\n  [\"factory\", \"droid\"],\n  [\"kiro\", \"kiro\"],\n  [\"cline\", \"cline\"],\n  [\"crush\", \"crush\"],\n];\n\n/** The coding agent this process runs under, from the variables each one exports to its shell. */\nexport const detectAgentKind = (\n  env: NodeJS.ProcessEnv = process.env,\n): string | undefined => {\n  const named = env.AI_AGENT?.trim().toLowerCase();\n  if (named) {\n    // The name, or the name followed by a separator and a version or role.\n    const match = AI_AGENT_PREFIXES.find(\n      ([prefix]) =>\n        named.startsWith(prefix) &&\n        (named.length === prefix.length ||\n          /[-_ ./0-9]/.test(named[prefix.length]!)),\n    );\n    return match?.[1] ?? \"other\";\n  }\n  return AGENT_ENV.find(([, variable]) => env[variable])?.[0];\n};\n\n/** True when a person typed the command into a terminal rather than an agent running it from its shell. */\nexport const isDirectInvocation = (\n  env: NodeJS.ProcessEnv = process.env,\n  stdin: { isTTY?: boolean | undefined } = process.stdin,\n  stdout: { isTTY?: boolean | undefined } = process.stdout,\n) =>\n  detectAgentKind(env) === undefined &&\n  stdin.isTTY === true &&\n  stdout.isTTY === true;\n\n/** The first of `commands` found on PATH, or `undefined`. */\nexport const findCommand = (\n  commands: readonly string[],\n  env: NodeJS.ProcessEnv = process.env,\n): string | undefined => {\n  // Empty entries (the working directory) are skipped on purpose: a project\n  // must not be able to plant its own `claude` next to the user.\n  const directories = (env.PATH ?? \"\").split(delimiter).filter(Boolean);\n  const extensions =\n    process.platform === \"win32\"\n      ? (env.PATHEXT ?? \".EXE;.CMD;.BAT\").split(\";\")\n      : [\"\"];\n  return commands.find((command) =>\n    directories.some((directory) =>\n      extensions.some((extension) => {\n        try {\n          accessSync(join(directory, command + extension), constants.X_OK);\n          return true;\n        } catch {\n          return false;\n        }\n      }),\n    ),\n  );\n};\n\n/**\n * Starts `agent` in this terminal with `prompt` as its first message and\n * resolves with its exit code; `undefined` when its command is not installed.\n */\nexport const runCodingAgent = (\n  agent: CodingAgent,\n  prompt: string,\n): Promise<number | undefined> => {\n  const launch = agent.launch;\n  if (!launch) return Promise.resolve(undefined);\n  const command = findCommand(launch.commands);\n  if (command === undefined) return Promise.resolve(undefined);\n  const child = spawn(command, launch.args(prompt), { stdio: \"inherit\" });\n  return new Promise((resolve) => {\n    child.on(\"error\", (error: NodeJS.ErrnoException) => {\n      if (error.code === \"ENOENT\") resolve(undefined);\n      else {\n        process.stderr.write(`${error.message}\\n`);\n        resolve(1);\n      }\n    });\n    child.on(\"exit\", (status) => resolve(status ?? 1));\n  });\n};\n"],"mappings":"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"}

package/dist/cli.d.ts

@@ -8,20 +8,26 @@ export declare const HELP: string;
  * no credentials, query or fragment, and hold only address characters.
  */
 export declare const parseSetupUrl: (value: string) => string;
-export declare const agentInstructions: (setupUrl: string) => string;
-export declare const INSTRUCTIONS: (setupUrl: string) => string;
+export type AgentInstructionsOptions = {
+    /**
+     * The agent started this setup with `assistant-ui setup`, which already
+     * began planning and opened the setup page in the user's browser; there is
+     * no Begin plan click to wait for.
+     */
+    startedByAgent?: {
+        browserUrl: string;
+        /** False when the browser was not opened for the user; the agent then hands them the link. */
+        opened?: boolean;
+    };
+};
+export declare const agentInstructions: (setupUrl: string, options?: AgentInstructionsOptions) => string;
+export declare const INSTRUCTIONS: (setupUrl: string, options?: AgentInstructionsOptions) => string;
 type Parsed = {
     positional: string[];
     flags: Map<string, string | true>;
 };
-/** The coding agent this process runs under, from the variables each one exports to its shell. */
-export declare const detectAgentKind: (env?: NodeJS.ProcessEnv) => string | undefined;
-/** True when a person typed the command into a terminal rather than an agent running it from its shell. */
-export declare const isDirectInvocation: (env?: NodeJS.ProcessEnv, stdin?: {
-    isTTY?: boolean | undefined;
-}, stdout?: {
-    isTTY?: boolean | undefined;
-}) => boolean;
+export { CODING_AGENTS, detectAgentKind, findCommand, isDirectInvocation, runCodingAgent, } from "./agents.js";
+export type { CodingAgent } from "./agents.js";
 type StreamEvent = {
     event: "planning.started";
 } | {
@@ -73,6 +79,5 @@ export declare const upsertEnvLine: (content: string, key: string, value: string
  * still deposited; it is read after, so lines written meanwhile survive.
  */
 export declare const writeEnvSecret: (file: string, key: string, take: () => Promise<string>, projectRoot?: string) => Promise<void>;
-export declare const main: (argv: readonly string[]) => Promise<undefined>;
-export {};
+export declare const main: (argv: readonly string[]) => Promise<void>;
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -1,13 +1,13 @@
+import { CODING_AGENTS, detectAgentKind, findCommand, isDirectInvocation, runCodingAgent } from "./agents.js";
 import { connectCheckout } from "./client.js";
 import { INPUT_PRESETS, isPresetId, presetInput } from "./presets.js";
 import { AGENT_HEARTBEAT_MS, OPTION_ICONS, classifyChoiceAnswer, currentPlan, isAgentPresent, isClosed, isLoopbackHostname, isOptionIcon, isValidModelAnswer, parseEntryPointOptions, parseMultipleAnswer, stepProgress } from "./protocol.js";
-import { spawn } from "node:child_process";
-import { createHash, randomBytes } from "node:crypto";
 import { constants } from "node:fs";
+import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { createHash, randomBytes } from "node:crypto";
 import { chmod, lstat, mkdir, open, readFile, realpath, unlink } from "node:fs/promises";
 import { homedir, tmpdir, userInfo } from "node:os";
 import { createInterface } from "node:readline/promises";
-import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 // src/cli.ts
 const HELP = `setup-agent <url> [command]
 
@@ -66,9 +66,14 @@ const parseSetupUrl = (value) => {
 };
 /** `value` as one shell word, quoted only when it holds more than plain URL characters. */
 const shellWord = (value) => /^[A-Za-z0-9._~%/:@=+,-]+$/.test(value) ? value : `'${value.replaceAll("'", `'\\''`)}'`;
-const agentInstructions = (setupUrl) => {
+const beginPlanHandoff = (url) => `Before planning, check the current setup status. If it is "waiting", tell the user in your own conversation: "I'm connected. Go back to your browser and click Begin plan. You can watch my progress, answer questions, and steer me there." Then run:
+  npx setup-agent ${url} wait start
+Keep the stream running while you wait. Do not inspect the project, fetch guides, ask setup questions, or propose a plan until this command returns {"ok":true}. If it returns {"ok":false,"status":"cancelled"}, the user ended this setup before planning: do not plan, tell the user you are connected and waiting for their next setup, and run "wait start" again. Only the user in the browser should start planning; never invoke the browser's start command yourself. "planning.started" also arrives on the stream. If the status is already "planning" or "installing", resume that phase without asking the user to begin again. If it is "done" or "cancelled", that setup is over: tell the user you are connected and waiting for their next setup, and run "wait start", which returns once the next one begins.`;
+const agentStartedHandoff = ({ browserUrl, opened = true }) => `You started this setup, and it is already planning: there is no Begin plan click to wait for. The browser asks the user to connect to you first; it shows your working directory once your stream is running. Check "status" before planning: if it is "planning" or "installing", go on with that phase. Tell the user in your own conversation, once: ${opened ? `"I opened the assistant-ui setup in your browser. I'll ask my questions there, and you can watch my progress and steer me from that page. If it didn't open, go to ${browserUrl} ."` : `"Open ${browserUrl} to follow the assistant-ui setup. I'll ask my questions there, and you can watch my progress and steer me from that page."`} If the status is "done" or "cancelled", that setup is over: tell the user you are connected and waiting for their next setup, and run "wait start", which returns once the next one begins.`;
+const agentInstructions = (setupUrl, options = {}) => {
 	const url = shellWord(setupUrl);
-	return `You are the coding agent for a setup the user opened in their browser. The browser shows this setup live; every command below updates it. The user watches the browser, not this terminal: once setup begins, send questions through "ask" so the user can answer in their browser.
+	const started = options.startedByAgent;
+	return `You are the coding agent for a setup ${started ? "you opened in the user's browser" : "the user opened in their browser"}. The browser shows this setup live; every command below updates it. The user watches the browser, not this terminal: once setup begins, send questions through "ask" so the user can answer in their browser.
 
 First, start a persistent Monitor on
   npx setup-agent ${url} stream
@@ -78,9 +83,7 @@ The user can message you at any time, including while a question is waiting. Rea
 
 "log" is a message to the user, and the user reads every one: send it only to reply to their message, to tell them something no question or step conveys (a blocker, a deviation from the plan, a decision you made for them), or once as a wrap-up when the install is finished. Findings go in the plan, progress in step notes, questions in "ask"; do not narrate.
 
-Before planning, check the current setup status. If it is "waiting", tell the user in your own conversation: "I'm connected. Go back to your browser and click Begin plan. You can watch my progress, answer questions, and steer me there." Then run:
-  npx setup-agent ${url} wait start
-Keep the stream running while you wait. Do not inspect the project, fetch guides, ask setup questions, or propose a plan until this command returns {"ok":true}. Only the user in the browser should start planning; never invoke the browser's start command yourself. "planning.started" also arrives on the stream. If the status is already "planning" or "installing", resume that phase without asking the user to begin again. If it is "done" or "cancelled", that setup is over: tell the user you are connected and waiting for their next setup, and run "wait start", which returns once the next one begins.
+${started ? agentStartedHandoff(started) : beginPlanHandoff(url)}
 
 The remaining phases are plan, then install.
 
@@ -89,7 +92,7 @@ The remaining phases are plan, then install.
 Read the project: its app framework and package manager, the agent framework and model provider it already uses, where components live, any existing chat route. Fetch each product's "guide" URL from the setup below; it is the install reference. Ask for what the project does not decide, using the standard questions so the browser can render them well:
   npx setup-agent ${url} ask --preset framework
   npx setup-agent ${url} ask --preset llm-provider
-The setup's products are starting names and guide references. Explore each product's setup instructions, then discover and plan any other relevant products or dependencies the app needs. Read /catalog.md on the guide URL’s origin to find related products and fetch their setup guides. The starting list does not restrict the implementation or require adding another product to the list. Include relevant additions in the plan for approval.
+The setup's products are starting names and guide references. If the setup lists no products, first ask the user what to set up with a choice question whose options are slugs from https://www.assistant-ui.com/catalog.md, then fetch https://www.assistant-ui.com/install.md?items=<slugs> as the guide. Explore each product's setup instructions, then discover and plan any other relevant products or dependencies the app needs. Read /catalog.md on the guide URL’s origin to find related products and fetch their setup guides. The starting list does not restrict the implementation or require adding another product to the list. Include relevant additions in the plan for approval.
 When the setup puts an assistant in the app, ask how users should access it after discovering the actual app and before proposing the plan. Skip this question when no product's guide installs an assistant (a standalone library or service setup, for example). Use an entry-point question with only 1–3 sensible alternatives. Describe the actual app's pages, workflow and component placement, not generic placeholder copy. Recommend one clear fit when there is one; two options may use the same form factor in different places. Each option needs a stable id, label, contextual description and entryPoint {"formFactor":"modal"|"sidebar"|"full-page","placement":"where it appears","trigger":"how users open it or navigate to it","recommended":true?}. Write the JSON array for this app and send it with:
   npx setup-agent ${url} ask "Where should users access the assistant?" --entry-points '<JSON array>' --wait
 Mark a clear fit with "recommended":true rather than --default, so the user makes the pick. When you ask it, do not submit the plan before the user picks an entry point. Respect the selected placement and trigger in the plan and implementation. Do not ask for a new-versus-existing app setting; discover the app from its files and ask only for an install path when needed.
@@ -145,47 +148,8 @@ const fail = (message) => {
 const print = (value) => {
 	process.stdout.write(`${JSON.stringify(value)}\n`);
 };
-const AGENT_ENV = [
-	["claude", "CLAUDECODE"],
-	["codex", "CODEX_SANDBOX"],
-	["codex", "CODEX_SANDBOX_NETWORK_DISABLED"],
-	["cursor", "CURSOR_AGENT"],
-	["gemini", "GEMINI_CLI"]
-];
-/** The coding agent this process runs under, from the variables each one exports to its shell. */
-const detectAgentKind = (env = process.env) => AGENT_ENV.find(([, variable]) => env[variable])?.[0];
-const LAUNCHERS = [
-	{
-		kind: "claude",
-		name: "Claude Code",
-		command: "claude",
-		args: (prompt) => [prompt],
-		install: "npm install -g @anthropic-ai/claude-code"
-	},
-	{
-		kind: "codex",
-		name: "Codex",
-		command: "codex",
-		args: (prompt) => [prompt],
-		install: "npm install -g @openai/codex"
-	},
-	{
-		kind: "cursor",
-		name: "Cursor",
-		command: "agent",
-		args: (prompt) => [prompt],
-		install: "curl https://cursor.com/install -fsS | bash"
-	},
-	{
-		kind: "gemini",
-		name: "Gemini CLI",
-		command: "gemini",
-		args: (prompt) => ["-i", prompt],
-		install: "npm install -g @google/gemini-cli"
-	}
-];
-/** True when a person typed the command into a terminal rather than an agent running it from its shell. */
-const isDirectInvocation = (env = process.env, stdin = process.stdin, stdout = process.stdout) => detectAgentKind(env) === void 0 && stdin.isTTY === true && stdout.isTTY === true;
+/** The agents `setup-agent <url>` can start itself, for a person who ran it in a terminal. */
+const LAUNCHERS = CODING_AGENTS.filter((agent) => agent.launch !== void 0);
 const chooseLauncher = async () => {
 	const rl = createInterface({
 		input: process.stdin,
@@ -213,16 +177,9 @@ const launchAgent = async (url) => {
 	const launcher = await chooseLauncher();
 	const prompt = `Run \`npx setup-agent ${shellWord(url)}\` and follow the instructions it prints.`;
 	process.stdout.write(`\nStarting ${launcher.name}...\n\n`);
-	const child = spawn(launcher.command, launcher.args(prompt), { stdio: "inherit" });
-	const code = await new Promise((resolve) => {
-		child.on("error", (error) => {
-			if (error.code === "ENOENT") process.stderr.write(`${launcher.name} is not installed. Install it with:\n  ${launcher.install}\nthen run this command again.\n`);
-			else process.stderr.write(`${error.message}\n`);
-			resolve(1);
-		});
-		child.on("exit", (status) => resolve(status ?? 1));
-	});
-	process.exit(code);
+	const code = await runCodingAgent(launcher, prompt);
+	if (code === void 0) process.stderr.write(`${launcher.name} is not installed. Install it with:\n  ${launcher.launch.install}\nthen run this command again.\n`);
+	process.exitCode = code ?? 1;
 };
 const requireState = (client) => client.state ?? fail("the setup has no state");
 const summary = (state) => {
@@ -828,6 +785,6 @@ const main = async (argv) => {
 		client.dispose();
 	}
 };
-export { HELP, INSTRUCTIONS, agentInstructions, askSeed, detectAgentKind, diffEvents, isDirectInvocation, main, parseSetupUrl, upsertEnvLine, waitForStart, writeEnvSecret };
+export { CODING_AGENTS, HELP, INSTRUCTIONS, agentInstructions, askSeed, detectAgentKind, diffEvents, findCommand, isDirectInvocation, main, parseSetupUrl, runCodingAgent, upsertEnvLine, waitForStart, writeEnvSecret };
 
 //# sourceMappingURL=cli.js.map