feat(ai-config): add agent choices for skills/instruction locations

README.md

@@ -145,13 +145,21 @@ ig start
 
 ## Configure AI Tooling
 
-To automatically configure Ignite UI AI tooling - MCP servers and AI coding skills, run:
+To configure Ignite UI AI tooling — MCP servers and AI coding skills — run:
 
 ```bash
 ig ai-config
 ```
 
-This creates or updates `.vscode/mcp.json` in the current project with entries for both the [Ignite UI MCP](#mcp-server) and `igniteui-theming` MCP servers. Existing servers in the file are preserved. It also copies any AI coding skill files from installed Ignite UI packages into the project. New projects are created with AI tooling configuration out of the box.
+You will be prompted to select which AI tools to configure (Claude and Generic are selected by default). You can also pass agents directly:
+
+```bash
+ig ai-config --agents claude copilot generic
+```
+
+This creates or updates `.vscode/mcp.json` with entries for the [Ignite UI MCP](#mcp-server) and `igniteui-theming` MCP servers (existing servers are preserved), copies AI coding skill files from installed Ignite UI packages, and generates agent-specific instruction files (e.g. `CLAUDE.md`, `AGENTS.md`).
+
+The `ig new` command also prompts for AI tool configuration as part of project creation.
 
 ## MCP Server
 
@@ -170,14 +178,18 @@ ig mcp --debug          # Enable debug logging to mcp-server.log
 
 ### Using with AI Assistants
 
-For VS Code, the `ig ai-config` command handles configuration automatically (see above). For other MCP clients (e.g., Claude Desktop, Cursor), configure them manually to use the CLI as the MCP server:
+For VS Code, the `ig ai-config` command handles configuration automatically (see above). For other MCP clients (e.g., Claude Desktop, Cursor), configure them manually:
 
 ```json
 {
   "mcpServers": {
     "igniteui-cli": {
-      "command": "ig",
-      "args": ["mcp"]
+      "command": "npx",
+      "args": ["-y", "igniteui-cli", "mcp"]
+    },
+    "igniteui-theming": {
+      "command": "npx",
+      "args": ["-y", "igniteui-theming", "igniteui-theming-mcp"]
     }
   }
 }

packages/cli/lib/PromptSession.ts

@@ -89,6 +89,7 @@ export class PromptSession extends BasePromptSession {
 			}
 			// move cwd to project folder
 			process.chdir(projectName);
+			await this.configureAI();
 		}
 		await this.chooseActionLoop(projLibrary);
 		//TODO: restore cwd?
@@ -105,8 +106,7 @@ export class PromptSession extends BasePromptSession {
 	}
 
 	protected async configureAI(): Promise<void> {
-		// skip adding skills since those are baked into the project template atm:
-		aiConfigure(false);
+		await aiConfigure();
 	}
 
 	/**

packages/cli/lib/commands/ai-config.ts

@@ -1,4 +1,4 @@
-import { addMcpServers, copyAISkillsToProject, GoogleAnalytics, Util, VS_CODE_MCP_PATH } from "@igniteui/cli-core";
+import { addMcpServers, AI_AGENT_LABELS, AI_AGENT_CHOICES, AIAgentTarget, copyAgentInstructionFiles, copyAISkillsToProject, GoogleAnalytics, InquirerWrapper, Util, VS_CODE_MCP_PATH } from "@igniteui/cli-core";
 import { ArgumentsCamelCase, CommandModule } from "yargs";
 
 export function configureMCP(): void {
@@ -11,8 +11,8 @@ export function configureMCP(): void {
 	Util.log(Util.greenCheck() + ` MCP servers configured in ${VS_CODE_MCP_PATH}`);
 }
 
-export function configureSkills(): void {
-	const result = copyAISkillsToProject();
+export function configureSkills(agents: AIAgentTarget[]): void {
+	const result = copyAISkillsToProject(agents);
 	if (result.found === 0) {
 		Util.warn("No AI skill files found. Make sure packages are installed (npm install) " +
 			"and your Ignite UI packages are up-to-date.", "yellow");
@@ -26,30 +26,72 @@ export function configureSkills(): void {
 	}
 }
 
-export function configure(skills = true): void {
+export async function configure(agents?: AIAgentTarget[], skills = true): Promise<void> {
+	if (!agents?.length) {
+		agents = await promptForAgents();
+	}
+	if (!agents.length) return;
 	configureMCP();
 	if (skills) {
-		configureSkills();
+		configureSkills(agents);
+	}
+	copyAgentInstructionFiles(agents);
+}
+const AI_AGENT_CHECKBOX_DEFAULTS: AIAgentTarget[] = ["generic", "claude"];
+const AI_AGENT_CHECKBOX_CHOICES = [
+	{ value: "none", name: "None (skip AI configuration)" },
+	...AI_AGENT_CHOICES.map(agent => ({
+		value: agent,
+		name: AI_AGENT_LABELS[agent],
+		checked: AI_AGENT_CHECKBOX_DEFAULTS.includes(agent)
+	}))
+];
+
+export async function promptForAgents(): Promise<AIAgentTarget[]> {
+	let selected: AIAgentTarget[] = AI_AGENT_CHECKBOX_DEFAULTS;
+	if (Util.canPrompt()) {
+		const result = await InquirerWrapper.checkbox({
+			message: "Which AI tools do you want to generate configuration files for?",
+			required: true,
+			choices: AI_AGENT_CHECKBOX_CHOICES
+		});
+		selected = result.includes("none") ? [] : result as AIAgentTarget[];
 	}
+	return selected;
 }
 
 const command: CommandModule = {
 	command: "ai-config",
-	describe: "Configures Ignite UI AI tooling (MCP servers and AI coding skills)",
-	builder: (yargs) => yargs,
-	async handler(_argv: ArgumentsCamelCase) {
+	describe: "Configures Ignite UI AI tooling (MCP servers, AI coding skills and instructions)",
+	builder: (yargs) => yargs
+		.usage("")
+		.option("agent", {
+			alias: "a",
+			describe: "AI agents/tools to generate configuration files for",
+			choices: AI_AGENT_CHOICES,
+			type: "array"
+		}),
+	async handler(argv: ArgumentsCamelCase) {
+		let agents = argv.agent as AIAgentTarget[] | undefined;
 		GoogleAnalytics.post({
 			t: "screenview",
-			cd: "MCP"
+			cd: "Ai Config"
 		});
 
+		if (!agents?.length) {
+			agents = await promptForAgents();
+		}
 		GoogleAnalytics.post({
 			t: "event",
 			ec: "$ig ai-config",
-			ea: "client: vscode"
+			ea: `agent: ${agents.join(", ")}`
 		});
 
-		configure();
+		if (!agents.length) {
+			Util.log("No AI configuration selected. Skipping.");
+			return;
+		}
+		await configure(agents);
 	}
 };
 

packages/cli/lib/commands/new.ts

@@ -1,9 +1,10 @@
-import { GoogleAnalytics, PackageManager, ProjectConfig, ProjectLibrary, Util } from "@igniteui/cli-core";
+import { AI_AGENT_CHOICES, AIAgentTarget, GoogleAnalytics, PackageManager, ProjectConfig, ProjectLibrary, Util } from "@igniteui/cli-core";
 import * as path from "path";
 import { PromptSession } from "./../PromptSession";
 import { NewCommandType, PositionalArgs } from "./types";
 import { TemplateManager } from "../TemplateManager";
 import { ArgumentsCamelCase, Choices } from "yargs";
+import { configure } from "./ai-config";
 
 // explicit typing because `type: "string"` will be inferred as `type: string` which yargs will not like
 const _framework: {
@@ -59,6 +60,12 @@ const command: NewCommandType = {
 				describe: "Project template",
 				type: "string"
 			})
+			.option("agents", {
+				alias: "a",
+				describe: "AI agents/tools to generate configuration files for",
+				choices: AI_AGENT_CHOICES,
+				type: "array"
+			})
 			.example("$0 new my-app", "Scaffold a new project interactively")
 			.example("$0 new my-app -f angular -t igx-ts", "Scaffold an Ignite UI for Angular project");
 	},
@@ -152,16 +159,20 @@ const command: NewCommandType = {
 
 		Util.log(Util.greenCheck() + " Project Created");
 
-		if (!argv["skip-git"] && !ProjectConfig.getConfig().skipGit) {
-			Util.gitInit(process.cwd(), argv.name);
-		}
-
 		if (!argv.skipInstall) {
 			process.chdir(argv.name);
 			await PackageManager.installPackages();
 			process.chdir("..");
 		}
 
+		process.chdir(argv.name);
+		await configure(argv.agents as AIAgentTarget[] | undefined);
+		process.chdir("..");
+
+		if (!argv["skip-git"] && !ProjectConfig.getConfig().skipGit) {
+			Util.gitInit(process.cwd(), argv.name);
+		}
+
 		Util.log("");
 		Util.log("Next Steps:");
 		Util.log(`  cd ${argv.name}`);

packages/cli/templates/react/igr-ts/projects/ai-config/index.ts

@@ -0,0 +1,38 @@
+import { ControlExtraConfiguration, defaultDelimiters, ProjectTemplate } from "@igniteui/cli-core";
+import * as path from "path";
+
+// currently reusing hidden project impl as components/views pipeline go through registerInProject
+// ideally would define a separate type/category for those partial files
+export class IgrTsAiConfigPartial implements ProjectTemplate {
+	public id: string = "ai-config";
+	public name = "ai-config";
+	public description = "Ignite UI CLI AI config for React partial project files";
+	public framework: string = "react";
+	public projectType: string = "tsx";
+	public dependencies: string[] = [];
+	public hasExtraConfiguration: boolean = false;
+	public isHidden: boolean = true;
+	public delimiters = defaultDelimiters;
+
+	public get templatePaths(): string[] {
+		return [path.join(__dirname, "files")];
+	}
+
+	public generateConfig(_name: string, _theme: string, ..._options: any[]): {[key: string]: any} {
+		return { /* partials not using Util.processTemplates atm */ };
+	}
+
+	public installModules(): void {
+		throw new Error("Method not implemented.");
+	}
+	public async upgradeIgniteUIPackages(_projectPath: string, _packagePath: string): Promise<boolean> {
+		throw new Error("Method not implemented.");
+	}
+	public getExtraConfiguration(): ControlExtraConfiguration[] {
+		throw new Error("Method not implemented.");
+	}
+	public setExtraConfiguration(_extraConfigKeys: {}) {
+		throw new Error("Method not implemented.");
+	}
+}
+export default new IgrTsAiConfigPartial();

packages/cli/templates/webcomponents/igc-ts/projects/ai-config/index.ts

@@ -0,0 +1,40 @@
+import { ControlExtraConfiguration, defaultDelimiters, ProjectTemplate } from "@igniteui/cli-core";
+import * as path from "path";
+
+// currently reusing hidden project impl as components/views pipeline go through registerInProject
+// ideally would define a separate type/category for those partial files
+export class IgcTsAiConfigPartial implements ProjectTemplate {
+
+	public id: string = "ai-config";
+	public name = "ai-config";
+	public description = "Ignite UI CLI AI config for Web Components partial project files";
+	public framework: string = "webcomponents";
+	public projectType: string = "igc-ts";
+	public dependencies: string[];
+	public hasExtraConfiguration: boolean = false;
+	public isHidden: boolean = true;
+	public delimiters = defaultDelimiters;
+
+	public get templatePaths(): string[] {
+		return [path.join(__dirname, "files")];
+	}
+
+	installModules(): void {
+		throw new Error("Method not implemented.");
+	}
+	upgradeIgniteUIPackages(_projectPath: string, _packagePath: string): Promise<boolean> {
+		throw new Error("Method not implemented.");
+	}
+	generateConfig(_name: string, _theme: string, ..._options: any[]): { [key: string]: any; } {
+		throw new Error("Method not implemented.");
+	}
+	getExtraConfiguration(): ControlExtraConfiguration[] {
+		throw new Error("Method not implemented.");
+	}
+	setExtraConfiguration(_extraConfigKeys: {}) {
+		throw new Error("Method not implemented.");
+	}
+}
+export default new IgcTsAiConfigPartial();
+
+

packages/core/prompt/BasePromptSession.ts

@@ -71,6 +71,7 @@ export abstract class BasePromptSession {
 			}
 			// move cwd to project folder
 			process.chdir(projectName);
+			await this.configureAI();
 		}
 		await this.chooseActionLoop(projLibrary);
 		//TODO: restore cwd?
@@ -423,8 +424,6 @@ export abstract class BasePromptSession {
 				}
 			}
 
-			await this.configureAI();
-
 			const defaultPort = config.project.defaultPort;
 			const port = await this.getUserInput({
 				type: "input",

packages/core/prompt/InquirerWrapper.ts

@@ -8,14 +8,18 @@ type InputConfig = {
     required?: boolean;
 	type?: string;
 	name?: string;
-	choices?: (string | Separator)[];
+	choices?: (string | Separator)[] | ({ value: string; name?: string; checked?: boolean } | Separator)[];
     transformer?: (value: string, { isFinal }: {
         isFinal: boolean;
     }) => string;
 
 	// TODO: consider typing these by extracting the types from the inquirer package
     validate?: any;
-    theme?: unknown;
+    theme?: any;
+};
+
+type InputChoicesConfig = InputConfig & {
+    choices: (string | Separator)[] | ({ value: string; name?: string; checked?: boolean } | Separator)[];
 };
 
 export class InquirerWrapper {
@@ -25,11 +29,11 @@ export class InquirerWrapper {
 		return input(message, context);
 	}
 
-	public static async select(message: InputConfig & { choices: (string | Separator)[] }, context?: Context): Promise<string> {
+	public static async select(message: InputChoicesConfig, context?: Context): Promise<string> {
 		return select(message, context);
 	}
 
-	public static async checkbox(message: InputConfig & { choices: (string | Separator)[] }, context?: Context): Promise<string[]> {
+	public static async checkbox(message: InputChoicesConfig, context?: Context): Promise<string[]> {
 		return checkbox(message, context);
 	}
 

packages/core/util/Util.ts

@@ -309,6 +309,13 @@ export class Util {
 		}
 	}
 
+	/**
+	 * Checks if the terminal is TTY and is not in CI env
+	 */
+	public static canPrompt() {
+		return process.stdout.isTTY && process.stdin.isTTY && !process.env.CI;
+	}
+
 	/**
 	 * Fairly aggressive sanitize removing anything but ASCII, numbers and a few needed chars that have no action:
 	 * - semicolons (:), dots (.), underscores (_) for paths/URLs