@prisma/cli 3.0.0-dev.104.1 → 3.0.0-dev.107.1

package/dist/lib/agent/cli-command.js

@@ -0,0 +1,17 @@
+import { formatPrismaCliCommand } from "../../shell/cli-command.js";
+import { resolvePackageRunner, resolvePackageRunnerSync } from "./package-manager.js";
+//#region src/lib/agent/cli-command.ts
+async function resolvePrismaCliPackageCommandFormatter(options) {
+	return createPrismaCliPackageCommandFormatter(await resolvePackageRunner(options));
+}
+async function resolvePrismaCliPackageCommand(options) {
+	return (await resolvePrismaCliPackageCommandFormatter(options))(options.args);
+}
+function resolvePrismaCliPackageCommandFormatterSync(cwd) {
+	return createPrismaCliPackageCommandFormatter(resolvePackageRunnerSync(cwd));
+}
+function createPrismaCliPackageCommandFormatter(packageRunner) {
+	return (args) => formatPrismaCliCommand(args, { packageRunner });
+}
+//#endregion
+export { resolvePrismaCliPackageCommand, resolvePrismaCliPackageCommandFormatterSync };

package/dist/lib/agent/constants.js

@@ -0,0 +1,12 @@
+//#region src/lib/agent/constants.ts
+const PRISMA_SKILLS_SOURCE = "prisma/skills";
+const PRISMA_SKILLS_LOCK_FILENAME = "skills-lock.json";
+const SKILLS_CLI_PACKAGE = "skills@latest";
+const DEFAULT_PRISMA_AGENT_SKILLS = ["*"];
+const PRISMA_COMPUTE_AGENT_SKILL = "prisma-compute";
+const DEFAULT_PRISMA_AGENT_TARGETS = ["codex", "claude-code"];
+const PRISMA_AGENT_INSTALL_ARGS = ["agent", "install"];
+const PRISMA_AGENT_UPDATE_ARGS = ["agent", "update"];
+const PRISMA_AGENT_STATUS_ARGS = ["agent", "status"];
+//#endregion
+export { DEFAULT_PRISMA_AGENT_SKILLS, DEFAULT_PRISMA_AGENT_TARGETS, PRISMA_AGENT_INSTALL_ARGS, PRISMA_AGENT_STATUS_ARGS, PRISMA_AGENT_UPDATE_ARGS, PRISMA_COMPUTE_AGENT_SKILL, PRISMA_SKILLS_LOCK_FILENAME, PRISMA_SKILLS_SOURCE, SKILLS_CLI_PACKAGE };

package/dist/lib/agent/package-manager.js

