neon 5.0.0 → 6.0.0

package/dist/commands/init.js

@@ -1,26 +1,13 @@
 import { t as __exportAll } from "../_chunks/rolldown-runtime-8H4AJuhK.js";
-import { log } from "../log.js";
-import { contextBranch, readContextFile } from "../context.js";
-import { recordCommandSuccessExtras } from "../analytics.js";
-import { t as credentialInputs } from "../_chunks/auth_selection-pitMFzDe.js";
 import { getCliName } from "../utils/cli_name.js";
-import { deprecatedServiceMessage, parseServices, servicesFlagValue, servicesOption } from "../neon_services.js";
-import { CONFIG_INIT_NONE_MEANS, CONFIG_INIT_SERVICES, CONFIG_INIT_UNAVAILABLE } from "../config_template.js";
 import { helpCsv, helpEpilogue } from "../utils/help_text.js";
-import { fetchTemplates } from "../init/bootstrap.js";
-import { initChildEnv, spawnCliChild } from "../init/child.js";
-import { agentSetupLabel, configSummaryLabel, formatInitDone, printInitBanner, printInitDone, shouldPrintInitBanner } from "../init/chrome.js";
-import { hasNeonConfigFile } from "./config.js";
-import { runAuthenticatedLink } from "../init/link.js";
+import { servicesOption } from "../neon_services.js";
+import { CONFIG_INIT_NONE_MEANS, CONFIG_INIT_SERVICES } from "../config_template.js";
+import { initChildEnv } from "../init/child.js";
 import { coerceAgentFlag } from "../utils/agent_flag.js";
