neon 8.14.0 → 8.15.1

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/index.js

@@ -9,7 +9,7 @@ import { NETWORK_ERROR_MESSAGE, isNetworkError, matchErrorCode } from "./errors.
 import { analyticsMiddleware, closeAnalytics, initAnalyticsClientMiddleware, isAnalyticsActive, recordCommandSuccessExtras, sendError, takeCommandSuccessExtras, trackCommandSuccess } from "./analytics.js";
 import { AuthRefreshError, defaultClientID } from "./auth.js";
 import { getCliName } from "./utils/cli_name.js";
-import { c as ensureAuth } from "./_chunks/auth-DPSDYYtG.js";
+import { c as ensureAuth } from "./_chunks/auth-rup6nemJ.js";
 import { recoverFrom401 } from "./auth_recovery.js";
 import { UsageError, failOnUsageError, isBareParentCommand, showHelp, showUsageErrorHelp } from "./help.js";
 import { lazyCommands, preloadCommand } from "./commands/manifest.js";

package/dist/init/auth.js

@@ -2,7 +2,7 @@ import { isNeonApiError } from "../api.js";
 import { r as defaultDir } from "../_chunks/paths-B55ZfOg1.js";
 import "../config.js";
 import "../auth.js";
-import { c as ensureAuth } from "../_chunks/auth-DPSDYYtG.js";
+import { c as ensureAuth, l as existingApiClient } from "../_chunks/auth-rup6nemJ.js";
 import { recoverFrom401 } from "../auth_recovery.js";
 import { c as pull } from "../_chunks/env-BOt9AZ1j.js";
 import { c as setupNeonMcp } from "../_chunks/mcp-BznTRK3w.js";
@@ -54,6 +54,27 @@ const runAuthenticatedMcp = async (options) => {
 	}
 };
 /**
+* The client and key `neon config init` may read the linked branch with. Init calls this only
+* after a link is verified, but a pin that was already in place can have no credentials on
+* disk, so this never starts a login: with nothing usable it returns an empty result and the
+* scaffold declares the Neon Auth default with a warning, as a failed read does.
+*/
+const resolveInitConfigApi = async (options) => {
+	const access = await existingApiClient({
+		configDir: options.configDir ?? defaultDir,
+		apiHost: options.apiHost ?? "https://console.neon.tech/api/v2",
+		...options.profile !== void 0 ? { profile: options.profile } : {},
+		...options.oauthHost !== void 0 ? { oauthHost: options.oauthHost } : {},
+		...options.clientId !== void 0 ? { clientId: options.clientId } : {}
+	});
+	if (access === null) return {};
+	return {
+		apiClient: access.apiClient,
+		apiKey: access.apiKey,
+		apiHost: options.apiHost
+	};
+};
+/**
 * Resolves Neon auth the same way a standalone `neon env pull` invocation would, then runs
 * `pull` — the same function `link`/`checkout` already call directly via
 * `autoPullEnvAfterPin` (see `commands/env.ts`).
@@ -77,4 +98,4 @@ const pullInitEnv = async (props) => {
 		throw authenticationFailed();
 	}
 };
-export { pullInitEnv, runAuthenticatedMcp };
+export { pullInitEnv, resolveInitConfigApi, runAuthenticatedMcp };

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/link.js

@@ -2,9 +2,9 @@ import { isNeonApiError } from "../api.js";
 import { r as defaultDir } from "../_chunks/paths-B55ZfOg1.js";
 import "../config.js";
 import "../auth.js";
-import { c as ensureAuth } from "../_chunks/auth-DPSDYYtG.js";
+import { c as ensureAuth } from "../_chunks/auth-rup6nemJ.js";
 import { recoverFrom401 } from "../auth_recovery.js";
-import { s as runLink } from "../_chunks/link-CcwTXRny.js";
+import { s as runLink } from "../_chunks/link-nAiuWKfg.js";
 // src/init/link.ts
 const isUnauthorized = (error) => isNeonApiError(error) && error.status === 401;
 const authenticationFailed = () => /* @__PURE__ */ new Error("Authentication failed.");

package/dist/init/run.js

@@ -11,17 +11,17 @@ 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";
 import { AGENTS_NOT_INSTALLED, CANCELLED_BODY, CLAIMABLE_ACCOUNT_FLAGS, CLAIMABLE_ALREADY_LINKED, CLAIMABLE_MCP_API_KEY, CLAIMABLE_NO_LINK, MCP_API_KEY_NEEDS_AUTH, MCP_SCOPED_NEEDS_PROJECT, NON_TTY_LINK_NEEDS_AUTH, NO_AGENTS_FALLBACK_STATUS, PROGRESS, PROJECT_PINNED_OFFLINE, claimableNext, claimableThenServicesNext, configInitNext, envPullFailedNext, existingConfigNext, installFailedNext, mcpAfterLinkNext, mcpConfigLocationSkipped, mcpConfigLocationUnavailable, mcpKeyFailedNext, namedAgentsUnavailable, newConfigNext, offlinePinNext, skippedLinkNext, toolingFailedNext, unattendedUnauthedNext } from "./copy.js";
 import { agentsRowValue, configRowValue, formatInitDone, headingForKind, printInitBanner, printInitDone, printInitProgress, projectRowValue, shouldPrintInitBanner } from "./chrome.js";