@@ -0,0 +1,99 @@
+import { readFileSync, statSync } from "node:fs";
+import path from "node:path";
+//#region src/lib/agent/package-manager.ts
+const LOCKFILE_PACKAGE_MANAGERS = [
+	{
+		packageManager: "bun",
+		fileNames: ["bun.lock", "bun.lockb"]
+	},
+	{
+		packageManager: "pnpm",
+		fileNames: ["pnpm-lock.yaml", "pnpm-workspace.yaml"]
+	},
+	{
+		packageManager: "yarn",
+		fileNames: ["yarn.lock"]
+	},
+	{
+		packageManager: "npm",
+		fileNames: ["package-lock.json", "npm-shrinkwrap.json"]
+	}
+];
+async function resolveSkillsPackageRunner(options) {
+	return resolvePackageRunner(options);
+}
+async function resolvePackageRunner(options) {
+	options.signal.throwIfAborted();
+	const packageManager = detectPackageManagerSync(options.cwd, options.signal) ?? "npm";
+	options.signal.throwIfAborted();
+	return packageRunnerForPackageManager(packageManager);
+}
+function resolvePackageRunnerSync(cwd) {
+	return packageRunnerForPackageManager(detectPackageManagerSync(cwd) ?? "npm");
+}
+function detectPackageManagerSync(cwd, signal) {
+	let directory = path.resolve(cwd);
+	while (true) {
+		signal?.throwIfAborted();
+		const packageJsonManager = readPackageJsonPackageManager(directory);
+		if (packageJsonManager) return packageJsonManager;
+		const lockfileManager = readLockfilePackageManager(directory, signal);
+		if (lockfileManager) return lockfileManager;
+		const parent = path.dirname(directory);
+		if (parent === directory) return null;
+		directory = parent;
+	}
+}
+function readPackageJsonPackageManager(directory) {
+	const packageJsonPath = path.join(directory, "package.json");
+	let content;
+	try {
+		content = readFileSync(packageJsonPath, "utf8");
+	} catch (error) {
+		if (isMissingFileError(error)) return null;
+		throw error;
+	}
+	try {
+		return parsePackageManager(JSON.parse(content).packageManager);
+	} catch {
+		return null;
+	}
+}
+function readLockfilePackageManager(directory, signal) {
+	for (const candidate of LOCKFILE_PACKAGE_MANAGERS) for (const fileName of candidate.fileNames) {
+		signal?.throwIfAborted();
+		if (fileExists(path.join(directory, fileName))) return candidate.packageManager;
+	}
+	return null;
+}
+function fileExists(filePath) {
+	try {
+		return statSync(filePath).isFile();
+	} catch (error) {
+		if (isMissingFileError(error)) return false;
+		throw error;
+	}
+}
+function parsePackageManager(value) {
+	if (typeof value !== "string") return null;
+	const normalized = value.trim().toLowerCase();
+	if (normalized === "bun" || normalized.startsWith("bun@")) return "bun";
+	if (normalized === "pnpm" || normalized.startsWith("pnpm@")) return "pnpm";
+	if (normalized === "yarn" || normalized.startsWith("yarn@")) return "yarn";
+	if (normalized === "npm" || normalized.startsWith("npm@")) return "npm";
+	return null;
+}
+function packageRunnerForPackageManager(packageManager) {
+	switch (packageManager) {
+		case "bun": return ["bunx"];
+		case "pnpm": return ["pnpm", "dlx"];
+		case "yarn": return ["yarn", "dlx"];
+		case "npm": return ["npx", "-y"];
+	}
+}
+function isMissingFileError(error) {
+	const code = error.code;
+	return code === "ENOENT" || code === "ENOTDIR";
+}
+//#endregion
+export { resolvePackageRunner, resolvePackageRunnerSync, resolveSkillsPackageRunner };

package/dist/lib/agent/setup-status.js