-import { INIT_NEEDS_YES_OR_TERMINAL, assertNamedAgentTooling, directoryIsEmpty, initPluginAgents, initSkillsMcpAgents, planExistingInit, resolveNamedAgents } from "../init/plan.js";
-import { canPickAgentsInteractively } from "../utils/agent_picker.js";
-import { pickInitConfigInteractively, pickInitLinkInteractively, pickInitTemplateInteractively } from "../init/wizard.js";
-import { runAgentTooling, runInitSteps } from "../init/tooling.js";
-import { handler as handler$1 } from "./bootstrap.js";
-import { INIT_CONFIG_SERVICES_CONFLICT, INIT_TEMPLATE_KEEPS_CONFIG, configPlanFromResolution, resolveInitConfigChoice, resolveInitTemplateChoice, shouldRefreshEnvAfterNewConfig } from "../init/choices.js";
-import { existsSync, readdirSync } from "node:fs";
-import { resolve } from "node:path";
+import { initPluginAgents, initSkillsMcpAgents } from "../init/plan.js";
+import { listSkillIds } from "../skills/catalog.js";
+import { runInit } from "../init/run.js";
 //#region src/commands/init.ts
 var init_exports = /* @__PURE__ */ __exportAll({
 	builder: () => builder,
@@ -30,33 +17,43 @@ var init_exports = /* @__PURE__ */ __exportAll({
 	initChildEnv: () => initChildEnv
 });
 const command = "init";
-const describe = "Set up this directory for Neon: agent tooling, a linked project, and optionally neon.ts. In an empty directory, pick a template or skip scaffolding.";
+const describe = "Set up coding agents and this directory for Neon. -y is Recommended. -y with Custom flags applies those answers without prompts.";
 const removedProtocol = () => `\`${getCliName()} init --data\` was removed. Run \`${getCliName()} init\` or \`${getCliName()} init -y\`.`;
 const builder = (yargs) => yargs.usage("$0 init [options]").option("context-file", { hidden: true }).option("yes", {
 	alias: "y",
 	type: "boolean",
 	default: false,
-	describe: "Empty dir: scaffold the default template. --skip-template: plugin, or skills and MCP, for project folders, else the host CLI agent. Exits if none. Then link with defaults and create the bare neon.ts policy. If several organizations or projects exist, link prints IDs and exits"
-}).option("skip-template", {
+	describe: "Skip prompts. Alone: Recommended (detected agents, link when authenticated, default neon.ts). With --skill, MCP flags, --no-agent-setup, or --claimable: Custom using those flags"
+}).option("agent-setup", {
+	type: "boolean",
+	default: true,
+	describe: "Install Neon into coding agents. Use --no-agent-setup to skip. Plugin vs skills is inferred from --skill and MCP flags"
+}).option("claimable", {
 	type: "boolean",
 	default: false,
-	describe: "Do not scaffold a template. Set up agents, link a project, and optionally neon.ts in this directory"
-}).option("template", {
+	describe: "Create a claimable project that expires in 72 hours unless claimed. Selects Custom"
+}).option("package-manager", {
 	type: "string",
-	describe: "Template to scaffold into an empty directory. Conflicts with --skip-template"
+	choices: [
+		"npm",
+		"pnpm",
+		"yarn",
+		"bun"
+	],
+	describe: "Package manager for neon.ts dependencies. -y uses this without asking. Custom asks only when none is detected"
 }).option("link", {
 	type: "boolean",
 	default: true,
 	describe: "Link a Neon project during setup. Use --no-link to skip without being asked"
 }).option("config", {
 	type: "boolean",
-	describe: "Existing app or --skip-template: create neon.ts after linking. Use --no-config to skip. Omitted in a terminal: you will be asked. Scaffolding a template keeps that template's neon.ts"
+	describe: "Create neon.ts after linking. Use --no-config to skip. Omitted in Custom: you will be asked"
 }).option("services", servicesOption({
 	key: "services",
 	allowed: CONFIG_INIT_SERVICES,
-	describe: "Existing app or --skip-template: services to declare in neon.ts",
+	describe: "Services to declare in neon.ts",
 	noneMeans: CONFIG_INIT_NONE_MEANS,
-	also: "Implies creating neon.ts. Cannot be combined with --no-config. Ignored when scaffolding a template."
+	also: "Implies creating neon.ts. Cannot be combined with --no-config."
 })).option("org-id", {
 	describe: "Forwarded to link: organization ID to link to",
 	type: "string"
@@ -77,8 +74,24 @@ const builder = (yargs) => yargs.usage("$0 init [options]").option("context-file
 	alias: "a",
 	type: "array",
 	string: true,
-	describe: "Coding agent to install into (repeatable). Forwarded to plugins, or to skills and mcp. Skips agent selection. Values listed below",
+	describe: "Coding agent to install into (repeatable). Skips agent selection. Values listed below",
 	coerce: coerceAgentFlag
+}).option("skill", {
+	type: "array",
+	string: true,
+	describe: "Neon skill to install (repeatable). Selects skills setup (not the plugin) and skips the skills picker. With MCP flags, also configures MCP. Values listed below"
+}).option("mcp-config-location", {
+	type: "string",
+	choices: ["global", "project"],
+	describe: "Where to configure the Neon MCP server: global (user config, same as neon mcp) or project (this directory, same as neon mcp --project). Selects skills and MCP setup"
+}).option("mcp-auth", {
+	type: "string",
+	choices: ["oauth", "api-key"],
+	describe: "MCP authentication. Selects skills and MCP setup. oauth is neon mcp --oauth"
+}).option("mcp-project-scoped", {
+	type: "boolean",
+	default: false,
+	describe: "Limit MCP tools to the linked project, same as neon mcp --project-id. Selects skills and MCP setup"
 }).option("data", {
 	hidden: true,
 	type: "string"
@@ -86,281 +99,13 @@ const builder = (yargs) => yargs.usage("$0 init [options]").option("context-file
 	alias: "o",
 	hidden: true,
 	describe: "Not supported; the commands init runs print their own output"
-}).example("$0 init", "Set up this directory (template picker if empty)").example("$0 init --skip-template", "Empty dir: agents, link, and neon.ts — no template files").example("$0 init -y", "Default template, or existing-app defaults").example("$0 init --agent cursor --agent claude-code", "Skip agent selection; install the plugin for those agents").epilogue(helpEpilogue("Empty directory: pick a starter template, or skip scaffolding and only set up agents, a Neon project, and neon.ts. That skip is not on `neon bootstrap`.", "Interactive agent setup: plugin (recommended), skills and MCP separately, or skip agent setup. Never both plugin and skills+MCP.", "neon.ts is optional when you skip the template or set up an existing app. Saying no skips the services picker and does not write the file. Scaffolding a template keeps that template's neon.ts.", "-y installs the plugin when Cursor, Claude Code, or Codex is in project folders, else the host CLI agent. Otherwise skills and MCP. If none are found, it exits: pass --agent <name>, run from a supported agent, or omit -y in a terminal to pick. Then link unless already linked. If several organizations or projects exist, link prints IDs and exits.", "--agent / -a is forwarded to plugins, or to skills and mcp, not both. It skips agent selection, including with -y.", helpCsv("Plugin agents", initPluginAgents()), helpCsv("Skills and MCP agents", initSkillsMcpAgents()))).check((argv) => {
+}).example("$0 init", "Recommended or Custom setup").example("$0 init -y", "Recommended setup without prompts").example("$0 init -y --skill neon --mcp-auth oauth --mcp-config-location project", "Custom: those skills and MCP, Recommended defaults for the rest").example("$0 init --no-agent-setup --claimable", "Skip agent setup and create a claimable project").example("$0 init --agent cursor --agent claude-code", "Skip agent selection; install tooling for those agents").epilogue(helpEpilogue("Recommended setup installs tooling for detected coding agents, links a Neon project when the CLI is authenticated or the session is interactive, and writes a default neon.ts.", "init sets up the current directory in place. It does not scaffold starter files.", "-y alone is Recommended. -y with --skill, MCP flags, --no-agent-setup, or --claimable is Custom: those flags, Recommended defaults for unanswered questions. -y never opens a browser.", "--skill selects skills (not the plugin). MCP flags select skills and MCP. --no-agent-setup skips agent setup. --agent without those flags installs the plugin (and skills/MCP for agents the plugin cannot cover).", "Without a TTY, pass -y or enough flags to answer every question.", "--agent / -a is forwarded to plugins, or to skills and mcp. It skips agent selection, including with -y.", helpCsv("Plugin agents", initPluginAgents()), helpCsv("Skills and MCP agents", initSkillsMcpAgents()), helpCsv("Skills", listSkillIds()))).check((argv) => {
 	if (argv.data !== void 0) throw new Error(removedProtocol());
 	if (argv.help !== true && (argv.output === "json" || argv.output === "yaml")) throw new Error(`\`${getCliName()} init\` does not support --output. The commands it runs print their own output.`);
 	return true;
 }).strict();
-const isLinked = (contextFile) => {
-	const projectId = readContextFile(contextFile).projectId;
-	return typeof projectId === "string" && projectId.length > 0;
-};
-const nestedBootstrapDirectory = (cwd) => resolve(cwd) === resolve(process.cwd()) ? "." : cwd;
-const parsedInitServices = (raw) => {
-	const values = servicesFlagValue(raw);
-	if (values === void 0) return;
-	return parseServices(values, {
-		allowed: CONFIG_INIT_SERVICES,
-		whyUnavailable: CONFIG_INIT_UNAVAILABLE,
-		flag: "--services",
-		noneMeans: CONFIG_INIT_NONE_MEANS,
-		onDeprecated: (used, canonical) => log.warning(deprecatedServiceMessage(used, canonical))
-	});
-};
-const nestedBootstrapProps = (props, cwd, contextFile, template, linkInputs) => ({
-	apiClient: props.apiClient,
-	apiKey: props.apiKey,
-	apiHost: props.apiHost,
-	output: props.output,
-	contextFile,
-	directory: nestedBootstrapDirectory(cwd),
-	force: false,
-	listTemplates: false,
-	default: template.useDefault,
-	install: true,
-	git: true,
-	link: props.link !== false,
-	printBanner: false,
-	skipDoneSummary: true,
-	linkNoConfig: true,
-	narrate: "human",
-	...template.selected ? { selectedTemplate: template.selected } : {},
-	...!template.selected && template.id !== void 0 ? { template: template.id } : {},
-	linkInputs,
-	...props.agent !== void 0 ? { agent: props.agent } : {},
-	...props.configDir ? { configDir: props.configDir } : {},
-	...props.profile ? { profile: props.profile } : {},
-	...props.oauthHost ? { oauthHost: props.oauthHost } : {},
-	...props.clientId ? { clientId: props.clientId } : {},
-	...props.forceAuth !== void 0 ? { forceAuth: props.forceAuth } : {},
-	...props.allowUnsafeTls !== void 0 ? { allowUnsafeTls: props.allowUnsafeTls } : {},
-	...props.analytics === false ? { analytics: false } : {},
-	...props.run ? { run: props.run } : {},
-	...props.linkProject ? { linkProject: props.linkProject } : {},
-	...props.pickLink ? { pickLink: props.pickLink } : {},
-	...props.pickAgentSetup ? { pickAgentSetup: props.pickAgentSetup } : {},
-	...props.detectProjectAgents ? { detectProjectAgents: props.detectProjectAgents } : {},
-	...props.detectAgent ? { detectAgent: props.detectAgent } : {},
-	...props.hasProjectPlugins ? { hasProjectPlugins: props.hasProjectPlugins } : {}
-});
-const projectRow = (input) => {
-	if (input.alreadyLinked) return "already linked";
-	if (input.linkedNow) return "linked";
-	return "not linked";
-};
-const configSummary = (input) => {
-	if (input.plan.kind === "skip") return "skipped";
-	if (input.existingConfig) return "existing";
-	return "created";
-};
-const printNestedBootstrapDone = (result, cwd, fallbackTitle) => {
-	const hasConfig = result?.hasNeonConfig === true || hasNeonConfigFile(cwd);
-	printInitDone(formatInitDone({
-		heading: "Neon setup complete.",
-		rows: [
-			{
-				label: "Template",
-				value: result?.templateTitle ?? fallbackTitle
-			},
-			{
-				label: "Agents",
-				value: agentSetupLabel(result?.agentSetup ?? "skip")
-			},
-			{
-				label: "Project",
-				value: projectRow({
-					alreadyLinked: false,
-					linkedNow: result?.linked === true
-				})
-			},
-			{
-				label: "Config",
-				value: configSummaryLabel(hasConfig ? "template" : "skipped")
-			}
-		],
-		next: []
-	}));
-};
-const noteTemplateKeepsShippedConfig = (config, services) => {
-	if (config === void 0 && services === void 0) return;
-	log.warning(INIT_TEMPLATE_KEEPS_CONFIG);
-};
-const recordInitSuccess = (kind, agentSetup) => {
-	recordCommandSuccessExtras({
-		init_kind: kind,
-		...agentSetup !== void 0 ? { agent_setup: agentSetup } : {}
-	});
-};
 const handler = async (props) => {
-	if (props.output === "json" || props.output === "yaml") throw new Error(`\`${getCliName()} init\` does not support --output. The commands it runs print their own output.`);
-	const cwd = props.cwd ?? process.cwd();
-	const names = existsSync(cwd) ? readdirSync(cwd) : [];
-	const contextFile = resolve(cwd, props.contextFile);
-	const yes = props.yes === true;
-	const named = resolveNamedAgents(props.agent ?? []);
-	assertNamedAgentTooling(named, "init", yes ? { yes: true } : void 0);
-	const run = props.run ?? spawnCliChild;
-	const explicitKey = props.profile ? "" : credentialInputs().apiKeyFlag;
-	const authEnv = explicitKey ? { NEON_API_KEY: explicitKey } : void 0;
-	const forward = {
-		...props.configDir ? { configDir: props.configDir } : {},
-		...props.profile ? { profile: props.profile } : {},
-		apiHost: props.apiHost,
-		contextFile,
-		...props.analytics === false ? { analytics: false } : {}
-	};
-	const services = parsedInitServices(props.services);
-	if (props.config === false && services !== void 0) throw new Error(INIT_CONFIG_SERVICES_CONFLICT);
-	const linkInputs = {
-		...props.orgId ? { orgId: props.orgId } : {},
-		...props.projectId ? { projectId: props.projectId } : {},
-		...props.projectName ? { projectName: props.projectName } : {},
-		...props.regionId ? { regionId: props.regionId } : {},
-		...props.branch ? { branch: props.branch } : {}
-	};
-	const hasExplicitLinkInputs = props.orgId !== void 0 || props.projectId !== void 0 || props.projectName !== void 0 || props.regionId !== void 0 || props.branch !== void 0;
-	const templateChoice = resolveInitTemplateChoice({
-		empty: directoryIsEmpty(names),
-		yes,
-		skipTemplate: props.skipTemplate === true,
-		template: props.template
-	});
-	if (shouldPrintInitBanner(yes)) printInitBanner();
-	if (templateChoice.kind === "default" || templateChoice.kind === "template") {
-		if (templateChoice.kind === "template" && !yes && props.runBootstrap === void 0 && !canPickAgentsInteractively()) throw new Error(INIT_NEEDS_YES_OR_TERMINAL);
-		const runBootstrap = props.runBootstrap ?? handler$1;
-		noteTemplateKeepsShippedConfig(props.config, services);
-		const result = await runBootstrap(nestedBootstrapProps(props, cwd, contextFile, {
-			useDefault: yes,
-			...templateChoice.kind === "template" ? { id: templateChoice.id } : {}
-		}, linkInputs));
-		printNestedBootstrapDone(result, cwd, templateChoice.kind === "template" ? templateChoice.id : "default");
-		recordInitSuccess("empty-template", result?.agentSetup);
-		return;
-	}
-	if (templateChoice.kind === "ask") {
-		if (props.pickTemplate === void 0 && !canPickAgentsInteractively()) throw new Error(INIT_NEEDS_YES_OR_TERMINAL);
-		const templates = await (props.fetchTemplates ?? fetchTemplates)();
-		const picked = await (props.pickTemplate ?? pickInitTemplateInteractively)(templates);
-		if (picked.kind === "template") {
-			const runBootstrap = props.runBootstrap ?? handler$1;
-			noteTemplateKeepsShippedConfig(props.config, services);
-			const result = await runBootstrap(nestedBootstrapProps(props, cwd, contextFile, {
-				selected: picked.template,
-				useDefault: false
-			}, linkInputs));
-			printNestedBootstrapDone(result, cwd, picked.template.id);
-			recordInitSuccess("empty-template", result?.agentSetup);
-			return;
-		}
-	}
-	const alreadyLinked = isLinked(contextFile);
-	const shouldLink = props.link !== false && (!alreadyLinked || hasExplicitLinkInputs);
-	const existingConfig = hasNeonConfigFile(cwd);
-	const canAskConfig = props.pickConfig !== void 0 || canPickAgentsInteractively();
-	const agentSetup = await runAgentTooling({
-		cwd,
-		yes,
-		run,
-		forward,
-		authEnv,
-		narrate: "human",
-		command: "init",
-		...named.length > 0 ? { agents: named } : {},
-		...props.pickAgentSetup ? { pickAgentSetup: props.pickAgentSetup } : {},
-		...props.detectProjectAgents ? { detectProjectAgents: props.detectProjectAgents } : {},
-		...props.detectAgent ? { detectAgent: props.detectAgent } : {},
-		...props.hasProjectPlugins ? { hasProjectPlugins: props.hasProjectPlugins } : {}
-	});
-	const canAskLink = props.pickLink !== void 0 || canPickAgentsInteractively();
-	const acceptedLink = shouldLink && (yes || !canAskLink || await (props.pickLink ?? pickInitLinkInteractively)());
-	if (acceptedLink) await (props.linkProject ?? runAuthenticatedLink)({
-		apiClient: props.apiClient,
-		apiKey: props.apiKey,
-		apiHost: props.apiHost,
-		output: props.output,
-		contextFile,
-		yes,
-		clear: false,
-		checks: true,
-		envPull: true,
-		config: false,
-		cwd,
-		...linkInputs,
-		...props.configDir ? { configDir: props.configDir } : {},
-		...props.profile ? { profile: props.profile } : {},
-		...props.oauthHost ? { oauthHost: props.oauthHost } : {},
-		...props.clientId ? { clientId: props.clientId } : {},
-		...props.forceAuth !== void 0 ? { forceAuth: props.forceAuth } : {},
-		...props.allowUnsafeTls !== void 0 ? { allowUnsafeTls: props.allowUnsafeTls } : {}
-	});
-	const configResolution = resolveInitConfigChoice({
-		flag: props.config,
-		yes,
-		canAsk: canAskConfig,
-		existingConfig,
-		...services !== void 0 ? { services } : {}
-	});
-	const accepted = configResolution.kind === "ask" ? await (props.pickConfig ?? pickInitConfigInteractively)() : void 0;
-	const configPlan = configPlanFromResolution(configResolution, accepted);
-	if (configPlan.kind === "write") {
-		await runInitSteps(planExistingInit({
-			linked: true,
-			yes,
-			agentSetup: "skip",
-			config: configPlan
-		}), {
-			cwd,
-			run,
-			forward,
-			authEnv,
-			narrate: "human"
-		});
-		const context = readContextFile(contextFile);
-		const branch = contextBranch(context);
-		if (shouldRefreshEnvAfterNewConfig({
-			wroteNewFile: !existingConfig,
-			projectId: context.projectId,
-			branch
-		})) try {
-			await runInitSteps([["env", "pull"]], {
-				cwd,
-				run,
-				forward,
-				authEnv,
-				narrate: "human"
-			});
-		} catch (err) {
-			const message = err instanceof Error ? err.message : String(err);
-			log.warning(`Created neon.ts, but pulling its Neon env vars failed: %s
-Run \`${getCliName()} env pull\` once resolved.`, message);
-		}
-	}
-	printInitDone(formatInitDone({
-		heading: "Neon setup complete.",
-		rows: [
-			{
-				label: "Agents",
-				value: agentSetupLabel(agentSetup)
-			},
-			{
-				label: "Project",
-				value: projectRow({
-					alreadyLinked,
-					linkedNow: acceptedLink
-				})
-			},
-			{
-				label: "Config",
-				value: configSummaryLabel(configSummary({
-					plan: configPlan,
-					existingConfig
-				}))
-			}
-		],
-		next: []
-	}));
-	recordInitSuccess(templateChoice.kind === "existing" ? "existing" : "empty-skip", agentSetup);
+	await runInit(props);
 };
 //#endregion
 export { builder, command, describe, handler, initChildEnv, init_exports as t };

package/dist/commands/mcp.js

@@ -10,7 +10,6 @@ import { NEON_MCP_CATEGORIES, NEON_MCP_URL, existingNeonApiKey, installNeonMcpSe
 import { mcpInstallableAgents, resolveInstallTargets } from "../mcp/targets.js";
 import { canPickAgentsInteractively } from "../utils/agent_picker.js";
 import { mintMcpApiKey, mintedKeyRevokeCommand, withdrawMintedKey } from "../mcp/mint.js";
-import { confirmMcpInstall } from "../mcp/wizard.js";
 import { resolveMcpPlan } from "../mcp/plan.js";
 //#region src/commands/mcp.ts
 var mcp_exports = /* @__PURE__ */ __exportAll({
@@ -87,7 +86,7 @@ const builder = (argv) => argv.usage("$0 mcp [options]").options({
 			return parseMcpCategories(parts);
 		}
 	}
-}).example("$0 mcp", "Interactive: config location, agents, auth, then confirm").example("$0 mcp -y", "Global config, installed apps else the host CLI agent, reuse or mint an API key").example("$0 mcp --oauth", "Install with OAuth; the agent signs in on first use").example("$0 mcp --agent cursor --agent claude-code", "Install into specific agents").example("$0 mcp --project", "Write project-level config").example("$0 mcp --read-only", "Hide write tools via ?readonly=true").example("$0 mcp --project-id <id>", "Pin tools to one project via ?projectId=").example("$0 mcp --category querying --category schema", "Limit tools to those categories").epilogue(helpEpilogue(`Installs ${NEON_MCP_URL}`, helpCsv("Supported agents at global scope", mcpGlobalAgents), helpCsv("--project does not support", mcpProjectDroppedAgents), helpCsv("Supported categories", NEON_MCP_CATEGORIES), "neon mcp -y:", "  global config", "  globally installed apps, else the host CLI agent", "  reuse an existing Neon MCP API key, else mint an account-wide key", "  write tools on, all categories", "  no project pin (including from .neon)")).strict().check(noPassthrough("mcp"));
+}).example("$0 mcp", "Interactive: config location, agents, then auth").example("$0 mcp -y", "Global config, installed apps else the host CLI agent, reuse or mint an API key").example("$0 mcp --oauth", "Install with OAuth; the agent signs in on first use").example("$0 mcp --agent cursor --agent claude-code", "Install into specific agents").example("$0 mcp --project", "Write project-level config").example("$0 mcp --read-only", "Hide write tools via ?readonly=true").example("$0 mcp --project-id <id>", "Pin tools to one project via ?projectId=").example("$0 mcp --category querying --category schema", "Limit tools to those categories").epilogue(helpEpilogue(`Installs ${NEON_MCP_URL}`, helpCsv("Supported agents at global scope", mcpGlobalAgents), helpCsv("--project does not support", mcpProjectDroppedAgents), helpCsv("Supported categories", NEON_MCP_CATEGORIES), "neon mcp -y:", "  global config", "  globally installed apps, else the host CLI agent", "  reuse an existing Neon MCP API key, else mint an account-wide key", "  write tools on, all categories", "  no project pin (including from .neon)")).strict().check(noPassthrough("mcp"));
 const handler = async (props) => {
 	const cwd = process.cwd();
 	const interactive = canPickAgentsInteractively() && props.yes !== true;
@@ -129,20 +128,6 @@ const handler = async (props) => {
 		if (!props.apiClient || !props.apiKey) throw new Error(`Authentication required. Run \`${getCliName()} auth\`, pass --api-key or use --oauth to install without a Neon credential.`);
 		if (!canPickAgentsInteractively() && props.yes !== true && (props.agent ?? []).length === 0) throw new Error("No interactive terminal. Pass -y to mint into every detected agent, --agent <name> to name them or --oauth to install without minting.");
 	}
-	if (interactive) {
-		if (!await confirmMcpInstall({
-			scope: plan.scope,
-			install,
-			skipped,
-			auth: plan.auth,
-			reuse: existing !== void 0,
-			url,
-			mintProjectId: plan.urlProjectId
-		})) {
-			log.info("Aborted. Nothing was written.");
-			return;
-		}
-	}
 	let auth;
 	let minted;
 	if (plan.auth === "oauth") auth = { kind: "oauth" };

package/dist/commands/plugins.js

@@ -9,9 +9,8 @@ import { NEON_MCP_URL } from "../mcp/install.js";
 import "../init/agents.js";
 import { pluginsInstallableAgents } from "../plugins/targets.js";
 import { canPickAgentsInteractively } from "../utils/agent_picker.js";
-import { NEON_PLUGIN_NAME, PLUGIN_SKILLS, PLUGIN_SOURCE, neonPluginsRetryCommand, pluginsAddArgs, runPluginsCli } from "../plugins/run.js";
 import { resolvePluginsPlan } from "../plugins/plan.js";
-import { confirmPluginsInstall } from "../plugins/wizard.js";
+import { NEON_PLUGIN_NAME, PLUGIN_SKILLS, PLUGIN_SOURCE, neonPluginsRetryCommand, pluginsAddArgs, runPluginsCli } from "../plugins/run.js";
 //#region src/commands/plugins.ts
 var plugins_exports = /* @__PURE__ */ __exportAll({
 	aliases: () => aliases,
@@ -54,7 +53,7 @@ const builder = (argv) => argv.usage("$0 plugins [options]").options({
 		describe: "Coding agent to install into (repeatable). Skips the agent picker. Values listed below",
 		coerce: coerceAgents
 	}
-}).example("$0 plugins", "Interactive: agents, then confirm").example("$0 plugins -y", "Detected agents (project folders, else the host CLI agent), skip prompts").example("$0 plugins --agent cursor --agent claude-code", "Install into specific agents").example("$0 plugins --global", "Install user-level").epilogue(helpEpilogue(helpCsv("Supported agents at project scope", pluginProjectAgents), helpCsv("Also with --global", pluginGlobalOnlyAgents), `Currently one plugin: ${NEON_PLUGIN_NAME} from ${PLUGIN_SOURCE}.`, `It includes the Neon MCP server (${NEON_MCP_URL})`, helpCsv("and these skills", PLUGIN_SKILLS))).strict().check(noPassthrough("plugins"));
+}).example("$0 plugins", "Interactive: pick agents, then install").example("$0 plugins -y", "Detected agents (project folders, else the host CLI agent), skip prompts").example("$0 plugins --agent cursor --agent claude-code", "Install into specific agents").example("$0 plugins --global", "Install user-level").epilogue(helpEpilogue(helpCsv("Supported agents at project scope", pluginProjectAgents), helpCsv("Also with --global", pluginGlobalOnlyAgents), `Currently one plugin: ${NEON_PLUGIN_NAME} from ${PLUGIN_SOURCE}.`, `It includes the Neon MCP server (${NEON_MCP_URL})`, helpCsv("and these skills", PLUGIN_SKILLS))).strict().check(noPassthrough("plugins"));
 const handler = async (props) => {
 	const cwd = process.cwd();
 	const yes = props.yes === true;
@@ -68,15 +67,6 @@ const handler = async (props) => {
 	});
 	for (const agent of plan.skipped) log.warning("Skipping %s: no plugins mapping.", getAgentDisplayName(agent));
 	for (const agent of plan.userScopeSkipped) log.warning("Skipping %s: plugins are user-level. Pass --global.", getAgentDisplayName(agent));
-	if (interactive) {
-		if (!await confirmPluginsInstall({
-			scope: plan.scope,
-			agents: plan.agents
-		})) {
-			log.info("Aborted. Nothing was written.");
-			return;
-		}
-	}
 	const rows = [];
 	const failed = [];
 	const scope = scopeLabel(plan.scope);

package/dist/commands/skills.js

@@ -9,7 +9,7 @@ import "../init/agents.js";
 import { mappedSkillsAgentNames, skillsInstallableAgents } from "../skills/targets.js";
 import { canPickAgentsInteractively } from "../utils/agent_picker.js";
 import { skillsHelpValues, skillsYesHelp } from "../skills/catalog.js";
-import { confirmSkillsInstall, confirmSkillsUpdate } from "../skills/wizard.js";
+import { confirmSkillsUpdate } from "../skills/wizard.js";
 import { assertSkillsCanRun, resolveSkillsPlan } from "../skills/plan.js";
 import { assertSkillsNode, neonSkillsRetryCommand, neonSkillsUpdateRetryCommand, runSkillsCli, skillsAddArgs, skillsMetadata, skillsUpdateArgs, skillsUpdateDetail, skillsUpdateHadNothing } from "../skills/run.js";
 //#region src/commands/skills.ts
@@ -82,7 +82,7 @@ const builder = (argv) => argv.usage("$0 skills [command] [options]").command("u
 		describe: "Skill to install (repeatable). Skips the skill picker. Does not select agents. Values listed below",
 		coerce: coerceSkills
 	}
-}).example("$0 skills", "Interactive: this directory, agents, skills, then confirm").example("$0 skills -y", "This directory, detected agents (project folders, else the host CLI agent), the default skills").example("$0 skills -y -s neon -s neon-ai-gateway", "Named skills into detected agents").example("$0 skills -s neon -s neon-ai-gateway --agent cursor", "Named skills into a named agent").example("$0 skills --global", "Install user-level skills").epilogue(helpEpilogue(helpCsv("Supported agents", skillsInstallableAgents()), "Supported skills, by source repo:", skillsHelpValues(), skillsYesHelp())).strict().check(noPassthrough("skills"));
+}).example("$0 skills", "Interactive: this directory, then agents, then skills").example("$0 skills -y", "This directory, detected agents (project folders, else the host CLI agent), the default skills").example("$0 skills -y -s neon -s neon-ai-gateway", "Named skills into detected agents").example("$0 skills -s neon -s neon-ai-gateway --agent cursor", "Named skills into a named agent").example("$0 skills --global", "Install user-level skills").epilogue(helpEpilogue(helpCsv("Supported agents", skillsInstallableAgents()), "Supported skills, by source repo:", skillsHelpValues(), skillsYesHelp())).strict().check(noPassthrough("skills"));
 const handler = async (props) => {
 	assertSkillsNode();
 	const cwd = process.cwd();
@@ -98,16 +98,6 @@ const handler = async (props) => {
 	});
 	const mapped = mappedSkillsAgentNames(plan.agents);
 	for (const agent of plan.skipped) log.warning("Skipping %s: no skills mapping.", getAgentDisplayName(agent));
