create-harper 1.4.5 → 1.4.7

package/index.js

@@ -1,81 +1,4 @@
 #!/usr/bin/env node
-import * as prompts from '@clack/prompts';
-import path from 'node:path';
-import { helpMessage } from './lib/constants/helpMessage.js';
-import { pkgFromUserAgent } from './lib/pkg/pkgFromUserAgent.js';
-import { checkForUpdate } from './lib/steps/checkForUpdate.js';
-import { getEnvVars } from './lib/steps/getEnvVars.js';
-import { getPackageName } from './lib/steps/getPackageName.js';
-import { getProjectName } from './lib/steps/getProjectName.js';
-import { getRunAppImmediately } from './lib/steps/getRunAppImmediately.js';
-import { getTemplate } from './lib/steps/getTemplate.js';
-import { handleExistingDir } from './lib/steps/handleExistingDir.js';
-import { helpAgents } from './lib/steps/helpAgents.js';
-import { installAndOptionallyStart } from './lib/steps/installAndOptionallyStart.js';
-import { parseArgv } from './lib/steps/parseArgv.js';
-import { scaffoldProject } from './lib/steps/scaffoldProject.js';
+import { init } from './lib/init.js';
 
-init().catch((e) => {
-	console.error(e);
-});
-
-async function init() {
-	const args = parseArgv(process.argv.slice(2));
-
-	if (args.help) {
-		console.log(helpMessage);
-		return;
-	}
-
-	const currentVersion = await checkForUpdate();
-	if (args.version) {
-		console.log(`Current version: ${currentVersion}`);
-		return;
-	}
-
-	const interactive = args.interactive;
-
-	// Detect AI agent environment for better agent experience (AX)
-	await helpAgents(interactive);
-
-	const cancel = () => prompts.cancel('Operation cancelled');
-
-	// Get the project name and target directory
-	const projectNameResult = await getProjectName(args.targetDir, interactive);
-	if (projectNameResult.cancelled) { return cancel(); }
-	const { projectName, targetDir } = projectNameResult;
-
-	// Handle if the directory exists and isn't empty
-	const handleExistingDirResult = await handleExistingDir(targetDir, args.overwrite, interactive);
-	if (handleExistingDirResult.cancelled) { return cancel(); }
-
-	// Get the package name
-	const packageNameResult = await getPackageName(targetDir, interactive);
-	if (packageNameResult.cancelled) { return cancel(); }
-	const { packageName } = packageNameResult;
-
-	// Choose a framework and variant
-	const templateResult = await getTemplate(args.template, interactive);
-	if (templateResult.cancelled) { return cancel(); }
-	const { template } = templateResult;
-
-	// Get environment variables for .env file
-	const envVarsResult = await getEnvVars(interactive, template, args.deploymentUsername, args.deploymentURL);
-	if (envVarsResult.cancelled) { return cancel(); }
-	const { envVars } = envVarsResult;
-
-	// Should we do a package manager installation?
-	const pkgInfo = pkgFromUserAgent(process.env.npm_config_user_agent);
-	const pkgManager = pkgInfo ? pkgInfo.name : 'npm';
-	const immediateResult = await getRunAppImmediately(args.immediate, interactive, pkgManager);
-	if (immediateResult.cancelled) { return cancel(); }
-	const { immediate } = immediateResult;
-
-	// 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);
-}
+init();

package/lib/init.js

@@ -0,0 +1,86 @@
+import * as prompts from '@clack/prompts';
+import path from 'node:path';
+import { helpMessage } from './constants/helpMessage.js';
+import { pkgFromUserAgent } from './pkg/pkgFromUserAgent.js';
+import { checkForUpdate } from './steps/checkForUpdate.js';
+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';
+import { installAndOptionallyStart } from './steps/installAndOptionallyStart.js';
+import { parseArgv } from './steps/parseArgv.js';
+import { scaffoldProject } from './steps/scaffoldProject.js';
+
+export async function init() {
+	try {
+		const args = parseArgv(process.argv.slice(2));
+
+		if (args.help) {
+			console.log(helpMessage);
+			return;
+		}
+
+		const currentVersion = await checkForUpdate();
+		if (args.version) {
+			console.log(`Current version: ${currentVersion}`);
+			return;
+		}
+
+		const interactive = args.interactive;
+
+		// Detect AI agent environment for better agent experience (AX)
+		await helpAgents(interactive);
+
+		const cancel = () => prompts.cancel('Operation cancelled');
+
+		// Get the project name and target directory
+		const projectNameResult = await getProjectName(args.targetDir, interactive);
+		if (projectNameResult.cancelled) { return cancel(); }
+		const { projectName, targetDir } = projectNameResult;
+
+		// Handle if the directory exists and isn't empty
+		const handleExistingDirResult = await handleExistingDir(targetDir, args.overwrite, interactive);
+		if (handleExistingDirResult.cancelled) { return cancel(); }
+
+		// Get the package name
+		const packageNameResult = await getPackageName(targetDir, interactive);
+		if (packageNameResult.cancelled) { return cancel(); }
+		const { packageName } = packageNameResult;
+
+		// Choose a framework and variant
+		const templateResult = await getTemplate(args.template, interactive);
+		if (templateResult.cancelled) { return cancel(); }
+		const { template } = templateResult;
+
+		// Get environment variables for .env file
+		const envVarsResult = await getEnvVars(interactive, template, args.deploymentUsername, args.deploymentURL);
+		if (envVarsResult.cancelled) { return cancel(); }
+		const { envVars } = envVarsResult;
+
+		// Should we do a package manager installation?
+		const pkgInfo = pkgFromUserAgent(process.env.npm_config_user_agent);
+		const pkgManager = pkgInfo ? pkgInfo.name : 'npm';
+		const immediateResult = await getRunAppImmediately(args.immediate, interactive, pkgManager);
+		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, 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.5",
+	"version": "1.4.7",
 	"type": "module",
 	"author": {
 		"name": "HarperDB",