neon 4.10.1 → 4.11.0

package/dist/commands/init.js

@@ -1,12 +1,14 @@
 import { t as __exportAll } from "../_chunks/rolldown-runtime-8H4AJuhK.js";
-import { log } from "../log.js";
 import { readContextFile } from "../context.js";
 import { getCliName } from "../utils/cli_name.js";
 import { t as credentialInputs } from "../_chunks/auth_selection-pitMFzDe.js";
 import { initChildEnv, spawnCliChild } from "../init/child.js";
-import { bootstrapInitStep, directoryIsEmpty, planExistingInit } from "../init/plan.js";
+import { agentSetupLabel, formatInitDone, printInitBanner, printInitDone, shouldPrintInitBanner } from "../init/chrome.js";
+import { coerceAgentFlag } from "../utils/agent_flag.js";
+import { INIT_NEEDS_YES_OR_TERMINAL, assertNamedAgentTooling, bootstrapInitStep, directoryIsEmpty, initPluginAgents, initSkillsMcpAgents, planExistingInit, resolveNamedAgents } from "../init/plan.js";
+import { canPickAgentsInteractively } from "../utils/agent_picker.js";
 import { runAgentTooling, runInitSteps } from "../init/tooling.js";
-import { helpEpilogue } from "../utils/help_text.js";
+import { helpCsv, helpEpilogue } from "../utils/help_text.js";
 import { existsSync, readdirSync } from "node:fs";
 import { resolve } from "node:path";
 //#region src/commands/init.ts
@@ -19,15 +21,18 @@ var init_exports = /* @__PURE__ */ __exportAll({
 });
 const command = "init";
 const describe = "Set up this directory for Neon: agent tooling, a linked project, and neon.ts. In an empty directory, scaffolds a template first. Skills needs Node.js 22.20 or newer.";