-	if (interactive) {
-		if (!await confirmSkillsInstall({
-			scope: plan.scope,
-			agents: plan.agents,
-			invocations: plan.invocations
-		})) {
-			log.info("Aborted. Nothing was written.");
-			return;
-		}
-	}
 	const metadata = skillsMetadata("skills");
 	const rows = [];
 	const failed = [];

package/dist/index.js

@@ -8,12 +8,13 @@ import { currentContextFile, enrichFromContext } from "./context.js";
 import { analyticsMiddleware, closeAnalytics, commandSuccessProperties, initAnalyticsClientMiddleware, sendError, takeCommandSuccessExtras, trackEvent } from "./analytics.js";
 import { NETWORK_ERROR_MESSAGE, isNetworkError, matchErrorCode } from "./errors.js";
 import { AuthRefreshError, defaultClientID } from "./auth.js";
+import { getCliName } from "./utils/cli_name.js";
 import { ensureAuth } from "./commands/auth.js";
 import { recoverFrom401 } from "./auth_recovery.js";
-import { getCliName } from "./utils/cli_name.js";
 import { showHelp } from "./help.js";
 import { rewriteUnknownAgentArg } from "./init/plan.js";
 import commands_default from "./commands/index.js";
+import { notifyIfUpdateAvailable } from "./update_notifier.js";
 import { fillInArgs, resolveApiKeyFromEnv } from "./utils/middlewares.js";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
