@react-grab/cli 0.1.37 → 0.1.39

package/dist/cli.cjs

@@ -31,19 +31,15 @@ node_path = __toESM(node_path, 1);
 let package_manager_detector_detect = require("package-manager-detector/detect");
 let ignore = require("ignore");
 ignore = __toESM(ignore, 1);
-let node_os = require("node:os");
-node_os = __toESM(node_os, 1);
-let node_process = require("node:process");
-node_process = __toESM(node_process, 1);
-let jsonc_parser = require("jsonc-parser");
-jsonc_parser = __toESM(jsonc_parser, 1);
-let smol_toml = require("smol-toml");
-smol_toml = __toESM(smol_toml, 1);
+let node_url = require("node:url");
+let agent_install_skill = require("agent-install/skill");
 let prompts = require("prompts");
 prompts = __toESM(prompts, 1);
 let ora = require("ora");
 ora = __toESM(ora, 1);
 let tinyexec = require("tinyexec");
+let node_child_process = require("node:child_process");
+let node_crypto = require("node:crypto");
 //#region src/utils/is-non-interactive.ts
 const AGENT_ENVIRONMENT_VARIABLES = [
 	"CI",
@@ -72,24 +68,61 @@ const detectPackageManager = async (projectRoot) => {
 	}
 	return "npm";
 };
