neon 4.10.1 → 4.11.0

package/dist/init/plan.js

@@ -1,23 +1,223 @@
+import { getCliName } from "../utils/cli_name.js";
+import { tryResolveAddMcpAgentId, uniqueAgentIds } from "../mcp/agents.js";
+import { mcpInstallableAgents } from "../mcp/targets.js";
+import { supportsSkills } from "./agents.js";
+import { pluginsInstallableAgents } from "../plugins/targets.js";
+import { skillsInstallableAgents } from "../skills/targets.js";
+import { agentArgv } from "../utils/agent_flag.js";
 import { isAbsolute, join, relative, resolve } from "node:path";
 //#region src/init/plan.ts
 const directoryIsEmpty = (names) => names.filter((name) => name !== ".git").length === 0;
-const bootstrapInitStep = (yes) => yes ? [
+const bootstrapInitStep = (yes, agents = []) => [...yes ? [
 	"bootstrap",
 	".",
 	"--default"
-] : ["bootstrap", "."];
+] : ["bootstrap", "."], ...agentArgv(agents)];
 const projectContextFile = (projectDir, contextFile) => {
 	const resolved = isAbsolute(contextFile) ? contextFile : resolve(projectDir, contextFile);
 	const rel = relative(projectDir, resolved);
 	if (rel === "" || rel.startsWith("..") || isAbsolute(rel)) return join(projectDir, ".neon");
 	return resolved;
 };
+/** Linking a template with neon.ts requires installed dependencies because env pull evaluates it. */
+const postScaffoldActions = (input) => {
+	const actions = [];
+	if (input.git) actions.push("git");
+	if (input.agentSetup !== "skip") actions.push("agent");
+	const canLink = input.link && !(input.hasNeonConfig && !input.install);
+	if (canLink && input.hasNeonConfig && input.install) {
+		actions.push("install");
+		actions.push("link");
+		return actions;
+	}
+	if (canLink) actions.push("link");
+	if (input.install) actions.push("install");
+	return actions;
+};
 const planAgentSteps = (input) => {
 	const y = input.yes ? ["-y"] : [];
 	if (input.agentSetup === "plugin") return [["plugins", ...y]];
 	if (input.agentSetup === "skills-mcp") return [["skills", ...y], ["mcp", ...y]];
 	return [];
 };
