neon 8.15.0 → 8.15.1

package/README.md

@@ -1056,6 +1056,8 @@ On a TTY the command asks which agents, then installs. Detected agents start sel
 
 Default scope is `project`. `--global` is `user`. On macOS and Linux, Cursor and Claude Code store the plugin cache under `~/.claude/plugins`; on Windows, Cursor installs into Cursor extensions. `project` vs `user` is the scope field the plugins CLI records, not a directory in the repo. VS Code, GitHub Copilot CLI, and Grok Build only install user-level: they are skipped at the default scope with a warning, and a VS Code-only project fails if nothing else is selected. Pass `--global` for those.
 
+GitHub Copilot CLI and Grok Build install through their own CLIs (`copilot`, `grok`), so `neon plugins` runs `copilot --version` or `grok --version` first. A command that is missing, fails, or (for Copilot) is older than 0.0.400 is skipped with a warning under `-y`, fails an explicit `--agent`, and in `neon init` gets Neon skills and MCP instead of the plugin. The other agents install by writing files, so their detected config directory is enough.
+
 Supported agents with a plugins mapping: `claude-code`, `claude-desktop`, `codex`, `cursor`, `github-copilot-cli`, `grok-build`, `vscode`. `claude-desktop` installs as Claude Code; detecting both produces one install and lists both names in the table. `mcporter` is a known MCP name that is then skipped.
 
 The plugins CLI installs every plugin it finds in the Neon plugin package. Today that is `neon-postgres` from `neondatabase/agent-skills`. It includes the Neon MCP server (`https://mcp.neon.tech/mcp`) and these skills: `neon`, `neon-ai-gateway`, `neon-auth`, `neon-functions`, `neon-object-storage`, `neon-postgres`, `neon-postgres-branches`, `neon-postgres-egress-optimizer`, `neon-realtime`. It does not include `neon-postgres-agent-platforms`.
@@ -1122,7 +1124,7 @@ Without a template, a terminal asks which one to use; anything else exits with t
 
 A template's `layout` decides what you get. `router` writes one module per operation plus a generated `index.ts` that dispatches on the URL path, and declares one function. `separate` declares each operation as its own function under the slug the template gives it. Without `--operation` or `--all-operations`, a TTY asks which operations to include and anything else uses the template's recommended ones.
 
-Variables a template needs are declared on each function in `neon.ts` (`env: { API_KEY: process.env.API_KEY! }`) and added, without values, to `.env.example` next to it. Values are never written to `.env` or `.env.local` for you: a blank placeholder there would deploy as an empty string and delete the live value. Put the real value in the file `env pull` uses and deploy with `neon config apply --env .env.local`. `neon dev` reads function env from your shell, so export it there as well.
+Variables a template needs are declared on each function in `neon.ts` (`env: { API_KEY: process.env.API_KEY! }`) and added, without values, to `.env.example` next to it. Values are never written to `.env` or `.env.local` for you: a blank placeholder there would deploy as an empty string and delete the live value. Put the real value in the file `env pull` uses and deploy with `neon config apply --env .env.local`. `neon dev` loads it automatically.
 
 Nothing is written until every check passes: a file that already exists with different contents needs `--force`, and a slug `neon.ts` already declares needs `--slug`, `--force`, or `--no-add-to-config`. A `separate` template sets its own slugs, so `--slug` only changes its directory; remove the existing declarations from `neon.ts`, or use `--force` or `--no-add-to-config`.
 

package/dist/_chunks/{docs-CClmgj_Z.js → docs-BpLiSTmm.js}

@@ -128,7 +128,7 @@ function siteSearchHeaders(opts) {
 		"Content-Type": "application/json",
 		"User-Agent": `neon/${opts.version}`,
 		"x-caller-source": "cli",
-		...opts.agent ? { "x-caller-client": encodeURIComponent(opts.agent) } : {},
+		...opts.analytics && opts.agent ? { "x-caller-client": encodeURIComponent(opts.agent) } : {},
 		...opts.analytics ? {} : { "x-caller-analytics": "off" }
 	};
 }

package/dist/_chunks/{plugins-CKOcBuuP.js → plugins-B2Gym8Lw.js}

@@ -5,7 +5,7 @@ import { helpCsv, helpEpilogue } from "../utils/help_text.js";
 import { getAgentDisplayName } from "../mcp/agents.js";
 import { NEON_MCP_URL } from "../mcp/install.js";
 import "../init/agents.js";
-import { pluginsInstallableAgents } from "../plugins/targets.js";
+import { pluginsCommandProblemText, pluginsInstallableAgents } from "../plugins/targets.js";
 import { writer } from "../writer.js";
 import { noPassthrough } from "../utils/flags.js";
 import { AGENT_PLUGIN_SKIP_MESSAGE } from "../init/copy.js";
@@ -77,7 +77,7 @@ const installPlugins = async (options) => {
 	});
 	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));
-	for (const { agent, command } of plan.missingCommands) log.warning("Skipping %s: the plugin installs through \"%s\", which was not found on PATH.", getAgentDisplayName(agent), command);
+	for (const row of plan.unusableCommands) log.warning("Skipping %s: the plugin installs through \"%s\", which %s.", getAgentDisplayName(row.agent), row.command.name, pluginsCommandProblemText(row));
 	const rows = [];
 	const failed = [];
 	const scope = scopeLabel(plan.scope);

package/dist/analytics.js

@@ -1,5 +1,5 @@
 import { a as OAUTH, t as storeFor } from "./_chunks/credential_io-DbeSh3Pl.js";
-import { getCliAgent, getGithubEnvVars, isCi } from "./env.js";
+import { getCliAgent, getGithubEnvVars, getTty, isCi } from "./env.js";
 import { log } from "./log.js";
 import { getOrCreateAnonymousId } from "./anonymous_id.js";
 import pkg_default from "./pkg.js";