-const detectFramework = (projectRoot) => {
+const CONFIG_EXTENSIONS = [
+	"ts",
+	"mts",
+	"cts",
+	"js",
+	"mjs",
+	"cjs"
+];
+const hasConfigFile = (projectRoot, configBaseName) => CONFIG_EXTENSIONS.some((extension) => (0, node_fs.existsSync)((0, node_path.join)(projectRoot, `${configBaseName}.${extension}`)));
+const readMergedDependencies = (projectRoot) => {
 	const packageJsonPath = (0, node_path.join)(projectRoot, "package.json");
-	if (!(0, node_fs.existsSync)(packageJsonPath)) return "unknown";
+	if (!(0, node_fs.existsSync)(packageJsonPath)) return null;
 	try {
 		const packageJson = JSON.parse((0, node_fs.readFileSync)(packageJsonPath, "utf-8"));
-		const allDependencies = {
+		return {
 			...packageJson.dependencies,
 			...packageJson.devDependencies
 		};
-		if (allDependencies["next"]) return "next";
-		if (allDependencies["@tanstack/react-start"]) return "tanstack";
-		if (allDependencies["vite"]) return "vite";
-		if (allDependencies["webpack"]) return "webpack";
-		return "unknown";
 	} catch {
-		return "unknown";
+		return null;
 	}
 };
+const detectFrameworkFromDependencies = (dependencies) => {
+	if (!dependencies) return "unknown";
+	if (dependencies["next"]) return "next";
+	if (dependencies["@tanstack/react-start"]) return "tanstack";
+	if (dependencies["vite"]) return "vite";
+	if (dependencies["webpack"]) return "webpack";
+	return "unknown";
+};
+const detectFrameworkFromConfigFiles = (projectRoot) => {
+	if (hasConfigFile(projectRoot, "next.config")) return "next";
+	if (hasConfigFile(projectRoot, "app.config")) return "tanstack";
+	if (hasConfigFile(projectRoot, "vite.config")) return "vite";
+	if (hasConfigFile(projectRoot, "webpack.config")) return "webpack";
+	return "unknown";
+};
+const findEnclosingMonorepoRoot = (projectRoot) => {
+	let currentDirectory = (0, node_path.dirname)(projectRoot);
+	while (currentDirectory !== (0, node_path.dirname)(currentDirectory)) {
+		if (detectMonorepo(currentDirectory)) return currentDirectory;
+		currentDirectory = (0, node_path.dirname)(currentDirectory);
+	}
+	return null;
+};
+const detectFramework = (projectRoot) => {
+	const localFramework = detectFrameworkFromDependencies(readMergedDependencies(projectRoot));
+	if (localFramework !== "unknown") return localFramework;
+	return detectFrameworkFromConfigFiles(projectRoot);
+};
+const detectFrameworkFromMonorepoRoot = (projectRoot) => {
+	const monorepoRoot = findEnclosingMonorepoRoot(projectRoot);
+	if (!monorepoRoot) return "unknown";
+	return detectFrameworkFromDependencies(readMergedDependencies(monorepoRoot));
+};
 const detectNextRouterType = (projectRoot) => {
 	const hasAppDir = (0, node_fs.existsSync)((0, node_path.join)(projectRoot, "app"));
 	const hasSrcAppDir = (0, node_fs.existsSync)((0, node_path.join)(projectRoot, "src", "app"));
@@ -162,18 +195,9 @@ const expandWorkspacePattern = (projectRoot, pattern) => {
 	return results;
 };
 const hasReactDependency = (projectPath) => {
-	const packageJsonPath = (0, node_path.join)(projectPath, "package.json");
-	if (!(0, node_fs.existsSync)(packageJsonPath)) return false;
-	try {
-		const packageJson = JSON.parse((0, node_fs.readFileSync)(packageJsonPath, "utf-8"));
-		const allDeps = {
-			...packageJson.dependencies,
-			...packageJson.devDependencies
-		};
-		return Boolean(allDeps["react"] || allDeps["react-dom"]);
-	} catch {
-		return false;
-	}
+	const dependencies = readMergedDependencies(projectPath);
+	if (!dependencies) return false;
+	return Boolean(dependencies["react"] || dependencies["react-dom"]);
 };
 const buildReactProject = (projectPath) => {
 	const framework = detectFramework(projectPath);
@@ -275,14 +299,7 @@ const hasReactGrabInFile = (filePath) => {
 	}
 };
 const detectReactGrab = (projectRoot) => {
-	const packageJsonPath = (0, node_path.join)(projectRoot, "package.json");
-	if ((0, node_fs.existsSync)(packageJsonPath)) try {
-		const packageJson = JSON.parse((0, node_fs.readFileSync)(packageJsonPath, "utf-8"));
-		if ({
-			...packageJson.dependencies,
-			...packageJson.devDependencies
-		}["react-grab"]) return true;
-	} catch {}
+	if (readMergedDependencies(projectRoot)?.["react-grab"]) return true;
 	return [
 		(0, node_path.join)(projectRoot, "app", "layout.tsx"),
 		(0, node_path.join)(projectRoot, "app", "layout.jsx"),
@@ -307,22 +324,13 @@ const detectReactGrab = (projectRoot) => {
 	].some(hasReactGrabInFile);
 };
 const detectUnsupportedFramework = (projectRoot) => {
-	const packageJsonPath = (0, node_path.join)(projectRoot, "package.json");
-	if (!(0, node_fs.existsSync)(packageJsonPath)) return null;
-	try {
-		const packageJson = JSON.parse((0, node_fs.readFileSync)(packageJsonPath, "utf-8"));
-		const allDependencies = {
-			...packageJson.dependencies,
-			...packageJson.devDependencies
-		};
-		if (allDependencies["@remix-run/react"] || allDependencies["remix"]) return "remix";
-		if (allDependencies["astro"]) return "astro";
-		if (allDependencies["@sveltejs/kit"]) return "sveltekit";
-		if (allDependencies["gatsby"]) return "gatsby";
-		return null;
-	} catch {
-		return null;
-	}
+	const dependencies = readMergedDependencies(projectRoot);
+	if (!dependencies) return null;
+	if (dependencies["@remix-run/react"] || dependencies["remix"]) return "remix";
+	if (dependencies["astro"]) return "astro";
+	if (dependencies["@sveltejs/kit"]) return "sveltekit";
+	if (dependencies["gatsby"]) return "gatsby";
+	return null;
 };
 const detectReactGrabVersion = (projectRoot) => {
 	const installedPackageJsonPath = (0, node_path.join)(projectRoot, "node_modules", "react-grab", "package.json");
@@ -332,7 +340,8 @@ const detectReactGrabVersion = (projectRoot) => {
 	return null;
 };
 const detectProject = async (projectRoot = process.cwd()) => {
-	const framework = detectFramework(projectRoot);
+	const localFramework = detectFramework(projectRoot);
+	const framework = localFramework === "unknown" ? detectFrameworkFromMonorepoRoot(projectRoot) : localFramework;
 	return {
 		packageManager: await detectPackageManager(projectRoot),
 		framework,
@@ -384,6 +393,45 @@ const handleError = (error) => {
 	process.exit(1);
 };
 //#endregion
+//#region src/utils/detect-agents.ts
+const PATH_BINARIES = {
+	"claude-code": ["claude"],
+	codex: ["codex"],
+	cursor: ["cursor", "cursor-agent"],
+	droid: ["droid"],
+	"gemini-cli": ["gemini"],
+	"github-copilot": ["copilot"],
+	opencode: ["opencode"],
+	pi: ["pi", "omegon"]
+};
+const isCommandAvailable = (command) => {
+	const pathDirectories = (process.env.PATH ?? "").split(node_path.delimiter).filter(Boolean);
+	for (const directory of pathDirectories) {
+		const binaryPath = (0, node_path.join)(directory, command);
+		try {
+			if ((0, node_fs.statSync)(binaryPath).isFile()) {
+				(0, node_fs.accessSync)(binaryPath, node_fs.constants.X_OK);
+				return true;
+			}
+		} catch {}
+	}
+	return false;
+};
+const detectAvailableAgents = async () => {
+	const installedAgents = new Set(await (0, agent_install_skill.detectInstalledSkillAgents)());
+	return (0, agent_install_skill.getSkillAgentTypes)().filter((agent) => {
+		if (agent === "universal") return false;
+		if (installedAgents.has(agent)) return true;
+		return PATH_BINARIES[agent]?.some(isCommandAvailable) ?? false;
+	});
+};
+//#endregion
+//#region src/utils/unref-stdin.ts
+const unrefStdin = () => {
+	if (process.stdin.isTTY) return;
+	process.stdin.unref?.();
+};
+//#endregion
 //#region src/utils/prompts.ts
 const onCancel = () => {
 	logger.break();
@@ -392,210 +440,74 @@ const onCancel = () => {
 	process.exit(0);
 };
 const prompts$1 = (questions) => {
-	return (0, prompts.default)(questions, { onCancel });
+	return (0, prompts.default)(questions, { onCancel }).finally(unrefStdin);
 };
 //#endregion
 //#region src/utils/spinner.ts
 const spinner = (text) => (0, ora.default)({ text });
 //#endregion
-//#region src/utils/install-mcp.ts
-const SERVER_NAME = "react-grab-mcp";
-const PACKAGE_NAME = "@react-grab/mcp";
-const getXdgConfigHome = () => node_process.default.env.XDG_CONFIG_HOME || node_path.default.join(node_os.default.homedir(), ".config");
-const getBaseDir = () => {
-	const homeDir = node_os.default.homedir();
-	if (node_process.default.platform === "win32") return node_process.default.env.APPDATA || node_path.default.join(homeDir, "AppData", "Roaming");
-	if (node_process.default.platform === "darwin") return node_path.default.join(homeDir, "Library", "Application Support");
-	return getXdgConfigHome();
-};
-const getZedConfigPath = () => {
-	if (node_process.default.platform === "win32") return node_path.default.join(getBaseDir(), "Zed", "settings.json");
-	return node_path.default.join(node_os.default.homedir(), ".config", "zed", "settings.json");
-};
-const getOpenCodeConfigPath = () => {
-	const configDir = node_path.default.join(getXdgConfigHome(), "opencode");
-	const jsoncPath = node_path.default.join(configDir, "opencode.jsonc");
-	const jsonPath = node_path.default.join(configDir, "opencode.json");
-	if (node_fs.default.existsSync(jsoncPath)) return jsoncPath;
-	if (node_fs.default.existsSync(jsonPath)) return jsonPath;
-	return jsoncPath;
-};
-const getClients = () => {
-	const homeDir = node_os.default.homedir();
-	const baseDir = getBaseDir();
-	const stdioConfig = {
-		command: "npx",
-		args: [
-			"-y",
-			PACKAGE_NAME,
-			"--stdio"
-		]
-	};
-	return [
-		{
-			name: "Claude Code",
-			configPath: node_path.default.join(homeDir, ".claude.json"),
-			configKey: "mcpServers",
-			format: "json",
-			serverConfig: stdioConfig
-		},
-		{
-			name: "Codex",
-			configPath: node_path.default.join(node_process.default.env.CODEX_HOME || node_path.default.join(homeDir, ".codex"), "config.toml"),
-			configKey: "mcp_servers",
-			format: "toml",
-			serverConfig: stdioConfig
-		},
-		{
-			name: "Cursor",
-			configPath: node_path.default.join(homeDir, ".cursor", "mcp.json"),
-			configKey: "mcpServers",
-			format: "json",
-			serverConfig: stdioConfig
-		},
-		{
-			name: "OpenCode",
-			configPath: getOpenCodeConfigPath(),
-			configKey: "mcp",
-			format: "json",
-			serverConfig: {
-				type: "local",
-				command: [
-					"npx",
-					"-y",
-					PACKAGE_NAME,
-					"--stdio"
-				]
-			}
-		},
-		{
-			name: "VS Code",
-			configPath: node_path.default.join(baseDir, "Code", "User", "mcp.json"),
-			configKey: "servers",
-			format: "json",
-			serverConfig: {
-				type: "stdio",
-				...stdioConfig
-			}
-		},
-		{
-			name: "Amp",
-			configPath: node_path.default.join(homeDir, ".config", "amp", "settings.json"),
-			configKey: "amp.mcpServers",
-			format: "json",
-			serverConfig: stdioConfig
-		},
-		{
-			name: "Droid",
-			configPath: node_path.default.join(homeDir, ".factory", "mcp.json"),
-			configKey: "mcpServers",
-			format: "json",
-			serverConfig: {
-				type: "stdio",
-				...stdioConfig
-			}
-		},
-		{
-			name: "Windsurf",
-			configPath: node_path.default.join(homeDir, ".codeium", "windsurf", "mcp_config.json"),
-			configKey: "mcpServers",
-			format: "json",
-			serverConfig: stdioConfig
-		},
-		{
-			name: "Zed",
-			configPath: getZedConfigPath(),
-			configKey: "context_servers",
-			format: "json",
-			serverConfig: {
-				source: "custom",
-				...stdioConfig,
-				env: {}
-			}
-		}
-	];
-};
-const ensureDirectory = (filePath) => {
-	const directory = node_path.default.dirname(filePath);
-	if (!node_fs.default.existsSync(directory)) node_fs.default.mkdirSync(directory, { recursive: true });
-};
-const JSONC_FORMAT_OPTIONS = {
-	tabSize: 2,
-	insertSpaces: true
-};
-const upsertIntoJsonc = (filePath, content, configKey, serverName, serverConfig) => {
-	const edits = jsonc_parser.modify(content, [configKey, serverName], serverConfig, { formattingOptions: JSONC_FORMAT_OPTIONS });
-	node_fs.default.writeFileSync(filePath, jsonc_parser.applyEdits(content, edits));
-};
-const installJsonClient = (client) => {
-	ensureDirectory(client.configPath);
-	const content = node_fs.default.existsSync(client.configPath) ? node_fs.default.readFileSync(client.configPath, "utf8") : "{}";
-	upsertIntoJsonc(client.configPath, content, client.configKey, SERVER_NAME, client.serverConfig);
-};
-const installTomlClient = (client) => {
-	ensureDirectory(client.configPath);
-	const existingConfig = node_fs.default.existsSync(client.configPath) ? smol_toml.parse(node_fs.default.readFileSync(client.configPath, "utf8")) : {};
-	const serverSection = existingConfig[client.configKey] ?? {};
-	serverSection[SERVER_NAME] = client.serverConfig;
-	existingConfig[client.configKey] = serverSection;
-	node_fs.default.writeFileSync(client.configPath, smol_toml.stringify(existingConfig));
-};
-const getMcpClientNames = () => getClients().map((client) => client.name);
-const installMcpServers = (selectedClients) => {
-	const allClients = getClients();
-	const clients = selectedClients ? allClients.filter((client) => selectedClients.includes(client.name)) : allClients;
-	const results = [];
-	const installSpinner = spinner("Installing MCP server.").start();
-	for (const client of clients) try {
-		if (client.format === "toml") installTomlClient(client);
-		else installJsonClient(client);
-		results.push({
-			client: client.name,
-			configPath: client.configPath,
-			success: true
-		});
-	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error);
-		results.push({
-			client: client.name,
-			configPath: client.configPath,
-			success: false,
-			error: message
+//#region src/utils/install-skill.ts
+const SKILL_NAME = "react-grab";
+const SKILL_SOURCE = (0, node_url.fileURLToPath)(new URL("../skills/react-grab", require("url").pathToFileURL(__filename).href));
+const agentLabel = (agent) => (0, agent_install_skill.getSkillAgentConfig)(agent).displayName;
+const installedSkillDir = (agent) => (0, node_path.join)((0, agent_install_skill.isUniversalSkillAgent)(agent) ? (0, agent_install_skill.getCanonicalSkillsDir)(true) : (0, agent_install_skill.getSkillAgentDir)(agent, { global: true }), SKILL_NAME);
+const promptSkillInstall = async ({ yes = false } = {}) => {
+	const detectedAgents = await detectAvailableAgents();
+	if (detectedAgents.length === 0) {
+		logger.warn("No supported agents detected.");
+		return false;
+	}
+	let selectedAgents = detectedAgents;
+	if (!yes) {
+		const { agents } = await prompts$1({
+			type: "multiselect",
+			name: "agents",
+			message: "Install the React Grab skill for:",
+			choices: detectedAgents.map((agent) => ({
+				title: agentLabel(agent),
+				value: agent,
+				selected: true
+			})),
+			instructions: false,
+			min: 1
 		});
+		selectedAgents = agents ?? [];
+		if (selectedAgents.length === 0) return false;
 	}
-	const successCount = results.filter((result) => result.success).length;
-	if (successCount < results.length) installSpinner.warn(`Installed to ${successCount}/${results.length} agents.`);
-	else installSpinner.succeed(`Installed to ${successCount} agents.`);
-	for (const result of results) if (result.success) logger.log(`  ${highlighter.success("✓")} ${result.client} ${highlighter.dim("→")} ${highlighter.dim(result.configPath)}`);
-	else logger.log(`  ${highlighter.error("✗")} ${result.client} ${highlighter.dim("→")} ${result.error}`);
-	return results;
+	const installSpinner = spinner("Installing React Grab skill.").start();
+	const { installed, failed } = await (0, agent_install_skill.add)({
+		source: SKILL_SOURCE,
+		agents: selectedAgents,
+		global: true,
+		mode: "copy"
+	});
+	if (installed.length === 0) {
+		installSpinner.fail("Failed to install React Grab skill.");
+		return false;
+	}
+	installSpinner.succeed(`Installed React Grab skill for ${installed.map((record) => agentLabel(record.agent)).join(", ")}.`);
+	for (const record of failed) logger.log(`  ${highlighter.error("✗")} ${agentLabel(record.agent)} ${record.error}`);
+	return true;
 };
-const promptMcpInstall = async () => {
-	const { selectedAgents } = await prompts$1({
-		type: "multiselect",
-		name: "selectedAgents",
-		message: "Select agents to install MCP server for:",
-		choices: getMcpClientNames().map((name) => ({
-			title: name,
-			value: name,
-			selected: true
-		}))
+const removeSkill = async () => {
+	const agentsWithSkill = (await detectAvailableAgents()).filter((agent) => (0, node_fs.existsSync)(installedSkillDir(agent)));
+	for (const skillDir of new Set(agentsWithSkill.map(installedSkillDir))) (0, node_fs.rmSync)(skillDir, {
+		recursive: true,
+		force: true
 	});
-	if (selectedAgents === void 0 || selectedAgents.length === 0) return false;
-	logger.break();
-	return installMcpServers(selectedAgents).some((result) => result.success);
+	for (const agent of agentsWithSkill) logger.log(`  ${highlighter.success("✓")} ${agentLabel(agent)}`);
+	return agentsWithSkill.length;
 };
 //#endregion
 //#region src/commands/add.ts
-const VERSION$5 = "0.1.37";
-const add = new commander.Command().name("add").alias("install").description("connect React Grab to your agent via MCP").argument("[agent]", "agent to connect (mcp)").option("-y, --yes", "skip confirmation prompts", false).option("-c, --cwd <cwd>", "working directory (defaults to current directory)", process.cwd()).action(async (agentArg, opts) => {
+const VERSION$5 = "0.1.39";
+const add = new commander.Command().name("add").alias("install").description("install the React Grab skill for your agent").option("-y, --yes", "skip confirmation prompts", false).option("-c, --cwd <cwd>", "working directory (defaults to current directory)", process.cwd()).action(async (opts) => {
 	console.log(`${picocolors.default.magenta("✿")} ${picocolors.default.bold("React Grab")} ${picocolors.default.gray(VERSION$5)}`);
 	console.log();
 	try {
-		const cwd = opts.cwd;
 		const isNonInteractive = detectNonInteractive(opts.yes);
 		const preflightSpinner = spinner("Preflight checks.").start();
-		if (!(await detectProject(cwd)).hasReactGrab) {
+		if (!(await detectProject(opts.cwd)).hasReactGrab) {
 			preflightSpinner.fail("React Grab is not installed.");
 			logger.break();
 			logger.error(`Run ${highlighter.info("react-grab init")} first to install React Grab.`);
@@ -603,39 +515,12 @@ const add = new commander.Command().name("add").alias("install").description("co
 			process.exit(1);
 		}
 		preflightSpinner.succeed();
-		if (agentArg && agentArg !== "mcp") {
-			logger.break();
-			logger.warn(`Legacy agent packages are deprecated. Use ${highlighter.info("mcp")} instead.`);
-			logger.log(`Run ${highlighter.info("grab add mcp")} to install the MCP server.`);
+		logger.break();
+		if (!await promptSkillInstall({ yes: isNonInteractive }) && isNonInteractive) {
 			logger.break();
 			process.exit(1);
 		}
-		if (agentArg === "mcp" || isNonInteractive) {
-			if (isNonInteractive) {
-				if (!installMcpServers().some((result) => result.success)) {
-					logger.break();
-					logger.error("Failed to install MCP server.");
-					logger.break();
-					process.exit(1);
-				}
-			} else if (!await promptMcpInstall()) {
-				logger.break();
-				process.exit(0);
-			}
-			logger.break();
-			logger.log(`${highlighter.success("Success!")} MCP server has been configured.`);
-			logger.log("Restart your agents to activate.");
-			logger.break();
-		} else {
-			if (!await promptMcpInstall()) {
-				logger.break();
-				process.exit(0);
-			}
-			logger.break();
-			logger.log(`${highlighter.success("Success!")} MCP server has been configured.`);
-			logger.log("Restart your agents to activate.");
-			logger.break();
-		}
+		logger.break();
 	} catch (error) {
 		handleError(error);
 	}
@@ -1018,6 +903,15 @@ const transformTanStack = (projectRoot, reactGrabAlreadyConfigured, force = fals
 		newContent
 	};
 };
+const hasFrameworkEntryPoint = (projectRoot, framework, nextRouterType) => {
+	switch (framework) {
+		case "next": return nextRouterType === "app" ? findLayoutFile(projectRoot) !== null : findDocumentFile(projectRoot) !== null;
+		case "vite":
+		case "webpack": return findEntryFile(projectRoot) !== null;
+		case "tanstack": return findTanStackRootFile(projectRoot) !== null;
+		default: return false;
+	}
+};
 const previewTransform = (projectRoot, framework, nextRouterType, reactGrabAlreadyConfigured = false, force = false) => {
 	switch (framework) {
 		case "next":
@@ -1217,7 +1111,7 @@ const formatActivationKeyDisplay = (activationKey) => {
 };
 //#endregion
 //#region src/commands/configure.ts
-const VERSION$4 = "0.1.37";
+const VERSION$4 = "0.1.39";
 const isMac = process.platform === "darwin";
 const META_LABEL = isMac ? "Cmd" : "Win";
 const ALT_LABEL = isMac ? "Option" : "Alt";
@@ -1836,7 +1730,7 @@ const installPackagesWithFeedback = async (packages, packageManager, projectRoot
 };
 //#endregion
 //#region src/commands/init.ts
-const VERSION$3 = "0.1.37";
+const VERSION$3 = "0.1.39";
 const REPORT_URL = "https://react-grab.com/api/report-cli";
 const DOCS_URL = "https://github.com/aidenybai/react-grab";
 const reportToCli = (type, config, error) => {
@@ -1894,6 +1788,15 @@ const printSubprojects = (searchRoot, sortedProjects) => {
 	logger.log(`  ${highlighter.dim("$")} npx grab@latest init -c ${(0, node_path.relative)(searchRoot, sortedProjects[0].path)}`);
 	logger.break();
 };
+const SUPPORTED_FRAMEWORKS_LINE = "React Grab supports Next.js, Vite, TanStack Start, and Webpack projects.";
+const failWithManualSetup = (failingSpinner, message, { listSupportedFrameworks = false } = {}) => {
+	failingSpinner.fail(message);
+	logger.break();
+	if (listSupportedFrameworks) logger.log(SUPPORTED_FRAMEWORKS_LINE);
+	logger.log(`Visit ${highlighter.info(DOCS_URL)} for manual setup.`);
+	logger.break();
+	process.exit(1);
+};
 const init = new commander.Command().name("init").alias("setup").description("initialize React Grab in your project").option("-y, --yes", "skip confirmation prompts", false).option("-f, --force", "force overwrite existing config", false).option("-k, --key <key>", "activation key (e.g., Meta+K, Ctrl+Shift+G, Space)").option("--skip-install", "skip package installation", false).option("--pkg <pkg>", "custom package URL for CLI (e.g., grab)").option("-c, --cwd <cwd>", "working directory (defaults to current directory)", process.cwd()).action(async (opts) => {
 	console.log(`${picocolors.default.magenta("✿")} ${picocolors.default.bold("React Grab")} ${picocolors.default.gray(VERSION$3)}`);
 	console.log();
@@ -2052,25 +1955,7 @@ const init = new commander.Command().name("init").alias("setup").description("in
 				}
 			}
 			logger.break();
-			const { wantAddMcp } = await prompts$1({
-				type: "confirm",
-				name: "wantAddMcp",
-				message: `Would you like to ${highlighter.info("connect it to your agent via MCP")}?`,
-				initial: false
-			});
-			if (wantAddMcp === void 0) {
-				logger.break();
-				process.exit(1);
-			}
-			if (wantAddMcp) {
-				if (!await promptMcpInstall()) {
-					logger.break();
-					process.exit(0);
-				}
-				logger.break();
-				logger.success("MCP server has been configured.");
-				logger.log("Restart your agents to activate.");
-			}
+			await promptSkillInstall({ yes: isNonInteractive });
 			logger.break();
 			process.exit(0);
 		}
@@ -2085,7 +1970,7 @@ const init = new commander.Command().name("init").alias("setup").description("in
 			logger.break();
 			process.exit(1);
 		}
-		if (projectInfo.framework === "unknown") {
+		if (projectInfo.framework === "unknown" || projectInfo.isMonorepo && !hasFrameworkEntryPoint(projectInfo.projectRoot, projectInfo.framework, projectInfo.nextRouterType)) {
 			let searchRoot = cwd;
 			let reactProjects = findReactProjects(searchRoot);
 			if (reactProjects.length === 0 && cwd !== process.cwd()) {
@@ -2122,45 +2007,21 @@ const init = new commander.Command().name("init").alias("setup").description("in
 				process.chdir(selectedProject);
 				const newProjectInfo = await detectProject(selectedProject);
 				Object.assign(projectInfo, newProjectInfo);
-				spinner("Verifying framework.").start().succeed(`Verifying framework. Found ${highlighter.info(FRAMEWORK_NAMES[newProjectInfo.framework])}.`);
-			} else {
-				frameworkSpinner.fail("Could not detect a supported framework.");
-				logger.break();
-				logger.log("React Grab supports Next.js, Vite, TanStack Start, and Webpack projects.");
-				logger.log(`Visit ${highlighter.info(DOCS_URL)} for manual setup.`);
-				logger.break();
-				process.exit(1);
-			}
+				const newFrameworkSpinner = spinner("Verifying framework.").start();
+				if (newProjectInfo.framework === "unknown") failWithManualSetup(newFrameworkSpinner, "Could not detect a supported framework in this project.", { listSupportedFrameworks: true });
+				newFrameworkSpinner.succeed(`Verifying framework. Found ${highlighter.info(FRAMEWORK_NAMES[newProjectInfo.framework])}.`);
+			} else if (projectInfo.framework !== "unknown") failWithManualSetup(frameworkSpinner, `Verifying framework. Found ${highlighter.info(FRAMEWORK_NAMES[projectInfo.framework])}, but could not find an entry file.`);
+			else failWithManualSetup(frameworkSpinner, "Could not detect a supported framework.", { listSupportedFrameworks: true });
 		} else frameworkSpinner.succeed(`Verifying framework. Found ${highlighter.info(FRAMEWORK_NAMES[projectInfo.framework])}.`);
 		if (projectInfo.framework === "next") spinner("Detecting router type.").start().succeed(`Detecting router type. Found ${highlighter.info(projectInfo.nextRouterType === "app" ? "App Router" : "Pages Router")}.`);
 		spinner("Detecting package manager.").start().succeed(`Detecting package manager. Found ${highlighter.info(PACKAGE_MANAGER_NAMES[projectInfo.packageManager])}.`);
 		const finalFramework = projectInfo.framework;
 		const finalPackageManager = projectInfo.packageManager;
 		const finalNextRouterType = projectInfo.nextRouterType;
-		let didInstallMcp = false;
+		let didInstallSkill = false;
 		if (!isNonInteractive) {
 			logger.break();
-			const { wantAddMcp } = await prompts$1({
-				type: "confirm",
-				name: "wantAddMcp",
-				message: `Would you like to ${highlighter.info("connect it to your agent via MCP")}?`,
-				initial: false
-			});
-			if (wantAddMcp === void 0) {
-				logger.break();
-				process.exit(1);
-			}
-			if (wantAddMcp) {
-				didInstallMcp = Boolean(await promptMcpInstall());
-				if (!didInstallMcp) {
-					logger.break();
-					process.exit(0);
-				}
-				logger.break();
-				logger.success("MCP server has been configured.");
-				logger.log("Continuing with React Grab installation...");
-				logger.break();
-			}
+			didInstallSkill = await promptSkillInstall({ yes: isNonInteractive });
 		}
 		const result = previewTransform(projectInfo.projectRoot, finalFramework, finalNextRouterType, false, opts.force);
 		if (!result.success) {
@@ -2204,7 +2065,7 @@ const init = new commander.Command().name("init").alias("setup").description("in
 			framework: finalFramework,
 			packageManager: finalPackageManager,
 			router: finalNextRouterType,
-			agent: didInstallMcp ? "mcp" : void 0,
+			agent: didInstallSkill ? "skill" : void 0,
 			isMonorepo: projectInfo.isMonorepo
 		});
 	} catch (error) {
@@ -2214,29 +2075,16 @@ const init = new commander.Command().name("init").alias("setup").description("in
 });
 //#endregion
 //#region src/commands/remove.ts
-const VERSION$2 = "0.1.37";
-const remove = new commander.Command().name("remove").description("disconnect React Grab from your agent").argument("[agent]", "agent to disconnect (mcp)").option("-y, --yes", "skip confirmation prompts", false).option("-c, --cwd <cwd>", "working directory (defaults to current directory)", process.cwd()).action(async (agentArg, opts) => {
+const VERSION$2 = "0.1.39";
+const remove = new commander.Command().name("remove").description("uninstall the React Grab skill from your agent").action(async () => {
 	console.log(`${picocolors.default.magenta("✿")} ${picocolors.default.bold("React Grab")} ${picocolors.default.gray(VERSION$2)}`);
 	console.log();
 	try {
-		const cwd = opts.cwd;
-		const preflightSpinner = spinner("Preflight checks.").start();
-		if (!(await detectProject(cwd)).hasReactGrab) {
-			preflightSpinner.fail("React Grab is not installed.");
-			logger.break();
-			logger.error(`Run ${highlighter.info("react-grab init")} first to install React Grab.`);
-			logger.break();
-			process.exit(1);
-		}
-		preflightSpinner.succeed();
-		if (agentArg && agentArg !== "mcp") {
-			logger.break();
-			logger.warn(`Legacy agent packages are deprecated. Uninstall ${highlighter.info(`@react-grab/${agentArg}`)} manually with your package manager.`);
-			logger.break();
-			process.exit(0);
-		}
 		logger.break();
-		logger.warn("To remove the MCP server, delete the react-grab-mcp entry from your agent's MCP config file.");
+		const removedCount = await removeSkill();
+		logger.break();
+		if (removedCount === 0) logger.log("React Grab skill is not installed in any detected agent.");
+		else logger.log(`${highlighter.success("Removed")} the React Grab skill from ${removedCount} agent${removedCount === 1 ? "" : "s"}.`);
 		logger.break();
 	} catch (error) {
 		handleError(error);
@@ -2244,7 +2092,7 @@ const remove = new commander.Command().name("remove").description("disconnect Re
 });
 //#endregion
 //#region src/commands/upgrade.ts
-const VERSION$1 = "0.1.37";
+const VERSION$1 = "0.1.39";
 const NPM_REGISTRY_URL = "https://registry.npmjs.org/react-grab/latest";
 const fetchLatestVersion = async () => {
 	try {
@@ -2318,8 +2166,368 @@ const upgrade = new commander.Command().name("upgrade").alias("update").descript
 	}
 });
 //#endregion
+//#region src/utils/clipboard.ts
+const READ_TIMEOUT_MS = 2500;
+const MAX_CLIPBOARD_BYTES = 64 * 1024 * 1024;
+const ID_RADIX = 36;
+const HASH_LENGTH = 12;
+const PICKLE_HEADER_BYTES = 4;
+const PICKLE_ALIGN_BYTES = 4;
+const SIGNATURE_SCAN_CHARS = 32 * 1024;
+const GRAB_MIME = "application/x-react-grab";
+const CHROMIUM_CUSTOM_FORMAT = "chromium/x-web-custom-data";
+const GRAB_TEXT_SIGNATURE = /\bin\s+\S+\s+\(at\s+[^\n]{1,400}?:\d+:\d+\)/;
+const sleep = (durationMs) => new Promise((resolve) => setTimeout(resolve, durationMs));
+const shortHash = (text) => (0, node_crypto.createHash)("sha1").update(text).digest("hex").slice(0, HASH_LENGTH);
+const alignUp = (value) => value + PICKLE_ALIGN_BYTES - 1 & ~(PICKLE_ALIGN_BYTES - 1);
+const parseChromiumPickle = (buffer) => {
+	const formats = {};
+	if (!buffer || buffer.length < PICKLE_HEADER_BYTES + 4) return formats;
+	let offset = PICKLE_HEADER_BYTES;
+	const pairCount = buffer.readUInt32LE(offset);
+	offset += 4;
+	for (let pairIndex = 0; pairIndex < pairCount; pairIndex += 1) {
+		if (offset + 4 > buffer.length) break;
+		const formatCodeUnits = buffer.readUInt32LE(offset);
+		offset += 4;
+		if (offset + formatCodeUnits * 2 > buffer.length) break;
+		const format = buffer.toString("utf16le", offset, offset + formatCodeUnits * 2);
+		offset = alignUp(offset + formatCodeUnits * 2);
+		if (offset + 4 > buffer.length) break;
+		const dataCodeUnits = buffer.readUInt32LE(offset);
+		offset += 4;
+		if (offset + dataCodeUnits * 2 > buffer.length) break;
+		const value = buffer.toString("utf16le", offset, offset + dataCodeUnits * 2);
+		offset = alignUp(offset + dataCodeUnits * 2);
+		formats[format] = value;
+	}
+	return formats;
+};
+const extractGrab = (raw) => {
+	if (raw.grab) return raw.grab;
+	if (raw.pickleBase64) return parseChromiumPickle(Buffer.from(raw.pickleBase64, "base64"))[GRAB_MIME];
+};
+const isGrabText = (text) => GRAB_TEXT_SIGNATURE.test(text.length > SIGNATURE_SCAN_CHARS ? text.slice(0, SIGNATURE_SCAN_CHARS) : text);
+const extractPrompt = (record) => {
+	const comments = (Array.isArray(record.entries) ? record.entries : []).map((entry) => entry?.commentText?.trim?.()).filter(Boolean);
+	if (comments.length > 0) return comments.join("\n");
+	const lines = (typeof record.content === "string" ? record.content : "").split("\n");
+	const firstReferenceLine = lines.findIndex((line) => line.startsWith("["));
+	if (firstReferenceLine <= 0) return void 0;
+	return lines.slice(0, firstReferenceLine).join("\n").trim() || void 0;
+};
+const hasCommand = (name) => {
+	return (0, node_child_process.spawnSync)(process.platform === "win32" ? "where" : "which", [name], { stdio: "ignore" }).status === 0;
+};
+const runText = (command, args) => {
+	const output = (0, node_child_process.spawnSync)(command, args, {
+		encoding: "utf8",
+		maxBuffer: MAX_CLIPBOARD_BYTES,
+		timeout: READ_TIMEOUT_MS
+	});
+	return output.status === 0 ? output.stdout : null;
+};
+const runBuffer = (command, args) => {
+	const output = (0, node_child_process.spawnSync)(command, args, {
+		maxBuffer: MAX_CLIPBOARD_BYTES,
+		timeout: READ_TIMEOUT_MS
+	});
+	return output.status === 0 && output.stdout?.length ? output.stdout : null;
+};
+const runJson = (command, args) => {
+	const output = (0, node_child_process.spawnSync)(command, args, {
+		encoding: "utf8",
+		maxBuffer: MAX_CLIPBOARD_BYTES,
+		timeout: READ_TIMEOUT_MS
+	});
+	if (output.status !== 0 || !output.stdout) return null;
+	try {
+		return JSON.parse(output.stdout);
+	} catch {
+		return null;
+	}
+};
+const compileSwiftReader = (readersDir, workDir) => {
+	if (!hasCommand("swiftc")) return null;
+	const source = node_path.default.join(readersDir, "read-clipboard.swift");
+	if (!node_fs.default.existsSync(source)) return null;
+	const binary = node_path.default.join(workDir, "pbread");
+	if ((!node_fs.default.existsSync(binary) || node_fs.default.statSync(source).mtimeMs > node_fs.default.statSync(binary).mtimeMs) && (0, node_child_process.spawnSync)("swiftc", [
+		"-O",
+		source,
+		"-o",
+		binary
+	]).status !== 0) return null;
+	return binary;
+};
+const createDarwinReader = (options) => {
+	const binary = options.textOnly ? null : compileSwiftReader(options.readersDir, options.workDir);
+	if (binary) return {
+		mode: "darwin-native",
+		read: () => {
+			const raw = runJson(binary, []);
+			if (!raw) return null;
+			return {
+				changeCount: raw.changeCount ?? null,
+				text: raw.text,
+				grab: extractGrab(raw)
+			};
+		}
+	};
+	if (!hasCommand("pbpaste")) return null;
+	return {
+		mode: "darwin-text",
+		read: () => {
+			const text = runText("pbpaste", []);
+			return text == null ? null : {
+				changeCount: null,
+				text,
+				grab: void 0
+			};
+		}
+	};
+};
+const detectLinuxTool = () => {
+	if (Boolean(process.env.WAYLAND_DISPLAY) && hasCommand("wl-paste") || hasCommand("wl-paste") && !hasCommand("xclip")) return {
+		name: "wl-paste",
+		readText: () => runText("wl-paste", [
+			"-n",
+			"-t",
+			"text/plain"
+		]) ?? runText("wl-paste", ["-n"]),
+		readCustom: () => runBuffer("wl-paste", [
+			"-n",
+			"-t",
+			CHROMIUM_CUSTOM_FORMAT
+		])
+	};
+	if (hasCommand("xclip")) return {
+		name: "xclip",
+		readText: () => runText("xclip", [
+			"-selection",
+			"clipboard",
+			"-o"
+		]),
+		readCustom: () => runBuffer("xclip", [
+			"-selection",
+			"clipboard",
+			"-t",
+			CHROMIUM_CUSTOM_FORMAT,
+			"-o"
+		])
+	};
+	if (hasCommand("xsel")) return {
+		name: "xsel",
+		readText: () => runText("xsel", ["--clipboard", "--output"]),
+		readCustom: null
+	};
+	return null;
+};
+const createLinuxReader = (options) => {
+	const tool = detectLinuxTool();
+	if (!tool) return null;
+	const useCustom = !options.textOnly && Boolean(tool.readCustom);
+	return {
+		mode: useCustom ? `linux-${tool.name}` : `linux-${tool.name}-text`,
+		read: () => {
+			const text = tool.readText();
+			if (text == null) return null;
+			return {
+				changeCount: null,
+				text,
+				grab: useCustom && tool.readCustom ? parseChromiumPickle(tool.readCustom())[GRAB_MIME] : void 0
+			};
+		}
+	};
+};
+const detectPowershell = () => hasCommand("pwsh") ? "pwsh" : hasCommand("powershell") ? "powershell" : null;
+const createWindowsReader = (options) => {
+	const shell = detectPowershell();
+	if (!shell) return null;
+	const scriptPath = node_path.default.join(options.readersDir, "read-clipboard.ps1");
+	if (options.textOnly || !node_fs.default.existsSync(scriptPath)) return {
+		mode: "win-text",
+		read: () => {
+			const text = runText(shell, [
+				"-NoProfile",
+				"-Command",
+				"Get-Clipboard -Raw"
+			]);
+			return text == null ? null : {
+				changeCount: null,
+				text,
+				grab: void 0
+			};
+		}
+	};
+	const args = [
+		"-NoProfile",
+		"-ExecutionPolicy",
+		"Bypass",
+		"-File",
+		scriptPath
+	];
+	(0, node_child_process.spawnSync)(shell, args, {
+		stdio: "ignore",
+		maxBuffer: MAX_CLIPBOARD_BYTES
+	});
+	return {
+		mode: "win-native",
+		read: () => {
+			const raw = runJson(shell, args);
+			if (!raw) return null;
+			return {
+				changeCount: raw.changeCount ?? null,
+				text: raw.text ?? void 0,
+				grab: extractGrab(raw)
+			};
+		}
+	};
+};
+const createReader = (options) => {
+	if (process.platform === "darwin") return createDarwinReader(options);
+	if (process.platform === "linux") return createLinuxReader(options);
+	if (process.platform === "win32") return createWindowsReader(options);
+	return null;
+};
+const ensureSafeDir = (dir) => {
+	let stats;
+	try {
+		stats = node_fs.default.lstatSync(dir);
+	} catch {
+		return;
+	}
+	if (stats.isSymbolicLink()) throw new Error(`Refusing to use ${dir}: it is a symlink.`);
+	if (process.getuid && stats.uid !== process.getuid()) throw new Error(`Refusing to use ${dir}: owned by another user.`);
+};
+const prepareWorkDir = (dir) => {
+	ensureSafeDir(dir);
+	node_fs.default.mkdirSync(dir, {
+		recursive: true,
+		mode: 448
+	});
+	const gitignore = node_path.default.join(dir, ".gitignore");
+	if (!node_fs.default.existsSync(gitignore)) node_fs.default.writeFileSync(gitignore, "*\n");
+};
+const watchForNextGrab = async (options) => {
+	const { reader, dir, intervalMs, replayLast, onWarn, signal } = options;
+	const logPath = node_path.default.join(dir, "history.jsonl");
+	const { read } = reader;
+	let lastChangeCount = null;
+	let lastTimestamp = 0;
+	let lastTextHash = "";
+	let lastErrorMessage = "";
+	let sequence = 0;
+	const initial = read();
+	if (initial && !replayLast) {
+		lastChangeCount = initial.changeCount;
+		if (initial.text) lastTextHash = shortHash(initial.text);
+		if (initial.grab) try {
+			lastTimestamp = JSON.parse(initial.grab).timestamp ?? 0;
+		} catch {}
+	}
+	while (!signal?.aborted) {
+		await sleep(intervalMs);
+		if (signal?.aborted) return null;
+		try {
+			const snapshot = read();
+			if (!snapshot) continue;
+			if (snapshot.changeCount !== null && snapshot.changeCount === lastChangeCount) continue;
+			const textHash = snapshot.text ? shortHash(snapshot.text) : "";
+			const didTextChange = textHash !== lastTextHash;
+			let record = null;
+			let nextTimestamp = lastTimestamp;
+			if (snapshot.grab) {
+				let parsed = null;
+				try {
+					parsed = JSON.parse(snapshot.grab);
+				} catch {}
+				if (parsed && typeof parsed.timestamp === "number" && parsed.timestamp > lastTimestamp) {
+					nextTimestamp = parsed.timestamp;
+					record = {
+						source: "custom",
+						timestamp: parsed.timestamp,
+						version: typeof parsed.version === "string" ? parsed.version : void 0,
+						content: typeof parsed.content === "string" ? parsed.content : "",
+						entries: Array.isArray(parsed.entries) ? parsed.entries : []
+					};
+				}
+			} else if (didTextChange && snapshot.text && isGrabText(snapshot.text)) record = {
+				source: "text",
+				timestamp: Date.now(),
+				content: snapshot.text,
+				entries: []
+			};
+			if (!record) {
+				lastChangeCount = snapshot.changeCount;
+				lastTextHash = textHash;
+				continue;
+			}
+			const prompt = extractPrompt(record);
+			if (prompt) record.prompt = prompt;
+			const captured = {
+				id: `${record.timestamp}-${(sequence += 1).toString(ID_RADIX)}`,
+				receivedAt: Date.now(),
+				...record
+			};
+			node_fs.default.appendFileSync(logPath, `${JSON.stringify(captured)}\n`);
+			lastChangeCount = snapshot.changeCount;
+			lastTextHash = textHash;
+			lastTimestamp = nextTimestamp;
+			return captured;
+		} catch (error) {
+			const message = String(error?.message ?? error);
+			if (message !== lastErrorMessage) {
+				lastErrorMessage = message;
+				onWarn?.(message);
+			}
+		}
+	}
+	return null;
+};
+//#endregion
+//#region src/commands/watch.ts
+const DEFAULT_INTERVAL_MS = 800;
+const DEFAULT_DIR = ".react-grab";
+const readersDir = () => node_path.default.dirname((0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href));
+const watch = new commander.Command().name("watch").description("watch the clipboard for the next React Grab selection, print it, then exit").option("-d, --dir <dir>", "work dir for history.jsonl + cursor.txt", DEFAULT_DIR).option("-i, --interval <ms>", "clipboard poll interval in ms", String(DEFAULT_INTERVAL_MS)).option("--text-only", "skip the native reader and use the plain-text fallback").option("--replay-last", "also capture the grab already on the clipboard at startup").action((options) => {
+	const dir = node_path.default.resolve(options.dir);
+	const intervalMs = Number(options.interval);
+	const textOnly = Boolean(options.textOnly);
+	try {
+		prepareWorkDir(dir);
+	} catch (error) {
+		process.stderr.write(`react-grab watch: ${String(error?.message ?? error)}\n`);
+		process.exit(1);
+	}
+	const reader = createReader({
+		textOnly,
+		readersDir: readersDir(),
+		workDir: dir
+	});
+	if (!reader) {
+		process.stderr.write("react-grab watch: no clipboard reader available. Linux: install xclip or wl-clipboard. macOS: install Xcode CLI tools (swiftc) or rely on pbpaste. Windows: ensure PowerShell is on PATH.\n");
+		process.exit(1);
+	}
+	process.stderr.write(`react-grab watch: watching clipboard via ${reader.mode}; history → ${node_path.default.join(dir, "history.jsonl")} (Ctrl+C to stop)\n`);
+	watchForNextGrab({
+		reader,
+		dir,
+		intervalMs: Number.isFinite(intervalMs) && intervalMs > 0 ? intervalMs : DEFAULT_INTERVAL_MS,
+		replayLast: Boolean(options.replayLast),
+		onWarn: (message) => process.stderr.write(`react-grab watch: ${message}\n`)
+	}).then((grab) => {
+		if (!grab) process.exit(0);
+		process.stdout.write(`${JSON.stringify(grab)}\n`);
+		process.exit(0);
+	}).catch((error) => {
+		process.stderr.write(`react-grab watch: ${String(error?.message ?? error)}\n`);
+		process.exit(1);
+	});
+});
+//#endregion
 //#region src/cli.ts
-const VERSION = "0.1.37";
+const VERSION = "0.1.39";
 const VERSION_API_URL = "https://www.react-grab.com/api/version";
 process.on("SIGINT", () => process.exit(0));
 process.on("SIGTERM", () => process.exit(0));
@@ -2332,6 +2540,7 @@ program.addCommand(add);
 program.addCommand(remove);
 program.addCommand(configure);
 program.addCommand(upgrade);
+program.addCommand(watch);
 const main = async () => {
 	await program.parseAsync();
 };