Kurulum

Gereksinimler

• Node.js 20.9 veya üzeri.
• next (Next.js) veya @tanstack/react-start (TanStack Start) içeren bir package.json. Yoksa --framework verin.
• Komutu proje kök dizininde, package.json ile aynı yerde çalıştırın.

Kurulum

$ pnpm dlx @virastack/ai init

CLI önce tespit ettiklerini, sonra yazdığı her dosyayı listeler. Bayraksız çalıştırıldığında Claude Code ve Cursor için kural kurar:

ViraStack AI v2.0.0
Framework: nextjs · Agents: claude, cursor · i18n: no · Package manager: pnpm

  + .claude/rules/virastack/core.md · created
  + .claude/rules/virastack/architecture.md · created
  ...
  + .cursor/rules/virastack/nextjs.mdc · created
  + AGENTS.md · created
  + CLAUDE.md · created
  + .virastack/ai.json · created

27 created · 0 updated · 0 removed · 0 skipped
ViraStack AI rules are ready.

Yeni dosyaları .virastack/ai.json dahil commit edin. Ekip arkadaşlarınız ve sonraki güncellemeler bu dosyaya dayanır.

AI araçlarını seçin

Sadece kullandığınız araçlar için kural kurmak üzere --agent kullanın:

$ pnpm dlx @virastack/ai init --agent claude

• --agent claude: .claude/rules/virastack/ ve CLAUDE.md içinde @AGENTS.md satırı.
• --agent cursor: .cursor/rules/virastack/.
• --agent claude,cursor: ikisi birden. Varsayılan budur.
• --agent none: .agents/rules/virastack/ içinde düz Markdown kurallar. Agent’lar bunları AGENTS.md haritasından okur.

Seçim .virastack/ai.json içine kaydedilir ve sonraki init aynı seçimi kullanır. Değiştirmek için init komutunu farklı bir --agent ile çalıştırın. Diğer aracın kural dosyaları silinir.

ViraStack Start ile

ViraStack Start kurulumda “Hangi AI kodlama araçlarını kullanıyorsunuz?” diye sorar ve ViraStack AI’ı cevabınızla çalıştırır. Mevcut bir Start projesinde kuralları add ai ile ekleyin veya yenileyin:

$ pnpm dlx virastack@latest add ai --agent claude

Güncelleme

$ pnpm dlx @virastack/ai@2 init

init komutunu tekrar çalıştırın. Değiştirmediğiniz kurallar güncellenir, yeni sürümün kaldırdığı kurallar silinir. Değiştirdiğiniz kurallar siz onaylamadan korunur. Değiştirilmiş kurallar ve --force için özelleştirme sayfasına bakın.