@@ -0,0 +1,83 @@
+import { PRISMA_SKILLS_LOCK_FILENAME } from "./constants.js";
+import path from "node:path";
+import { readFile, stat } from "node:fs/promises";
+import { findComputeConfigDir } from "@prisma/compute-sdk/config";
+//#region src/lib/agent/setup-status.ts
+async function readPrismaAgentSetupStatus(options) {
+	const setupCwd = await resolvePrismaAgentSetupCwd(options);
+	const skillsLockPath = path.join(setupCwd, PRISMA_SKILLS_LOCK_FILENAME);
+	const [skillsInstalled, promptDismissedAt] = await Promise.all([hasPrismaSkillsLock(skillsLockPath, options.signal, options.requiredSkill), options.stateStore?.readAgentSetupPromptDismissedAt() ?? null]);
+	return {
+		skillsLockPath: path.basename(skillsLockPath),
+		skillsInstalled,
+		promptDismissedAt
+	};
+}
+async function resolvePrismaAgentSetupCwd(options) {
+	options.signal.throwIfAborted();
+	const configDir = await findComputeConfigDir(options.cwd, options.signal);
+	options.signal.throwIfAborted();
+	return configDir ?? options.cwd;
+}
+function isPrismaAgentSetupComplete(status) {
+	return status.skillsInstalled;
+}
+function shouldOfferPrismaAgentSetup(status) {
+	return !isPrismaAgentSetupComplete(status) && !status.promptDismissedAt;
+}
+async function isLikelyProjectDirectory(options) {
+	return (await Promise.all([
+		"package.json",
+		"prisma.compute.ts",
+		"prisma.config.ts",
+		".git"
+	].map((fileName) => pathExists(path.join(options.cwd, fileName), options.signal)))).some(Boolean);
+}
+async function hasPrismaSkillsLock(filePath, signal, requiredSkill) {
+	try {
+		const raw = await readFile(filePath, {
+			encoding: "utf8",
+			signal
+		});
+		return hasPrismaSkillsLockEntry(JSON.parse(raw), requiredSkill);
+	} catch (error) {
+		if (isNotFoundError(error) || error instanceof SyntaxError) return false;
+		throw error;
+	}
+}
+function hasPrismaSkillsLockEntry(value, requiredSkill) {
+	if (!isRecord(value)) return false;
+	if (requiredSkill) return skillLockEntryUsesPrismaSource(readSkillLockEntries(value)[requiredSkill]);
+	if (readLegacySources(value).includes("prisma/skills")) return true;
+	return Object.values(readSkillLockEntries(value)).some(skillLockEntryUsesPrismaSource);
+}
+function readLegacySources(value) {
+	return Array.isArray(value.sources) ? value.sources.filter((source) => typeof source === "string") : [];
+}
+function readSkillLockEntries(value) {
+	return isRecord(value.skills) ? value.skills : {};
+}
+function skillLockEntryUsesPrismaSource(value) {
+	return isRecord(value) && value.source === "prisma/skills";
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null;
+}
+async function pathExists(filePath, signal) {
+	signal.throwIfAborted();
+	try {
+		await stat(filePath);
+		signal.throwIfAborted();
+		return true;
+	} catch (error) {
+		if (signal.aborted) throw error;
+		if (isNotFoundError(error)) return false;
+		throw error;
+	}
+}
+function isNotFoundError(error) {
+	const code = error.code;
+	return code === "ENOENT" || code === "ENOTDIR";
+}
+//#endregion
+export { isLikelyProjectDirectory, readPrismaAgentSetupStatus, resolvePrismaAgentSetupCwd, shouldOfferPrismaAgentSetup };

package/dist/lib/app/app-provider.js

@@ -404,9 +404,9 @@ async function listComputeServices(client, options) {
 		liveUrl: toAbsoluteUrl(service.appEndpointDomain ?? null)
 	}));
 }
