virastack 1.0.5 → 1.1.0-beta.1

package/README.md

@@ -8,7 +8,7 @@
   </picture>
 </a>
 
-*Production-grade scaffolding CLI for modern React — integrate ecosystem tools in one command.*
+*Scaffolding CLI for Next.js and TanStack Start: ViraStack tools and AI rules in one command*
 
 [![ViraStack Start](https://img.shields.io/badge/ViraStack-Start-%2300bba7)](https://virastack.com/start/)
 [![npm version](https://img.shields.io/npm/v/virastack?color=blue)](https://www.npmjs.com/package/virastack)
@@ -23,11 +23,11 @@
 
 ### [Read the full documentation →](https://virastack.com/start/)
 
-## Why ViraStack Start?
+## Features
 
 - **Interactive CLI:** Interactive prompts for template selection, project naming, and ecosystem tool integration.
 - **Production-Ready Foundations:** Scaffolds Next.js or TanStack Start projects with pre-configured feature-sliced architecture.
-- **Built-in AI Protocols:** Integrates [**ViraStack AI**](https://github.com/virastack/ai) automatically — architecture rules, `AGENTS.md`, and design skills from [**Emil Kowalski**](https://github.com/emilkowalski/skills) and [**Jakub Krehel**](https://github.com/jakubkrehel/make-interfaces-feel-better) — giving your coding agents a strict "constitution" from day one.
+- **Built-in AI Protocols:** Asks which AI coding tools you use (Claude Code, Cursor) and sets up [**ViraStack AI**](https://github.com/virastack/ai) for them — architecture rules in each tool's native format, `AGENTS.md`, and design skills from [**Emil Kowalski**](https://github.com/emilkowalski/skills) and [**Jakub Krehel**](https://github.com/jakubkrehel/skills) — giving your coding agents a strict "constitution" from day one.
 - **End-to-End Type Safety:** Strict TypeScript rules, Zod validation, and native package manager alignment (pnpm, npm, yarn, bun).
 - **Ecosystem Integration:** Add optional ViraStack tools (`@virastack/mask`, `@virastack/password`) seamlessly.
 
@@ -57,6 +57,10 @@ Which template would you like to use?
   › Next.js App Router
     TanStack Start
 
+Which AI coding tools do you use?
+  [x] Claude Code
+  [x] Cursor
+
 Would you like multi-language (i18n) support?
   › Yes
     No
@@ -66,6 +70,19 @@ Which ViraStack tools would you like to include?
   [ ] @virastack/password
 ```
 
+Select none to get plain rules in `.agents/rules/` that any agent can read through `AGENTS.md`.
+
+## What it sets up
+
+1. Copies the template and sets the project name.
+2. Installs dependencies with the package manager you ran it with.
+3. Next.js only: adds the Next.js block to `AGENTS.md`, pointing agents at the docs bundled in `node_modules/next/dist/docs/`.
+4. Runs `@virastack/ai init --agent <your choice>`. It never overwrites files you changed.
+5. Installs three design skills: `emil-design-eng` ([Emil Kowalski](https://github.com/emilkowalski/skills)), `better-ui` and `better-accessibility` ([Jakub Krehel](https://github.com/jakubkrehel/skills)). They go to `.agents/skills/` and, with Claude Code, to `.claude/skills/`. With Claude Code as the only tool, they go only to `.claude/skills/`.
+6. Creates the first git commit, so `git status` is clean.
+
+`--skip-install` skips step 2. Offline, steps 2, 4 and 5 are skipped and the commands to run later are printed.
+
 ## Tools
 
 | Tool | Description |
@@ -83,9 +100,10 @@ Which ViraStack tools would you like to include?
 | `--name <name>` | Project name (or pass as positional / `.`) |
 | `--template <name>` | `nextjs` or `tanstack` |
 | `--tools <list>` | Comma-separated tools (`mask,password`) |
+| `--agent <list>` | AI coding tools: `claude`, `cursor` (comma separated) or `none`. Default with `--yes`: both |
 | `--i18n` / `--no-i18n` | Enable or disable the i18n template |
 | `--yes`, `-y` | Non-interactive mode (flags + defaults) |
-| `--skip-install` | Scaffold files only; skip install + AI setup |
+| `--skip-install` | Skip dependency install (AI rules and skills are still added) |
 | `--tr` | Turkish prompts |
 | `--telemetry-disable` | Permanently disable anonymous usage tracking |
 | `-v`, `--version` | Print CLI version |
@@ -95,6 +113,7 @@ Which ViraStack tools would you like to include?
 pnpm dlx virastack add mask
 pnpm dlx virastack add password
 pnpm dlx virastack add ai
+pnpm dlx virastack add ai --agent cursor
 ```
 
 ## Included by default
@@ -106,30 +125,23 @@ Every template ships with this stack already installed:
 | **State** | TanStack Query, Zustand, nuqs |
 | **Form** | React Hook Form, Zod |
 | **Hooks** | `usehooks-ts` |
-| **UI** | Base UI, Framer Motion, Lucide React |
+| **UI** | Base UI, Motion, Lucide React |
+| **Test** | Vitest, Testing Library, MSW |
 
 [ViraStack AI](https://github.com/virastack/ai) encodes these choices as agent rules so assistants follow the same stack from day one.
 
 ## Telemetry
 
-To keep usage statistics, ViraStack collects strictly anonymous data (template, i18n choice, selected tools, package manager, and CLI version). Absolutely no personal data, project names, or file paths are collected.
-
-Opt out anytime: `pnpm dlx virastack --telemetry-disable`
+The CLI collects anonymous usage data only: template, options, tools, package manager and CLI version. Opt out: `pnpm dlx virastack --telemetry-disable`
 
 ## Contributing
 
 Ideas and bug reports are welcome — open an [issue](https://github.com/virastack/start/issues).
 
-## Explore the ViraStack Ecosystem
+## Ecosystem
 
-Discover all ViraStack tools, libraries, and boilerplates at [**virastack.com**](https://virastack.com).
+Part of the [ViraStack](https://virastack.com) ecosystem: [Academy](https://github.com/virastack/academy) · [AI](https://github.com/virastack/ai) · [Mask](https://github.com/virastack/mask) · [Password](https://github.com/virastack/password) · [Guide](https://github.com/virastack/guide)
 
 ## License
 
-Licensed under the [MIT License](LICENSE).
-
-## Maintainer
-
-A project by [**Ömer Gülçiçek**](https://omergulcicek.com)
-
-[![Follow Ömer Gülçiçek](https://img.shields.io/github/followers/omergulcicek?label=Follow&style=social)](https://github.com/omergulcicek)
+[MIT](LICENSE) © [Ömer Gülçiçek](https://omergulcicek.com)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "virastack",
-  "version": "1.0.5",
-  "description": "Scaffold new projects and add tools from the ViraStack ecosystem with a single command.",
+  "version": "1.1.0-beta.1",
+  "description": "Scaffolding CLI for Next.js and TanStack Start: ViraStack tools and AI rules in one command",
   "author": {
     "name": "Ömer Gülçiçek (ViraStack)",
     "email": "iletisim@omergulcicek.com",
@@ -34,10 +34,11 @@
     "!src/**/*.test.js"
   ],
   "scripts": {
-    "prepublishOnly": "find templates templates-i18n -type d \\( -name 'node_modules' -o -name '.next' -o -name 'dist' -o -name '.vinxi' -o -name '.output' -o -name '.turbo' \\) -prune -exec rm -rf '{}' +",
+    "prepublishOnly": "find templates templates-i18n -type d \\( -name 'node_modules' -o -name '.next' -o -name 'dist' -o -name '.vinxi' -o -name '.output' -o -name '.turbo' \\) -prune -exec rm -rf '{}' + && find templates templates-i18n -name '.eslintcache' -type f -delete",
     "start": "node ./bin/virastack.js",
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "test:e2e": "node scripts/e2e.js"
   },
   "keywords": [
     "virastack",

package/src/commands/add.js

@@ -8,6 +8,7 @@ import { runCommand } from "../utils/exec.js";
 import { detectPackageManager, getAddArgs } from "../utils/package-manager.js";
 import { trackEvent } from "../utils/telemetry.js";
 import { findTool, TOOLS } from "../utils/tools.js";
+import { getAiInitArgs } from "../utils/agents.js";
 
 async function fileExists(filePath) {
   try {
@@ -18,7 +19,11 @@ async function fileExists(filePath) {
   }
 }
 
-export async function runAdd(toolId) {
+/**
+ * @param {string | undefined} toolId
+ * @param {{ agents?: string[] }} [options] `agents` applies to `add ai` only.
+ */
+export async function runAdd(toolId, options = {}) {
   console.log();
   p.intro(pc.bgMagenta(pc.black(" ViraStack ")));
 
@@ -49,9 +54,7 @@ export async function runAdd(toolId) {
     if (tool.kind === "dependency") {
       await runCommand(packageManager, getAddArgs(packageManager, [tool.package]), { cwd });
     } else {
-      const args = ["--yes", tool.package, "init", "--force"];
-      if (getLocale() === "tr") args.push("--tr");
-      await runCommand("npx", args, { cwd });
+      await runCommand("npx", getAiInitArgs(options.agents, { tr: getLocale() === "tr" }), { cwd });
     }
     spinner.stop(t("add.done", { pkg: tool.package }));
   } catch (error) {
@@ -60,5 +63,9 @@ export async function runAdd(toolId) {
     process.exit(1);
   }
 
-  await trackEvent("add", { tool: tool.id, packageManager });
+  await trackEvent("add", {
+    tool: tool.id,
+    ...(tool.id === "ai" && options.agents ? { agents: options.agents } : {}),
+    packageManager,
+  });
 }

package/src/commands/init.js

@@ -6,7 +6,9 @@ import pc from "picocolors";
 import { t, getLocale } from "../i18n.js";
 import { copyTemplate, dirHasFiles, isDirEmpty } from "../utils/copy-template.js";
 import { runCommand } from "../utils/exec.js";
-import { initGitRepo } from "../utils/git.js";
+import { commitInitial, initGitRepo } from "../utils/git.js";
+import { AGENTS, ALL_AGENTS, SKILLS, getAiInitArgs, getSkillArgs, getSkillsCommand } from "../utils/agents.js";
+import { writeNextAgentsBlock } from "../utils/next-agents-md.js";
 import { isOnline } from "../utils/is-online.js";
 import {
   detectPackageManager,
@@ -43,6 +45,7 @@ function failAndExit(message) {
  *   template?: string,
  *   i18n?: boolean,
  *   tools?: string[] | string | true,
+ *   agents?: string[],
  *   yes?: boolean,
  *   skipInstall?: boolean,
  * }} [options]
@@ -139,6 +142,25 @@ export async function runInit(options = {}) {
     template = "nextjs";
   }
 
+  let agents = options.agents;
+  if (agents == null) {
+    if (yes) {
+      agents = ALL_AGENTS;
+    } else {
+      const selected = await p.multiselect({
+        message: t("agents.message"),
+        required: false,
+        initialValues: ALL_AGENTS,
+        options: AGENTS.map((agent) => ({
+          value: agent.id,
+          label: t(`agents.${agent.id}.label`),
+        })),
+      });
+      if (p.isCancel(selected)) return cancelAndExit();
+      agents = ALL_AGENTS.filter((id) => selected.includes(id));
+    }
+  }
+
   let wantsI18n = options.i18n;
   if (wantsI18n == null) {
     if (yes) {
@@ -193,22 +215,15 @@ export async function runInit(options = {}) {
   await setupEnvFile(targetDir);
   scaffoldSpinner.stop(t("scaffold.copyDone"));
 
-  const gitSpinner = p.spinner();
-  gitSpinner.start(t("scaffold.gitInit"));
   const gitInitialized = await initGitRepo(targetDir);
-  gitSpinner.stop(
-    gitInitialized ? t("scaffold.gitInitDone") : t("scaffold.gitInitSkipped"),
-  );
 
   const online = await isOnline();
   let installOk = false;
-  let aiOk = false;
-  let offline = false;
+  const offline = !online;
 
   if (skipInstall) {
     p.log.info(t("scaffold.skipInstall"));
-  } else if (!online) {
-    offline = true;
+  } else if (offline) {
     p.log.warn(t("scaffold.offline"));
   } else {
     const installSpinner = p.spinner();
@@ -221,37 +236,55 @@ export async function runInit(options = {}) {
       installSpinner.stop(t("scaffold.installFailed"));
       p.log.error(String(error?.message ?? error));
     }
+  }
+
+  if (template === "nextjs") {
+    await writeNextAgentsBlock(targetDir);
+  }
+
+  // ViraStack AI only writes files, so it runs even with --skip-install.
+  let aiOk = false;
+  if (!offline) {
+    const aiSpinner = p.spinner();
+    aiSpinner.start(t("scaffold.aiInit"));
+    try {
+      await runCommand("npx", getAiInitArgs(agents, { tr: getLocale() === "tr" }), { cwd: targetDir });
+      aiSpinner.stop(t("scaffold.aiInitDone"));
+      aiOk = true;
+    } catch {
+      aiSpinner.stop(t("scaffold.aiInitFailed"));
+    }
+  }
 
-    if (installOk) {
-      const aiSpinner = p.spinner();
-      aiSpinner.start(t("scaffold.aiInit"));
+  // Each skill installs on its own: one failing must not stop the others.
+  // Like ViraStack AI, they only write files, so only offline skips them.
+  let skillsOk = false;
+  if (!offline) {
+    const skillsSpinner = p.spinner();
+    skillsSpinner.start(t("scaffold.skillsInit"));
+    let failed = 0;
+    for (const entry of SKILLS) {
       try {
-        const args = ["--yes", "@virastack/ai", "init", "--force"];
-        if (getLocale() === "tr") args.push("--tr");
-        await runCommand("npx", args, { cwd: targetDir });
-        aiSpinner.stop(t("scaffold.aiInitDone"));
-        aiOk = true;
+        await runCommand("npx", getSkillArgs(entry, agents), { cwd: targetDir });
       } catch {
-        aiSpinner.stop(t("scaffold.aiInitFailed"));
+        failed += 1;
       }
-
-      if (aiOk) {
-        try {
-          await runCommand("npx", ["--yes", "skills@latest", "add", "emilkowalski/skills", "--skill", "emil-design-eng", "-y"], { cwd: targetDir });
-          await runCommand("npx", ["--yes", "skills@latest", "add", "jakubkrehel/make-interfaces-feel-better", "-y"], { cwd: targetDir });
-        } catch {
-          p.log.warn(t("scaffold.skillsInitFailed"));
-        }
-      }
-    } else {
-      p.log.warn(t("scaffold.aiInitSkipped"));
     }
+    skillsOk = failed === 0;
+    skillsSpinner.stop(skillsOk ? t("scaffold.skillsInitDone") : t("scaffold.skillsInitFailed"));
   }
 
+  // Last, so the first commit contains every generated file.
+  const gitSpinner = p.spinner();
+  gitSpinner.start(t("scaffold.gitInit"));
+  const committed = gitInitialized && (await commitInitial(targetDir));
+  gitSpinner.stop(committed ? t("scaffold.gitInitDone") : t("scaffold.gitInitSkipped"));
+
   await trackEvent("create", {
     template,
     i18n: wantsI18n,
     tools,
+    agents,
     packageManager,
     installOk,
     skipInstall,
@@ -259,14 +292,16 @@ export async function runInit(options = {}) {
 
   const cdHint = useCurrentDir ? null : t("done.cd", { dir: projectName });
   const installCmd = getInstallCommand(packageManager);
-  const aiCmd = getAiInitCommand();
+  const aiCmd = getAiInitCommand(agents);
+  const skillsCmd = getSkillsCommand();
   const devCmd = getRunDevCommand(packageManager);
 
   if (skipInstall || offline || !installOk) {
     const outroLines = [t("done.partialTitle")];
     if (cdHint) outroLines.push(cdHint);
     outroLines.push(t("done.manualInstall", { cmd: installCmd }));
-    outroLines.push(t("done.manualAi", { cmd: aiCmd }));
+    if (!aiOk) outroLines.push(t("done.manualAi", { cmd: aiCmd }));
+    if (!skillsOk) outroLines.push(t("done.manualSkills", { cmd: skillsCmd }));
     outroLines.push(t("done.dev", { cmd: devCmd }));
     if (!installOk && !offline && !skipInstall) {
       p.log.error(t("done.installFailedNote"));
@@ -281,6 +316,7 @@ export async function runInit(options = {}) {
   const outroLines = [t("done.title")];
   if (cdHint) outroLines.push(cdHint);
   if (!aiOk) outroLines.push(t("done.manualAi", { cmd: aiCmd }));
+  if (!skillsOk) outroLines.push(t("done.manualSkills", { cmd: skillsCmd }));
   outroLines.push(t("done.dev", { cmd: devCmd }));
   p.outro(outroLines.join("\n"));
 }

package/src/i18n.js

@@ -7,7 +7,7 @@ const dictionaries = {
   en: {
     cancel: "Operation cancelled.",
     "telemetry.notice":
-      "ViraStack collects anonymous usage data (template, i18n choice, selected tools) to improve the CLI. No personal data is ever collected. Disable anytime with --telemetry-disable.",
+      "ViraStack collects anonymous usage data (template, i18n choice, selected tools, AI coding tools) to improve the CLI. No personal data is ever collected. Disable anytime with --telemetry-disable.",
 
     "projectName.message": "What is your project named?",
     "projectName.placeholder": "virastack-app",
@@ -30,6 +30,12 @@ const dictionaries = {
     "template.errorInvalid":
       'Unknown template "{template}". Available templates: nextjs, tanstack.',
 
+    "agents.message": "Which AI coding tools do you use?",
+    "agents.claude.label": "Claude Code",
+    "agents.cursor.label": "Cursor",
+    "agent.errorInvalid":
+      'Invalid --agent value "{value}". Use claude, cursor (comma separated) or none.',
+
     "i18n.message": "Would you like multi-language (i18n) support?",
     "i18n.active": "Yes",
     "i18n.inactive": "No",
@@ -46,9 +52,9 @@ const dictionaries = {
 
     "scaffold.copying": "Creating project files...",
     "scaffold.copyDone": "Project files created.",
-    "scaffold.gitInit": "Initializing git repository...",
-    "scaffold.gitInitDone": "Git repository initialized.",
-    "scaffold.gitInitSkipped": "Skipped git initialization.",
+    "scaffold.gitInit": "Creating the initial git commit...",
+    "scaffold.gitInitDone": "Initial git commit created.",
+    "scaffold.gitInitSkipped": "Skipped the initial git commit.",
     "scaffold.installing": "Installing dependencies with {pm}...",
     "scaffold.installDone": "Dependencies installed.",
     "scaffold.installFailed":
@@ -61,10 +67,9 @@ const dictionaries = {
     "scaffold.aiInitDone": "🤖 ViraStack AI agent rules successfully integrated.",
     "scaffold.aiInitFailed":
       "Failed to configure ViraStack AI rules.",
-    "scaffold.aiInitSkipped":
-      "Skipping AI setup because dependency install failed.",
-    "scaffold.skillsInitFailed":
-      "Design skills could not be installed. Run manually: npx skills@latest add emilkowalski/skills && npx skills@latest add jakubkrehel/make-interfaces-feel-better",
+    "scaffold.skillsInit": "Installing design skills...",
+    "scaffold.skillsInitDone": "Design skills installed.",
+    "scaffold.skillsInitFailed": "Some design skills could not be installed.",
 
     "done.title": "You're all set!",
     "done.partialTitle": "Project files are ready — finish setup manually:",
@@ -73,6 +78,7 @@ const dictionaries = {
     "done.cd": "  cd {dir}",
     "done.manualInstall": "  {cmd}",
     "done.manualAi": "  {cmd}",
+    "done.manualSkills": "  {cmd}",
     "done.dev": "  {cmd}",
 
     "add.toolMissing": "Please specify a tool to add. Available tools: {list}.",
@@ -85,6 +91,7 @@ const dictionaries = {
     help: `Usage:
   pnpm dlx virastack [init] [name]   Scaffold a new project
   pnpm dlx virastack add <tool>      Add a ViraStack tool to an existing project
+  pnpm dlx virastack add ai --agent <list>  Add AI rules for the given tools
 
 Tools:
   mask, password, ai
@@ -93,9 +100,10 @@ Options:
   --name <name>         Project name (or pass as positional arg / ".")
   --template <name>     Template: nextjs | tanstack
   --tools <list>        Comma-separated tools (e.g. mask,password)
+  --agent <list>        AI coding tools: claude, cursor (comma separated) or none
   --i18n / --no-i18n    Enable or disable the i18n template
   --yes, -y             Non-interactive mode (use flags/defaults)
-  --skip-install        Scaffold files only; skip install + AI setup
+  --skip-install        Skip dependency install (AI rules and skills are still added)
   --tr                  Ask questions in Turkish
   --telemetry-disable   Disable anonymous usage tracking
   -v, --version         Print the version
@@ -104,13 +112,13 @@ Options:
 Examples:
   pnpm dlx virastack
   pnpm dlx virastack my-app --yes
-  pnpm dlx virastack init my-app --template nextjs --tools mask --yes`,
+  pnpm dlx virastack init my-app --template nextjs --tools mask --agent claude --yes`,
   },
 
   tr: {
     cancel: "İşlem iptal edildi.",
     "telemetry.notice":
-      "ViraStack, CLI'ı geliştirmek için anonim kullanım verisi toplar (şablon, i18n tercihi, seçilen araçlar). Hiçbir kişisel veri toplanmaz. --telemetry-disable ile her zaman kapatabilirsiniz.",
+      "ViraStack, CLI'ı geliştirmek için anonim kullanım verisi toplar (şablon, i18n tercihi, seçilen araçlar, AI kodlama araçları). Hiçbir kişisel veri toplanmaz. --telemetry-disable ile her zaman kapatabilirsiniz.",
 
     "projectName.message": "Projenizin adı ne olsun?",
     "projectName.placeholder": "virastack-app",
@@ -133,6 +141,12 @@ Examples:
     "template.errorInvalid":
       'Bilinmeyen şablon "{template}". Kullanılabilir şablonlar: nextjs, tanstack.',
 
+    "agents.message": "Hangi AI kodlama araçlarını kullanıyorsunuz?",
+    "agents.claude.label": "Claude Code",
+    "agents.cursor.label": "Cursor",
+    "agent.errorInvalid":
+      'Geçersiz --agent değeri "{value}". claude, cursor (virgülle) veya none kullanın.',
+
     "i18n.message": "Çoklu dil (i18n) desteği ister misiniz?",
     "i18n.active": "Evet",
     "i18n.inactive": "Hayır",
@@ -149,9 +163,9 @@ Examples:
 
     "scaffold.copying": "Proje dosyaları oluşturuluyor...",
     "scaffold.copyDone": "Proje dosyaları oluşturuldu.",
-    "scaffold.gitInit": "Git deposu başlatılıyor...",
-    "scaffold.gitInitDone": "Git deposu başlatıldı.",
-    "scaffold.gitInitSkipped": "Git başlatma adımı atlandı.",
+    "scaffold.gitInit": "İlk git commit'i oluşturuluyor...",
+    "scaffold.gitInitDone": "İlk git commit'i oluşturuldu.",
+    "scaffold.gitInitSkipped": "İlk git commit'i atlandı.",
     "scaffold.installing": "Bağımlılıklar {pm} ile kuruluyor...",
     "scaffold.installDone": "Bağımlılıklar kuruldu.",
     "scaffold.installFailed":
@@ -164,10 +178,9 @@ Examples:
     "scaffold.aiInitDone": "🤖 ViraStack AI ajan kuralları projeye başarıyla entegre edildi.",
     "scaffold.aiInitFailed":
       "ViraStack AI kuralları yapılandırılamadı.",
-    "scaffold.aiInitSkipped":
-      "Bağımlılık kurulumu başarısız olduğu için AI yapılandırması atlandı.",
-    "scaffold.skillsInitFailed":
-      "Tasarım skill'leri kurulamadı. Manuel çalıştırın: npx skills@latest add emilkowalski/skills && npx skills@latest add jakubkrehel/make-interfaces-feel-better",
+    "scaffold.skillsInit": "Tasarım skill'leri kuruluyor...",
+    "scaffold.skillsInitDone": "Tasarım skill'leri kuruldu.",
+    "scaffold.skillsInitFailed": "Bazı tasarım skill'leri kurulamadı.",
 
     "done.title": "Her şey hazır!",
     "done.partialTitle": "Proje dosyaları hazır — kurulumu manuel tamamlayın:",
@@ -176,6 +189,7 @@ Examples:
     "done.cd": "  cd {dir}",
     "done.manualInstall": "  {cmd}",
     "done.manualAi": "  {cmd}",
+    "done.manualSkills": "  {cmd}",
     "done.dev": "  {cmd}",
 
     "add.toolMissing":
@@ -189,6 +203,7 @@ Examples:
     help: `Kullanım:
   pnpm dlx virastack [init] [ad]     Yeni bir proje oluştur
   pnpm dlx virastack add <araç>      Mevcut projeye bir ViraStack aracı ekle
+  pnpm dlx virastack add ai --agent <liste>  Seçilen araçlar için AI kurallarını ekle
 
 Araçlar:
   mask, password, ai
@@ -197,9 +212,10 @@ Seçenekler:
   --name <ad>           Proje adı (veya positional arg / ".")
   --template <ad>       Şablon: nextjs | tanstack
   --tools <liste>       Virgülle ayrılmış araçlar (örn. mask,password)
+  --agent <liste>       AI kodlama araçları: claude, cursor (virgülle) veya none
   --i18n / --no-i18n    i18n şablonunu aç / kapat
   --yes, -y             İnteraktif olmayan mod (flag/varsayılanlar)
-  --skip-install        Sadece dosyaları oluştur; kurulum + AI atla
+  --skip-install        Bağımlılık kurulumunu atla (AI kuralları ve skill'ler yine eklenir)
   --tr                  Soruları Türkçe sor
   --telemetry-disable   Anonim kullanım verisi toplamayı kapat
   -v, --version         Sürümü göster
@@ -208,7 +224,7 @@ Seçenekler:
 Örnekler:
   pnpm dlx virastack
   pnpm dlx virastack my-app --yes
-  pnpm dlx virastack init my-app --template nextjs --tools mask --yes`,
+  pnpm dlx virastack init my-app --template nextjs --tools mask --agent claude --yes`,
   },
 };
 

package/src/index.js

@@ -5,6 +5,7 @@ import { setLocale, t } from "./i18n.js";
 import { runInit } from "./commands/init.js";
 import { runAdd } from "./commands/add.js";
 import { parseToolsFlag } from "./utils/tools.js";
+import { parseAgentFlag } from "./utils/agents.js";
 
 function resolveI18nFlag(flags) {
   if (hasFlag(flags, "no-i18n")) return false;
@@ -12,6 +13,18 @@ function resolveI18nFlag(flags) {
   return undefined;
 }
 
+/** `--agent` as a list of ids, undefined when absent. Exits on an invalid value. */
+function resolveAgentFlag(flags) {
+  const value = getFlag(flags, "agent");
+  if (value === undefined) return undefined;
+  const agents = parseAgentFlag(value);
+  if (agents === null) {
+    console.error(t("agent.errorInvalid", { value: value === true ? "" : value }));
+    process.exit(1);
+  }
+  return agents;
+}
+
 function buildInitOptions(flags, projectName) {
   const nameFlag = getFlag(flags, "name");
   const template = getFlag(flags, "template");
@@ -22,6 +35,7 @@ function buildInitOptions(flags, projectName) {
     template: typeof template === "string" ? template : undefined,
     i18n: resolveI18nFlag(flags),
     tools: tools === undefined ? undefined : parseToolsFlag(tools),
+    agents: resolveAgentFlag(flags),
     yes: hasFlag(flags, "yes", "y"),
     skipInstall: hasFlag(flags, "skip-install"),
   };
@@ -55,7 +69,7 @@ export async function main() {
       await runInit(buildInitOptions(flags, rest[0]));
       break;
     case "add":
-      await runAdd(rest[0]);
+      await runAdd(rest[0], { agents: resolveAgentFlag(flags) });
       break;
     default:
       // `pnpm dlx virastack my-app --yes` — first token is the project name.

package/src/utils/agents.js

@@ -0,0 +1,85 @@
+import { getCliVersion } from "./package-info.js";
+
+/**
+ * AI coding tools the CLI can set up. `skillsAgent` is the matching
+ * `skills` CLI agent id (https://github.com/vercel-labs/skills).
+ */
+export const AGENTS = [
+  { id: "claude", skillsAgent: "claude-code" },
+  { id: "cursor", skillsAgent: "cursor" },
+];
+
+export const ALL_AGENTS = AGENTS.map((agent) => agent.id);
+
+/**
+ * Parses `--agent claude,cursor` / `--agent none`.
+ * Returns the selected ids in canonical order, or null when the value is
+ * missing or names an unknown tool.
+ */
+export function parseAgentFlag(value) {
+  if (typeof value !== "string" || value.trim() === "") return null;
+  const parts = value.split(",").map((part) => part.trim()).filter(Boolean);
+  if (parts.length === 1 && parts[0] === "none") return [];
+  if (parts.length === 0 || parts.some((part) => !ALL_AGENTS.includes(part))) return null;
+  return ALL_AGENTS.filter((id) => parts.includes(id));
+}
+
+/** `--agent` value for @virastack/ai: "claude,cursor", "cursor" or "none". */
+export function formatAgents(agents) {
+  return agents.length === 0 ? "none" : agents.join(",");
+}
+
+/**
+ * npm spec for @virastack/ai. A prerelease of this CLI pairs with the ai
+ * prerelease channel (`next`), a stable release with ai v2.
+ * VIRASTACK_AI_SPEC overrides it (e.g. `file:` + a local tarball in end-to-end tests).
+ */
+export function getAiPackageSpec(cliVersion = getCliVersion()) {
+  if (process.env.VIRASTACK_AI_SPEC) return process.env.VIRASTACK_AI_SPEC;
+  return `@virastack/ai@${cliVersion.includes("-") ? "next" : "2"}`;
+}
+
+/**
+ * Arguments for `npx`. Never `--force`, so files the user changed are kept.
+ * Without `agents`, ViraStack AI reuses the saved choice (or installs both).
+ */
+export function getAiInitArgs(agents, { tr = false } = {}) {
+  const args = ["--yes", getAiPackageSpec(), "init"];
+  if (agents) args.push("--agent", formatAgents(agents));
+  args.push("--yes");
+  if (tr) args.push("--tr");
+  return args;
+}
+
+/** Design skills installed in every project, one `skills add` call each. */
+export const SKILLS = [
+  { source: "emilkowalski/skills", skill: "emil-design-eng" },
+  { source: "jakubkrehel/skills", skill: "better-ui" },
+  { source: "jakubkrehel/skills", skill: "better-accessibility" },
+];
+
+/**
+ * Arguments for `npx skills@latest add`. Skills land in `.agents/skills/`
+ * (the `universal` target, read by Cursor and other agents) and are also
+ * copied for each selected tool that needs its own folder. With Claude Code
+ * as the only tool, `.agents/skills/` would go unused, so it is skipped.
+ * `--copy` writes real files instead of symlinks so the first commit works
+ * the same on Windows.
+ */
+export function getSkillArgs({ source, skill }, agents) {
+  const tools = agents.map((id) => AGENTS.find((agent) => agent.id === id).skillsAgent);
+  const claudeOnly = agents.length === 1 && agents[0] === "claude";
+  const targets = claudeOnly ? tools : ["universal", ...tools];
+  const args = ["--yes", "skills@latest", "add", source];
+  if (skill) args.push("--skill", skill);
+  for (const target of targets) args.push("-a", target);
+  args.push("--copy", "-y");
+  return args;
+}
+
+/** Manual command for the skills (interactive), shown when they were not installed. */
+export function getSkillsCommand() {
+  return SKILLS.map(({ source, skill }) =>
+    ["npx skills@latest add", source, ...(skill ? ["--skill", skill] : [])].join(" "),
+  ).join(" && ");
+}

package/src/utils/args.js

@@ -5,7 +5,7 @@
  * Value-taking long flags consume the next token when it is not itself a flag.
  */
 
-const VALUE_FLAGS = new Set(["name", "template", "tools"]);
+const VALUE_FLAGS = new Set(["name", "template", "tools", "agent"]);
 
 /**
  * @param {string[]} argv