-const removedProtocol = () => `\`${getCliName()} init --agent\` and \`--data\` were removed. Run \`${getCliName()} init\` or \`${getCliName()} init -y\`.`;
+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: bootstrap --default. Otherwise plugin when a project plugin agent is detected, else skills and MCP, then link --yes and config init --services none. link --yes still asks for a project unless one is already linked"
+	describe: "Empty dir: bootstrap --default. Otherwise plugin, or skills and MCP, for project folders, else the host CLI agent. Exits if none. Then link --yes and config init --services none. link --yes still asks for a project unless one is already linked"
 }).option("agent", {
-	hidden: true,
-	type: "boolean"
+	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",
+	coerce: coerceAgentFlag
 }).option("data", {
 	hidden: true,
 	type: "string"
@@ -35,8 +40,8 @@ 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", "Empty dir: bootstrap (scaffold, agent tooling, link). Existing app: agent tooling, link, config init").example("$0 init -y", "Same steps, using each child's defaults").epilogue(helpEpilogue("Interactive agent setup: plugin (recommended), skills and MCP separately, or skip agent setup. Never both plugin and skills+MCP.", "-y installs the plugin when Cursor, Claude Code, or Codex is detected in the project. Otherwise skills and MCP. Then link unless already linked. link --yes may still ask for a project.")).check((argv) => {
-	if (argv.agent === true || argv.data !== void 0) throw new Error(removedProtocol());
+}).example("$0 init", "Empty dir: bootstrap (scaffold, agent tooling, link). Existing app: agent tooling, link, config init").example("$0 init -y", "Same steps, using each child's defaults").example("$0 init --agent cursor --agent claude-code", "Skip agent selection; install the plugin for those agents").epilogue(helpEpilogue("Interactive agent setup: plugin (recommended), skills and MCP separately, or skip agent setup. Never both plugin and skills+MCP.", "-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. link --yes may still ask for a project.", "--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) => {
+	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();
@@ -50,6 +55,8 @@ const handler = async (props) => {
 	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;
@@ -61,26 +68,32 @@ const handler = async (props) => {
 		...props.analytics === false ? { analytics: false } : {}
 	};
 	if (directoryIsEmpty(names)) {
-		await runInitSteps([bootstrapInitStep(yes)], {
+		if (!yes && !canPickAgentsInteractively()) throw new Error(INIT_NEEDS_YES_OR_TERMINAL);
+		await runInitSteps([bootstrapInitStep(yes, named)], {
 			cwd,
 			run,
 			forward,
 			authEnv
 		});
-		log.info("Done.");
 		return;
 	}
-	await runAgentTooling({
+	if (shouldPrintInitBanner(yes)) printInitBanner();
+	const alreadyLinked = isLinked(contextFile);
+	const agentSetup = await runAgentTooling({
 		cwd,
 		yes,
 		run,
 		forward,
 		authEnv,
+		...named.length > 0 ? { agents: named } : {},
 		...props.pickAgentSetup ? { pickAgentSetup: props.pickAgentSetup } : {},
-		...props.hasProjectPlugins ? { hasProjectPlugins: props.hasProjectPlugins } : {}
+		...props.detectProjectAgents ? { detectProjectAgents: props.detectProjectAgents } : {},
+		...props.detectAgent ? { detectAgent: props.detectAgent } : {},
+		...props.hasProjectPlugins ? { hasProjectPlugins: props.hasProjectPlugins } : {},
+		command: "init"
 	});
 	await runInitSteps(planExistingInit({
-		linked: isLinked(contextFile),
+		linked: alreadyLinked,
 		yes,
 		agentSetup: "skip"
 	}), {
@@ -89,7 +102,24 @@ const handler = async (props) => {
 		forward,
 		authEnv
 	});
-	log.info("Done.");
+	printInitDone(formatInitDone({
+		heading: "Configured this directory for Neon.",
+		rows: [
+			{
+				label: "Agents",
+				value: agentSetupLabel(agentSetup)
+			},
+			{
+				label: "Project",
+				value: alreadyLinked ? "already linked" : "linked"
+			},
+			{
+				label: "Config",
+				value: "neon.ts"
+			}
+		],
+		next: []
+	}));
 };
 //#endregion
 export { builder, command, describe, handler, initChildEnv, init_exports as t };

package/dist/commands/link.js

@@ -4,10 +4,10 @@ import { log } from "../log.js";
 import { isNeonApiError, messageFromBody } from "../api.js";
 import { applyContext, contextBranch, readContextFile, setContext, updateContextFile } from "../context.js";
 import { getCliName } from "../utils/cli_name.js";
+import { helpEpilogue } from "../utils/help_text.js";
 import { createBranch, pickBranchInteractively } from "../utils/branch_picker.js";
 import { autoPullEnvAfterPin } from "./env.js";
 import { hasNeonConfigFile, initCmd } from "./config.js";
-import { helpEpilogue } from "../utils/help_text.js";
 import { REGIONS } from "./projects.js";
 import prompts from "prompts";
 //#region src/commands/link.ts
@@ -31,7 +31,6 @@ const nonInteractiveLinkCommands = () => {
 };
 const nonInteractiveLinkHelp = () => nonInteractiveLinkCommands().map((command) => `  ${command}`).join("\n");
 const orgScopedKeyHint = "Organization-scoped API keys cannot list orgs; pass --org-id.";
-const removedAgent = () => `\`${getCliName()} link --agent\` was removed.\nUse:\n${nonInteractiveLinkHelp()}\n${orgScopedKeyHint}`;
 const command = "link";
 const describe = "Link the current directory to a Neon project";
 const builder = (argv) => argv.usage("$0 link [options]").options({
@@ -60,10 +59,6 @@ const builder = (argv) => argv.usage("$0 link [options]").options({
 		describe: "JSON object with link parameters, e.g. '{\"orgId\":\"...\",\"projectId\":\"...\"}' or '{\"orgId\":\"...\",\"projectName\":\"...\",\"regionId\":\"...\"}'. Flags take precedence over fields in --params.",
 		type: "string"
 	},
-	agent: {
-		hidden: true,
-		type: "boolean"
-	},
 	yes: {
 		alias: "y",
 		describe: "Skip the \"already linked\" confirmation, and pin the project's default branch when linking a project that has more than one.",
@@ -92,10 +87,7 @@ const builder = (argv) => argv.usage("$0 link [options]").options({
 	["$0 link --branch-id br-…", "Pin a branch in the already-linked project"],
 	["$0 link --no-checks --org-id org-… --project-id polished-snowflake-12345678", "Write the context offline (no API calls, no verification)"],
 	["$0 link --clear", "Forget the current org/project/branch context"]
-]).epilogue(helpEpilogue("Non-interactive (CI, scripts, agents):", ...nonInteractiveLinkCommands().map((command) => `  ${command}`), orgScopedKeyHint)).check((argv) => {
-	if (argv.agent === true) throw new Error(removedAgent());
-	return true;
-});
+]).epilogue(helpEpilogue("Non-interactive (CI, scripts, agents):", ...nonInteractiveLinkCommands().map((command) => `  ${command}`), orgScopedKeyHint)).strict();
 const handler = async (props) => {
 	if (props.clear) {
 		clearContext(props.contextFile);

package/dist/commands/mcp.js

@@ -4,11 +4,11 @@ import { readContextFile } from "../context.js";
 import { getCliName } from "../utils/cli_name.js";
 import { writer } from "../writer.js";
 import { noPassthrough, single } from "../utils/flags.js";
+import { NEON_MCP_CATEGORIES, NEON_MCP_URL, existingNeonApiKey, installNeonMcpServer, neonMcpUrl, parseMcpCategories, trackedProjectMcpConfig } from "../mcp/install.js";
+import { mcpInstallableAgents, resolveInstallTargets } from "../mcp/targets.js";
 import { canPickAgentsInteractively } from "../utils/agent_picker.js";
 import { helpCsv, helpEpilogue } from "../utils/help_text.js";
-import { NEON_MCP_CATEGORIES, NEON_MCP_URL, existingNeonApiKey, installNeonMcpServer, neonMcpUrl, parseMcpCategories, trackedProjectMcpConfig } from "../mcp/install.js";
 import { mintMcpApiKey, mintedKeyRevokeCommand, withdrawMintedKey } from "../mcp/mint.js";
-import { mcpInstallableAgents, resolveInstallTargets } from "../mcp/targets.js";
 import { confirmMcpInstall } from "../mcp/wizard.js";
 import { resolveMcpPlan } from "../mcp/plan.js";
 //#region src/commands/mcp.ts
@@ -38,7 +38,7 @@ const builder = (argv) => argv.usage("$0 mcp [options]").options({
 		alias: "y",
 		type: "boolean",
 		default: false,
-		describe: "Skip prompts. Defaults listed below. --project, --oauth, --agent, --read-only, --project-id and --category still apply"
+		describe: "Skip prompts. Defaults listed below. --agent, --project, --oauth, --read-only, --project-id and --category still apply"
 	},
 	agent: {
 		alias: "a",
@@ -86,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, detected agents, reuse or mint an API key").example("$0 mcp --oauth", "Install with OAuth; the agent signs in on first use").example("$0 mcp --project", "Write project-level config").example("$0 mcp --agent cursor --agent claude-code", "Install into specific agents").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", "  every globally detected 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, 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"));
 const handler = async (props) => {
 	const cwd = process.cwd();
 	const interactive = canPickAgentsInteractively() && props.yes !== true;

package/dist/commands/plugins.js

@@ -3,12 +3,12 @@ import { log } from "../log.js";
 import { writer } from "../writer.js";
 import { noPassthrough } from "../utils/flags.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 { canPickAgentsInteractively } from "../utils/agent_picker.js";
 import { NEON_PLUGIN_NAME, PLUGIN_SKILLS, PLUGIN_SOURCE, neonPluginsRetryCommand, pluginsAddArgs, runPluginsCli } from "../plugins/run.js";
 import { helpCsv, helpEpilogue } from "../utils/help_text.js";
-import { NEON_MCP_URL } from "../mcp/install.js";
 import { resolvePluginsPlan } from "../plugins/plan.js";
 import { confirmPluginsInstall } from "../plugins/wizard.js";
 //#region src/commands/plugins.ts
@@ -18,7 +18,6 @@ var plugins_exports = /* @__PURE__ */ __exportAll({
 	describe: () => describe,
 	handler: () => handler
 });
-const scopeLabel = (scope) => scope === "project" ? "project" : "user";
 const coerceAgents = (value) => {
 	if (value === void 0) return [];
 	const list = Array.isArray(value) ? value : [value];
@@ -28,6 +27,7 @@ const coerceAgents = (value) => {
 		return item;
 	});
 };
+const scopeLabel = (scope) => scope === "project" ? "project" : "user";
 const command = "plugins";
 const describe = "Install the Neon plugin into coding agents";
 const pluginProjectAgents = pluginsInstallableAgents("project");
@@ -37,7 +37,7 @@ const builder = (argv) => argv.usage("$0 plugins [options]").options({
 		alias: "y",
 		type: "boolean",
 		default: false,
-		describe: "Skip prompts"
+		describe: "Skip prompts. Detected agents (project folders, else the host CLI agent). --global uses installed apps, else the host CLI agent"
 	},
 	global: {
 		type: "boolean",
@@ -51,7 +51,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, 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: 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"));
 const handler = async (props) => {
 	const cwd = process.cwd();
 	const yes = props.yes === true;

package/dist/commands/skills.js

@@ -4,10 +4,10 @@ import { writer } from "../writer.js";
 import { noPassthrough } from "../utils/flags.js";
 import { getAgentDisplayName } from "../mcp/agents.js";
 import "../init/agents.js";
+import { mappedSkillsAgentNames, skillsInstallableAgents } from "../skills/targets.js";
 import { canPickAgentsInteractively } from "../utils/agent_picker.js";
 import { helpCsv, helpEpilogue } from "../utils/help_text.js";
 import { skillsHelpValues, skillsYesHelp } from "../skills/catalog.js";
-import { mappedSkillsAgentNames, skillsInstallableAgents } from "../skills/targets.js";
 import { confirmSkillsInstall, 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";
@@ -39,11 +39,14 @@ const coerceSkills = (value) => {
 };
 const command = "skills";
 const describe = "Install Neon agent skills into coding agents";
-const builder = (argv) => argv.usage("$0 skills [command] [options]").command("update", "Update installed skills to the latest versions", (yargs) => yargs.usage("$0 skills update [options]").options({ global: {
-	type: "boolean",
-	default: false,
-	describe: "Update user-level skills (skills CLI -g). Default is this directory"
-} }).example("$0 skills update", "Interactive: confirm, then update skills in this directory").example("$0 skills update -y", "Update skills in this directory without prompting").example("$0 skills update --global -y", "Update user-level skills").strict().hide("agent").hide("skill").check((args) => {
+const builder = (argv) => argv.usage("$0 skills [command] [options]").command("update", "Update installed skills to the latest versions", (yargs) => yargs.usage("$0 skills update [options]").options({
+	yes: { describe: "Skip the confirm prompt" },
+	global: {
+		type: "boolean",
+		default: false,
+		describe: "Update user-level skills (skills CLI -g). Default is this directory"
+	}
+}).example("$0 skills update", "Interactive: confirm, then update skills in this directory").example("$0 skills update -y", "Update skills in this directory without prompting").example("$0 skills update --global -y", "Update user-level skills").strict().hide("agent").hide("skill").check((args) => {
 	noPassthrough("skills update")(args);
 	const agents = args.agent;
 	if (Array.isArray(agents) && agents.length > 0) throw new Error("neon skills update does not take --agent. It refreshes every installed skill in this directory (or --global).");
@@ -55,7 +58,7 @@ const builder = (argv) => argv.usage("$0 skills [command] [options]").command("u
 		alias: "y",
 		type: "boolean",
 		default: false,
-		describe: "Skip prompts"
+		describe: "Skip prompts. Detected agents (project folders, else the host CLI agent). --global uses installed apps, else the host CLI agent"
 	},
 	global: {
 		type: "boolean",
@@ -73,10 +76,10 @@ const builder = (argv) => argv.usage("$0 skills [command] [options]").command("u
 		alias: "s",
 		type: "array",
 		string: true,
-		describe: "Skill to install (repeatable). Skips the skill picker. Values listed below",
+		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, the default skills").example("$0 skills -s neon -s neon-ai-gateway --agent cursor", "Install named skills into specific agents").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, 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"));
 const handler = async (props) => {
 	assertSkillsNode();
 	const cwd = process.cwd();

package/dist/errors.js

@@ -2,7 +2,8 @@
 const ERROR_MATCHERS = [
 	[/^Unknown command: (.*)$/, "UNKNOWN_COMMAND"],
 	[/^Missing required argument: (.*)$/, "MISSING_ARGUMENT"],
-	[/^Failed to open web browser. (.*)$/, "AUTH_BROWSER_FAILED"]
+	[/^Failed to open web browser. (.*)$/, "AUTH_BROWSER_FAILED"],
+	[/^Setup did not finish\.$/, "NEON_INIT_FAILED"]
 ];
 const matchErrorCode = (message) => {
 	if (!message) return "UNKNOWN_ERROR";

package/dist/index.js

@@ -11,6 +11,7 @@ import { defaultClientID } from "./auth.js";
 import { getCliName } from "./utils/cli_name.js";
 import { showHelp } from "./help.js";
 import { deleteCredentialsAt, ensureAuth } from "./commands/auth.js";
+import { rewriteUnknownAgentArg } from "./init/plan.js";
 import commands_default from "./commands/index.js";
 import { fillInArgs, resolveApiKeyFromEnv } from "./utils/middlewares.js";
 import yargs from "yargs";
@@ -125,6 +126,19 @@ async function handleError(msg, err) {
 		process.exit(0);
 	}
 	if (err instanceof Error && err.stack) log.debug("Stack: %s", err.stack);
+	if (err instanceof Error) {
+		const rewritten = rewriteUnknownAgentArg({
+			message: err.message,
+			argv: process.argv,
+			cliName: getCliName()
+		});
+		if (rewritten !== void 0) {
+			const error = new Error(rewritten);
+			sendError(error, matchErrorCode(error.message));
+			log.error(error.message);
+			return false;
+		}
+	}
 	if (isNetworkError(err)) {
 		log.error(NETWORK_ERROR_MESSAGE);
 		const error = err instanceof Error ? err : new Error(NETWORK_ERROR_MESSAGE);
@@ -162,8 +176,9 @@ async function handleError(msg, err) {
 		}
 	} else {
 		const error = err instanceof Error ? err : new Error(msg || "Unknown error");
-		sendError(error, matchErrorCode(error.message));
-		log.error(error.message);
+		const code = matchErrorCode(error.message);
+		sendError(error, code);
+		if (code !== "NEON_INIT_FAILED") log.error(error.message);
 		return false;
 	}
 }

package/dist/init/chrome.js

@@ -0,0 +1,44 @@
+import { isCi } from "../env.js";
+import chalk from "chalk";
+//#region src/init/chrome.ts
+const NEON_GREEN = "#4BB578";
+const INIT_BANNER_LINES = [
+	" ██╗  ██╗██████╗  ██████╗ ██╗  ██╗",
+	" ███╗ ██║██╔═══╝ ██╔═══██╗███╗ ██║",
+	" ████╗██║██████╗ ██║   ██║████╗██║",
+	" ██╔████║██╔═══╝ ██║   ██║██╔████║",
+	" ██║╚███║██████╗ ╚██████╔╝██║╚███║",
+	" ╚═╝ ╚══╝╚═════╝  ╚═════╝ ╚═╝ ╚══╝"
+];
+const formatInitBanner = () => INIT_BANNER_LINES.join("\n");
+const shouldPrintInitBanner = (yes) => !yes && !isCi() && Boolean(process.stdout.isTTY);
+const printInitBanner = () => {
+	process.stdout.write(`\n${chalk.hex(NEON_GREEN)(formatInitBanner())}\n\n${chalk.dim("Let's get this directory set up with Neon.")}\n\n`);
+};
+const formatInitDone = (input) => {
+	const labelWidth = Math.max(0, ...input.rows.map((row) => row.label.length));
+	const body = input.rows.length === 0 ? "" : `\n\n${input.rows.map((row) => `  ${row.label.padEnd(labelWidth)}  ${row.value}`).join("\n")}`;
+	const next = input.next.length === 0 ? "" : `\n\nNext:\n${input.next.map((line) => `  ${line}`).join("\n")}`;
+	const rule = "-".repeat(input.heading.length);
+	return `${input.heading}\n${rule}${body}${next}\n`;
+};
+const printInitDone = (text) => {
+	const painted = (text.endsWith("\n") ? text.slice(0, -1) : text).split("\n").map((line, index) => {
+		if (index === 0) return chalk.hex(NEON_GREEN).bold(line);
+		if (/^-{3,}$/.test(line)) return chalk.hex(NEON_GREEN)(line);
+		if (line === "Next:") return chalk.bold(line);
+		return line;
+	});
+	process.stdout.write(`\n${painted.join("\n")}\n\n`);
+};
+const agentSetupLabel = (setup) => {
+	if (setup === "plugin") return "plugin";
+	if (setup === "skills-mcp") return "skills and MCP";
+	return "skipped";
+};
+const agentSetupDoneLabel = (input) => {
+	if (!input.ran && input.setup !== "skip") return "not run";
+	return agentSetupLabel(input.setup);
+};
+//#endregion
+export { INIT_BANNER_LINES, NEON_GREEN, agentSetupDoneLabel, agentSetupLabel, formatInitBanner, formatInitDone, printInitBanner, printInitDone, shouldPrintInitBanner };

package/dist/init/detect_host.js

@@ -0,0 +1,38 @@
+//#region src/init/detect_host.ts
+const CLAUDE_ENV = ["CLAUDECODE", "CLAUDE_CODE_CHILD_SESSION"];
+const CURSOR_ENV = [
+	"CURSOR_TRACE_ID",
+	"CURSOR_EXTENSION_HOST_ROLE",
+	"CURSOR_LAYOUT",
+	"CURSOR_SPAWNED_BY_EXTENSION_ID"
+];
+const CURSOR_PATH_ENV = [
+	"GIT_ASKPASS",
+	"VSCODE_GIT_ASKPASS_NODE",
+	"VSCODE_GIT_ASKPASS_MAIN",
+	"VSCODE_IPC_HOOK_CLI"
+];
+const looksLikeCursor = (value) => {
+	const lower = value.toLowerCase();
+	return lower.includes("cursor.app") || lower.includes("/cursor/") || lower.includes("/.cursor/");
+};
+const isSet = (value) => value !== void 0;
+const isNonEmpty = (value) => typeof value === "string" && value.trim() !== "";
+function detectAgent(env = process.env) {
+	if (CLAUDE_ENV.some((key) => env[key] === "1")) return "claude-code";
+	if (env.CODEX === "1") return "codex";
+	if (isNonEmpty(env.CODEX_THREAD_ID) || isNonEmpty(env.CODEX_SESSION_ID)) return "codex";
+	if (env.GEMINI_CLI === "1") return "gemini-cli";
+	if (env.OPENCODE === "1") return "opencode";
+	if (env.GOOSE_TERMINAL === "1" || env.AGENT === "goose") return "goose";
+	if (env.TERM_PROGRAM === "cursor" || CURSOR_ENV.some((key) => isSet(env[key])) || CURSOR_PATH_ENV.some((key) => {
+		const value = env[key];
+		return typeof value === "string" && looksLikeCursor(value);
+	})) return "cursor";
+	if (env.TERM_PROGRAM === "windsurf") return "windsurf";
+	if (env.TERM_PROGRAM === "zed") return "zed";
+	if (env.TERM_PROGRAM === "vscode" || isSet(env.VSCODE_PID) || isSet(env.VSCODE_CWD)) return "vscode";
+	return null;
+}
+//#endregion
+export { detectAgent };