@@ -193,6 +194,13 @@ async function handleError(msg, err, canRetry) {
 			process.exit(0);
 		}
 		await closeAnalytics();
+		notifyIfUpdateAvailable({
+			commandPath: args._.map(String),
+			configDir: typeof args.configDir === "string" ? args.configDir : defaultDir,
+			currentBranch: Boolean(args.currentBranch),
+			currentVersion: pkg_default.version,
+			output: typeof args.output === "string" ? args.output : "table"
+		});
 		break;
 	} catch (err) {
 		takeCommandSuccessExtras();

package/dist/init/cancelled.js

@@ -0,0 +1,16 @@
+//#region src/init/cancelled.ts
+var InitCancelled = class extends Error {
+	constructor() {
+		super("Aborted.");
+		this.name = "InitCancelled";
+	}
+};
+const restoreCursor = () => {
+	process.stdout.write("\x1B[?25h");
+	process.stdout.write("\n");
+};
+const restoreCursorVisibilityOnAbort = (state) => {
+	if (state.aborted) process.stdout.write("\x1B[?25h");
+};
+//#endregion
+export { InitCancelled, restoreCursor, restoreCursorVisibilityOnAbort };

package/dist/init/child.js

@@ -1,3 +1,4 @@
+import { InitCancelled } from "./cancelled.js";
 import { spawn } from "node:child_process";
 //#region src/init/child.ts
 const AUTH_CHILD = /* @__PURE__ */ new Set([
@@ -19,18 +20,29 @@ const initChildEnv = (command, overlay, base = process.env) => {
 const spawnCliChild = async (argv, cwd, overlay) => {
 	const cli = process.argv[1];
 	if (!cli) throw new Error("Cannot re-exec the Neon CLI: process.argv[1] is missing.");
-	return new Promise((resolve) => {
+	return new Promise((resolve, reject) => {
 		const child = spawn(process.execPath, [cli, ...argv], {
 			cwd,
 			stdio: "inherit",
 			env: initChildEnv(argv[0], overlay)
 		});
+		const onSigint = () => {
+			child.kill("SIGINT");
+		};
+		process.on("SIGINT", onSigint);
+		const finish = (code, signal) => {
+			process.off("SIGINT", onSigint);
+			if (signal === "SIGINT" || signal === "SIGTERM") {
+				reject(new InitCancelled());
+				return;
+			}
+			resolve(code === 0);
+		};
 		child.on("error", () => {
+			process.off("SIGINT", onSigint);
 			resolve(false);
 		});
-		child.on("close", (code) => {
-			resolve(code === 0);
-		});
+		child.on("close", finish);
 	});
 };
 //#endregion

package/dist/init/choices.js

@@ -1,25 +1,5 @@
-import { getCliName } from "../utils/cli_name.js";
 //#region src/init/choices.ts
-const INIT_TEMPLATE_CONFLICT = "--skip-template cannot be combined with --template.";
 const INIT_CONFIG_SERVICES_CONFLICT = "--no-config cannot be combined with --services.";
-const INIT_TEMPLATE_KEEPS_CONFIG = "A scaffolded template keeps the neon.ts it ships. --config, --no-config, and --services apply when you skip the template or set up an existing app.";
-const initTemplateInNonEmptyMessage = () => `--template is only for an empty directory. This directory already has files, so there is nothing to scaffold. Omit --template, or run \`${getCliName()} bootstrap\` in an empty folder.`;
-const resolveInitTemplateChoice = (input) => {
-	const id = input.template?.trim();
-	const hasTemplate = id !== void 0 && id.length > 0;
-	if (input.skipTemplate && hasTemplate) throw new Error(INIT_TEMPLATE_CONFLICT);
-	if (!input.empty) {
-		if (hasTemplate) throw new Error(initTemplateInNonEmptyMessage());
-		return { kind: "existing" };
-	}
-	if (input.skipTemplate) return { kind: "skip" };
-	if (hasTemplate) return {
-		kind: "template",
-		id
-	};
-	if (input.yes) return { kind: "default" };
-	return { kind: "ask" };
-};
 const resolveInitConfigChoice = (input) => {
 	if (input.flag === false && input.services !== void 0) throw new Error(INIT_CONFIG_SERVICES_CONFLICT);
 	if (input.flag === false) return { kind: "skip" };
@@ -41,6 +21,15 @@ const configPlanFromResolution = (resolution, accepted) => {
 	if (resolution.kind === "skip") return { kind: "skip" };
 	return resolution;
 };
+const isBareInitServices = (services) => {
+	if (services === void 0 || services.length === 0) return true;
+	return services.every((service) => service === "none");
+};
 const shouldRefreshEnvAfterNewConfig = (input) => input.wroteNewFile && typeof input.projectId === "string" && input.projectId.length > 0 && typeof input.branch === "string" && input.branch.length > 0;
+const shouldPullEnvAfterInitConfig = (input) => !input.extraServices && !input.alreadyPulled && shouldRefreshEnvAfterNewConfig({
+	wroteNewFile: input.wroteNewFile,
+	...input.projectId !== void 0 ? { projectId: input.projectId } : {},
+	...input.branch !== void 0 ? { branch: input.branch } : {}
+});
 //#endregion
-export { INIT_CONFIG_SERVICES_CONFLICT, INIT_TEMPLATE_CONFLICT, INIT_TEMPLATE_KEEPS_CONFIG, configPlanFromResolution, initTemplateInNonEmptyMessage, resolveInitConfigChoice, resolveInitTemplateChoice, shouldRefreshEnvAfterNewConfig };
+export { INIT_CONFIG_SERVICES_CONFLICT, configPlanFromResolution, isBareInitServices, resolveInitConfigChoice, shouldPullEnvAfterInitConfig, shouldRefreshEnvAfterNewConfig };