vibes-plug 2.5.0 → 2.14.1

package/index.js

@@ -0,0 +1,19 @@
+/**
+ * Vibes Plug - Universal AI Plugin with 145+ Specialized Skills
+ * Platform support: Antigravity (AGY), Claude Code, and Cursor IDE
+ */
+
+const path = require('path');
+const pluginJson = require('./plugin.json');
+
+module.exports = {
+  name: pluginJson.name,
+  version: pluginJson.version,
+  description: pluginJson.description,
+  author: pluginJson.author,
+  license: pluginJson.license,
+  platforms: pluginJson.platforms,
+  pluginRoot: path.resolve(__dirname),
+  skillsPath: path.resolve(__dirname, 'skills'),
+  scriptsPath: path.resolve(__dirname, 'scripts'),
+};

package/package.json

@@ -1,23 +1,59 @@
 {
   "name": "vibes-plug",
-  "version": "2.5.0",
-  "description": "Customization plugin for Antigravity containing 103+ specialized *skills* updated for the modern 2026 tech stack (React 19, Tailwind v4, Bun, Hono, Supabase Auth v3). Designed to support software development, UI/UX design, SEO optimization, and SaaS business strategies",
+  "version": "2.14.1",
+  "description": "Universal AI plugin with 125 specialized skills for Antigravity, Claude, and Cursor. Updated for the modern 2026 tech stack (React 19, Tailwind v4, Bun, Hono, Supabase Auth v3). Designed to support software development, UI/UX design, SEO optimization, and SaaS business strategies",
   "main": "index.js",
+  "bin": {
+    "vibes-plug": "./scripts/install.js"
+  },
+  "files": [
+    "index.js",
+    "plugin.json",
+    "AGENTS.md",
+    "CLAUDE.md",
+    ".cursorrules",
+    "scripts",
+    "skills",
+    "!**/__pycache__/**",
+    "!**/*.pyc",
+    "!**/*.pyo",
+    ".claude",
+    ".cursor",
+    "README.md",
+    "BLUEPRINT.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "generate:gif": "python scripts/generate_swarm_gif.py",
+    "install-all": "node scripts/install.js --all",
+    "install-claude": "node scripts/install.js --claude",
+    "install-cursor": "node scripts/install.js --cursor"
   },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/roedyrustam/vibes-plug.git"
   },
   "keywords": [
-    "gemini",
-    "plugins",
-    "gemini",
-    "skills"
+    "antigravity",
+    "claude-code",
+    "cursor-rules",
+    "ai-agents",
+    "multi-agent-swarm",
+    "mcp",
+    "model-context-protocol",
+    "vibe-coding",
+    "react19",
+    "nextjs15",
+    "tailwindcss-v4",
+    "bun",
+    "skills",
+    "developer-tools",
+    "zero-to-prod"
   ],
   "author": "Roedy Rustam",
-  "license": "ISC",
+  "license": "MIT",
   "bugs": {
     "url": "https://github.com/roedyrustam/vibes-plug/issues"
   },

package/plugin.json