-import { h as initCmd, t as ConfigInstallFailed } from "../_chunks/config-7SIE_C5O.js";
-import { o as quoteFlagValue, s as runLink } from "../_chunks/link-CcwTXRny.js";
+import { h as initCmd, t as ConfigInstallFailed } from "../_chunks/config-BjCm5cfr.js";
+import { o as quoteFlagValue, s as runLink } from "../_chunks/link-nAiuWKfg.js";
 import { runAuthenticatedLink } from "./link.js";
 import { CannotMintApiKeyError } from "../mcp/mint.js";
-import { pullInitEnv } from "./auth.js";
+import { pullInitEnv, resolveInitConfigApi } from "./auth.js";
 import { InitCancelled, raceSigint, restoreCursor } from "./cancelled.js";
 import { pickAgentSetupInteractively, pickInitAgentsInteractively, pickInitConfigInteractively, pickInitMcpAuthInteractively, pickInitMcpConfigLocationInteractively, pickInitModeInteractively, pickInitPackageManagerInteractively, pickInitProjectSetupInteractively, pickInitServicesInteractively, pickInitSkillsInteractively } from "./wizard.js";
 import { runToolingSteps, toolingStepCommandText } from "./tooling.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,19 +124,34 @@ 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;
 };
 const defaultInitConfig = async (input) => {
+	let project = {};
+	if (input.project) try {
+		project = {
+			...await resolveInitConfigApi(input.project.auth),
+			projectId: input.project.projectId,
+			...input.project.branch !== void 0 ? { branch: input.project.branch } : {},
+			...input.project.auth.configDir !== void 0 ? { configDir: input.project.auth.configDir } : {},
+			...input.project.auth.profile !== void 0 ? { profile: input.project.auth.profile } : {},
+			...input.project.auth.oauthHost !== void 0 ? { oauthHost: input.project.auth.oauthHost } : {},
+			...input.project.auth.clientId !== void 0 ? { clientId: input.project.auth.clientId } : {}
+		};
+	} catch (error) {
+		log.warning("Couldn't authenticate to read the Data API on the linked branch (%s); declaring it with Neon Auth.", error instanceof Error ? error.message : String(error));
+	}
 	await initCmd({
 		cwd: input.cwd,
 		install: input.install,
 		silent: true,
 		requireInstall: true,
 		...input.services !== void 0 ? { services: input.services } : {},
-		...input.packageManager !== void 0 ? { packageManager: input.packageManager } : {}
+		...input.packageManager !== void 0 ? { packageManager: input.packageManager } : {},
+		...project
 	});
 };
 const defaultCreateClaimable = async (input) => {
@@ -250,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;
@@ -262,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({
@@ -279,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);
@@ -295,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,
@@ -557,12 +581,19 @@ const runInit = async (props) => {
 			}
 			if (!existingConfig) printInitProgress(PROGRESS.config);
 			printInitProgress(PROGRESS.install(pm));
+			const readableProject = funnel.link !== "skipped" && !pinnedOffline && declared.includes("data-api") ? readContextFile(contextFile) : void 0;
+			const readableBranch = readableProject !== void 0 ? contextBranch(readableProject) : void 0;
 			try {
 				await (props.initConfig ?? defaultInitConfig)({
 					cwd,
 					install: true,
 					packageManager: pm,
-					...planned !== void 0 ? { services: planned } : {}
+					...planned !== void 0 ? { services: planned } : {},
+					...typeof readableProject?.projectId === "string" ? { project: {
+						projectId: readableProject.projectId,
+						...readableBranch !== void 0 ? { branch: readableBranch } : {},
+						auth
+					} } : {}
 				});
 			} catch (error) {
 				if (error instanceof ConfigInstallFailed) {

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
 			};
 		})
 	});
@@ -207,7 +207,7 @@ const pickInitServicesInteractively = async () => {
 			{
 				value: "data-api",
 				title: "Data API",
-				description: "Declare an HTTP API for Postgres. Also declares Managed Better Auth."
+				description: "Declare an HTTP API for Postgres. Also declares Managed Better Auth, unless the branch's Data API already uses an external identity provider."
 			},
 			{
 				value: "functions",

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 };