@@ -248,7 +248,8 @@ const settleErrorReports = async (deadline) => {
 const getErrorAnalyticsEventContext = (_args) => ({
 	version: pkg_default.version,
 	ci: isCi(),
-	agent: getCliAgent(process.env)
+	agent: getCliAgent(process.env),
+	tty: getTty()
 });
 const CREDENTIAL_TOKEN_ID = /\bnak_live_[0-9a-f]+\b/gi;
 const redactCredentialTokenIds = (text) => text.replace(CREDENTIAL_TOKEN_ID, "nak_live_<redacted>");
@@ -353,6 +354,7 @@ const getAnalyticsEventProperties = (args) => ({
 	flags: { output: args.output },
 	ci: isCi(),
 	agent: getCliAgent(process.env),
+	tty: getTty(),
 	githubEnvVars: getGithubEnvVars(process.env)
 });
 export { analyticsIdentity, analyticsMiddleware, closeAnalytics, commandSuccessProperties, getAnalyticsEventProperties, getErrorAnalyticsEventProperties, initAnalyticsClientMiddleware, isAnalyticsActive, recordCommandSuccessExtras, recordScaffoldedTemplate, redactCredentialTokenIds, sendError, storedCredentialAttribution, takeCommandSuccessExtras, telemetryCredential, trackCommandSuccess, trackEvent, useAnalyticsClientForTests };

package/dist/commands/docs.js

@@ -1 +1 @@
-export { t as DEFAULT_SITE_SEARCH_URL, n as MAX_LIMIT, r as MAX_QUERY_LENGTH, i as SITE_SEARCH_CATEGORIES, a as builder, o as command, s as describe, l as formatSearchResults, u as parseSearchHits, d as resolveSiteSearchUrl, f as siteSearchHeaders } from "../_chunks/docs-CClmgj_Z.js";
+export { t as DEFAULT_SITE_SEARCH_URL, n as MAX_LIMIT, r as MAX_QUERY_LENGTH, i as SITE_SEARCH_CATEGORIES, a as builder, o as command, s as describe, l as formatSearchResults, u as parseSearchHits, d as resolveSiteSearchUrl, f as siteSearchHeaders } from "../_chunks/docs-BpLiSTmm.js";

package/dist/commands/functions_new.js

@@ -169,9 +169,8 @@ const scaffoldFromTemplate = async (options) => {
 	const envFile = displayPath(resolveEnvFilePath(location), cwd);
 	const names = environment.join(", ");
 	if (variables && register) {
-		const them = environment.length === 1 ? "it" : "them";
-		nextSteps.push(`Set ${variables} in ${envFile}. \`${cli} dev\` reads ${them} from your shell, so export ${them} there too.`);
-		next.push(`Set ${names} in ${envFile}, and export ${them} for ${cli} dev`);
+		nextSteps.push(`Set ${variables} in ${envFile} (\`${cli} dev\` loads it automatically).`);
+		next.push(`Set ${names} in ${envFile} (${cli} dev loads it automatically)`);
 	} else if (variables) {
 		nextSteps.push(`Set ${variables} in your shell.`);
 		next.push(`Set ${names} in your shell`);

package/dist/commands/index.js

@@ -7,7 +7,7 @@ import { c as config_exports } from "../_chunks/config-BjCm5cfr.js";
 import { u as projects_exports } from "../_chunks/projects-a3X4OFEJ.js";
 import { a as link_exports } from "../_chunks/link-nAiuWKfg.js";
 import { o as mcp_exports } from "../_chunks/mcp-BznTRK3w.js";
-import { c as plugins_exports } from "../_chunks/plugins-CKOcBuuP.js";
+import { c as plugins_exports } from "../_chunks/plugins-B2Gym8Lw.js";
 import { l as skills_exports } from "../_chunks/skills-DKgafm65.js";
 import { t as bootstrap_exports } from "../_chunks/bootstrap-BDkvsAVJ.js";
 import { r as branches_exports } from "../_chunks/branches-Bp-5z1lM.js";
@@ -21,7 +21,7 @@ import { o as databases_exports } from "../_chunks/databases-DC2h6IW2.js";
 import { r as deploy_exports } from "../_chunks/deploy-DmEEhux0.js";
 import { s as dev_exports } from "../_chunks/dev-DlUJFzRs.js";
 import { i as diff_exports } from "../_chunks/diff-dnxneH0u.js";
-import { c as docs_exports } from "../_chunks/docs-CClmgj_Z.js";
+import { c as docs_exports } from "../_chunks/docs-BpLiSTmm.js";
 import { o as feedback_exports } from "../_chunks/feedback-mQmdTRFn.js";
 import { o as functions_exports } from "../_chunks/functions-3ypiRwZK.js";
 import { o as git_exports } from "../_chunks/git-j6xSVo3e.js";

package/dist/commands/plugins.js

@@ -1 +1 @@
-export { t as aliases, n as builder, r as command, i as describe, a as handler, o as installPlugins, s as pluginsInstallError, l as reportPluginsInstall } from "../_chunks/plugins-CKOcBuuP.js";
+export { t as aliases, n as builder, r as command, i as describe, a as handler, o as installPlugins, s as pluginsInstallError, l as reportPluginsInstall } from "../_chunks/plugins-B2Gym8Lw.js";

package/dist/env.js

@@ -1,3 +1,4 @@
+import { isatty } from "node:tty";
 // src/env.ts
 const isCi = () => {
 	return process.env.CI !== "false" && Boolean(process.env.CI);
@@ -6,16 +7,30 @@ const isInteractiveTerminal = () => !isCi() && Boolean(process.stdin.isTTY) && B
 const isDebug = () => {
 	return Boolean(process.env.DEBUG);
 };
+const getTty = () => ({
+	stdin: isatty(0),
+	stdout: isatty(1)
+});
+const AI_AGENT_NAME = /^[a-z0-9][a-z0-9._-]{0,63}$/;
+const isNonEmpty = (value) => Boolean(value?.trim());
 const getCliAgent = (env) => {
 	const active = [
 		["claude-code", env.CLAUDE_CODE_CHILD_SESSION === "1"],
 		["codex", env.CODEX_CI === "1" && (Boolean(env.CODEX_THREAD_ID?.trim()) || Boolean(env.CODEX_SESSION_ID?.trim()))],
 		["cursor", env.CURSOR_AGENT === "1"],
-		["opencode", env.OPENCODE === "1"],
+		["opencode", env.OPENCODE === "1" && env.KILO !== "1"],
+		["kilo", env.KILO === "1"],
 		["gemini-cli", env.GEMINI_CLI === "1"],
-		["github-copilot-cli", env.COPILOT_CLI === "1"]
+		["qwen-code", env.QWEN_CODE === "1"],
+		["github-copilot-cli", env.COPILOT_CLI === "1"],
+		["antigravity", isNonEmpty(env.ANTIGRAVITY_AGENT)],
+		["amp", isNonEmpty(env.AMP_CURRENT_THREAD_ID)],
+		["cline", env.CLINE_ACTIVE === "true"],
+		["openclaw", env.OPENCLAW_SHELL === "exec"]
 	].filter(([, present]) => present);
-	return active.length === 1 ? active[0][0] : void 0;
+	if (active.length > 0) return active.length === 1 ? active[0][0] : void 0;
+	const declared = env.AI_AGENT?.trim().toLowerCase();
+	return declared && AI_AGENT_NAME.test(declared) ? declared : void 0;
 };
 const getGithubEnvVars = (env) => {
 	const vars = [
@@ -38,4 +53,4 @@ const getGithubEnvVars = (env) => {
 	});
 	return Object.fromEntries(map);
 };
-export { getCliAgent, getGithubEnvVars, isCi, isDebug, isInteractiveTerminal };
+export { getCliAgent, getGithubEnvVars, getTty, isCi, isDebug, isInteractiveTerminal };

package/dist/init/copy.js

@@ -1,4 +1,5 @@
 import { getCliName } from "../utils/cli_name.js";
+import { pluginsCommandProblemText } from "../plugins/targets.js";
 // src/init/copy.ts
 const INIT_SUBTITLE = "Set up coding agents and this directory for Neon.";
 const MODE_MESSAGE = "How would you like to set up Neon?";
@@ -16,7 +17,7 @@ const AGENT_SETUP_SKIP_DESCRIPTION = "Continue to project setup without changing
 const AGENT_PICKER_MESSAGE = "Which coding agents should receive Neon tooling? (space to toggle, enter to confirm)";
 const AGENT_DETECTED_DESCRIPTION = "Detected on this machine or in this directory.";
 const AGENT_OTHER_DESCRIPTION = "Install for this agent.";
-const agentMissingCommandDescription = (command) => `Detected, but "${command}" was not found on PATH. Its plugin cannot install.`;
+const agentUnusableCommandDescription = (row) => `Detected, but "${row.command.name}" ${pluginsCommandProblemText(row)}. Its plugin cannot install.`;
 const AGENT_PLUGIN_SKIP_MESSAGE = "No agents selected. Continue without installing the Neon plugin?";
 const AGENT_SKILLS_PICKER_MESSAGE = "Which coding agents should receive Neon skills? (space to toggle, enter to confirm)";
 const AGENT_MCP_PICKER_MESSAGE = "Which coding agents should receive the Neon MCP server? (space to toggle, enter to confirm)";
@@ -184,4 +185,4 @@ const headingForOutcome = (outcome) => {
 		default: return outcome;
 	}
 };
-export { AGENTS_NOT_INSTALLED, AGENT_DETECTED_DESCRIPTION, AGENT_MCP_PICKER_MESSAGE, AGENT_MCP_SKIP_MESSAGE, AGENT_OTHER_DESCRIPTION, AGENT_PICKER_MESSAGE, AGENT_PLUGIN_SKIP_MESSAGE, AGENT_SETUP_MESSAGE, AGENT_SETUP_PLUGIN_DESCRIPTION, AGENT_SETUP_PLUGIN_TITLE, AGENT_SETUP_SKILLS_DESCRIPTION, AGENT_SETUP_SKILLS_TITLE, AGENT_SETUP_SKIP_DESCRIPTION, AGENT_SETUP_SKIP_TITLE, AGENT_SKILLS_PICKER_MESSAGE, AGENT_SKILLS_SKIP_MESSAGE, CANCELLED_BODY, CLAIMABLE_ACCOUNT_FLAGS, CLAIMABLE_ALREADY_LINKED, CLAIMABLE_MCP_API_KEY, CLAIMABLE_NO_LINK, CONFIG_CONFIRM_HINT, CONFIG_CONFIRM_MESSAGE, HEADING_CANCELLED, HEADING_COMPLETE, HEADING_FAILED, HEADING_PENDING, INIT_NEEDS_YES, INIT_SUBTITLE, MCP_API_KEY_NEEDS_AUTH, MCP_AUTH_API_KEY_DESCRIPTION, MCP_AUTH_API_KEY_TITLE, MCP_AUTH_MESSAGE, MCP_AUTH_OAUTH_DESCRIPTION, MCP_AUTH_OAUTH_TITLE, MCP_OAUTH_FALLBACK, MCP_SCOPED_NEEDS_PROJECT, MCP_SCOPE_GLOBAL_DESCRIPTION, MCP_SCOPE_GLOBAL_TITLE, MCP_SCOPE_MESSAGE, MCP_SCOPE_PROJECT_DESCRIPTION, MCP_SCOPE_PROJECT_TITLE, MODE_CUSTOM_DESCRIPTION, MODE_CUSTOM_TITLE, MODE_MESSAGE, MODE_RECOMMENDED_DESCRIPTION, MODE_RECOMMENDED_TITLE, NON_TTY_AGENT_SETUP, NON_TTY_LINK_NEEDS_AUTH, NO_AGENTS_FALLBACK_STATUS, NO_AGENT_SETUP_CONFLICT, PACKAGE_MANAGER_MESSAGE, PROGRESS, PROJECT_PINNED_OFFLINE, PROJECT_SETUP_CLAIMABLE_DESCRIPTION, PROJECT_SETUP_CLAIMABLE_TITLE, PROJECT_SETUP_LINK_DESCRIPTION, PROJECT_SETUP_LINK_TITLE, PROJECT_SETUP_MESSAGE, SERVICES_HINT, SERVICES_MESSAGE, SKILLS_PICKER_MESSAGE, agentMissingCommandDescription, claimableNext, claimableThenServicesNext, configInitNext, envPullFailedNext, existingConfigNext, headingForOutcome, installFailedNext, mcpAfterLinkNext, mcpConfigLocationSkipped, mcpConfigLocationUnavailable, mcpKeyFailedNext, namedAgentsUnavailable, newConfigNext, offlinePinNext, skippedLinkNext, toolingFailedNext, unattendedUnauthedNext };
+export { AGENTS_NOT_INSTALLED, AGENT_DETECTED_DESCRIPTION, AGENT_MCP_PICKER_MESSAGE, AGENT_MCP_SKIP_MESSAGE, AGENT_OTHER_DESCRIPTION, AGENT_PICKER_MESSAGE, AGENT_PLUGIN_SKIP_MESSAGE, AGENT_SETUP_MESSAGE, AGENT_SETUP_PLUGIN_DESCRIPTION, AGENT_SETUP_PLUGIN_TITLE, AGENT_SETUP_SKILLS_DESCRIPTION, AGENT_SETUP_SKILLS_TITLE, AGENT_SETUP_SKIP_DESCRIPTION, AGENT_SETUP_SKIP_TITLE, AGENT_SKILLS_PICKER_MESSAGE, AGENT_SKILLS_SKIP_MESSAGE, CANCELLED_BODY, CLAIMABLE_ACCOUNT_FLAGS, CLAIMABLE_ALREADY_LINKED, CLAIMABLE_MCP_API_KEY, CLAIMABLE_NO_LINK, CONFIG_CONFIRM_HINT, CONFIG_CONFIRM_MESSAGE, HEADING_CANCELLED, HEADING_COMPLETE, HEADING_FAILED, HEADING_PENDING, INIT_NEEDS_YES, INIT_SUBTITLE, MCP_API_KEY_NEEDS_AUTH, MCP_AUTH_API_KEY_DESCRIPTION, MCP_AUTH_API_KEY_TITLE, MCP_AUTH_MESSAGE, MCP_AUTH_OAUTH_DESCRIPTION, MCP_AUTH_OAUTH_TITLE, MCP_OAUTH_FALLBACK, MCP_SCOPED_NEEDS_PROJECT, MCP_SCOPE_GLOBAL_DESCRIPTION, MCP_SCOPE_GLOBAL_TITLE, MCP_SCOPE_MESSAGE, MCP_SCOPE_PROJECT_DESCRIPTION, MCP_SCOPE_PROJECT_TITLE, MODE_CUSTOM_DESCRIPTION, MODE_CUSTOM_TITLE, MODE_MESSAGE, MODE_RECOMMENDED_DESCRIPTION, MODE_RECOMMENDED_TITLE, NON_TTY_AGENT_SETUP, NON_TTY_LINK_NEEDS_AUTH, NO_AGENTS_FALLBACK_STATUS, NO_AGENT_SETUP_CONFLICT, PACKAGE_MANAGER_MESSAGE, PROGRESS, PROJECT_PINNED_OFFLINE, PROJECT_SETUP_CLAIMABLE_DESCRIPTION, PROJECT_SETUP_CLAIMABLE_TITLE, PROJECT_SETUP_LINK_DESCRIPTION, PROJECT_SETUP_LINK_TITLE, PROJECT_SETUP_MESSAGE, SERVICES_HINT, SERVICES_MESSAGE, SKILLS_PICKER_MESSAGE, agentUnusableCommandDescription, claimableNext, claimableThenServicesNext, configInitNext, envPullFailedNext, existingConfigNext, headingForOutcome, installFailedNext, mcpAfterLinkNext, mcpConfigLocationSkipped, mcpConfigLocationUnavailable, mcpKeyFailedNext, namedAgentsUnavailable, newConfigNext, offlinePinNext, skippedLinkNext, toolingFailedNext, unattendedUnauthedNext };

package/dist/init/run.js

@@ -11,7 +11,7 @@ import { CONFIG_INIT_SERVICES, parseConfigInitServices } from "../config_templat
 import { hasNeonConfigFile, neonConfigFilename } from "../project.js";
 import { getAgentDisplayName } from "../mcp/agents.js";
 import { mcpInstallableAgents } from "../mcp/targets.js";
-import { missingPluginsCommands, pluginsInstallableAgents } from "../plugins/targets.js";
+import { missingPluginsCommands, pluginsCommandProblemText, pluginsInstallableAgents, unusablePluginsCommands } from "../plugins/targets.js";
 import { skillsInstallableAgents } from "../skills/targets.js";
 import { FALLBACK_SKILLS_AGENTS, assertNamedAgentTooling, funnelAgentSetup, planInitToolingSteps, recommendedTooling, resolveNamedAgents, splitInitTooling } from "./plan.js";
 import { inferPackageManager, resolvePackageManager } from "../utils/package_manager.js";
@@ -67,10 +67,10 @@ const pluginScopeFor = (agents, preferred) => {
 	const project = new Set(pluginsInstallableAgents("project"));
 	return agents.some((id) => !project.has(id) && pluginsInstallableAgents("global").includes(id)) ? "global" : "project";
 };
-const warnMissingPluginCommands = (missing, tooling) => {
+const warnUnusablePluginCommands = (unusable, tooling) => {
 	if (tooling.setup !== "skills-mcp" && tooling.setup !== "mixed") return;
 	const routed = /* @__PURE__ */ new Set([...tooling.skillsAgents, ...tooling.mcpAgents]);
-	for (const { agent, command } of missing) if (routed.has(agent)) log.warning("%s: \"%s\" was not found on PATH, so its plugin cannot install. Installing Neon skills and MCP instead.", getAgentDisplayName(agent), command);
+	for (const row of unusable) if (routed.has(row.agent)) log.warning("%s: \"%s\" %s, so its plugin cannot install. Installing Neon skills and MCP instead.", getAgentDisplayName(row.agent), row.command.name, pluginsCommandProblemText(row));
 };
 const nonEmptyAgents = (ids, fallback) => {
 	const [first, ...rest] = ids;
@@ -124,7 +124,7 @@ const pickOrDetectAgents = async (input) => {
 		available: [...input.available],
 		detected,
 		preselected,
-		...input.missingCommands !== void 0 ? { missingCommands: input.missingCommands } : {},
+		...input.unusableCommands !== void 0 ? { unusableCommands: input.unusableCommands } : {},
 		setup: input.setup
 	});
 	return detected;
@@ -265,9 +265,18 @@ const runInit = async (props) => {
 		}
 		const recommended = mode === "recommended";
 		const targets = named.length > 0 ? named : detection.detectedAgents;
-		const missingPluginCommands = missingPluginsCommands(targets, { cwd });
-		const unavailablePluginAgents = missingPluginCommands.map((row) => row.agent);
-		const pluginReady = (agents) => agents.filter((id) => !unavailablePluginAgents.includes(id));
+		let probedPluginCommands;
+		const unusablePluginCommands = () => {
+			probedPluginCommands ??= unusablePluginsCommands(targets, { cwd });
+			return probedPluginCommands;
+		};
+		let missingCommands;
+		const missingPluginCommands = () => {
+			missingCommands ??= missingPluginsCommands(targets, { cwd });
+			return missingCommands;
+		};
+		const unavailablePluginAgents = () => unusablePluginCommands().map((row) => row.agent);
+		const pluginReady = (agents) => agents.filter((id) => !unavailablePluginAgents().includes(id));
 		let tooling = { setup: "skip" };
 		let mcpAuth = props.mcpAuth;
 		let mcpAuthChosen = props.mcpAuth !== void 0;
@@ -277,9 +286,9 @@ const runInit = async (props) => {
 		let pluginScope = recommended ? "global" : "project";
 		if (recommended) {
 			pluginScope = "global";
-			tooling = named.length > 0 ? splitInitTooling(named, "global", "global", unavailablePluginAgents) : recommendedTooling(detection.detectedAgents, unavailablePluginAgents);
+			tooling = named.length > 0 ? splitInitTooling(named, "global", "global", unavailablePluginAgents()) : recommendedTooling(detection.detectedAgents, unavailablePluginAgents());
 			if (named.length === 0 && detection.detectedAgents.length === 0) printInitProgress(NO_AGENTS_FALLBACK_STATUS);
-			warnMissingPluginCommands(missingPluginCommands, tooling);
+			warnUnusablePluginCommands(unusablePluginCommands(), tooling);
 			mcpAuth = !detection.authenticated && (tooling.setup === "skills-mcp" || tooling.setup === "mixed") ? "oauth" : mcpAuth;
 		} else {
 			const inferred = inferInitAgentSetup({
@@ -294,8 +303,8 @@ const runInit = async (props) => {
 			else if (inferred.kind === "auto") {
 				const autoAgents = named.length > 0 ? named : detection.detectedAgents;
 				pluginScope = pluginScopeFor(pluginReady(autoAgents), "project");
-				tooling = splitInitTooling(autoAgents, pluginScope, mcpConfigLocation, unavailablePluginAgents);
-				warnMissingPluginCommands(missingPluginCommands, tooling);
+				tooling = splitInitTooling(autoAgents, pluginScope, mcpConfigLocation, unavailablePluginAgents());
+				warnUnusablePluginCommands(unusablePluginCommands(), tooling);
 				if (tooling.setup === "skip" && yes && named.length === 0) {
 					tooling = recommendedTooling([]);
 					printInitProgress(NO_AGENTS_FALLBACK_STATUS);
@@ -310,8 +319,8 @@ const runInit = async (props) => {
 						available,
 						detected: detection.detectedAgents,
 						...setup === "plugin" ? {
-							preselected: pluginReady(detection.detectedAgents),
-							missingCommands: missingPluginCommands
+							preselected: detection.detectedAgents.filter((id) => !missingPluginCommands().some((row) => row.agent === id)),
+							unusableCommands: missingPluginCommands()
 						} : {},
 						interactive: detection.interactive,
 						setup,

package/dist/init/tooling.js

@@ -6,7 +6,7 @@ import { CannotMintApiKeyError } from "../mcp/mint.js";
 import { detectAgent } from "./detect_host.js";
 import { AgentSelectionSkipped, canPickAgentsInteractively } from "../utils/agent_picker.js";
 import { a as mcpInstallError, s as reportMcpInstall } from "../_chunks/mcp-BznTRK3w.js";
-import { l as reportPluginsInstall, o as installPlugins, s as pluginsInstallError } from "../_chunks/plugins-CKOcBuuP.js";
+import { l as reportPluginsInstall, o as installPlugins, s as pluginsInstallError } from "../_chunks/plugins-B2Gym8Lw.js";
 import { c as skillsInstallError, o as installSkills, s as reportSkillsInstall } from "../_chunks/skills-DKgafm65.js";
 import { runAuthenticatedMcp } from "./auth.js";
 import { raceSigint } from "./cancelled.js";

package/dist/init/wizard.js

@@ -2,7 +2,7 @@ import { CONFIG_INIT_SERVICES } from "../config_template.js";
 import { getAgentDisplayName, listMcpAgentIds } from "../mcp/agents.js";
 import { INIT_NEEDS_YES_OR_TERMINAL } from "./plan.js";
 import { installedPackageManagers } from "../utils/package_manager.js";
-import { AGENT_DETECTED_DESCRIPTION, AGENT_MCP_PICKER_MESSAGE, AGENT_MCP_SKIP_MESSAGE, AGENT_OTHER_DESCRIPTION, AGENT_PICKER_MESSAGE, AGENT_PLUGIN_SKIP_MESSAGE, AGENT_SETUP_MESSAGE, AGENT_SETUP_PLUGIN_DESCRIPTION, AGENT_SETUP_PLUGIN_TITLE, AGENT_SETUP_SKILLS_DESCRIPTION, AGENT_SETUP_SKILLS_TITLE, AGENT_SETUP_SKIP_DESCRIPTION, AGENT_SETUP_SKIP_TITLE, AGENT_SKILLS_PICKER_MESSAGE, AGENT_SKILLS_SKIP_MESSAGE, CONFIG_CONFIRM_HINT, CONFIG_CONFIRM_MESSAGE, MCP_AUTH_API_KEY_DESCRIPTION, MCP_AUTH_API_KEY_TITLE, MCP_AUTH_MESSAGE, MCP_AUTH_OAUTH_DESCRIPTION, MCP_AUTH_OAUTH_TITLE, MCP_SCOPE_GLOBAL_DESCRIPTION, MCP_SCOPE_GLOBAL_TITLE, MCP_SCOPE_MESSAGE, MCP_SCOPE_PROJECT_DESCRIPTION, MCP_SCOPE_PROJECT_TITLE, MODE_CUSTOM_DESCRIPTION, MODE_CUSTOM_TITLE, MODE_MESSAGE, MODE_RECOMMENDED_DESCRIPTION, MODE_RECOMMENDED_TITLE, PACKAGE_MANAGER_MESSAGE, PROJECT_SETUP_CLAIMABLE_DESCRIPTION, PROJECT_SETUP_CLAIMABLE_TITLE, PROJECT_SETUP_LINK_DESCRIPTION, PROJECT_SETUP_LINK_TITLE, PROJECT_SETUP_MESSAGE, SERVICES_HINT, SERVICES_MESSAGE, SKILLS_PICKER_MESSAGE, agentMissingCommandDescription } from "./copy.js";
+import { AGENT_DETECTED_DESCRIPTION, AGENT_MCP_PICKER_MESSAGE, AGENT_MCP_SKIP_MESSAGE, AGENT_OTHER_DESCRIPTION, AGENT_PICKER_MESSAGE, AGENT_PLUGIN_SKIP_MESSAGE, AGENT_SETUP_MESSAGE, AGENT_SETUP_PLUGIN_DESCRIPTION, AGENT_SETUP_PLUGIN_TITLE, AGENT_SETUP_SKILLS_DESCRIPTION, AGENT_SETUP_SKILLS_TITLE, AGENT_SETUP_SKIP_DESCRIPTION, AGENT_SETUP_SKIP_TITLE, AGENT_SKILLS_PICKER_MESSAGE, AGENT_SKILLS_SKIP_MESSAGE, CONFIG_CONFIRM_HINT, CONFIG_CONFIRM_MESSAGE, MCP_AUTH_API_KEY_DESCRIPTION, MCP_AUTH_API_KEY_TITLE, MCP_AUTH_MESSAGE, MCP_AUTH_OAUTH_DESCRIPTION, MCP_AUTH_OAUTH_TITLE, MCP_SCOPE_GLOBAL_DESCRIPTION, MCP_SCOPE_GLOBAL_TITLE, MCP_SCOPE_MESSAGE, MCP_SCOPE_PROJECT_DESCRIPTION, MCP_SCOPE_PROJECT_TITLE, MODE_CUSTOM_DESCRIPTION, MODE_CUSTOM_TITLE, MODE_MESSAGE, MODE_RECOMMENDED_DESCRIPTION, MODE_RECOMMENDED_TITLE, PACKAGE_MANAGER_MESSAGE, PROJECT_SETUP_CLAIMABLE_DESCRIPTION, PROJECT_SETUP_CLAIMABLE_TITLE, PROJECT_SETUP_LINK_DESCRIPTION, PROJECT_SETUP_LINK_TITLE, PROJECT_SETUP_MESSAGE, SERVICES_HINT, SERVICES_MESSAGE, SKILLS_PICKER_MESSAGE, agentUnusableCommandDescription } from "./copy.js";
 import { POSTGRES_SERVICE_CHOICE, keepPostgresSelected } from "../utils/service_picker.js";
 import { canPickAgentsInteractively, pickAgentsInteractively } from "../utils/agent_picker.js";
 import { NEON_SKILL_CATALOG, listSkillIds } from "../skills/catalog.js";
@@ -72,18 +72,18 @@ const pickAgentSetupInteractively = async () => {
 const pickInitAgentsInteractively = async (input) => {
 	requireInteractive();
 	const detected = new Set(input.detected);
-	const missing = new Map((input.missingCommands ?? []).map((row) => [row.agent, row.command]));
+	const unusable = new Map((input.unusableCommands ?? []).map((row) => [row.agent, row]));
 	const selected = await pickAgentsInteractively({
 		onCancel: aborted,
 		message: input.setup === "skills" ? AGENT_SKILLS_PICKER_MESSAGE : input.setup === "mcp" ? AGENT_MCP_PICKER_MESSAGE : AGENT_PICKER_MESSAGE,
 		skipMessage: input.setup === "plugin" ? AGENT_PLUGIN_SKIP_MESSAGE : input.setup === "skills" ? AGENT_SKILLS_SKIP_MESSAGE : AGENT_MCP_SKIP_MESSAGE,
 		selected: input.preselected ?? input.detected,
 		choices: input.available.map((id) => {
-			const command = missing.get(id);
+			const row = unusable.get(id);
 			return {
 				id,
 				title: `${getAgentDisplayName(id)} (${id})`,
-				description: command !== void 0 ? agentMissingCommandDescription(command) : detected.has(id) ? AGENT_DETECTED_DESCRIPTION : AGENT_OTHER_DESCRIPTION
+				description: row !== void 0 ? agentUnusableCommandDescription(row) : detected.has(id) ? AGENT_DETECTED_DESCRIPTION : AGENT_OTHER_DESCRIPTION
 			};
 		})
 	});

package/dist/plugins/child_env.js

@@ -0,0 +1,10 @@
+// src/plugins/child_env.ts
+const TELEMETRY_BLOCKERS = ["DISABLE_TELEMETRY", "DO_NOT_TRACK"];
+/** The env the plugins CLI and the agent CLIs it calls run with. */
+const pluginsChildEnv = (base = process.env) => {
+	const env = { ...base };
+	for (const key of TELEMETRY_BLOCKERS) delete env[key];
+	for (const key of Object.keys(env)) if (key.toUpperCase() === "NEON_API_KEY") delete env[key];
+	return env;
+};
+export { pluginsChildEnv };

package/dist/plugins/plan.js

@@ -1,11 +1,11 @@
 import { getAgentDisplayName, tryResolveAddMcpAgentId } from "../mcp/agents.js";
 import "../init/agents.js";
-import { detectPluginsAgents, getPluginsTargetName, isUserScopeOnlyPluginsTarget, mappedPluginsTargets, missingPluginsCommands, pluginsInstallableAgents } from "./targets.js";
+import { detectPluginsAgents, getPluginsTargetName, isUserScopeOnlyPluginsTarget, mappedPluginsTargets, missingPluginsCommands, pluginsCommandFix, pluginsCommandProblemText, pluginsInstallableAgents, unusablePluginsCommands } from "./targets.js";
 import { collectYesAgents, noDetectedAgentsMessage } from "../init/plan.js";
 import { detectAgent } from "../init/detect_host.js";
 import { agentChoicesFrom, pickAgentsInteractively, resolveAgentSelection } from "../utils/agent_picker.js";
 // src/plugins/plan.ts
-const missingPluginsCommandsError = (missing) => new Error(missing.map(({ agent, command }) => `Cannot install the Neon plugin for ${getAgentDisplayName(agent)}: "${command}" was not found on PATH. Install it or add it to PATH, then retry.`).join("\n"));
+const unusablePluginsCommandsError = (unusable) => new Error(unusable.map((row) => `Cannot install the Neon plugin for ${getAgentDisplayName(row.agent)}: "${row.command.name}" ${pluginsCommandProblemText(row)}. ${pluginsCommandFix(row)}, then retry.`).join("\n"));
 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> to name them.");
@@ -34,18 +34,18 @@ async function resolvePluginsPlan(options) {
 		detectAgent: options.detectAgent ?? detectAgent,
 		acceptHost: (id) => availableSet.has(id) || getPluginsTargetName(id) !== void 0
 	}) : scoped;
-	const missingDetected = new Map((prompt ? missingPluginsCommands(detected, commandLookup(options)) : []).map((row) => [row.agent, row.command]));
+	const unusableDetected = new Map((prompt && options.agents.length === 0 ? missingPluginsCommands(detected, commandLookup(options)) : []).map((row) => [row.agent, row]));
 	const choices = agentChoicesFrom(available, detected).map((choice) => {
-		const command = missingDetected.get(choice.id);
-		return command === void 0 ? choice : {
+		const row = unusableDetected.get(choice.id);
+		return row === void 0 ? choice : {
 			...choice,
-			description: `detected, but "${command}" is not on PATH`
+			description: `detected, but "${row.command.name}" ${pluginsCommandProblemText(row)}`
 		};
 	});
 	const selected = await resolveAgentSelection({
 		specified: options.agents,
 		choices,
-		detected: detected.filter((id) => !missingDetected.has(id)),
+		detected: detected.filter((id) => !unusableDetected.has(id)),
 		message: "Which coding agents should get the Neon plugin? (space to toggle, enter to confirm)",
 		nonInteractiveMessage: noDetectedAgentsMessage({
 			scope,
@@ -77,17 +77,17 @@ async function resolvePluginsPlan(options) {
 		}
 		agents.push(id);
 	}
-	const missingCommands = missingPluginsCommands(agents, commandLookup(options));
-	if (missingCommands.length > 0) {
-		if (!(options.agents.length === 0 && !prompt)) throw missingPluginsCommandsError(missingCommands);
-		const missingAgents = new Set(missingCommands.map((row) => row.agent));
+	const unusableCommands = unusablePluginsCommands(agents, commandLookup(options));
+	if (unusableCommands.length > 0) {
+		if (!(options.agents.length === 0 && !prompt)) throw unusablePluginsCommandsError(unusableCommands);
+		const missingAgents = new Set(unusableCommands.map((row) => row.agent));
 		const installable = agents.filter((id) => !missingAgents.has(id));
 		return {
 			scope,
 			agents: installable,
 			skipped,
 			userScopeSkipped,
-			missingCommands,
+			unusableCommands,
 			targets: installable.length === 0 ? [] : mappedPluginsTargets(installable, scope)
 		};
 	}
@@ -103,8 +103,8 @@ async function resolvePluginsPlan(options) {
 		agents,
 		skipped,
 		userScopeSkipped,
-		missingCommands,
+		unusableCommands,
 		targets: mappedPluginsTargets(agents, scope)
 	};
 }
-export { assertPluginsCanRun, missingPluginsCommandsError, resolvePluginsPlan };
+export { assertPluginsCanRun, resolvePluginsPlan, unusablePluginsCommandsError };

package/dist/plugins/run.js

@@ -1,7 +1,7 @@
+import { pluginsChildEnv } from "./child_env.js";
 import { spawnSync } from "node:child_process";
 import { execa } from "execa";
 // src/plugins/run.ts
-const TELEMETRY_BLOCKERS = ["DISABLE_TELEMETRY", "DO_NOT_TRACK"];
 const PLUGIN_SOURCE = "neondatabase/agent-skills";
 const NEON_PLUGIN_NAME = "neon-postgres";
 const PLUGIN_SKILLS = [
@@ -16,12 +16,6 @@ const PLUGIN_SKILLS = [
 	"neon-realtime"
 ];
 const PLUGINS_CLI_TIMEOUT_MS = 12e4;
-const pluginsChildEnv = (base = process.env) => {
-	const env = { ...base };
-	for (const key of TELEMETRY_BLOCKERS) delete env[key];
-	for (const key of Object.keys(env)) if (key.toUpperCase() === "NEON_API_KEY") delete env[key];
-	return env;
-};
 const pluginsScopeFlag = (global) => global ? "user" : "project";
 const pluginsAddArgs = (options) => {
 	if (options.target.length === 0) throw new Error("plugins add needs a -t target.");
@@ -130,4 +124,4 @@ const killProcessTree = (pid) => {
 };
 const isCommandMissing = (error) => typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
 const isExecaFailure = (error) => typeof error === "object" && error !== null && "shortMessage" in error && typeof error.shortMessage === "string";
-export { NEON_PLUGIN_NAME, PLUGINS_CLI_TIMEOUT_MS, PLUGIN_SKILLS, PLUGIN_SOURCE, neonPluginsRetryCommand, pluginsAddArgs, pluginsChildEnv, pluginsCliFailureMessage, pluginsScopeFlag, quoteNpxArg, runPluginsCli };
+export { NEON_PLUGIN_NAME, PLUGINS_CLI_TIMEOUT_MS, PLUGIN_SKILLS, PLUGIN_SOURCE, neonPluginsRetryCommand, pluginsAddArgs, pluginsCliFailureMessage, pluginsScopeFlag, quoteNpxArg, runPluginsCli };

package/dist/plugins/targets.js

@@ -1,7 +1,9 @@
 import { detectInstalledAgents, listMcpAgentIds, tryResolveAddMcpAgentId, uniqueAgentIds } from "../mcp/agents.js";
 import "../init/agents.js";
+import { pluginsChildEnv } from "./child_env.js";
 import { delimiter, dirname, join, resolve } from "node:path";
 import { detectProjectAgents } from "add-mcp";
+import { spawnSync } from "node:child_process";
 import which from "which";
 // src/plugins/targets.ts
 const CLAUDE_CODE = { target: "claude-code" };
@@ -13,11 +15,20 @@ const PLUGINS_TARGET_BY_TYPE = {
 	codex: { target: "codex" },
 	"github-copilot-cli": {
 		target: "github-copilot",
-		command: "copilot"
+		command: {
+			name: "copilot",
+			product: "GitHub Copilot CLI",
+			versionPrefix: "GitHub Copilot CLI",
+			minVersion: "0.0.400"
+		}
 	},
 	"grok-build": {
 		target: "grok",
-		command: "grok"
+		command: {
+			name: "grok",
+			product: "Grok Build",
+			versionPrefix: "grok"
+		}
 	}
 };
 const pluginsTargets = () => [...new Set(Object.values(PLUGINS_TARGET_BY_TYPE))];
@@ -38,20 +49,127 @@ const pluginsCommandSearchPath = (cwd, path) => {
 	}
 	return [...bins, path].join(delimiter);
 };
-const missingPluginsCommands = (agents, options) => {
+const VERSION_TIMEOUT_MS = 1e4;
+const versionParts = (version) => version.split(".").map((part) => Number.parseInt(part, 10));
+/** Exported for tests. */
+const versionAtLeast = (version, minimum) => {
+	const have = versionParts(version);
+	const need = versionParts(minimum);
+	for (let i = 0; i < 3; i++) {
+		const a = have[i] ?? 0;
+		const b = need[i] ?? 0;
+		if (a !== b) return a > b;
+	}
+	return true;
+};
+/** Exported for tests. */
+const pluginsCommandVersionProblem = (command, output) => {
+	const label = `${command.versionPrefix} `;
+	const at = output.indexOf(label);
+	const version = at === -1 ? void 0 : output.slice(at + label.length).match(/^\d+\.\d+\.\d+/)?.[0];
+	if (version === void 0) return { kind: "unrecognized" };
+	if (command.minVersion !== void 0 && !versionAtLeast(version, command.minVersion)) return {
+		kind: "outdated",
+		version
+	};
+};
+const firstLine = (text) => text.split("\n").map((line) => line.trim()).find((line) => line.length > 0) ?? "";
+/** The child sees the same PATH the command was resolved on, as under npx. */
+const withPath = (env, path) => {
+	const key = Object.keys(env).find((name) => name.toUpperCase() === "PATH");
+	return {
+		...env,
+		[key ?? "PATH"]: path
+	};
+};
+/**
+* Runs `<command> --version` the way the plugins CLI spawns the command (no shell, the npx
+* search PATH, its child env), so a command it could not run is caught before it runs.
+*/
+const probePluginsCommand = (command, options) => {
+	const resolved = which.sync(command.name, {
+		nothrow: true,
+		path: options.searchPath
+	});
+	if (resolved === null) return { kind: "missing" };
+	const result = spawnSync(resolved, ["--version"], {
+		cwd: options.cwd,
+		env: withPath(pluginsChildEnv(), options.searchPath),
+		encoding: "utf8",
+		stdio: [
+			"ignore",
+			"pipe",
+			"pipe"
+		],
+		timeout: VERSION_TIMEOUT_MS,
+		windowsHide: true
+	});
+	if (result.error !== void 0) {
+		const code = "code" in result.error && typeof result.error.code === "string" ? result.error.code : void 0;
+		return {
+			kind: "broken",
+			detail: code === "ETIMEDOUT" ? `timed out after ${VERSION_TIMEOUT_MS / 1e3} seconds` : code ?? result.error.message
+		};
+	}
+	const output = `${result.stdout}\n${result.stderr}`;
+	if (result.status !== 0) {
+		const line = firstLine(result.stderr) || firstLine(result.stdout);
+		return {
+			kind: "broken",
+			detail: line.length > 0 ? line.slice(0, 160).replace(/\.$/, "") : result.signal !== null ? `killed by ${result.signal}` : `exit code ${result.status}`
+		};
+	}
+	return pluginsCommandVersionProblem(command, output);
+};
+const commandRows = (agents, options, check) => {
 	const searchPath = pluginsCommandSearchPath(options.cwd, options.path ?? process.env.PATH ?? "");
-	const missing = [];
+	const rows = [];
 	for (const agent of uniqueAgentIds(agents)) {
 		const command = getPluginsTarget(agent)?.command;
-		if (command !== void 0 && which.sync(command, {
-			nothrow: true,
-			path: searchPath
-		}) === null) missing.push({
+		if (command === void 0) continue;
+		const problem = check(command, searchPath);
+		if (problem !== void 0) rows.push({
 			agent,
-			command
+			command,
+			problem
 		});
 	}
-	return missing;
+	return rows;
+};
+/**
+* Agents whose plugin command is not on the search PATH. Runs nothing, so it is safe for
+* agents that were only detected and may not be installed.
+*/
+const missingPluginsCommands = (agents, options) => commandRows(agents, options, (command, searchPath) => which.sync(command.name, {
+	nothrow: true,
+	path: searchPath
+}) === null ? { kind: "missing" } : void 0);
+/**
+* Agents whose plugin installs through a CLI that is missing, does not run, is not the
+* expected product, or is too old. Runs `<command> --version`, so pass only agents the
+* plugin is about to install into; file-based targets never spawn anything.
+*/
+const unusablePluginsCommands = (agents, options) => commandRows(agents, options, (command, searchPath) => probePluginsCommand(command, {
+	cwd: options.cwd,
+	searchPath
+}));
+/** Completes `"<command>" …` in a warning or error. */
+const pluginsCommandProblemText = (row) => {
+	const { command, problem } = row;
+	const product = command.product;
+	switch (problem.kind) {
+		case "missing": return "was not found on PATH";
+		case "broken": return `did not run ("${command.name} --version" failed: ${problem.detail})`;
+		case "unrecognized": return `is not ${product} ("${command.name} --version" printed no ${product} version)`;
+		case "outdated": return `is ${product} ${problem.version}, older than the ${command.minVersion} its plugin needs`;
+		default: return problem;
+	}
+};
+/** What to do about the problem, as an imperative clause. */
+const pluginsCommandFix = (row) => {
+	const { command, problem } = row;
+	if (problem.kind === "missing") return "Install it or add it to PATH";
+	return `Install or update ${command.product}`;
 };
 function getPluginsTarget(agent) {
 	if (Object.prototype.hasOwnProperty.call(PLUGINS_TARGET_BY_TYPE, agent)) return PLUGINS_TARGET_BY_TYPE[agent];
@@ -104,4 +222,4 @@ const mappedPluginsTargets = (agents, scope) => {
 	if (mapped.length === 0) throw new Error(`None of the selected agents can install plugins. Supported agents: ${pluginsInstallableAgents(scope).join(", ")}`);
 	return mapped;
 };
-export { detectInstallablePluginsAgents, detectPluginsAgents, getPluginsTargetName, isUserScopeOnlyPluginsTarget, mappedPluginsTargets, missingPluginsCommands, pluginsInstallableAgents, pluginsMappedAgents, pluginsTargets, supportsPlugins };
+export { detectInstallablePluginsAgents, detectPluginsAgents, getPluginsTargetName, isUserScopeOnlyPluginsTarget, mappedPluginsTargets, missingPluginsCommands, pluginsCommandFix, pluginsCommandProblemText, pluginsCommandVersionProblem, pluginsInstallableAgents, pluginsMappedAgents, pluginsTargets, supportsPlugins, unusablePluginsCommands, versionAtLeast };

package/dist/update_notifier.js

@@ -141,10 +141,11 @@ const duplicateInstallNotice = () => {
 	}
 };
 const isPackagedExecutable = () => "pkg" in process;
-const shouldRunUpdateNotifier = ({ commandPath, currentBranch, disabled, isCi: runningInCi, isPackaged, output, stderrIsTty, stdoutIsTty }) => !runningInCi && !disabled && !isPackaged && output === "table" && stdoutIsTty && stderrIsTty && commandPath.length > 0 && commandPath[0] !== "completion" && !isCurrentBranchProbe({
+const commandSucceeded = () => (process.exitCode ?? 0) === 0;
+const shouldRunUpdateNotifier = ({ commandPath, currentBranch, disabled, isCi: runningInCi, isPackaged, output, stderrIsTty, stdoutIsTty, succeeded }) => !runningInCi && !disabled && !isPackaged && output === "table" && stdoutIsTty && stderrIsTty && commandPath.length > 0 && commandPath[0] !== "completion" && !isCurrentBranchProbe({
 	commandPath,
 	currentBranch
-});
+}) && succeeded;
 /**
 * The skills notice drops the terminal checks: coding agents run the CLI without a TTY,
 * and they are the ones that act on it. `neon skills` itself reports skill state.
@@ -157,7 +158,8 @@ const shouldRunSkillsNotifier = ({ commandPath, currentBranch, output }) => comm
 	isPackaged: isPackagedExecutable(),
 	output,
 	stderrIsTty: true,
-	stdoutIsTty: true
+	stdoutIsTty: true,
+	succeeded: commandSucceeded()
 });
 const notifyIfUpdateAvailable = ({ commandPath, configDir, currentBranch, currentVersion, output }) => {
 	if (!shouldRunUpdateNotifier({
@@ -168,7 +170,8 @@ const notifyIfUpdateAvailable = ({ commandPath, configDir, currentBranch, curren
 		isPackaged: isPackagedExecutable(),
 		output,
 		stderrIsTty: process.stderr.isTTY === true,
-		stdoutIsTty: process.stdout.isTTY === true
+		stdoutIsTty: process.stdout.isTTY === true,
+		succeeded: commandSucceeded()
 	})) return;
 	const now = Date.now();
 	if (process.platform !== "win32") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neon",
-  "version": "8.15.0",
+  "version": "8.15.1",
   "description": "CLI tool for Neon, the cloud backend primitives built around Lakebase Postgres",
   "keywords": [
     "neon",
@@ -73,9 +73,9 @@
     "yargs": "17.7.2",
     "yoctocolors": "^2.1.2",
     "@neon/config": "1.10.0",
-    "@neon/config-runtime": "1.11.0",
     "@neon/realtime": "0.1.2",
-    "@neon/sdk": "7.7.0"
+    "@neon/sdk": "7.7.0",
+    "@neon/config-runtime": "1.11.0"
   },
   "optionalDependencies": {
     "@napi-rs/keyring": "1.3.0",
@@ -114,8 +114,8 @@
     "@neon-internals/cli-core": "0.0.0",
     "@neon-internals/env-core": "0.0.38",
     "@neon/env": "1.6.8",
-    "@neon/functions": "0.11.0",
-    "@neon/e2e-harness": "0.0.0"
+    "@neon/e2e-harness": "0.0.0",
+    "@neon/functions": "0.11.0"
   },
   "publishConfig": {
     "access": "public",