@@ -1,8 +1,25 @@
-{
-  "name": "vibes-plug",
-  "version": "2.5.0",
-  "description": "Plugin kustomisasi untuk Antigravity.",
-  "author": "roedy rustam",
-  "license": "MIT",
-  "repository": "https://github.com/roedyrustam/vibes-plug.git"
+{
+  "name": "vibes-plug",
+  "version": "2.14.0",
+  "description": "Universal AI plugin with 125 specialized skills for Antigravity, Claude, and Cursor.",
+  "author": "Roedy Rustam",
+  "license": "MIT",
+  "repository": "https://github.com/roedyrustam/vibes-plug.git",
+  "platforms": {
+    "antigravity": {
+      "entry": "AGENTS.md",
+      "config": "plugin.json",
+      "skillsDir": "skills/"
+    },
+    "claude": {
+      "entry": "CLAUDE.md",
+      "rulesDir": ".claude/rules/",
+      "skillsDir": "skills/"
+    },
+    "cursor": {
+      "entry": ".cursorrules",
+      "rulesDir": ".cursor/rules/",
+      "skillsDir": "skills/"
+    }
+  }
 }

package/scripts/check-anti-slop.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+/**
+ * scripts/check-anti-slop.js
+ * Automated Anti-AI Slop Validator for vibes-plug & user codebases.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const SLOP_PATTERNS = [
+  { name: 'Lazy Truncation Placeholder', regex: /\/\/\s*\.\.\.\s*(rest|code|implement|logic)/i },
+  { name: 'Unfinished TODO Stub', regex: /\/\/\s*TODO:\s*(implement|add logic|fill in|later)/i },
+  { name: 'Mock Data in Production', regex: /\/\/\s*mock data for now/i },
+  { name: 'Syntax Narration Comment', regex: /\/\/\s*(increment\s+\w+|return\s+(the\s+)?\w+|import\s+\w+\s+from)/i },
+];
+
+const IGNORE_DIRS = ['node_modules', '.git', '.next', 'dist', 'build', 'artifacts', '.gemini'];
+
+let slopCount = 0;
+
+function scanDir(dir) {
+  if (!fs.existsSync(dir)) return;
+  const files = fs.readdirSync(dir);
+  for (const file of files) {
+    if (IGNORE_DIRS.includes(file)) continue;
+    const fullPath = path.join(dir, file);
+    const stat = fs.statSync(fullPath);
+    if (stat.isDirectory()) {
+      scanDir(fullPath);
+    } else if (/\.(ts|tsx|js|jsx|py|go|rs)$/.test(file) && !file.includes('check-anti-slop')) {
+      const content = fs.readFileSync(fullPath, 'utf8');
+      const lines = content.split('\n');
+      lines.forEach((line, index) => {
+        SLOP_PATTERNS.forEach(({ name, regex }) => {
+          if (regex.test(line)) {
+            console.error(`🚨 [AI SLOP DETECTED] ${fullPath}:${index + 1} (${name}) -> ${line.trim()}`);
+            slopCount++;
+          }
+        });
+      });
+    }
+  }
+}
+
+console.log('🔍 Scanning repository for AI slop and placeholder code...');
+scanDir(process.cwd());
+
+if (slopCount > 0) {
+  console.error(`\n❌ Failed: ${slopCount} AI slop violations detected. Purge placeholders before commit.`);
+  process.exit(1);
+} else {
+  console.log('✅ Anti-Slop Audit Passed: Clean code, zero AI slop detected.');
+}

package/scripts/generate_swarm_gif.py

@@ -0,0 +1,295 @@
+import os
+import math
+from PIL import Image, ImageDraw, ImageFont
+
+W, H = 960, 440
+NUM_FRAMES = 50
+
+# Load system fonts
+font_title = ImageFont.truetype('C:\\Windows\\Fonts\\segoeuib.ttf', 16)
+font_subtitle = ImageFont.truetype('C:\\Windows\\Fonts\\segoeui.ttf', 12)
+font_badge = ImageFont.truetype('C:\\Windows\\Fonts\\segoeuib.ttf', 11)
+font_director_title = ImageFont.truetype('C:\\Windows\\Fonts\\segoeuib.ttf', 13)
+font_director_sub = ImageFont.truetype('C:\\Windows\\Fonts\\segoeui.ttf', 10)
+font_card_num = ImageFont.truetype('C:\\Windows\\Fonts\\segoeuib.ttf', 10)
+font_card_title = ImageFont.truetype('C:\\Windows\\Fonts\\segoeuib.ttf', 12)
+font_card_body = ImageFont.truetype('C:\\Windows\\Fonts\\segoeui.ttf', 10)
+font_card_status = ImageFont.truetype('C:\\Windows\\Fonts\\segoeuib.ttf', 9)
+font_console = ImageFont.truetype('C:\\Windows\\Fonts\\consola.ttf', 11)
+
+CARDS = [
+    {
+        "num": "01",
+        "title": "Ideation & PRD",
+        "skills": "brainstorming\nprd-architect",
+        "color": (6, 182, 212),       # Cyan
+        "hex": "#06b6d4",
+        "msg": "[Phase 1/5] Swarm Director: Synthesizing PRD.md, ERD & Architecture Matrix...",
+    },
+    {
+        "num": "02",
+        "title": "UI/UX & Design",
+        "skills": "senior-frontend\ntailwind-v4 • hig",
+        "color": (168, 85, 247),     # Purple
+        "hex": "#a855f7",
+        "msg": "[Phase 2/5] Frontend Swarm: Scaffolding Tailwind v4, M3 tokens & glassmorphic UI...",
+    },
+    {
+        "num": "03",
+        "title": "Backend & DB",
+        "skills": "js-backend • go\nmcp-architect",
+        "color": (59, 130, 246),      # Blue
+        "hex": "#3b82f6",
+        "msg": "[Phase 3/5] Backend Swarm: Provisioning Hono/Bun APIs & Model Context Protocol...",
+    },
+    {
+        "num": "04",
+        "title": "Frontier AI & Voice",
+        "skills": "voice-ai • graph-rag\nvector-db • evals",
+        "color": (236, 72, 153),     # Pink / Magenta
+        "hex": "#ec4899",
+        "msg": "[Phase 4/5] AI Swarm: Ultra-low latency Voice (<300ms) & Neo4j GraphRAG active...",
+    },
+    {
+        "num": "05",
+        "title": "Hardening & Prod",
+        "skills": "zero-to-prod\nproduction-hardener",
+        "color": (16, 185, 129),     # Emerald Green
+        "hex": "#10b981",
+        "msg": "[Phase 5/5] QA Auditor: Running Zero-to-Prod gates — 140 Skills Certified (100%)",
+    },
+]
+
+# Card layout
+CARD_W = 168
+CARD_H = 110
+CARD_Y = 205
+CARD_SPACING = 14
+TOTAL_CARDS_W = len(CARDS) * CARD_W + (len(CARDS) - 1) * CARD_SPACING
+START_X = (W - TOTAL_CARDS_W) // 2
+
+for i, card in enumerate(CARDS):
+    card["x1"] = START_X + i * (CARD_W + CARD_SPACING)
+    card["x2"] = card["x1"] + CARD_W
+    card["y1"] = CARD_Y
+    card["y2"] = CARD_Y + CARD_H
+    card["cx"] = card["x1"] + CARD_W // 2
+
+DIRECTOR_CX = W // 2
+DIRECTOR_CY = 112
+DIRECTOR_W = 190
+DIRECTOR_H = 64
+
+def draw_lightning(draw, x, y, color='#38bdf8'):
+    # Precise vector lightning bolt
+    pts = [
+        (x + 5, y),
+        (x, y + 9),
+        (x + 5, y + 9),
+        (x + 2, y + 17),
+        (x + 11, y + 6),
+        (x + 6, y + 6),
+        (x + 9, y)
+    ]
+    draw.polygon(pts, fill=color)
+
+def draw_checkmark(draw, x, y, color='#10b981'):
+    draw.line([(x, y + 4), (x + 3, y + 8)], fill=color, width=2)
+    draw.line([(x + 3, y + 8), (x + 9, y)], fill=color, width=2)
+
+def draw_play_arrow(draw, x, y, color):
+    pts = [(x, y), (x + 7, y + 4), (x, y + 8)]
+    draw.polygon(pts, fill=color)
+
+frames = []
+
+for frame_idx in range(NUM_FRAMES):
+    img = Image.new('RGB', (W, H), '#080c16')
+    draw = ImageDraw.Draw(img)
+
+    # 1. Subtle background grid
+    for gx in range(0, W, 32):
+        draw.line([(gx, 0), (gx, H)], fill='#0d1527', width=1)
+    for gy in range(0, H, 32):
+        draw.line([(0, gy), (W, gy)], fill='#0d1527', width=1)
+
+    # 2. Header
+    draw.line([(START_X, 48), (START_X + TOTAL_CARDS_W, 48)], fill='#1e293b', width=1)
+    
+    # Title & icon
+    draw_lightning(draw, START_X + 2, 20, '#38bdf8')
+    draw.text((START_X + 20, 18), 'VIBES PLUG', fill='#38bdf8', font=font_title)
+    draw.text((START_X + 135, 21), '— Universal Agentic Swarm Workflow (2026 Edition)', fill='#94a3b8', font=font_subtitle)
+
+    # 145+ Skills Badge (Pill)
+    badge_text = '145+ SKILLS ACTIVE'
+    badge_w, badge_h = 138, 24
+    badge_x = START_X + TOTAL_CARDS_W - badge_w
+    badge_y = 17
+    draw.rounded_rectangle([badge_x, badge_y, badge_x + badge_w, badge_y + badge_h], radius=12, fill='#6d28d9', outline='#8b5cf6', width=1)
+    draw.text((badge_x + 14, badge_y + 4), badge_text, fill='#ffffff', font=font_badge)
+
+    # Determine active phase (0 to 4)
+    phase_idx = min(frame_idx // 10, 4)
+    phase_progress = (frame_idx % 10) / 9.0
+
+    # Overall progress percentage
+    pct = int(((frame_idx + 1) / NUM_FRAMES) * 100)
+
+    # 3. Connector Lines from Director to Cards
+    for i, card in enumerate(CARDS):
+        c_x = card["cx"]
+        c_y = card["y1"]
+        d_x = DIRECTOR_CX
+        d_y = DIRECTOR_CY + DIRECTOR_H // 2
+
+        if i < phase_idx:
+            line_color = '#1e3a5f'
+            width = 1
+        elif i == phase_idx:
+            line_color = card["hex"]
+            width = 2
+        else:
+            line_color = '#131d2e'
+            width = 1
+
+        draw.line([(d_x, d_y), (c_x, c_y)], fill=line_color, width=width)
+
+    # 4. Animated Data Particles on Active Line
+    active_card = CARDS[phase_idx]
+    src_x, src_y = DIRECTOR_CX, DIRECTOR_CY + DIRECTOR_H // 2
+    dst_x, dst_y = active_card["cx"], active_card["y1"]
+
+    for p_offset in [0.0, 0.48]:
+        t = (phase_progress + p_offset) % 1.0
+        px = src_x + (dst_x - src_x) * t
+        py = src_y + (dst_y - src_y) * t
+        col = active_card["color"]
+        draw.ellipse([px - 4, py - 4, px + 4, py + 4], fill=col)
+        draw.ellipse([px - 2, py - 2, px + 2, py + 2], fill='#ffffff')
+
+    # 5. Director Node (Center)
+    dir_x1 = DIRECTOR_CX - DIRECTOR_W // 2
+    dir_x2 = DIRECTOR_CX + DIRECTOR_W // 2
+    dir_y1 = DIRECTOR_CY - DIRECTOR_H // 2
+    dir_y2 = DIRECTOR_CY + DIRECTOR_H // 2
+
+    # Outer glow pulse
+    pulse_size = int(math.sin(frame_idx * 0.3) * 3)
+    draw.rounded_rectangle(
+        [dir_x1 - 4 - pulse_size, dir_y1 - 4 - pulse_size, dir_x2 + 4 + pulse_size, dir_y2 + 4 + pulse_size],
+        radius=16,
+        outline='#4c1d95',
+        width=1
+    )
+    # Main node box
+    draw.rounded_rectangle([dir_x1, dir_y1, dir_x2, dir_y2], radius=12, fill='#111827', outline='#8b5cf6', width=2)
+    # Icon and Title
+    draw.text((dir_x1 + 18, dir_y1 + 14), 'SWARM DIRECTOR', fill='#f8fafc', font=font_director_title)
+    draw.text((dir_x1 + 18, dir_y1 + 36), 'AGY • Claude Code • Cursor', fill='#c084fc', font=font_director_sub)
+    # Pulsing status dot with margin
+    dot_col = '#10b981' if (frame_idx % 6 < 4) else '#059669'
+    draw.ellipse([dir_x2 - 20, dir_y1 + 15, dir_x2 - 12, dir_y1 + 23], fill=dot_col)
+
+    # 6. Domain Cards
+    for i, card in enumerate(CARDS):
+        is_active = (i == phase_idx)
+        is_completed = (i < phase_idx)
+        x1, y1, x2, y2 = card["x1"], card["y1"], card["x2"], card["y2"]
+
+        if is_active:
+            bg_col = '#0e172a'
+            border_col = card["hex"]
+            border_w = 2
+            draw.rounded_rectangle([x1 - 2, y1 - 2, x2 + 2, y2 + 2], radius=10, outline=border_col, width=1)
+        elif is_completed:
+            bg_col = '#0a101f'
+            border_col = '#1e293b'
+            border_w = 1
+        else:
+            bg_col = '#090d16'
+            border_col = '#151f32'
+            border_w = 1
+
+        draw.rounded_rectangle([x1, y1, x2, y2], radius=8, fill=bg_col, outline=border_col, width=border_w)
+
+        # Phase number pill
+        pill_w, pill_h = 24, 16
+        pill_x = x1 + 10
+        pill_y = y1 + 10
+        if is_active:
+            pill_fill = card["hex"]
+            pill_txt_col = '#ffffff'
+        elif is_completed:
+            pill_fill = '#10b981'
+            pill_txt_col = '#ffffff'
+        else:
+            pill_fill = '#1e293b'
+            pill_txt_col = '#64748b'
+
+        draw.rounded_rectangle([pill_x, pill_y, pill_x + pill_w, pill_y + pill_h], radius=4, fill=pill_fill)
+        draw.text((pill_x + 5, pill_y + 1), card["num"], fill=pill_txt_col, font=font_card_num)
+
+        # Card Title
+        title_col = '#f8fafc' if is_active else ('#cbd5e1' if is_completed else '#64748b')
+        draw.text((pill_x + pill_w + 6, pill_y + 1), card["title"], fill=title_col, font=font_card_title)
+
+        # Skills list
+        skills_col = '#94a3b8' if (is_active or is_completed) else '#475569'
+        draw.text((x1 + 10, y1 + 38), card["skills"], fill=skills_col, font=font_card_body, spacing=3)
+
+        # Status indicator at bottom of card
+        if is_completed:
+            draw_checkmark(draw, x1 + 10, y2 - 17, '#10b981')
+            draw.text((x1 + 24, y2 - 18), 'COMPLETED', fill='#10b981', font=font_card_status)
+        elif is_active:
+            draw_play_arrow(draw, x1 + 10, y2 - 16, card["hex"])
+            draw.text((x1 + 22, y2 - 18), 'EXECUTING...', fill=card["hex"], font=font_card_status)
+            draw.ellipse([x2 - 18, y2 - 16, x2 - 10, y2 - 8], fill=card["hex"])
+        else:
+            draw.ellipse([x1 + 11, y2 - 15, x1 + 16, y2 - 10], outline='#475569', width=1)
+            draw.text((x1 + 22, y2 - 18), 'QUEUED', fill='#475569', font=font_card_status)
+
+    # 7. Bottom Console & Execution Monitor
+    bar_x1 = START_X
+    bar_x2 = START_X + TOTAL_CARDS_W
+    bar_y1 = 338
+    bar_y2 = 418
+    draw.rounded_rectangle([bar_x1, bar_y1, bar_x2, bar_y2], radius=8, fill='#0a101f', outline='#1e293b', width=1)
+
+    # Console text with blinking cursor
+    cursor = '█' if (frame_idx % 4 < 2) else ' '
+    draw.text((bar_x1 + 16, bar_y1 + 14), active_card["msg"] + cursor, fill='#e2e8f0', font=font_console)
+
+    # Progress bar track
+    pb_x1 = bar_x1 + 16
+    pb_x2 = bar_x2 - 16
+    pb_y1 = bar_y1 + 42
+    pb_y2 = pb_y1 + 16
+    draw.rounded_rectangle([pb_x1, pb_y1, pb_x2, pb_y2], radius=4, fill='#0f172a', outline='#1e293b', width=1)
+
+    # Progress bar fill
+    fill_w = max(int((pb_x2 - pb_x1) * (pct / 100.0)), 14)
+    fill_col = active_card["hex"]
+    draw.rounded_rectangle([pb_x1 + 1, pb_y1 + 1, pb_x1 + fill_w - 1, pb_y2 - 1], radius=3, fill=fill_col)
+
+    # Progress percentage label
+    pct_text = f'{pct}% Complete'
+    draw.text((pb_x2 - 82, pb_y1 + 2), pct_text, fill='#ffffff' if pct > 85 else '#94a3b8', font=font_card_num)
+
+    frames.append(img)
+
+# Save as animated GIF
+PLUGIN_ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+output_path = os.path.join(PLUGIN_ROOT, 'vibes-swarm-demo.gif')
+frames[0].save(
+    output_path,
+    save_all=True,
+    append_images=frames[1:],
+    duration=80,
+    loop=0,
+    optimize=True
+)
+
+file_size = os.path.getsize(output_path)
+print(f'Generated {output_path}: {file_size / 1024:.1f} KB, {NUM_FRAMES} frames')

package/scripts/install.js

@@ -0,0 +1,201 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const PLUGIN_ROOT = path.resolve(__dirname, '..');
+const HOME = os.homedir();
+
+// Platform detection and target directories
+const platforms = {
+    antigravity: {
+        name: 'Antigravity (AGY)',
+        globalDir: path.join(HOME, '.gemini', 'config', 'plugins', 'vibes-plug'),
+        detect: () => fs.existsSync(path.join(HOME, '.gemini')),
+    },
+    claude: {
+        name: 'Claude Code',
+        globalDir: path.join(HOME, '.claude'),
+        detect: () => {
+            // Claude Code is installed if ~/.claude exists or `claude` command is available
+            return fs.existsSync(path.join(HOME, '.claude'));
+        },
+    },
+    cursor: {
+        name: 'Cursor IDE',
+        projectOnly: true,
+        detect: () => {
+            // Cursor uses per-project .cursor/rules/ — always available
+            return true;
+        },
+    },
+};
+
+function copyRecursiveSync(src, dest) {
+    const stat = fs.statSync(src);
+    if (stat.isDirectory()) {
+        if (!fs.existsSync(dest)) fs.mkdirSync(dest, { recursive: true });
+        fs.readdirSync(src).forEach(child => {
+            copyRecursiveSync(path.join(src, child), path.join(dest, child));
+        });
+    } else {
+        fs.copyFileSync(src, dest);
+    }
+}
+
+function installForAntigravity() {
+    const target = platforms.antigravity.globalDir;
+    if (path.resolve(PLUGIN_ROOT) === path.resolve(target)) {
+        console.log('  ✅ Already installed at correct location.');
+        return;
+    }
+    console.log(`  📁 Copying to ${target}`);
+    copyRecursiveSync(PLUGIN_ROOT, target);
+    console.log('  ✅ Done.');
+}
+
+function installForClaude(projectDir) {
+    // Global: Copy CLAUDE.md to ~/.claude/CLAUDE.md (append or create)
+    const globalClaudeDir = platforms.claude.globalDir;
+    if (!fs.existsSync(globalClaudeDir)) {
+        fs.mkdirSync(globalClaudeDir, { recursive: true });
+    }
+
+    // Copy CLAUDE.md
+    const claudeMdSrc = path.join(PLUGIN_ROOT, 'CLAUDE.md');
+    const claudeMdDest = path.join(globalClaudeDir, 'CLAUDE.md');
+    if (fs.existsSync(claudeMdSrc)) {
+        fs.copyFileSync(claudeMdSrc, claudeMdDest);
+        console.log(`  ✅ Copied CLAUDE.md → ${claudeMdDest}`);
+    }
+
+    // Copy .claude/rules/
+    const rulesDir = path.join(PLUGIN_ROOT, '.claude', 'rules');
+    const targetRulesDir = path.join(globalClaudeDir, 'rules');
+    if (fs.existsSync(rulesDir)) {
+        copyRecursiveSync(rulesDir, targetRulesDir);
+        console.log(`  ✅ Copied rules → ${targetRulesDir}`);
+    }
+
+    // Copy skills directory
+    const skillsSrc = path.join(PLUGIN_ROOT, 'skills');
+    const skillsDest = path.join(globalClaudeDir, 'skills');
+    if (fs.existsSync(skillsSrc)) {
+        copyRecursiveSync(skillsSrc, skillsDest);
+        console.log(`  ✅ Copied skills → ${skillsDest}`);
+    }
+
+    // Per-project install
+    if (projectDir) {
+        const projClaude = path.join(projectDir, '.claude');
+        if (!fs.existsSync(projClaude)) fs.mkdirSync(projClaude, { recursive: true });
+        fs.copyFileSync(claudeMdSrc, path.join(projectDir, 'CLAUDE.md'));
+        copyRecursiveSync(rulesDir, path.join(projClaude, 'rules'));
+        console.log(`  ✅ Per-project install → ${projectDir}`);
+    }
+}
+
+function installForCursor(projectDir) {
+    if (!projectDir) {
+        console.log('  ⚠️  Cursor requires a project directory. Usage: node install.js --cursor --project /path/to/project');
+        return;
+    }
+
+    // Copy .cursorrules to project root
+    const cursorRulesSrc = path.join(PLUGIN_ROOT, '.cursorrules');
+    const cursorRulesDest = path.join(projectDir, '.cursorrules');
+    if (fs.existsSync(cursorRulesSrc)) {
+        fs.copyFileSync(cursorRulesSrc, cursorRulesDest);
+        console.log(`  ✅ Copied .cursorrules → ${cursorRulesDest}`);
+    }
+
+    // Copy .cursor/rules/ to project
+    const mdcSrc = path.join(PLUGIN_ROOT, '.cursor', 'rules');
+    const mdcDest = path.join(projectDir, '.cursor', 'rules');
+    if (fs.existsSync(mdcSrc)) {
+        copyRecursiveSync(mdcSrc, mdcDest);
+        console.log(`  ✅ Copied .cursor/rules/ → ${mdcDest}`);
+    }
+
+    // Copy skills/ for reference
+    const skillsSrc = path.join(PLUGIN_ROOT, 'skills');
+    const skillsDest = path.join(projectDir, '.cursor', 'skills');
+    if (fs.existsSync(skillsSrc)) {
+        copyRecursiveSync(skillsSrc, skillsDest);
+        console.log(`  ✅ Copied skills → ${skillsDest}`);
+    }
+}
+
+// --- CLI ---
+function main() {
+    const args = process.argv.slice(2);
+    const helpFlag = args.includes('--help') || args.includes('-h');
+    const allFlag = args.includes('--all');
+    const agyFlag = args.includes('--antigravity') || args.includes('--agy');
+    const claudeFlag = args.includes('--claude');
+    const cursorFlag = args.includes('--cursor');
+    const projectIdx = args.indexOf('--project');
+    const projectDir = projectIdx !== -1 ? args[projectIdx + 1] : null;
+
+    const pkg = require('../package.json');
+    const version = pkg.version || '2.11.0';
+
+    if (helpFlag || args.length === 0) {
+        console.log(`
+╔══════════════════════════════════════════════════════════╗
+║       vibes-plug installer v${version.padEnd(6)} (2026 Edition)        ║
+║    Universal AI Plugin for AGY, Claude, and Cursor       ║
+╚══════════════════════════════════════════════════════════╝
+
+Usage: npx vibes-plug [options] or node install.js [options]
+
+Options:
+  --all                   Install for all detected platforms
+  --antigravity, --agy    Install for Antigravity
+  --claude                Install for Claude Code (global + optional per-project)
+  --cursor                Install for Cursor IDE (requires --project)
+  --project <path>        Target project directory (for Claude/Cursor per-project install)
+  --help, -h              Show this help message
+
+Examples:
+  npx vibes-plug --all
+  npx vibes-plug --claude
+  npx vibes-plug --cursor --project ./my-app
+  node scripts/install.js --all
+`);
+        return;
+    }
+
+    console.log(`\n🚀 vibes-plug installer v${version}\n`);
+
+    // Detect platforms
+    console.log('📡 Detecting platforms...');
+    Object.entries(platforms).forEach(([key, p]) => {
+        const detected = p.detect();
+        console.log(`  ${detected ? '✅' : '❌'} ${p.name}: ${detected ? 'detected' : 'not found'}`);
+    });
+    console.log('');
+
+    if (allFlag || agyFlag) {
+        console.log('🔧 Installing for Antigravity...');
+        installForAntigravity();
+        console.log('');
+    }
+
+    if (allFlag || claudeFlag) {
+        console.log('🔧 Installing for Claude Code...');
+        installForClaude(projectDir);
+        console.log('');
+    }
+
+    if (allFlag || cursorFlag) {
+        console.log('🔧 Installing for Cursor IDE...');
+        installForCursor(projectDir);
+        console.log('');
+    }
+
+    console.log('✨ Installation complete!\n');
+}
+
+main();