create-harper 1.4.6 → 1.4.7

package/lib/init.js

@@ -7,6 +7,7 @@ import { getEnvVars } from './steps/getEnvVars.js';
 import { getPackageName } from './steps/getPackageName.js';
 import { getProjectName } from './steps/getProjectName.js';
 import { getRunAppImmediately } from './steps/getRunAppImmediately.js';
+import { getSkills } from './steps/getSkills.js';
 import { getTemplate } from './steps/getTemplate.js';
 import { handleExistingDir } from './steps/handleExistingDir.js';
 import { helpAgents } from './steps/helpAgents.js';
@@ -67,13 +68,18 @@ export async function init() {
 		if (immediateResult.cancelled) { return cancel(); }
 		const { immediate } = immediateResult;
 
+		// Choose skills to install
+		const skillsResult = await getSkills(interactive, args.skills, args.agents, args.skipSkills);
+		if (skillsResult.cancelled) { return cancel(); }
+		const { selectedSkills, selectedAgents } = skillsResult;
+
 		// Write out the contents based on all prior steps.
 		const cwd = process.cwd();
 		const root = path.join(cwd, targetDir);
 		scaffoldProject(root, projectName, packageName, template, envVars);
 
 		// Log out the next steps.
-		installAndOptionallyStart(root, pkgManager, immediate, args.skipInstall);
+		installAndOptionallyStart(root, pkgManager, immediate, args.skipInstall, selectedSkills, selectedAgents);
 	} catch (e) {
 		console.error(e);
 	}

package/lib/install.js

@@ -7,22 +7,43 @@ import { run } from './run.js';
  *
  * @param {string} root - The root directory of the project.
  * @param {string} agent - The package manager agent (e.g., 'npm', 'pnpm', 'yarn', 'bun').
+ * @param {string[]} [selectedSkills] - The skills to install.
+ * @param {string[]} [selectedAgents] - The agents to install skills to.
  */