+const planToolingSteps = (tooling, options) => {
+	const prefix = options.yes ? ["-y"] : [];
+	const flagsFor = (ids) => options.named ? [...prefix, ...agentArgv(ids)] : [...prefix];
+	switch (tooling.setup) {
+		case "skip": return [];
+		case "plugin": return [["plugins", ...flagsFor(tooling.agents)]];
+		case "skills-mcp": {
+			const steps = [];
+			if (tooling.skillsAgents.length > 0) steps.push(["skills", ...flagsFor(tooling.skillsAgents)]);
+			if (tooling.mcpAgents.length > 0) steps.push(["mcp", ...flagsFor(tooling.mcpAgents)]);
+			return steps;
+		}
+		default: return tooling;
+	}
+};
+const noDetectedAgentsMessage = (input) => {
+	const lead = input.scope === "project" ? "No coding agents detected in this project." : "No coding agents detected.";
+	const name = input.nameAgent === true;
+	let hint;
+	if (input.fix === "pass-yes") {
+		const detected = input.scope === "project" ? "Pass -y to use project folders, else the host CLI agent" : "Pass -y to use installed apps, else the host CLI agent";
+		hint = name ? `${detected}, --agent <name> to name them, or run from a terminal to pick one.` : `${detected}, or run from a terminal to pick one.`;
+	} else hint = name ? "Pass --agent <name>, run this command from a supported agent, or omit -y in a terminal to pick one." : "Run this command from a supported agent, or omit -y in a terminal to pick one.";
+	return `${lead} ${hint} Supported agents: ${input.supported.join(", ")}`;
+};
+const INIT_NEEDS_YES_OR_TERMINAL = "No interactive terminal. Pass -y to use defaults, or run this command in a terminal to pick.";
+const UNKNOWN_AGENT_COMMANDS = ["link"];
+const unknownAgentArgHint = (command, cliName) => `${cliName} ${command} has no --agent. Pass --project-id <id> to link without a TTY, or run ${cliName} ${command} in a terminal.`;
+const BOOLEAN_FLAGS = /* @__PURE__ */ new Set([
+	"-y",
+	"--yes",
+	"--default",
+	"--force",
+	"-h",
+	"--help",
+	"-v",
+	"--version",
+	"--color",
+	"--no-color",
+	"--analytics",
+	"--no-analytics",
+	"--oauth",
+	"--project",
+	"--global",
+	"--read-only",
+	"--readonly",
+	"--clear",
+	"--checks",
+	"--no-checks",
+	"--env-pull",
+	"--no-env-pull",
+	"--no-agent-setup",
+	"--no-link",
+	"--list",
+	"--list-templates",
+	"--force-auth",
+	"--no-force-auth"
+]);
+const isUnknownAgentCommand = (token) => {
+	for (const command of UNKNOWN_AGENT_COMMANDS) if (command === token) return true;
+	return false;
+};
+const commandFromArgv = (argv) => {
+	let skipValue = false;
+	for (const token of argv) {
+		if (skipValue) {
+			skipValue = false;
+			continue;
+		}
+		if (token === "--") break;
+		if (token.startsWith("-")) {
+			const flag = token.split("=")[0];
+			if (flag !== void 0 && !token.includes("=") && !BOOLEAN_FLAGS.has(flag)) skipValue = true;
+			continue;
+		}
+		if (isUnknownAgentCommand(token)) return token;
+	}
+};
+const rewriteUnknownAgentArg = (input) => {
+	if (input.message !== "Unknown argument: agent" && input.message !== "Unknown argument: a") return;
+	const command = commandFromArgv(input.argv);
+	if (command === void 0) return;
+	return unknownAgentArgHint(command, input.cliName);
+};
+const initYesSupportedAgents = () => uniqueAgentIds([
+	...pluginsInstallableAgents("project"),
+	...skillsInstallableAgents(),
+	...mcpInstallableAgents("global")
+]);
+const initPluginAgents = () => pluginsInstallableAgents("project");
+const initSkillsMcpAgents = () => {
+	const plugin = new Set(initPluginAgents());
+	return initYesSupportedAgents().filter((id) => !plugin.has(id));
+};
+const resolveYesAgentList = (input) => {
+	if (input.detected.length > 0) return uniqueAgentIds(input.detected);
+	if (input.host !== null) return [input.host];
+	return [];
+};
+async function collectYesAgents(sources) {
+	const detected = await sources.detected();
+	if (detected.length > 0) return resolveYesAgentList({
+		detected,
+		host: null
+	});
+	const rawHost = sources.detectAgent();
+	const accept = sources.acceptHost ?? (() => true);
+	const host = rawHost !== null && accept(rawHost) ? rawHost : null;
+	return resolveYesAgentList({
+		detected,
+		host
+	});
+}
+const chooseYesAgentTooling = (agents) => {
+	const projectPlugin = new Set(pluginsInstallableAgents("project"));
+	const [pluginFirst, ...pluginRest] = agents.filter((id) => projectPlugin.has(id));
+	if (pluginFirst !== void 0) return {
+		setup: "plugin",
+		agents: [pluginFirst, ...pluginRest]
+	};
+	const globalMcp = new Set(mcpInstallableAgents("global"));
+	const skillsAgents = agents.filter((id) => supportsSkills(id));
+	const mcpAgents = agents.filter((id) => globalMcp.has(id));
+	if (skillsAgents.length === 0 && mcpAgents.length === 0) return { setup: "skip" };
+	return {
+		setup: "skills-mcp",
+		skillsAgents,
+		mcpAgents
+	};
+};
+const planYesAgentSteps = (tooling) => planToolingSteps(tooling, {
+	yes: true,
+	named: false
+});
+const NAMED_AGENTS_UNSUPPORTED = "None of the selected agents can install the Neon plugin, skills, or MCP.";
+const NAMED_AGENTS_MIXED = "Cannot install the plugin and skills/MCP in one run.";
+const quoteIfNeeded = (value) => /[\s"'\\]/.test(value) ? `"${value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"")}"` : value;
+const mixedRerun = (command, ids, context) => {
+	const tokens = [getCliName(), command];
+	if (command === "bootstrap" && context?.directory !== void 0 && context.directory.length > 0) tokens.push(quoteIfNeeded(context.directory));
+	if (context?.yes === true) tokens.push(command === "bootstrap" ? "--default" : "-y");
+	tokens.push(...ids.flatMap((id) => ["--agent", id]));
+	return `\`${tokens.join(" ")}\``;
+};
+const namedAgentsMixedMessage = (named, command, context) => {
+	const plugin = new Set(initPluginAgents());
+	const pluginNamed = uniqueAgentIds(named.filter((id) => plugin.has(id)));
+	const otherNamed = uniqueAgentIds(named.filter((id) => !plugin.has(id)));
+	return `${NAMED_AGENTS_MIXED} Plugin: ${pluginNamed.join(", ")}. Skills/MCP: ${otherNamed.join(", ")}. Re-run ${mixedRerun(command, pluginNamed, context)} or ${mixedRerun(command, otherNamed, context)}.`;
+};
+const namedAgentsNeedSplit = (named, tooling) => {
+	if (tooling.setup === "skip") return false;
+	if (tooling.setup === "plugin") {
+		const used = new Set(tooling.agents);
+		const leftover = named.filter((id) => !used.has(id));
+		return chooseYesAgentTooling(leftover).setup !== "skip";
+	}
+	const used = /* @__PURE__ */ new Set([...tooling.skillsAgents, ...tooling.mcpAgents]);
+	return named.some((id) => !used.has(id));
+};
+const assertNamedAgentTooling = (named, command = "init", context) => {
+	if (named.length === 0) return;
+	const tooling = chooseYesAgentTooling(named);
+	if (tooling.setup === "skip") throw new Error(`${NAMED_AGENTS_UNSUPPORTED} Supported agents: ${initYesSupportedAgents().join(", ")}`);
+	if (namedAgentsNeedSplit(named, tooling)) throw new Error(namedAgentsMixedMessage(named, command, context));
+};
+const resolveNamedAgents = (raw) => {
+	if (raw.length === 0) return [];
+	const available = initYesSupportedAgents();
+	const resolved = [];
+	for (const item of raw) {
+		if (item === "*") throw new Error("--agent * is not accepted. Pass --agent <name> for each coding agent, or omit --agent to detect or pick.");
+		const id = tryResolveAddMcpAgentId(item);
+		if (!id) throw new Error(`Unknown agent: "${item}". Supported agents: ${available.join(", ")}`);
+		resolved.push(id);
+	}
+	return uniqueAgentIds(resolved);
+};
 const planExistingInit = (input) => {
 	const steps = [...planAgentSteps(input)];
 	if (!input.linked) steps.push(input.yes ? ["link", "--yes"] : ["link"]);
@@ -30,9 +230,8 @@ const planExistingInit = (input) => {
 	return steps;
 };
 const resolveInitAgentSetup = async (input) => {
-	if (input.yes) return input.hasProjectPlugins ? "plugin" : "skills-mcp";
 	if (input.interactive) return input.pick();
-	return "skills-mcp";
+	throw new Error(INIT_NEEDS_YES_OR_TERMINAL);
 };
 const childArgv = (step, forward) => {
 	const args = [...step];
@@ -44,4 +243,4 @@ const childArgv = (step, forward) => {
 	return args;
 };
 //#endregion
-export { bootstrapInitStep, childArgv, directoryIsEmpty, planAgentSteps, planExistingInit, projectContextFile, resolveInitAgentSetup };
+export { INIT_NEEDS_YES_OR_TERMINAL, NAMED_AGENTS_MIXED, NAMED_AGENTS_UNSUPPORTED, assertNamedAgentTooling, bootstrapInitStep, childArgv, chooseYesAgentTooling, collectYesAgents, directoryIsEmpty, initPluginAgents, initSkillsMcpAgents, initYesSupportedAgents, namedAgentsMixedMessage, namedAgentsNeedSplit, noDetectedAgentsMessage, planAgentSteps, planExistingInit, planToolingSteps, planYesAgentSteps, postScaffoldActions, projectContextFile, resolveInitAgentSetup, resolveNamedAgents, resolveYesAgentList, rewriteUnknownAgentArg };

package/dist/init/tooling.js

@@ -1,17 +1,13 @@
 import { log } from "../log.js";
 import { getCliName } from "../utils/cli_name.js";
 import { AUTH_CHILD } from "./child.js";
-import { childArgv, planAgentSteps, resolveInitAgentSetup } from "./plan.js";
-import { detectInstallablePluginsAgents } from "../plugins/targets.js";
+import { assertNamedAgentTooling, childArgv, chooseYesAgentTooling, collectYesAgents, initYesSupportedAgents, noDetectedAgentsMessage, planAgentSteps, planToolingSteps, planYesAgentSteps, resolveInitAgentSetup } from "./plan.js";
 import { canPickAgentsInteractively } from "../utils/agent_picker.js";
+import { detectAgent } from "./detect_host.js";
 import { pickAgentSetupInteractively } from "./wizard.js";
+import { detectProjectAgents } from "add-mcp";
 //#region src/init/tooling.ts
-const defaultHasProjectPlugins = async (cwd) => {
-	return (await detectInstallablePluginsAgents({
-		scope: "project",
-		cwd
-	})).length > 0;
-};
+const defaultProjectAgents = (cwd) => detectProjectAgents(cwd);
 const runInitSteps = async (steps, options) => {
 	for (const step of steps) {
 		log.info("Running `%s %s`", getCliName(), step.join(" "));
@@ -20,20 +16,60 @@ const runInitSteps = async (steps, options) => {
 		if (!await options.run(argv, options.cwd, command !== void 0 && AUTH_CHILD.has(command) ? options.authEnv : void 0)) throw new Error(`\`${getCliName()} ${step.join(" ")}\` failed.`);
 	}
 };
+const yesAgentsFromOptions = async (options) => collectYesAgents({
+	detected: () => (options.detectProjectAgents ?? defaultProjectAgents)(options.cwd),
+	detectAgent: options.detectAgent ?? detectAgent
+});
+const yesMiss = () => new Error(noDetectedAgentsMessage({
+	scope: "project",
+	supported: initYesSupportedAgents(),
+	fix: "run-without-yes",
+	nameAgent: true
+}));
 const runAgentTooling = async (options) => {
 	const yes = options.yes;
-	const hasProjectPlugins = yes ? await (options.hasProjectPlugins ?? defaultHasProjectPlugins)(options.cwd) : false;
-	const interactive = !yes && (options.pickAgentSetup !== void 0 || canPickAgentsInteractively());
+	const named = options.agents ?? [];
+	if (named.length > 0) {
+		assertNamedAgentTooling(named, options.command ?? "init");
+		const tooling = chooseYesAgentTooling(named);
+		await runInitSteps(planToolingSteps(tooling, {
+			yes,
+			named: true
+		}), options);
+		return tooling.setup;
+	}
+	if (options.agentSetup !== void 0) {
+		await runInitSteps(planAgentSteps({
+			yes,
+			agentSetup: options.agentSetup
+		}), options);
+		return options.agentSetup;
+	}
+	if (yes) {
+		if (options.hasProjectPlugins !== void 0) {
+			const agentSetup = await options.hasProjectPlugins(options.cwd) ? "plugin" : "skills-mcp";
+			await runInitSteps(planAgentSteps({
+				yes: true,
+				agentSetup
+			}), options);
+			return agentSetup;
+		}
+		const agents = await yesAgentsFromOptions(options);
+		const tooling = chooseYesAgentTooling(agents);
+		if (tooling.setup === "skip") throw yesMiss();
+		await runInitSteps(planYesAgentSteps(tooling), options);
+		return tooling.setup;
+	}
+	const interactive = options.pickAgentSetup !== void 0 || canPickAgentsInteractively();
 	const agentSetup = await resolveInitAgentSetup({
-		yes,
 		interactive,
-		hasProjectPlugins,
 		pick: options.pickAgentSetup ?? pickAgentSetupInteractively
 	});
 	await runInitSteps(planAgentSteps({
 		yes,
 		agentSetup
 	}), options);
+	return agentSetup;
 };
 const runScaffoldFollowUp = async (options) => {
 	if (!options.skipAgentSetup) await runAgentTooling(options);

package/dist/init/wizard.js

@@ -1,3 +1,4 @@
+import { INIT_NEEDS_YES_OR_TERMINAL } from "./plan.js";
 import { canPickAgentsInteractively } from "../utils/agent_picker.js";
 import { NEON_PLUGIN_NAME } from "../plugins/run.js";
 import prompts from "prompts";
@@ -10,7 +11,7 @@ const restoreCursorOnAbort = (state) => {
 	}
 };
 const pickAgentSetupInteractively = async () => {
-	if (!canPickAgentsInteractively()) throw new Error("No interactive terminal. Pass -y to use defaults, or run this command in a terminal.");
+	if (!canPickAgentsInteractively()) throw new Error(INIT_NEEDS_YES_OR_TERMINAL);
 	const { setup } = await prompts({
 		onState: restoreCursorOnAbort,
 		type: "select",

package/dist/mcp/plan.js

@@ -1,22 +1,35 @@
 import { tryResolveAddMcpAgentId } from "./agents.js";
-import { agentChoicesFrom, pickAgentsInteractively, resolveAgentSelection } from "../utils/agent_picker.js";
 import { detectMcpAgents, mcpInstallableAgents } from "./targets.js";
+import { collectYesAgents, noDetectedAgentsMessage } from "../init/plan.js";
+import { agentChoicesFrom, pickAgentsInteractively, resolveAgentSelection } from "../utils/agent_picker.js";
+import { detectAgent } from "../init/detect_host.js";
 import { pickMcpAuth, pickMcpProjectPin, pickMcpScope } from "./wizard.js";
 //#region src/mcp/plan.ts
 async function resolveMcpPlan(options) {
 	const prompt = options.interactive && !options.yes;
 	const scope = options.project ? "project" : prompt ? await (options.pickScope ?? pickMcpScope)() : "global";
 	const available = mcpInstallableAgents(scope);
-	const detected = await detectMcpAgents({
+	const availableSet = new Set(available);
+	const scoped = await detectMcpAgents({
 		scope,
 		cwd: options.cwd
 	});
+	const detected = options.yes && options.agents.length === 0 ? await collectYesAgents({
+		detected: () => scoped,
+		detectAgent: options.detectAgent ?? detectAgent,
+		acceptHost: (id) => availableSet.has(id)
+	}) : scoped;
 	const agents = await resolveAgentSelection({
 		specified: options.agents,
 		choices: agentChoicesFrom(available, detected),
 		detected,
 		message: "Which coding agents should get the Neon MCP server? (space to toggle, enter to confirm)",
-		nonInteractiveMessage: scope === "project" ? `No coding agents detected in this project. Pass --agent <name>. Supported agents: ${available.join(", ")}` : `No coding agents detected. Pass --agent <name>. Supported agents: ${available.join(", ")}`,
+		nonInteractiveMessage: noDetectedAgentsMessage({
+			scope,
+			supported: available,
+			fix: options.yes ? "run-without-yes" : "pass-yes",
+			nameAgent: true
+		}),
 		resolveSpecified: (raw) => {
 			const id = tryResolveAddMcpAgentId(raw);
 			if (!id) throw new Error(`Unknown agent: "${raw}". Supported agents: ${available.join(", ")}`);

package/dist/plugins/plan.js

@@ -1,11 +1,13 @@
 import { getAgentDisplayName, tryResolveAddMcpAgentId } from "../mcp/agents.js";
 import "../init/agents.js";
 import { detectPluginsAgents, getPluginsTargetName, isUserScopeOnlyPluginsTarget, mappedPluginsTargets, pluginsInstallableAgents } from "./targets.js";
+import { collectYesAgents, noDetectedAgentsMessage } from "../init/plan.js";
 import { agentChoicesFrom, pickAgentsInteractively, resolveAgentSelection } from "../utils/agent_picker.js";
+import { detectAgent } from "../init/detect_host.js";
 //#region src/plugins/plan.ts
 const assertPluginsCanRun = (options) => {
 	if (options.yes || options.interactive || options.hasAgents) return;
-	throw new Error("No interactive terminal. Pass -y to install into detected agents, or --agent <name>.");
+	throw new Error("No interactive terminal. Pass -y to install into detected agents, or --agent <name> to name them.");
 };
 async function resolvePluginsPlan(options) {
 	assertPluginsCanRun({
@@ -16,16 +18,28 @@ async function resolvePluginsPlan(options) {
 	const prompt = options.interactive && !options.yes;
 	const scope = options.global ? "global" : "project";
 	const available = pluginsInstallableAgents(scope);
-	const detected = await detectPluginsAgents({
+	const availableSet = new Set(available);
+	const scoped = await detectPluginsAgents({
 		scope,
-		cwd: options.cwd
+		cwd: options.cwd,
+		...options.detectInstalledAgents ? { detectInstalledAgents: options.detectInstalledAgents } : {}
 	});
+	const detected = options.yes && options.agents.length === 0 ? await collectYesAgents({
+		detected: () => scoped,
+		detectAgent: options.detectAgent ?? detectAgent,
+		acceptHost: (id) => availableSet.has(id) || getPluginsTargetName(id) !== void 0
+	}) : scoped;
 	const selected = await resolveAgentSelection({
 		specified: options.agents,
 		choices: agentChoicesFrom(available, detected),
 		detected,
 		message: "Which coding agents should get the Neon plugin? (space to toggle, enter to confirm)",
-		nonInteractiveMessage: scope === "project" ? `No coding agents detected in this project. Pass --agent <name>. Supported agents: ${available.join(", ")}` : `No coding agents detected. Pass --agent <name>. Supported agents: ${available.join(", ")}`,
+		nonInteractiveMessage: noDetectedAgentsMessage({
+			scope,
+			supported: available,
+			fix: options.yes ? "run-without-yes" : "pass-yes",
+			nameAgent: true
+		}),
 		resolveSpecified: (raw) => {
 			if (raw === "*") throw new Error("neon plugins does not accept --agent *. Pass --agent <name> for each coding agent, or omit --agent to use detected agents.");
 			const id = tryResolveAddMcpAgentId(raw);

package/dist/plugins/targets.js

@@ -35,7 +35,7 @@ const pluginsInstallableAgents = (scope) => pluginsMappedAgents().filter((id) =>
 	return target !== void 0 && !isUserScopeOnlyPluginsTarget(target);
 });
 const detectPluginsAgents = async (options) => {
-	const detected = options.scope === "project" ? detectProjectAgents(options.cwd) : await detectInstalledAgents();
+	const detected = options.scope === "project" ? detectProjectAgents(options.cwd) : await (options.detectInstalledAgents ?? detectInstalledAgents)();
 	return uniqueAgentIds(detected).filter((id) => supportsPlugins(id));
 };
 const detectInstallablePluginsAgents = async (options) => {

package/dist/skills/catalog.js

@@ -3,11 +3,6 @@ import { helpCsv } from "../utils/help_text.js";
 const AGENT_SKILLS_SOURCE = "neondatabase/agent-skills";
 const PLATFORMS_SKILLS_SOURCE = "neondatabase/neon-for-agent-platforms";
 const NEON_SKILL_CATALOG = [
-	{
-		skill: "claimable-postgres",
-		source: AGENT_SKILLS_SOURCE,
-		defaultSelected: true
-	},
 	{
 		skill: "neon",
 		source: AGENT_SKILLS_SOURCE,

package/dist/skills/plan.js

@@ -1,8 +1,10 @@
 import { tryResolveAddMcpAgentId } from "../mcp/agents.js";
 import "../init/agents.js";
+import { detectSkillsAgents, skillsInstallableAgents } from "./targets.js";
+import { collectYesAgents, noDetectedAgentsMessage } from "../init/plan.js";
 import { agentChoicesFrom, pickAgentsInteractively, resolveAgentSelection } from "../utils/agent_picker.js";
+import { detectAgent } from "../init/detect_host.js";
 import { invocationsForSelection, resolveSkillId, uniqueSkillEntries, yesInstallInvocations } from "./catalog.js";
-import { detectSkillsAgents, skillsInstallableAgents } from "./targets.js";
 import { pickSkillsInteractively } from "./wizard.js";
 //#region src/skills/plan.ts
 const assertSkillsCanRun = (options) => {
@@ -11,7 +13,7 @@ const assertSkillsCanRun = (options) => {
 		throw new Error("No interactive terminal. Pass -y to update installed skills.");
 	}
 	if (options.yes || options.interactive || options.hasSkills === true) return;
-	throw new Error("No interactive terminal. Pass -y to install the default skills, or --skill <name>.");
+	throw new Error("No interactive terminal. Pass -y to install the default skills into detected agents, or --skill <name>.");
 };
 async function resolveSkillsPlan(options) {
 	assertSkillsCanRun({
@@ -24,16 +26,28 @@ async function resolveSkillsPlan(options) {
 	const prompt = options.interactive && !options.yes;
 	const scope = options.global ? "global" : "project";
 	const available = skillsInstallableAgents();
-	const detected = await detectSkillsAgents({
+	const availableSet = new Set(available);
+	const scoped = await detectSkillsAgents({
 		scope,
-		cwd: options.cwd
+		cwd: options.cwd,
+		...options.detectInstalledAgents ? { detectInstalledAgents: options.detectInstalledAgents } : {}
 	});
+	const detected = options.yes && options.agents.length === 0 ? await collectYesAgents({
+		detected: () => scoped,
+		detectAgent: options.detectAgent ?? detectAgent,
+		acceptHost: (id) => availableSet.has(id)
+	}) : scoped;
 	const selected = await resolveAgentSelection({
 		specified: options.agents,
 		choices: agentChoicesFrom(available, detected),
 		detected,
 		message: "Which coding agents should get Neon agent skills? (space to toggle, enter to confirm)",
-		nonInteractiveMessage: scope === "project" ? `No coding agents detected in this project. Pass --agent <name>. Supported agents: ${available.join(", ")}` : `No coding agents detected. Pass --agent <name>. Supported agents: ${available.join(", ")}`,
+		nonInteractiveMessage: noDetectedAgentsMessage({
+			scope,
+			supported: available,
+			fix: options.yes ? "run-without-yes" : "pass-yes",
+			nameAgent: true
+		}),
 		resolveSpecified: (raw) => {
 			if (raw === "*") throw new Error("neon skills does not accept --agent *. Pass --agent <name> for each coding agent, or omit --agent to use detected agents.");
 			const id = tryResolveAddMcpAgentId(raw);

package/dist/skills/targets.js

@@ -4,7 +4,7 @@ import { detectProjectAgents } from "add-mcp";
 //#region src/skills/targets.ts
 const skillsInstallableAgents = () => listMcpAgentIds().filter((id) => supportsSkills(id));
 const detectSkillsAgents = async (options) => {
-	const detected = options.scope === "project" ? detectProjectAgents(options.cwd) : await detectInstalledAgents();
+	const detected = options.scope === "project" ? detectProjectAgents(options.cwd) : await (options.detectInstalledAgents ?? detectInstalledAgents)();
 	return uniqueAgentIds(detected).filter((id) => supportsSkills(id));
 };
 const mappedSkillsAgentNames = (agents) => {

package/dist/skills/wizard.js

@@ -12,7 +12,7 @@ const restoreCursorOnAbort = (state) => {
 	}
 };
 const pickSkillsInteractively = async () => {
-	if (!canPickAgentsInteractively()) throw new Error("No interactive terminal. Pass -y to install the default skills, or --skill <name>.");
+	if (!canPickAgentsInteractively()) throw new Error("No interactive terminal. Pass -y to install the default skills into detected agents.");
 	const { skills } = await prompts({
 		onState: restoreCursorOnAbort,
 		type: "multiselect",

package/dist/utils/agent_flag.js

@@ -0,0 +1,13 @@
+//#region src/utils/agent_flag.ts
+const coerceAgentFlag = (value) => {
+	if (value === void 0) return [];
+	const list = Array.isArray(value) ? value : [value];
+	if (list.length === 0) throw new Error("--agent needs a value. Pass one, or omit the flag entirely.");
+	return list.map((item) => {
+		if (typeof item !== "string" || item.trim() === "") throw new Error("--agent needs a value. Pass one, or omit the flag entirely.");
+		return item;
+	});
+};
+const agentArgv = (agents) => agents.flatMap((id) => ["--agent", id]);
+//#endregion
+export { agentArgv, coerceAgentFlag };

package/dist/utils/agent_picker.js

@@ -4,7 +4,7 @@ import prompts from "prompts";
 //#region src/utils/agent_picker.ts
 const canPickAgentsInteractively = () => !isCi() && Boolean(process.stdout.isTTY) && Boolean(process.stdin.isTTY);
 const pickAgentsInteractively = async (options) => {
-	if (!canPickAgentsInteractively()) throw new Error("No interactive terminal. Pass --agent <name>, or run this command in a terminal to pick agents.");
+	if (!canPickAgentsInteractively()) throw new Error("No interactive terminal. Pass -y, or run this command in a terminal to pick agents.");
 	if (options.choices.length === 0) throw new Error("No coding agents are available to pick.");
 	const selected = new Set(options.selected ?? []);
 	const { agents } = await prompts({
@@ -48,7 +48,7 @@ const resolveAgentSelection = async (options) => {
 			choices: options.choices,
 			selected: options.detected.filter((id) => options.choices.some((choice) => choice.id === id))
 		});
-		if (selected.length === 0) throw new Error("No agents selected. Pass --agent <name>, or pick at least one agent.");
+		if (selected.length === 0) throw new Error("No agents selected. Pick at least one agent, or pass -y to use detected agents.");
 		return uniqueAgentIds(selected);
 	}
 	if (options.detected.length > 0) return uniqueAgentIds(options.detected);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neon",
-  "version": "4.10.1",
+  "version": "4.11.0",
   "description": "CLI tool for Neon, the cloud backend primitives built around Lakebase Postgres",
   "keywords": [
     "neon",
@@ -63,9 +63,9 @@
     "yaml": "^2.9.0",
     "yargs": "17.7.2",
     "yoctocolors": "^2.1.2",
-    "@neon/config": "1.0.5",
+    "@neon/config-runtime": "1.0.5",
     "@neon/sdk": "3.0.0",
-    "@neon/config-runtime": "1.0.5"
+    "@neon/config": "1.0.5"
   },
   "optionalDependencies": {
     "@napi-rs/keyring": "1.3.0",