neon 8.15.0 → 8.16.0

package/README.md

@@ -951,7 +951,9 @@ On a TTY the command asks for config location (global is the default), then agen
 
 `-y` skips those questions. `neon mcp -y` writes `https://mcp.neon.tech/mcp` into global config for globally installed apps, else the host CLI agent, reuses an existing Neon MCP API key or mints an account-wide key, leaves write tools enabled, exposes every tool category, and does not pin a project (including from `.neon`). `--agent`, `--project`, `--oauth`, `--read-only`, `--project-id` and `--category` still apply with `-y`. `--read-only` and `--category` are flags only and are never prompted. A linked project-folder install asks whether to pin MCP tools to that `.neon` project (`?projectId=`). If you pin and selected API-key auth, the minted key is limited to that project too. An unlinked project folder does not ask. Global installs never add that param unless you pass `--project-id`. Without a TTY, pass `-y` to mint into every detected agent, `--agent <name>` to name them, or `--oauth` to write the URL only. If `-y` finds no agent, it exits: pass `--agent <name>`, run from a supported agent, or omit `-y` in a terminal to pick. `neon mcp --help` lists the server URL, those `-y` defaults, the supported agent names, and the `--category` values.
 
-Supported agents: `antigravity`, `cline`, `cline-cli`, `claude-code`, `codex`, `cursor`, `gemini-cli`, `goose`, `github-copilot-cli`, `grok-build`, `mcporter`, `opencode`, `vscode`, `windsurf`, `zed`. Project installs drop `antigravity`, `cline`, `cline-cli`, `goose` and `windsurf`. `claude-desktop` is a known name that is then skipped.
+Supported agents: `antigravity`, `cline`, `cline-cli`, `claude-code`, `codex`, `cursor`, `factory-droid`, `fx`, `gemini-cli`, `goose`, `github-copilot-cli`, `grok-build`, `hermes`, `junie`, `kilo-code`, `kimi-code`, `kiro-cli`, `mcporter`, `opencode`, `pi`, `vscode`, `windsurf`, `zed`. Project installs drop `antigravity`, `cline`, `cline-cli`, `fx`, `goose`, `hermes` and `windsurf`. `claude-desktop` is a known name that is then skipped. fx only takes `--oauth`; with an API key it is skipped. Pi reads MCP servers through [`pi-mcp-adapter`](https://github.com/nicobailon/pi-mcp-adapter) (`pi install npm:pi-mcp-adapter`).
+
+GitHub Copilot CLI project installs write into `.mcp.json`, or into `.github/mcp.json` when only that file exists. Claude Code project installs always write `.mcp.json`. Copilot CLI reads `.mcp.json` first, so once that file exists it no longer reads `.github/mcp.json`.
 
 The default mints an account-wide API key (or reuses the Bearer already configured for Neon at `https://mcp.neon.tech/mcp`) and writes it into each selected agent's config. That key reaches everything the account can, in every organization. Revoke it with `neon api-keys revoke <id>`. `--oauth` writes the URL with no `Authorization` header; the agent signs in on first use. `--project` writes into the project config (`.cursor/mcp.json` and similar). `--read-only` adds `?readonly=true`. `--project-id` adds `?projectId=` and, when a key is minted, limits that key to the named project. Accepting the linked-project pin does the same. Revoke a project-scoped key with `neon api-keys revoke <id> --org-id <org>`. A reused Bearer keeps the scope it already has. `--category` adds `?category=` (repeatable or comma-separated: `projects`, `branches`, `schema`, `querying`, `neon_auth`, `data_api`, `observability`, `docs`). `--read-only` and `--category` restrict which MCP tools the server exposes; they do not change what the minted key can do.
 
@@ -996,7 +998,7 @@ On a TTY the command asks which agents and which skills, then installs. Detected
 
 `--skill` names by source repo: `neondatabase/agent-skills` (`neon`, `neon-ai-gateway`, `neon-auth`, `neon-functions`, `neon-object-storage`, `neon-postgres`, `neon-postgres-branches`, `neon-postgres-egress-optimizer`, `neon-realtime`); `neondatabase/neon-for-agent-platforms` (`neon-postgres-agent-platforms`).
 
-Supported agents match `neon mcp`, minus agents that cannot install skills: `antigravity`, `cline`, `cline-cli`, `claude-code`, `claude-desktop`, `codex`, `cursor`, `gemini-cli`, `goose`, `github-copilot-cli`, `grok-build`, `opencode`, `vscode`, `windsurf`, `zed`. `mcporter` is a known MCP name that is then skipped. `neon skills --help` lists the same skill and agent values, and that `-y` leaves out `neon-postgres-agent-platforms`.
+Supported agents match `neon mcp`, minus agents that cannot install skills: `antigravity`, `cline`, `cline-cli`, `claude-code`, `claude-desktop`, `codex`, `cursor`, `factory-droid`, `fx`, `gemini-cli`, `goose`, `github-copilot-cli`, `grok-build`, `hermes`, `junie`, `kilo-code`, `kimi-code`, `kiro-cli`, `opencode`, `pi`, `vscode`, `windsurf`, `zed`. `mcporter` is a known MCP name that is then skipped. `neon skills --help` lists the same skill and agent values, and that `-y` leaves out `neon-postgres-agent-platforms`.
 
 ## Ask the Neon assistant (`ask`)
 
@@ -1054,9 +1056,11 @@ On a TTY the command asks which agents, then installs. Detected agents start sel
 
 `-y` skips those questions and installs into detected agents: project-folder markers such as `.cursor`, else the agent driving the CLI. `--agent` / `-a` names coding agents and skips the agent picker. `--global -y` uses installed apps, else the host CLI agent. Without a TTY, pass `-y` or `--agent <name>`. If `-y` finds no agent, it exits: pass `--agent <name>`, run from a supported agent, or omit `-y` in a terminal to pick.
 
-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.
+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, Grok Build, and Kimi Code 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.
+Supported agents with a plugins mapping: `claude-code`, `claude-desktop`, `codex`, `cursor`, `github-copilot-cli`, `grok-build`, `kimi-code`, `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 +1126,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/{checkout-BpOcFaAi.js → checkout-CNBIS3gA.js}

@@ -11,9 +11,9 @@ import { looksLikeBranchId } from "../utils/formats.js";
 import { fillSingleProject, listAllProjectBranches } from "../utils/enrichers.js";
 import { buildCheckoutEvent, readGitContext } from "../utils/git.js";
 import { buildHookBranch, loadHookConfig, resolveHookEnv, runCheckoutAfterHook, runCheckoutBeforeHook, runCreateAfterHook, runCreateBeforeHook } from "../utils/hooks.js";
-import { n as autoPullEnvAfterPin } from "./env-BOt9AZ1j.js";
-import { a as applyPolicyOnCreate, f as envFlag, l as createBranchFromPolicyOnCheckout } from "./config-BjCm5cfr.js";
-import { i as handler$1 } from "./link-nAiuWKfg.js";
+import { n as autoPullEnvAfterPin } from "./env-BtG4vH55.js";
+import { a as applyPolicyOnCreate, f as envFlag, l as createBranchFromPolicyOnCheckout } from "./config-CgtJH8xE.js";
+import { i as handler$1 } from "./link-CNO-HxHN.js";
 import chalk from "chalk";
 import prompts from "prompts";
 // src/commands/checkout.ts

package/dist/_chunks/{claim-DlLZmcq0.js → claim-m5sIJdm5.js}

@@ -12,7 +12,7 @@ import { projectConfigPath } from "../project.js";
 import { resolveEnvFilePath } from "../env_file.js";
 import { writer } from "../writer.js";
 import { noPassthrough } from "../utils/flags.js";
-import { c as pull } from "./env-BOt9AZ1j.js";
+import { c as pull } from "./env-BtG4vH55.js";
 import { existsSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
 import open from "open";
 import prompts from "prompts";

package/dist/_chunks/{config-BjCm5cfr.js → config-CgtJH8xE.js}

@@ -26,7 +26,7 @@ import { readGitContext } from "../utils/git.js";
 import { resolveHookEnv, runDeployAfterHook, runDeployBeforeHook } from "../utils/hooks.js";
 import { pickServicesInteractively } from "../utils/service_picker.js";
 import { zipBundle } from "../utils/zip.js";
-import { n as autoPullEnvAfterPin } from "./env-BOt9AZ1j.js";
+import { n as autoPullEnvAfterPin } from "./env-BtG4vH55.js";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join, relative, resolve } from "node:path";
 import chalk from "chalk";

package/dist/_chunks/{databases-DC2h6IW2.js → databases-B2Yapqme.js}

@@ -1,4 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-BJohB4LM.js";
+import { log } from "../log.js";
 import { retryOnLock } from "../api.js";
 import { writer } from "../writer.js";
 import { fillSingleProject, resolveBranchFromProps } from "../utils/enrichers.js";
@@ -75,9 +76,13 @@ const create = async (props) => {
 const deleteDb = async (props) => {
 	const { branchId, branch } = await resolveBranchFromProps(props);
 	const { data } = await retryOnLock(() => props.apiClient.deleteProjectBranchDatabase(props.projectId, branchId, props.database));
-	if (data) writer(props).end(data.database, {
-		fields: DATABASE_FIELDS,
-		humanTitle: `Database deleted from ${branch?.name ?? branchId}`
-	});
+	if (data) {
+		writer(props).end(data.database, {
+			fields: DATABASE_FIELDS,
+			humanTitle: `Database deleted from ${branch?.name ?? branchId}`
+		});
+		return;
+	}
+	log.info(`Database "${props.database}" not found on branch ${branch?.name ?? branchId}; nothing to delete.`);
 };
 export { create as a, describe as c, command as i, handler as l, aliases as n, databases_exports as o, builder as r, deleteDb as s, DATABASE_FIELDS as t, list as u };

package/dist/_chunks/{deploy-DmEEhux0.js → deploy-Bs5gmi4Q.js}

@@ -1,6 +1,6 @@
 import { t as __exportAll } from "./rolldown-runtime-BJohB4LM.js";
 import { fillSingleProject } from "../utils/enrichers.js";
-import { f as envFlag, i as applyFlags, p as envPullFlag, r as applyCmd } from "./config-BjCm5cfr.js";
+import { f as envFlag, i as applyFlags, p as envPullFlag, r as applyCmd } from "./config-CgtJH8xE.js";
 import { DEPLOY_COMMANDS_EPILOGUE } from "../commands/deploy_help.js";
 // src/commands/deploy.ts
 var deploy_exports = /* @__PURE__ */ __exportAll({

package/dist/_chunks/{dev-DlUJFzRs.js → dev-DxiIp4c9.js}

@@ -4,12 +4,12 @@ import { isClaimableEnvTarget } from "../claimable/state.js";
 import { getCliName } from "../utils/cli_name.js";
 import { defaultDevEnvFiles, readEnvFile, resolveEnvFilePath } from "../env_file.js";
 import { l as functionBaseUrlKey } from "./env-JgoSsmyt.js";
+import { branchIdResolve } from "../utils/enrichers.js";
+import { bundleEntry } from "../utils/esbuild.js";
 import { a as resolveDevEnv } from "./env-CIFMBEon.js";
+import { f as envFlag } from "./config-CgtJH8xE.js";
 import { findConfigFunctionBySource, resolveFunctionsFromConfig } from "../dev/functions.js";
 import { resolveWatchInputs } from "../dev/inputs.js";
-import { branchIdResolve } from "../utils/enrichers.js";
-import { bundleEntry } from "../utils/esbuild.js";
-import { f as envFlag } from "./config-BjCm5cfr.js";
 import { existsSync, mkdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";

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/{functions-3ypiRwZK.js → functions-PHaU-kRb.js}

@@ -198,7 +198,7 @@ const builder = (argv) => argv.usage("$0 function <sub-command> [options]").opti
 	describe: "Function slug",
 	type: "string",
 	demandOption: true
-}), (args) => deleteFn(args)).command(["domains", "domain"], "Manage custom domains on the branch (beta)", (yargs) => yargs.command("list", "List custom domains on the branch", (yargs) => yargs, (args) => listDomains(args)).command("register <domain>", "Point a domain you already own at a function on the branch", (yargs) => yargs.positional("domain", {
+}), (args) => deleteFn(args)).command(["domains", "domain"], "Manage custom domains on the branch", (yargs) => yargs.command("list", "List custom domains on the branch", (yargs) => yargs, (args) => listDomains(args)).command("register <domain>", "Point a domain you already own at a function on the branch", (yargs) => yargs.positional("domain", {
 	describe: "Domain you already own (for example docs.example.com)",
 	type: "string",
 	demandOption: true

package/dist/_chunks/{git-j6xSVo3e.js → git-DRUZBCmZ.js}

@@ -5,8 +5,8 @@ import { CONTEXT_FILE, contextBranch, gitBranchMap, gitBranchMapping, isUnfollow
 import { writer } from "../writer.js";
 import { neonSafeBranchName } from "../utils/branch_name.js";
 import { currentGitBranch, gitPull, gitRepoRoot, hasUpstream, installPostCheckoutHook, isGitRepo, isManagedHook, localGitBranches, postCheckoutHookPath, readGitContext, removePostCheckoutHook } from "../utils/git.js";
-import { o as quoteFlagValue } from "./link-nAiuWKfg.js";
-import { o as handler$1 } from "./checkout-BpOcFaAi.js";
+import { o as quoteFlagValue } from "./link-CNO-HxHN.js";
+import { o as handler$1 } from "./checkout-CNBIS3gA.js";
 import { existsSync } from "node:fs";
 import { join } from "node:path";
 import chalk from "chalk";

package/dist/_chunks/{link-nAiuWKfg.js → link-CNO-HxHN.js}

@@ -13,8 +13,8 @@ import { writer } from "../writer.js";
 import { createBranch, pickBranchInteractively } from "../utils/branch_picker.js";
 import { looksLikeBranchId } from "../utils/formats.js";
 import { listAllProjectBranches } from "../utils/enrichers.js";
-import { n as autoPullEnvAfterPin } from "./env-BOt9AZ1j.js";
-import { h as initCmd } from "./config-BjCm5cfr.js";
+import { n as autoPullEnvAfterPin } from "./env-BtG4vH55.js";
+import { h as initCmd } from "./config-CgtJH8xE.js";
 import { formatLinkSummary } from "../commands/link_output.js";
 import { r as REGIONS } from "./projects-a3X4OFEJ.js";
 import prompts from "prompts";

package/dist/_chunks/{mcp-BznTRK3w.js → mcp-SvqWzHnT.js}

@@ -4,11 +4,11 @@ import { readContextFile } from "../context.js";
 import { recordCommandSuccessExtras } from "../analytics.js";
 import { getCliName } from "../utils/cli_name.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 { mcpInstallableAgents, resolveInstallTargets } from "../mcp/targets.js";
 import { writer } from "../writer.js";
 import { noPassthrough, single } from "../utils/flags.js";
 import { AGENT_MCP_SKIP_MESSAGE } from "../init/copy.js";
+import { NEON_MCP_CATEGORIES, NEON_MCP_URL, existingNeonApiKey, installNeonMcpServer, mcpInstallOrder, neonMcpUrl, parseMcpCategories, trackedProjectMcpConfig } from "../mcp/install.js";
+import { mcpInstallableAgents, resolveInstallTargets } from "../mcp/targets.js";
 import { mintMcpApiKey, mintedKeyRevokeCommand, withdrawMintedKey } from "../mcp/mint.js";
 import { canPickAgentsInteractively, skippableAgentPicker } from "../utils/agent_picker.js";
 import { resolveMcpPlan } from "../mcp/plan.js";
@@ -119,7 +119,8 @@ const setupNeonMcp = async (options) => {
 	});
 	const { install, skipped } = resolveInstallTargets({
 		agents: plan.agents,
-		scope: plan.scope
+		scope: plan.scope,
+		auth: plan.auth
 	});
 	const url = neonMcpUrl({
 		readOnly: plan.readOnly,
@@ -167,7 +168,7 @@ const setupNeonMcp = async (options) => {
 	const rows = [];
 	let successes = 0;
 	const failedAgents = [];
-	for (const agent of install) {
+	for (const agent of mcpInstallOrder(install)) {
 		const result = installNeonMcpServer({
 			agent,
 			scope: plan.scope,
@@ -182,6 +183,7 @@ const setupNeonMcp = async (options) => {
 				status: "installed"
 			});
 			log.info("Wrote %s", result.path);
+			if (agent === "pi") log.warning("Pi reads MCP servers through pi-mcp-adapter. Install it with `pi install npm:pi-mcp-adapter`, then run /reload in Pi.");
 		} else {
 			rows.push({
 				agent,

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

@@ -2,13 +2,13 @@ import { t as __exportAll } from "./rolldown-runtime-BJohB4LM.js";
 import { log } from "../log.js";
 import { recordCommandSuccessExtras } from "../analytics.js";
 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 { writer } from "../writer.js";
 import { noPassthrough } from "../utils/flags.js";
+import { getAgentDisplayName } from "../mcp/agents.js";
+import "../init/agents.js";
+import { pluginsCommandProblemText, pluginsInstallableAgents } from "../plugins/targets.js";
 import { AGENT_PLUGIN_SKIP_MESSAGE } from "../init/copy.js";
+import { NEON_MCP_URL } from "../mcp/install.js";
 import { canPickAgentsInteractively, skippableAgentPicker } from "../utils/agent_picker.js";
 import { resolvePluginsPlan } from "../plugins/plan.js";
 import { NEON_PLUGIN_NAME, PLUGIN_SKILLS, PLUGIN_SOURCE, neonPluginsRetryCommand, pluginsAddArgs, runPluginsCli } from "../plugins/run.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/_chunks/{roles-xRuu0462.js → roles-BVc69rjG.js}

@@ -1,4 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-BJohB4LM.js";
+import { log } from "../log.js";
 import { retryOnLock } from "../api.js";
 import { writer } from "../writer.js";
 import { fillSingleProject, resolveBranchFromProps } from "../utils/enrichers.js";
@@ -70,9 +71,13 @@ const create = async (props) => {
 const deleteRole = async (props) => {
 	const { branchId, branch } = await resolveBranchFromProps(props);
 	const { data } = await retryOnLock(() => props.apiClient.deleteProjectBranchRole(props.projectId, branchId, props.role));
-	if (data) writer(props).end(data.role, {
-		fields: ROLES_FIELDS,
-		humanTitle: `Role deleted from ${branch?.name ?? branchId}`
-	});
+	if (data) {
+		writer(props).end(data.role, {
+			fields: ROLES_FIELDS,
+			humanTitle: `Role deleted from ${branch?.name ?? branchId}`
+		});
+		return;
+	}
+	log.info(`Role "${props.role}" not found on branch ${branch?.name ?? branchId}; nothing to delete.`);
 };
 export { deleteRole as a, list as c, create as i, roles_exports as l, builder as n, describe as o, command as r, handler as s, aliases as t };

package/dist/_chunks/{status-BC4XXuuE.js → status-BlrzeKyA.js}

@@ -1,6 +1,6 @@
 import { t as __exportAll } from "./rolldown-runtime-BJohB4LM.js";
 import { fillSingleProject } from "../utils/enrichers.js";
-import { y as status } from "./config-BjCm5cfr.js";
+import { y as status } from "./config-CgtJH8xE.js";
 // src/commands/status.ts
 var status_exports = /* @__PURE__ */ __exportAll({
 	builder: () => builder,

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

@@ -1 +1 @@
-export { n as builder, r as command, i as describe, a as handler } from "../_chunks/bootstrap-BDkvsAVJ.js";
+export { n as builder, r as command, i as describe, a as handler } from "../_chunks/bootstrap-vAtWRZXa.js";

package/dist/commands/checkout.js

@@ -1 +1 @@
-export { t as builder, r as command, i as describe, a as formatCheckoutPolicyFailure, o as handler } from "../_chunks/checkout-BpOcFaAi.js";
+export { t as builder, r as command, i as describe, a as formatCheckoutPolicyFailure, o as handler } from "../_chunks/checkout-CNBIS3gA.js";

package/dist/commands/claim.js

@@ -1 +1 @@
-export { t as CLAIM_CREATE_FIELDS, n as CLAIM_LIST_FIELDS, r as aliases, i as builder, a as claimCreateFields, s as claimableCapabilities, c as command, l as create, u as describe, d as handler } from "../_chunks/claim-DlLZmcq0.js";
+export { t as CLAIM_CREATE_FIELDS, n as CLAIM_LIST_FIELDS, r as aliases, i as builder, a as claimCreateFields, s as claimableCapabilities, c as command, l as create, u as describe, d as handler } from "../_chunks/claim-m5sIJdm5.js";

package/dist/commands/config.js

@@ -1 +1 @@
-export { t as ConfigInstallFailed, n as addCmd, r as applyCmd, i as applyFlags, a as applyPolicyOnCreate, o as builder, s as command, l as createBranchFromPolicyOnCheckout, u as describe, d as ensureConfigPackages, f as envFlag, p as envPullFlag, m as handler, h as initCmd, g as installCommandFrom, _ as missingDependencies, v as planCmd, y as status } from "../_chunks/config-BjCm5cfr.js";
+export { t as ConfigInstallFailed, n as addCmd, r as applyCmd, i as applyFlags, a as applyPolicyOnCreate, o as builder, s as command, l as createBranchFromPolicyOnCheckout, u as describe, d as ensureConfigPackages, f as envFlag, p as envPullFlag, m as handler, h as initCmd, g as installCommandFrom, _ as missingDependencies, v as planCmd, y as status } from "../_chunks/config-CgtJH8xE.js";

package/dist/commands/databases.js

@@ -1 +1 @@
-export { t as DATABASE_FIELDS, n as aliases, r as builder, i as command, a as create, s as deleteDb, c as describe, l as handler, u as list } from "../_chunks/databases-DC2h6IW2.js";
+export { t as DATABASE_FIELDS, n as aliases, r as builder, i as command, a as create, s as deleteDb, c as describe, l as handler, u as list } from "../_chunks/databases-B2Yapqme.js";

package/dist/commands/deploy.js

@@ -1 +1 @@
-export { t as builder, n as command, i as describe, a as handler } from "../_chunks/deploy-DmEEhux0.js";
+export { t as builder, n as command, i as describe, a as handler } from "../_chunks/deploy-Bs5gmi4Q.js";

package/dist/commands/dev.js

@@ -1 +1 @@
-export { t as builder, n as captureShellEnv, r as command, i as describe, a as devBundleDir, o as devEnvContext, c as diffUnits, l as formatEnvFiles, u as formatEnvSummary, d as handler, f as loadDevEnvFiles, p as localFunctionUrlEnv, m as planFunctionsToUnits, h as reportDevCredential, g as sourceFunctionUrlOverlay } from "../_chunks/dev-DlUJFzRs.js";
+export { t as builder, n as captureShellEnv, r as command, i as describe, a as devBundleDir, o as devEnvContext, c as diffUnits, l as formatEnvFiles, u as formatEnvSummary, d as handler, f as loadDevEnvFiles, p as localFunctionUrlEnv, m as planFunctionsToUnits, h as reportDevCredential, g as sourceFunctionUrlOverlay } from "../_chunks/dev-DxiIp4c9.js";

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

@@ -1 +1 @@
-export { t as ENV_PULL_SKIPPED_HINT, n as autoPullEnvAfterPin, r as builder, i as command, a as describe, s as handler, c as pull } from "../_chunks/env-BOt9AZ1j.js";
+export { t as ENV_PULL_SKIPPED_HINT, n as autoPullEnvAfterPin, r as builder, i as command, a as describe, s as handler, c as pull } from "../_chunks/env-BtG4vH55.js";

package/dist/commands/functions.js

@@ -1 +1 @@
-export { t as aliases, n as builder, r as command, i as deploymentPollDelay, a as describe, s as handler } from "../_chunks/functions-3ypiRwZK.js";
+export { t as aliases, n as builder, r as command, i as deploymentPollDelay, a as describe, s as handler } from "../_chunks/functions-PHaU-kRb.js";

package/dist/commands/functions_new.js

@@ -8,7 +8,7 @@ import { writer } from "../writer.js";
 import { formatInitDone, printInitDone } from "../init/chrome.js";
 import { FUNCTION_SLUG_PATTERN, deriveFunctionSlug } from "../utils/function_slug.js";
 import { displayPath } from "./env_output.js";
-import { _ as missingDependencies, d as ensureConfigPackages, g as installCommandFrom } from "../_chunks/config-BjCm5cfr.js";
+import { _ as missingDependencies, d as ensureConfigPackages, g as installCommandFrom } from "../_chunks/config-CgtJH8xE.js";
 import { recommendedOperations } from "../functions/registry.js";
 import { collidingFiles, operationsFromFlags, planConfigRegistration, planEnvExample, planScaffold, writeScaffold } from "../functions/scaffold.js";
 import { describeRegistrySource, openRegistry } from "../functions/source.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/git.js

@@ -1 +1 @@
-export { t as aliases, n as builder, r as cleanup, i as command, a as describe, s as handler, c as install, l as partitionBranchesToPrune, u as status, d as sync, f as uninstall } from "../_chunks/git-j6xSVo3e.js";
+export { t as aliases, n as builder, r as cleanup, i as command, a as describe, s as handler, c as install, l as partitionBranchesToPrune, u as status, d as sync, f as uninstall } from "../_chunks/git-DRUZBCmZ.js";

package/dist/commands/index.js

@@ -2,29 +2,29 @@ import { r as auth_exports } from "../_chunks/auth-rup6nemJ.js";
 import { t as api_exports } from "../_chunks/api-1MKsfpY3.js";
 import { n as api_keys_exports } from "../_chunks/api_keys-6Xnxl7a8.js";
 import { n as ask_exports } from "../_chunks/ask-Xlek1Pxh.js";
-import { o as env_exports } from "../_chunks/env-BOt9AZ1j.js";
-import { c as config_exports } from "../_chunks/config-BjCm5cfr.js";
+import { o as env_exports } from "../_chunks/env-BtG4vH55.js";
+import { c as config_exports } from "../_chunks/config-CgtJH8xE.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 { l as skills_exports } from "../_chunks/skills-DKgafm65.js";
-import { t as bootstrap_exports } from "../_chunks/bootstrap-BDkvsAVJ.js";
+import { a as link_exports } from "../_chunks/link-CNO-HxHN.js";
+import { o as mcp_exports } from "../_chunks/mcp-SvqWzHnT.js";
+import { c as plugins_exports } from "../_chunks/plugins-7cxVcgay.js";
+import { l as skills_exports } from "../_chunks/skills-Bv8oKKwE.js";
+import { t as bootstrap_exports } from "../_chunks/bootstrap-vAtWRZXa.js";
 import { r as branches_exports } from "../_chunks/branches-Bp-5z1lM.js";
 import { n as bucket_exports } from "../_chunks/bucket-D06bvDSa.js";
-import { n as checkout_exports } from "../_chunks/checkout-BpOcFaAi.js";
-import { o as claim_exports } from "../_chunks/claim-DlLZmcq0.js";
+import { n as checkout_exports } from "../_chunks/checkout-CNBIS3gA.js";
+import { o as claim_exports } from "../_chunks/claim-m5sIJdm5.js";
 import { a as connection_string_exports } from "../_chunks/connection_string-C9e7N4xk.js";
 import { a as credentials_exports } from "../_chunks/credentials-BMBNmW0t.js";
 import { r as data_api_exports } from "../_chunks/data_api-CHDwvMTG.js";
-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 { o as databases_exports } from "../_chunks/databases-B2Yapqme.js";
+import { r as deploy_exports } from "../_chunks/deploy-Bs5gmi4Q.js";
+import { s as dev_exports } from "../_chunks/dev-DxiIp4c9.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";
+import { o as functions_exports } from "../_chunks/functions-PHaU-kRb.js";
+import { o as git_exports } from "../_chunks/git-DRUZBCmZ.js";
 import { a as init_exports } from "../_chunks/init-CcVJb492.js";
 import { o as inspect_exports } from "../_chunks/inspect-yFAb61qo.js";
 import { a as ip_allow_exports } from "../_chunks/ip_allow-DBdxNEUa.js";
@@ -36,10 +36,10 @@ import { o as orgs_exports } from "../_chunks/orgs-Dpbr-K0A.js";
 import { o as profile_exports } from "../_chunks/profile-BAlM625e.js";
 import { a as psql_exports } from "../_chunks/psql-Bce4X0NG.js";
 import { s as realtime_exports } from "../_chunks/realtime-BwtzYf5a.js";
-import { l as roles_exports } from "../_chunks/roles-xRuu0462.js";
+import { l as roles_exports } from "../_chunks/roles-BVc69rjG.js";
 import { a as set_context_exports } from "../_chunks/set_context-ompB6d2D.js";
 import { s as snapshots_exports } from "../_chunks/snapshots-DxNhjcco.js";
-import { a as status_exports } from "../_chunks/status-BC4XXuuE.js";
+import { a as status_exports } from "../_chunks/status-BlrzeKyA.js";
 import { d as triggers_exports } from "../_chunks/triggers-BfvyeJUC.js";
 import { s as user_exports } from "../_chunks/user-D9mC430O.js";
 import { i as vpc_endpoints_exports } from "../_chunks/vpc_endpoints-C-Y4WK2M.js";

package/dist/commands/link.js

@@ -1 +1 @@
-export { t as builder, n as command, r as describe, i as handler, o as quoteFlagValue, s as runLink, c as shouldOfferConfigInit } from "../_chunks/link-nAiuWKfg.js";
+export { t as builder, n as command, r as describe, i as handler, o as quoteFlagValue, s as runLink, c as shouldOfferConfigInit } from "../_chunks/link-CNO-HxHN.js";

package/dist/commands/mcp.js

@@ -1 +1 @@
-export { t as builder, n as command, r as describe, i as handler, a as mcpInstallError, s as reportMcpInstall, c as setupNeonMcp } from "../_chunks/mcp-BznTRK3w.js";
+export { t as builder, n as command, r as describe, i as handler, a as mcpInstallError, s as reportMcpInstall, c as setupNeonMcp } from "../_chunks/mcp-SvqWzHnT.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-7cxVcgay.js";

package/dist/commands/roles.js

@@ -1 +1 @@
-export { t as aliases, n as builder, r as command, i as create, a as deleteRole, o as describe, s as handler, c as list } from "../_chunks/roles-xRuu0462.js";
+export { t as aliases, n as builder, r as command, i as create, a as deleteRole, o as describe, s as handler, c as list } from "../_chunks/roles-BVc69rjG.js";

package/dist/commands/skills.js

@@ -1 +1 @@
-export { t as aliases, n as builder, r as command, i as describe, a as handler, o as installSkills, s as reportSkillsInstall, c as skillsInstallError } from "../_chunks/skills-DKgafm65.js";
+export { t as aliases, n as builder, r as command, i as describe, a as handler, o as installSkills, s as reportSkillsInstall, c as skillsInstallError } from "../_chunks/skills-Bv8oKKwE.js";

package/dist/commands/status.js

@@ -1 +1 @@
-export { t as builder, n as command, r as describe, i as handler } from "../_chunks/status-BC4XXuuE.js";
+export { t as builder, n as command, r as describe, i as handler } from "../_chunks/status-BlrzeKyA.js";

package/dist/commands/subscribe.js

@@ -1,6 +1,6 @@
 import { writer } from "../writer.js";
-import { o as resolveNeonEnvVars } from "../_chunks/env-CIFMBEon.js";
 import { branchIdFromProps } from "../utils/enrichers.js";
+import { o as resolveNeonEnvVars } from "../_chunks/env-CIFMBEon.js";
 import YAML from "yaml";
 // src/commands/subscribe.ts
 const builder = (argv) => argv.usage("$0 realtime subscribe \"<query>\" [options]").positional("query", {

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

@@ -13,7 +13,7 @@ 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";
-import { rewriteUnknownAgentArg } from "./init/plan.js";
+import { rewriteUnknownAgentArg } from "./init/unknown_agent_arg.js";
 import { recoverFromSSO } from "./sso_recovery.js";
 import { notifyIfUpdateAvailable, shouldRunSkillsNotifier } from "./update_notifier.js";
 import { fillInArgs, resolveApiKeyFromEnv } from "./utils/middlewares.js";

package/dist/init/agents.js

@@ -1,4 +1,4 @@
-import { agentSupportsHttpMcp, agentSupportsProjectMcp, detectInstalledAgents, getAgentDisplayName, listMcpAgentIds, resolveAddMcpAgentId, tryResolveAddMcpAgentId, uniqueAgentIds } from "../mcp/agents.js";
+import { agentSupportsHttpMcp, agentSupportsProjectMcp, detectInstalledAgents, detectProjectAgents, getAgentDisplayName, listMcpAgentIds, resolveAddMcpAgentId, tryResolveAddMcpAgentId, uniqueAgentIds } from "../mcp/agents.js";
 import { agents } from "add-mcp";
 // src/init/agents.ts
 const SKILLS_AGENT_BY_TYPE = {
@@ -16,7 +16,15 @@ const SKILLS_AGENT_BY_TYPE = {
 	"github-copilot-cli": "github-copilot",
 	windsurf: "windsurf",
 	zed: "zed",
-	"grok-build": "grok"
+	"grok-build": "grok",
+	"factory-droid": "droid",
+	fx: "fx",
+	hermes: "hermes-agent",
+	junie: "junie",
+	"kilo-code": "kilo",
+	"kimi-code": "kimi-code-cli",
+	"kiro-cli": "kiro-cli",
+	pi: "pi"
 };
 function getSkillsAgentName(agent) {
 	if (Object.prototype.hasOwnProperty.call(SKILLS_AGENT_BY_TYPE, agent)) return SKILLS_AGENT_BY_TYPE[agent];
@@ -47,4 +55,4 @@ function skillsPickerOptions() {
 		hint: "agent skills"
 	}));
 }
-export { agentPickerHint, agentSupportsHttpMcp, agentSupportsProjectMcp, detectInstalledAgents, getAgentDisplayName, getSkillsAgentName, listMcpAgentIds, mcpPickerOptions, resolveAddMcpAgentId, skillsPickerOptions, supportsSkills, tryResolveAddMcpAgentId, uniqueAgentIds };
+export { agentPickerHint, agentSupportsHttpMcp, agentSupportsProjectMcp, detectInstalledAgents, detectProjectAgents, getAgentDisplayName, getSkillsAgentName, listMcpAgentIds, mcpPickerOptions, resolveAddMcpAgentId, skillsPickerOptions, supportsSkills, tryResolveAddMcpAgentId, uniqueAgentIds };

package/dist/init/auth.js

@@ -4,8 +4,8 @@ import "../config.js";
 import "../auth.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";
+import { c as pull } from "../_chunks/env-BtG4vH55.js";
+import { c as setupNeonMcp } from "../_chunks/mcp-SvqWzHnT.js";
 // src/init/auth.ts
 const isUnauthorized = (error) => isNeonApiError(error) && error.status === 401;
 const authenticationFailed = () => /* @__PURE__ */ new Error("Authentication failed.");