-export function install(root, agent) {
+export function install(root, agent, selectedSkills = [], selectedAgents = []) {
 	if (process.env._HARPER_TEST_CLI) {
 		prompts.log.step(
 			`Installing dependencies with ${agent}... (skipped in test)`,
 		);
 		return;
 	}
+
+	if (selectedSkills.length > 0) {
+		prompts.log.step('Installing Harper skills...');
+
+		const command = ['npx', '-y', 'skills', 'add', 'harperfast/skills'];
+
+		if (selectedSkills.includes('*') && selectedAgents.includes('*')) {
+			command.push('--all');
+		} else {
+			if (selectedSkills.length > 0) {
+				command.push('--skill', ...selectedSkills);
+			}
+			if (selectedAgents.length > 0) {
+				command.push('--agent', ...selectedAgents);
+			}
+			command.push('--yes');
+		}
+
+		run(command, {
+			stdio: 'inherit',
+			cwd: root,
+		});
+	}
+
 	prompts.log.step(`Installing dependencies with ${agent}...`);
 	run(getInstallCommand(agent), {
 		stdio: 'inherit',
 		cwd: root,
 	});
-	prompts.log.step('Installing Harper skills...');
-	run(['npx', '-y', 'skills', 'add', 'harperfast/skills', '--all', '--yes'], {
-		stdio: 'inherit',
-		cwd: root,
-	});
 }

package/lib/steps/getSkills.js

@@ -0,0 +1,61 @@
+import * as prompts from '@clack/prompts';
+
+/**
+ * Step 6: Choose whether to install Harper AI skills and for which agents.
+ *
+ * @param {boolean} interactive - Whether the CLI is running in interactive mode.
+ * @param {string} [argSkills] - The skills specified in the command line args.
+ * @param {string} [argAgents] - The agents specified in the command line args.
+ * @param {boolean} [argSkipSkills] - Whether to skip skills installation.
+ * @returns {Promise<{selectedSkills: string[], selectedAgents: string[], cancelled: boolean}>}
+ */
+export async function getSkills(interactive, argSkills, argAgents, argSkipSkills) {
+	if (argSkipSkills) {
+		return { selectedSkills: [], selectedAgents: [], cancelled: false };
+	}
+
+	let selectedSkills = argSkills ? argSkills.split(',') : ['*'];
+	let selectedAgents = argAgents ? argAgents.split(',') : [];
+
+	if (interactive && !argSkills && !argAgents) {
+		const installSkills = await prompts.confirm({
+			message: 'Would you like to install Harper AI skills to your IDE/agent?',
+			initialValue: true,
+		});
+
+		if (prompts.isCancel(installSkills)) {
+			return { selectedSkills: [], selectedAgents: [], cancelled: true };
+		}
+
+		if (!installSkills) {
+			return { selectedSkills: [], selectedAgents: [], cancelled: false };
+		}
+
+		const agents = await prompts.multiselect({
+			message: 'Which AI agents do you use? (Press <space> to select, <enter> to submit)',
+			options: [
+				{ value: 'auto', label: 'Just detect', hint: 'Auto-detect current environment' },
+				{ value: 'claude-code', label: 'Claude Code', hint: 'https://claude.com/product/claude-code' },
+				{ value: 'codex', label: 'OpenAI Codex', hint: 'https://chatgpt.com/codex' },
+				{ value: 'copilot', label: 'GitHub Copilot', hint: 'https://github.com/features/copilot' },
+				{ value: 'cursor', label: 'Cursor', hint: 'https://cursor.com/' },
+				{ value: 'windsurf', label: 'Windsurf', hint: 'https://windsurf.com/' },
+				{ value: 'all', label: 'All supported agents', hint: '40+ agents' },
+			],
+			required: false,
+		});
+
+		if (prompts.isCancel(agents)) {
+			return { selectedSkills: [], selectedAgents: [], cancelled: true };
+		}
+
+		selectedAgents = agents;
+		if (agents.includes('all')) {
+			selectedAgents = ['*'];
+		} else if (agents.includes('auto')) {
+			selectedAgents = [];
+		}
+	}
+
+	return { selectedSkills, selectedAgents, cancelled: false };
+}

package/lib/steps/installAndOptionallyStart.js

@@ -12,10 +12,12 @@ import { start } from '../start.js';
  * @param {string} pkgManager - The detected or selected package manager.
  * @param {boolean} immediate - Whether to immediately install and start the project.
  * @param {boolean} skipInstall - Whether to skip the installation step.
+ * @param {string[]} selectedSkills - The skills to install.
+ * @param {string[]} selectedAgents - The agents to install skills to.
  */
-export function installAndOptionallyStart(root, pkgManager, immediate, skipInstall) {
+export function installAndOptionallyStart(root, pkgManager, immediate, skipInstall, selectedSkills, selectedAgents) {
 	if (!skipInstall) {
-		install(root, pkgManager);
+		install(root, pkgManager, selectedSkills, selectedAgents);
 	}
 
 	if (immediate && !skipInstall) {

package/lib/steps/parseArgv.js

@@ -9,14 +9,18 @@ export function parseArgv(rawArgv) {
 			'interactive',
 			'overwrite',
 			'skipInstall',
+			'skipSkills',
 			'version',
 		],
 		string: [
+			'agents',
 			'deploymentURL',
 			'deploymentUsername',
+			'skills',
 			'template',
 		],
 		alias: {
+			a: 'agents',
 			c: 'deploymentURL',
 			'deployment-url': 'deploymentURL',
 			'deployment-username': 'deploymentUsername',
@@ -25,6 +29,7 @@ export function parseArgv(rawArgv) {
 			o: 'overwrite',
 			s: 'skipInstall',
 			'skip-install': 'skipInstall',
+			'skip-skills': 'skipSkills',
 			t: 'template',
 			u: 'deploymentUsername',
 			v: 'version',
@@ -49,6 +54,7 @@ export function parseArgv(rawArgv) {
 	}
 
 	return {
+		agents: argv.agents,
 		deploymentURL: argv.deploymentURL,
 		deploymentUsername: argv.deploymentUsername,
 		help: argv.help,
@@ -56,6 +62,8 @@ export function parseArgv(rawArgv) {
 		interactive: argv.interactive ?? process.stdin.isTTY,
 		overwrite: argv.overwrite,
 		skipInstall: argv.skipInstall,
+		skipSkills: argv.skipSkills,
+		skills: argv.skills,
 		targetDir: positionalArgs[0] ? formatTargetDir(String(positionalArgs[0])) : undefined,
 		template: argv.template,
 		version: argv.version,

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "create-harper",
 	"description": "Scaffold a new Harper project in JavaScript or TypeScript.",
-	"version": "1.4.6",
+	"version": "1.4.7",
 	"type": "module",
 	"author": {
 		"name": "HarperDB",