-async function listComputeServiceDomains(client, computeServiceId, signal) {
+async function listComputeServiceDomains(client, appId, signal) {
 	const result = await client.GET("/v1/apps/{appId}/domains", {
-		params: { path: { appId: computeServiceId } },
+		params: { path: { appId } },
 		signal
 	});
 	if (result.error || !result.data) throw domainApiCallError("Failed to list custom domains", result.response, result.error);
@@ -418,7 +418,7 @@ function normalizeDomainRecord(domain) {
 		type: domain.type,
 		url: domain.url,
 		hostname: domain.hostname,
-		computeServiceId: domain.computeServiceId,
+		appId: domain.appId,
 		status: domain.status,
 		foundryStatus: domain.foundryStatus,
 		failureReason: domain.failureReason,

package/dist/lib/app/branch-database-deploy.js

@@ -1,8 +1,8 @@
+import { formatCommandArgument } from "../../shell/command-arguments.js";
 import { CliError, usageError } from "../../shell/errors.js";
-import { confirmPrompt } from "../../shell/prompt.js";
 import { renderSummaryLine } from "../../shell/ui.js";
 import { canPrompt } from "../../shell/runtime.js";
-import { formatCommandArgument } from "../../shell/command-arguments.js";
+import { confirmPrompt } from "../../shell/prompt.js";
 import "../project/setup.js";
 import { hasBranchDatabaseSignal, inspectBranchDatabaseSignal } from "./branch-database.js";
 import path from "node:path";
@@ -51,6 +51,7 @@ async function maybeSetupBranchDatabase(context, provider, projectId, branch, op
 		if (!await confirmPrompt({
 			input: context.runtime.stdin,
 			output: context.output.stderr,
+			signal: context.runtime.signal,
 			message: databasePromptMessage(branch),
 			initialValue: false
 		})) return emptyBranchDatabaseSetupOutcome();

package/dist/lib/app/branch-database.js

@@ -1,8 +1,9 @@
-import { access, readFile, readdir, stat } from "node:fs/promises";
 import path from "node:path";
+import { access, readFile, readdir, stat } from "node:fs/promises";
 //#region src/lib/app/branch-database.ts
 const SKIPPED_DIRECTORIES = new Set([
 	".git",
+	".agents",
 	".next",
 	".nuxt",
 	".output",

package/dist/lib/app/build-settings.js

@@ -1,5 +1,5 @@
-import { readFile } from "node:fs/promises";
 import path from "node:path";
+import { readFile } from "node:fs/promises";
 import { resolveBuildSettings, resolveConfiguredBuildSettings } from "@prisma/compute-sdk";
 //#region src/lib/app/build-settings.ts
 /** Legacy build-settings file: no longer read or written, only detected for migration. */

package/dist/lib/app/build.js

@@ -1,7 +1,7 @@
 import "./build-settings.js";
-import { FRAMEWORKS } from "@prisma/compute-sdk/config";
-import "node:fs/promises";
 import "node:path";
+import "node:fs/promises";
+import { FRAMEWORKS } from "@prisma/compute-sdk/config";
 import { normalizeArtifactSymlinks, resolveBuildStrategy } from "@prisma/compute-sdk";
 //#region src/lib/app/build.ts
 const RESOLVED_APP_BUILD_TYPES = [...frameworkBuildTypesByLastOccurrence()];

package/dist/lib/app/bun-project.js

@@ -1,5 +1,5 @@
-import { access, readFile } from "node:fs/promises";
 import path from "node:path";
+import { access, readFile } from "node:fs/promises";
 //#region src/lib/app/bun-project.ts
 async function readBunPackageJson(appPath, signal) {
 	const packageJsonPath = path.join(appPath, "package.json");

package/dist/lib/app/compute-config.js

@@ -1,6 +1,6 @@
 import { CliError } from "../../shell/errors.js";
-import { COMPUTE_CONFIG_FILENAME, COMPUTE_CONFIG_FILENAME as COMPUTE_CONFIG_FILENAME$1, ComputeConfigTargetRequiredError, computeTargetAppDir, frameworkByKey, inferComputeTargetFromCwd, loadComputeConfig, selectComputeDeployTarget } from "@prisma/compute-sdk/config";
 import path from "node:path";
+import { COMPUTE_CONFIG_FILENAME, COMPUTE_CONFIG_FILENAME as COMPUTE_CONFIG_FILENAME$1, ComputeConfigTargetRequiredError, computeTargetAppDir, frameworkByKey, inferComputeTargetFromCwd, loadComputeConfig, selectComputeDeployTarget } from "@prisma/compute-sdk/config";
 import { matchError } from "better-result";
 //#region src/lib/app/compute-config.ts
 /**

package/dist/lib/app/env-file.js

@@ -1,7 +1,7 @@
 import { usageError } from "../../shell/errors.js";
 import { validateKey } from "./env-config.js";
-import { readFile } from "node:fs/promises";
 import path from "node:path";
+import { readFile } from "node:fs/promises";
 import { parse } from "dotenv";
 //#region src/lib/app/env-file.ts
 const ASSIGNMENT_KEY_PATTERN = /^\s*(?:export\s+)?([^#=\s]+)\s*=/;

package/dist/lib/app/local-dev.js

@@ -1,6 +1,6 @@
 import { resolveBunEntrypoint } from "./bun-project.js";
-import "node:fs/promises";
 import path from "node:path";
+import "node:fs/promises";
 import { spawn } from "node:child_process";
 //#region src/lib/app/local-dev.ts
 const DEFAULT_LOCAL_DEV_PORT = 3e3;

package/dist/lib/app/production-deploy-gate.js

@@ -1,6 +1,6 @@
 import { CliError } from "../../shell/errors.js";
-import { confirmPrompt } from "../../shell/prompt.js";
 import { canPrompt } from "../../shell/runtime.js";
+import { confirmPrompt } from "../../shell/prompt.js";
 //#region src/lib/app/production-deploy-gate.ts
 async function enforceProductionDeployGate(context, provider, options) {
 	if (options.branchKind !== "production") return { firstProductionDeploy: false };
@@ -25,6 +25,7 @@ async function enforceProductionDeployGate(context, provider, options) {
 	if (!await confirmPrompt({
 		input: context.runtime.stdin,
 		output: context.output.stderr,
+		signal: context.runtime.signal,
 		message: "Deploy to production?",
 		initialValue: false
 	})) throw productionDeployCancelledError();

package/dist/lib/auth/login.js

@@ -1,7 +1,7 @@
 import { getApiBaseUrl } from "./client.js";
 import { FileTokenStorage } from "../../adapters/token-storage.js";
-import open from "open";
 import { AuthError, createManagementApiSdk } from "@prisma/management-api-sdk";
+import open from "open";
 import events from "node:events";
 import http from "node:http";
 import readline from "node:readline/promises";

package/dist/lib/git/local-branch.js

@@ -1,5 +1,5 @@
-import { access, readFile } from "node:fs/promises";
 import path from "node:path";
+import { access, readFile } from "node:fs/promises";
 //#region src/lib/git/local-branch.ts
 /**
 * Resolves the checked-out branch the way git does: the nearest `.git`

package/dist/lib/project/interactive-setup.js

@@ -40,6 +40,7 @@ async function promptForProjectSetupChoice(options) {
 	const rawName = await textPrompt({
 		input: options.context.runtime.stdin,
 		output: options.context.runtime.stderr,
+		signal: options.context.runtime.signal,
 		message: "Project name",
 		placeholder: suggestedName.name,
 		validate: (value) => validateProjectSetupNameText(value, suggestedName.name)

package/dist/lib/project/local-pin.js

@@ -1,5 +1,5 @@
-import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import path from "node:path";
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import { Result, TaggedError, UnhandledException } from "better-result";
 //#region src/lib/project/local-pin.ts
 const LOCAL_RESOLUTION_PIN_RELATIVE_PATH = ".prisma/local.json";

package/dist/lib/project/resolution.js

@@ -1,8 +1,8 @@
+import { formatCommandArgument } from "../../shell/command-arguments.js";
 import { CliError } from "../../shell/errors.js";
 import { LOCAL_RESOLUTION_PIN_RELATIVE_PATH, readLocalResolutionPin } from "./local-pin.js";
-import { formatCommandArgument } from "../../shell/command-arguments.js";
-import { readFile } from "node:fs/promises";
 import path from "node:path";
+import { readFile } from "node:fs/promises";
 import { Result, TaggedError, matchError } from "better-result";
 //#region src/lib/project/resolution.ts
 var ProjectNotFoundError = class extends TaggedError("ProjectNotFoundError")() {

package/dist/lib/project/setup.js

@@ -1,7 +1,7 @@
+import "../../shell/command-arguments.js";
 import { CliError, usageError } from "../../shell/errors.js";
 import { shortenHomePath } from "../fs/home-path.js";
 import { LOCAL_RESOLUTION_PIN_RELATIVE_PATH, ensureLocalResolutionPinGitignore, writeLocalResolutionPin } from "./local-pin.js";
-import "../../shell/command-arguments.js";
 import { projectAmbiguousError, projectNotFoundError } from "./resolution.js";
 import path from "node:path";
 import { Result, matchError } from "better-result";

package/dist/presenters/agent.js

@@ -0,0 +1,74 @@
+import { formatShellCommand } from "../shell/command-arguments.js";
+import { formatDescriptorLabel } from "../shell/command-meta.js";
+import { renderSummaryLine } from "../shell/ui.js";
+//#region src/presenters/agent.ts
+function renderAgentInstall(context, descriptor, result) {
+	const ui = context.ui;
+	const rail = ui.dim("│");
+	return [
+		renderSummaryLine(ui, "success", `${formatDescriptorLabel(descriptor)} → ${operationSummary(result)} Prisma skills.`),
+		"",
+		`${rail}  ${ui.accent("skills:")}  ${result.skills.status.replace("-", " ")}`,
+		`${rail}  ${ui.dim(formatShellCommand(result.skills.command))}`
+	];
+}
+function renderAgentStatus(context, descriptor, result) {
+	const ui = context.ui;
+	const rail = ui.dim("│");
+	return [
+		`${ui.strong(formatDescriptorLabel(descriptor))} ${ui.dim("→")} ${ui.dim(`Checking ${result.statusScope} Prisma skills.`)}`,
+		"",
+		`${rail}  ${ui.accent("skills:")}  ${result.skillsInstalled ? "installed" : "not found"}`,
+		...renderInstalledSkills(context, result.skills),
+		`${rail}`,
+		`${rail}  ${ui.accent("source:")}  ${formatStatusSource(result)}`,
+		`${rail}  ${ui.dim(formatShellCommand(result.skillsListCommand))}`,
+		...renderProjectStatusDetails(context, result)
+	];
+}
+function serializeAgentInstall(result) {
+	return result;
+}
+function serializeAgentStatus(result) {
+	return result;
+}
+function formatSetupPromptStatus(result) {
+	if (result.skillsInstalled) return "not needed";
+	if (result.promptDismissedAt) return `dismissed ${result.promptDismissedAt}`;
+	return "active";
+}
+function formatStatusSource(result) {
+	if (result.statusSource === "skills-cli") return result.statusScope === "global" ? "skills list -g --json" : "skills list --json";
+	if (result.statusSource === "skills-lock") return result.skillsLockPath;
+	return "unavailable";
+}
+function renderProjectStatusDetails(context, result) {
+	if (result.statusScope !== "project") return [];
+	const ui = context.ui;
+	const rail = ui.dim("│");
+	return [
+		`${rail}`,
+		`${rail}  ${ui.accent("skills lock:")}  ${result.skillsLockInstalled ? "installed" : "not found"}`,
+		`${rail}  ${ui.dim(result.skillsLockPath)}`,
+		`${rail}`,
+		`${rail}  ${ui.accent("setup prompt:")}  ${formatSetupPromptStatus(result)}`
+	];
+}
+function renderInstalledSkills(context, skills) {
+	const ui = context.ui;
+	const rail = ui.dim("│");
+	if (skills.length === 0) return [`${rail}    ${ui.dim("No Prisma skills reported.")}`];
+	return skills.map((skill) => {
+		const agents = skill.agents.length > 0 ? skill.agents.join(", ") : "no agents reported";
+		return `${rail}    ${skill.name}  ${ui.dim(`${skill.scope}; ${agents}`)}`;
+	});
+}
+function operationSummary(result) {
+	if (result.skills.status === "would-install") return "Would install";
+	return operationLabel(result.operation);
+}
+function operationLabel(operation) {
+	return operation === "update" ? "Updated" : "Installed";
+}
+//#endregion
+export { renderAgentInstall, renderAgentStatus, serializeAgentInstall, serializeAgentStatus };

package/dist/presenters/auth.js

@@ -25,7 +25,7 @@ function renderAuthSuccess(context, descriptor, command, result) {
 			context: rows,
 			operationDescription: "Applying authentication session changes",
 			operationCount: 1,
-			details: ["Session stored in local CLI state."]
+			details: ["Session stored in local CLI state.", ...result.agentSetupTip ? [`Install Prisma skills for this project with ${result.agentSetupTip.command}.`] : []]
 		}, context.ui);
 	}
 	if (command === "auth.logout") return renderMutate({

package/dist/presenters/project.js

@@ -1,7 +1,7 @@
+import { formatCommandArgument } from "../shell/command-arguments.js";
 import { formatDescriptorLabel } from "../shell/command-meta.js";
 import { padDisplay, renderNextSteps, renderSummaryLine, renderVerboseBlock } from "../shell/ui.js";
 import { shortenHomePath } from "../lib/fs/home-path.js";
-import { formatCommandArgument } from "../shell/command-arguments.js";
 import { renderMutate, renderShow, serializeList } from "../output/patterns.js";
 import { renderResolvedProjectContextBlock } from "./verbose-context.js";
 import stringWidth from "string-width";

package/dist/shell/cli-command.js

@@ -0,0 +1,12 @@
+const PRISMA_CLI_PACKAGE_SPEC = `@prisma/cli@latest`;
+const DEFAULT_PRISMA_CLI_PACKAGE_RUNNER = ["npx", "-y"];
+const PRISMA_CLI_BINARY = "prisma-cli";
+function formatPrismaCliCommand(args, options = {}) {
+	return [...getPrismaCliCommandPrefix(options), ...args].join(" ");
+}
+function getPrismaCliCommandPrefix({ invocation = "package", packageRunner = DEFAULT_PRISMA_CLI_PACKAGE_RUNNER }) {
+	if (invocation === "binary") return [PRISMA_CLI_BINARY];
+	return [...packageRunner, PRISMA_CLI_PACKAGE_SPEC];
+}
+//#endregion
+export { formatPrismaCliCommand };

package/dist/shell/command-arguments.js

@@ -2,5 +2,11 @@
 function formatCommandArgument(value) {
 	return /^[A-Za-z0-9._/-]+$/.test(value) && !value.startsWith("-") ? value : `'${value.replace(/'/g, "'\\''")}'`;
 }
+function formatShellCommand(command) {
+	return command.map(formatShellCommandWord).join(" ");
+}
+function formatShellCommandWord(value) {
+	return /^[A-Za-z0-9_./:@=-]+$/.test(value) ? value : `'${value.replace(/'/g, "'\\''")}'`;
+}
 //#endregion
-export { formatCommandArgument };
+export { formatCommandArgument, formatShellCommand };

package/dist/shell/command-meta.js

@@ -1,5 +1,11 @@
+import { resolvePrismaCliPackageCommandFormatterSync } from "../lib/agent/cli-command.js";
+import { PRISMA_AGENT_INSTALL_ARGS, PRISMA_AGENT_STATUS_ARGS, PRISMA_AGENT_UPDATE_ARGS, PRISMA_COMPUTE_AGENT_SKILL } from "../lib/agent/constants.js";
 //#region src/shell/command-meta.ts
 const COMMAND_DESCRIPTOR_ID = Symbol("prisma.commandDescriptorId");
+function agentCommandExamples(runtime, commands) {
+	const formatCommand = resolvePrismaCliPackageCommandFormatterSync(runtime.cwd);
+	return commands.map((command) => formatCommand(command));
+}
 const DESCRIPTORS = [
 	{
 		id: "root",
@@ -14,6 +20,71 @@ const DESCRIPTORS = [
 		description: "Show CLI build and environment",
 		examples: ["prisma-cli version", "prisma-cli version --json"]
 	},
+	{
+		id: "agent",
+		path: ["prisma", "agent"],
+		description: "Install Prisma context for AI coding agents",
+		examples: (runtime) => agentCommandExamples(runtime, [
+			PRISMA_AGENT_INSTALL_ARGS,
+			PRISMA_AGENT_UPDATE_ARGS,
+			PRISMA_AGENT_STATUS_ARGS
+		])
+	},
+	{
+		id: "agent.install",
+		path: [
+			"prisma",
+			"agent",
+			"install"
+		],
+		description: "Install Prisma skills for AI coding agents",
+		examples: (runtime) => agentCommandExamples(runtime, [
+			PRISMA_AGENT_INSTALL_ARGS,
+			[
+				...PRISMA_AGENT_INSTALL_ARGS,
+				"--agent",
+				"codex"
+			],
+			[...PRISMA_AGENT_INSTALL_ARGS, "--all-agents"],
+			[
+				...PRISMA_AGENT_INSTALL_ARGS,
+				"--skill",
+				PRISMA_COMPUTE_AGENT_SKILL
+			]
+		])
+	},
+	{
+		id: "agent.update",
+		path: [
+			"prisma",
+			"agent",
+			"update"
+		],
+		description: "Refresh Prisma skills for AI coding agents",
+		examples: (runtime) => agentCommandExamples(runtime, [
+			PRISMA_AGENT_UPDATE_ARGS,
+			[
+				...PRISMA_AGENT_UPDATE_ARGS,
+				"--agent",
+				"codex"
+			],
+			[...PRISMA_AGENT_UPDATE_ARGS, "--all-agents"]
+		])
+	},
+	{
+		id: "agent.status",
+		path: [
+			"prisma",
+			"agent",
+			"status"
+		],
+		description: "Show installed Prisma skills",
+		examples: (runtime) => agentCommandExamples(runtime, [
+			PRISMA_AGENT_STATUS_ARGS,
+			[...PRISMA_AGENT_STATUS_ARGS, "--json"],
+			[...PRISMA_AGENT_STATUS_ARGS, "--global"]
+		])
+	},
 	{
 		id: "auth",
 		path: ["prisma", "auth"],

package/dist/shell/command-runner.js

@@ -2,9 +2,9 @@ import { CliError, authConfigInvalidError, authRequiredError, commandCanceledErr
 import { getCommandDescriptor } from "./command-meta.js";
 import { resolveGlobalFlags } from "./global-flags.js";
 import { createCommandContext } from "./runtime.js";
-import { cliErrorToJson, writeHumanError, writeHumanLines, writeJsonError, writeJsonEvent, writeJsonSuccess } from "./output.js";
 import { collectCommandDiagnostics } from "../lib/diagnostics.js";
 import { renderCommandDiagnostics } from "./diagnostics-output.js";
+import { cliErrorToJson, writeHumanError, writeHumanLines, writeJsonError, writeJsonEvent, writeJsonSuccess } from "./output.js";
 import { AuthError } from "@prisma/management-api-sdk";
 //#region src/shell/command-runner.ts
 function toCliError(error, runtime) {

package/dist/shell/help.js

@@ -1,6 +1,6 @@
 import { formatDescriptorLabel, getDescriptorForCommand } from "./command-meta.js";
-import { COMPACT_GLOBAL_OPTION_FLAGS, resolveGlobalFlags } from "./global-flags.js";
 import { createShellUi, padDisplay, wrapText } from "./ui.js";
+import { COMPACT_GLOBAL_OPTION_FLAGS, resolveGlobalFlags } from "./global-flags.js";
 //#region src/shell/help.ts
 function renderHelp(command, runtime) {
 	const descriptor = getDescriptorForCommand(command);
@@ -12,7 +12,7 @@ function renderHelp(command, runtime) {
 	if (visibleCommands.length > 0) lines.push(...renderCommandRows(rail, ui, visibleCommands));
 	lines.push(...renderLongDescription(rail, ui, descriptor.longDescription));
 	lines.push(...renderVisibleOptions(rail, ui, visibleCommands, visibleOptions));
-	lines.push(...renderExamples(rail, descriptor.examples));
+	lines.push(...renderExamples(rail, runtime, descriptor.examples));
 	lines.push(...renderDocsPath(rail, ui, descriptor.docsPath));
 	lines.push("");
 	return `${lines.join("\n")}`;
@@ -30,12 +30,13 @@ function renderVisibleOptions(rail, ui, visibleCommands, visibleOptions) {
 function shouldLabelGlobalOptions(visibleCommands, visibleOptions) {
 	return visibleCommands.length > 0 && visibleOptions.every((option) => COMPACT_GLOBAL_OPTION_FLAGS.includes(option.flags));
 }
-function renderExamples(rail, examples) {
-	if (!examples || examples.length === 0) return [];
+function renderExamples(rail, runtime, examples) {
+	const resolvedExamples = typeof examples === "function" ? examples(runtime) : examples;
+	if (!resolvedExamples || resolvedExamples.length === 0) return [];
 	return [
 		`${rail}`,
 		`${rail}  Examples:`,
-		...examples.map((example) => `${rail}    $ ${example}`)
+		...resolvedExamples.map((example) => `${rail}    $ ${example}`)
 	];
 }
 function renderDocsPath(rail, ui, docsPath) {