nex-framework-cli 1.0.17 → 1.0.19

package/cli/nex-cli.js

@@ -28,7 +28,7 @@ program.configureHelp({
 program
   .name('nex')
   .description('NEX Framework - Framework completo de agentes AI')
-  .version('1.0.16', '-v, --version', 'Mostra a versão')
+      .version('1.0.18', '-v, --version', 'Mostra a versão')
   .addHelpText('before', chalk.bold.cyan(`
 ╔════════════════════════════════════════════════════════════════╗
 ║              NEX Framework - CLI v1.0.9                        ║
@@ -62,6 +62,7 @@ Exemplos:
 `))
   .action(async (options) => {
     console.log(chalk.blue('🚀 Inicializando projeto NEX...'))
+    console.log()
     
     const answers = await inquirer.prompt([
       {
@@ -84,10 +85,11 @@ Exemplos:
     const projectName = options.name || answers.projectName
     const template = options.template || answers.template
 
-    // Criar estrutura do projeto
+    // Criar estrutura do projeto (sem config, usa global)
     await createProjectStructure(projectName, template)
     
-    console.log(chalk.green(`✅ Projeto ${projectName} criado com sucesso!`))
+    console.log(chalk.green(`\n✅ Projeto ${projectName} criado com sucesso!`))
+    console.log()
   })
 
 // Comando: plan
@@ -340,20 +342,37 @@ program
   })
 
 // Comando: config
-program
+const configCmd = program
   .command('config')
-  .description('Gerencia configurações')
-  .option('get <key>', 'Obtém valor de configuração')
-  .option('set <key> <value>', 'Define valor de configuração')
-  .option('list', 'Lista todas as configurações')
-  .action(async (options) => {
-    if (options.get) {
-      // Obter configuração
-    } else if (options.set) {
-      // Definir configuração
-    } else if (options.list) {
-      // Listar configurações
-    }
+  .description('Gerencia configurações do NEX CLI')
+
+configCmd
+  .command('reset')
+  .description('Reconfigura o NEX CLI (nome, idiomas, integração Cursor)')
+  .action(async () => {
+    const { runSetup } = await import('../scripts/postinstall.js')
+    await runSetup()
+  })
+
+configCmd
+  .command('show')
+  .alias('list')
+  .description('Mostra a configuração atual')
+  .action(async () => {
+    const { default: NEXMarketplace } = await import('../src/services/nex-marketplace/NEXMarketplace.js')
+    const marketplace = new NEXMarketplace()
+    const config = marketplace.getGlobalConfig()
+    
+    console.log(chalk.blue('\n⚙️  Configuração do NEX CLI\n'))
+    console.log(chalk.gray('Usuário:'))
+    console.log(chalk.white(`  Nome: ${config.user.name}`))
+    console.log(chalk.white(`  Idioma de conversação: ${config.user.conversationLanguage}`))
+    console.log(chalk.white(`  Idioma de documentos: ${config.user.documentLanguage}`))
+    console.log(chalk.gray('\nCursor:'))
+    console.log(chalk.white(`  Integração: ${config.cursor.enabled ? chalk.green('Habilitada') : chalk.red('Desabilitada')}`))
+    
+    const configPath = marketplace.getGlobalConfigPath()
+    console.log(chalk.gray(`\nArquivo: ${configPath}\n`))
   })
 
 // Funções auxiliares
@@ -391,6 +410,11 @@ Projeto criado com NEX Framework.
 npm install
 npm start
 \`\`\`
+
+## NEX Configuration
+
+As configurações do NEX (idioma, integração com Cursor) são gerenciadas globalmente.
+Para ver ou alterar: \`nex config\`
 `
   await fs.writeFile(path.join(projectDir, 'README.md'), readme)
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nex-framework-cli",
-  "version": "1.0.17",
+  "version": "1.0.19",
   "description": "NEX CLI - Command-line interface for NEX Framework and Agent Marketplace",
   "type": "module",
   "main": "cli/nex-cli.js",
@@ -11,12 +11,14 @@
     "cli/",
     "src/services/nex-marketplace/",
     "src/services/nex-installer/",
+    "scripts/postinstall.js",
     "registry/",
     "README.md",
     "LICENSE"
   ],
   "scripts": {
     "prepublishOnly": "npm run test",
+    "postinstall": "node scripts/postinstall.js",
     "test": "node cli/nex-cli.js --version",
     "test:api": "node scripts/test-marketplace-api.js",
     "publish:cli": "node scripts/publish-cli.js",

package/scripts/README.md

@@ -0,0 +1,196 @@
+# 📦 Scripts do NEX Framework
+
+Scripts utilitários para gerenciar o projeto NEX.
+
+---
+
+## 🗄️ Scripts de Banco de Dados
+
+### `check-database.js`
+
+**Descrição:** Verifica o estado atual do banco de dados Supabase
+
+**Uso:**
+```bash
+npm run db:check
+```
+
+**O que faz:**
+- ✅ Conecta ao Supabase
+- ✅ Verifica se as 7 tabelas do NEX Marketplace existem
+- ✅ Mostra status de cada tabela (✅ OK, ❌ Faltando, ⚠️ Erro)
+- ✅ Conta quantos agentes estão cadastrados
+- ✅ Lista os agentes existentes
+
+**Pré-requisitos:**
+```powershell
+$env:NEXT_PUBLIC_SUPABASE_URL="https://seu-projeto.supabase.co"
+$env:NEXT_PUBLIC_SUPABASE_ANON_KEY="sua-anon-key"
+```
+
+**Exemplo de saída:**
+```
+🔗 Connecting to Supabase...
+📍 URL: https://auqfubbpxjzuzzqfazdp.supabase.co
+
+🔍 Checking for NEX Marketplace tables...
+
+📊 Database Status:
+
+✅ nex_marketplace_agents              OK
+✅ nex_marketplace_versions            OK
+✅ nex_marketplace_installs            OK
+✅ nex_marketplace_reviews             OK
+✅ nex_marketplace_bundles             OK
+✅ nex_marketplace_analytics           OK
+✅ nex_marketplace_stars               OK
+
+🎉 All tables exist! Database is ready.
+
+📊 Checking data...
+✅ Found 3 agents:
+   - anx: ANX - Analysis Expert (v1.0.0)
+   - pmx: PMX - Product Management Expert (v1.0.0)
+   - arx: ARX - Architecture Expert (v1.0.0)
+```
+
+---
+
+### `run-migration.js`
+
+**Descrição:** Helper para executar migrations do Supabase
+
+**Uso:**
+```bash
+npm run db:migrate
+```
+
+**O que faz:**
+- ✅ Lê o arquivo `supabase/migrations/002_nex_agent_marketplace.sql`
+- ✅ Tenta executar via API do Supabase
+- ✅ Se falhar, fornece instruções para execução manual
+
+**Pré-requisitos:**
+```powershell
+$env:NEXT_PUBLIC_SUPABASE_URL="https://seu-projeto.supabase.co"
+$env:SUPABASE_SERVICE_ROLE_KEY="sua-service-role-key"
+```
+
+**Nota:** Na maioria dos casos, é melhor executar a migration **manualmente** via SQL Editor do Supabase. Este script é um helper que orienta o processo.
+
+---
+
+## ⚙️ Script de Setup do Supabase
+
+### `supabase-setup.ps1`
+
+**Descrição:** Script PowerShell para configurar o Supabase localmente (Docker)
+
+**Uso:**
+```powershell
+.\scripts\supabase-setup.ps1
+```
+
+**O que faz:**
+- ✅ Verifica se Docker está instalado
+- ✅ Inicializa projeto Supabase local
+- ✅ Inicia containers Docker
+- ✅ Aplica migrations
+- ✅ Configura ambiente local
+
+**Quando usar:** Para desenvolvimento local com Supabase rodando em Docker.
+
+---
+
+## 🔧 Variáveis de Ambiente
+
+Todos os scripts de banco de dados precisam de:
+
+### Para Verificação (read-only):
+```powershell
+$env:NEXT_PUBLIC_SUPABASE_URL="https://seu-projeto.supabase.co"
+$env:NEXT_PUBLIC_SUPABASE_ANON_KEY="sua-anon-key"
+```
+
+### Para Migrations (write):
+```powershell
+$env:NEXT_PUBLIC_SUPABASE_URL="https://seu-projeto.supabase.co"
+$env:SUPABASE_SERVICE_ROLE_KEY="sua-service-role-key"
+```
+
+**Onde encontrar:**
+👉 https://app.supabase.com/project/SEU_PROJECT_ID/settings/api
+
+---
+
+## 📝 Comandos NPM
+
+Adicionados em `package.json`:
+
+```json
+{
+  "scripts": {
+    "db:check": "node scripts/check-database.js",
+    "db:migrate": "node scripts/run-migration.js"
+  }
+}
+```
+
+---
+
+## 🚀 Fluxo Recomendado
+
+### Primeira vez (setup inicial):
+
+1. **Configurar variáveis:**
+   ```powershell
+   $env:NEXT_PUBLIC_SUPABASE_URL="https://auqfubbpxjzuzzqfazdp.supabase.co"
+   $env:NEXT_PUBLIC_SUPABASE_ANON_KEY="sua-key"
+   ```
+
+2. **Verificar estado:**
+   ```bash
+   npm run db:check
+   ```
+
+3. **Executar migration (manualmente):**
+   - Abrir: https://app.supabase.com/project/auqfubbpxjzuzzqfazdp/sql
+   - Copiar: `supabase/migrations/002_nex_agent_marketplace.sql`
+   - Colar e executar (Ctrl+Enter)
+
+4. **Verificar novamente:**
+   ```bash
+   npm run db:check
+   ```
+
+5. **Popular com dados de teste:**
+   - Ver: `EXECUTAR_SUPABASE.md` (seção "Popular com dados")
+
+---
+
+## 📚 Documentação Relacionada
+
+- **`EXECUTAR_SUPABASE.md`** - Guia completo de setup do banco
+- **`RODAR_MIGRATION_SUPABASE.md`** - Guia rápido de migrations
+- **`SUPABASE_DATABASE_SETUP_SUMMARY.md`** - Resumo executivo
+- **`SUPABASE_SETUP_INSTRUCTIONS.md`** - Instruções gerais do Supabase
+
+---
+
+## ⚠️ Troubleshooting
+
+### Erro: "Missing environment variables"
+**Solução:** Configure as variáveis de ambiente (ver acima)
+
+### Erro: "404 Not Found" na API
+**Solução:** As tabelas não existem. Execute a migration primeiro.
+
+### Erro: "Unauthorized"
+**Solução:** Use a `SUPABASE_SERVICE_ROLE_KEY` (não a anon key)
+
+### Erro: "function does not exist"
+**Solução:** A função RPC não está disponível. Use execução manual via SQL Editor.
+
+---
+
+**Precisa de ajuda?** Veja os guias completos nos arquivos `.md` na raiz do projeto! 🚀

package/scripts/postinstall.js

@@ -0,0 +1,169 @@
+#!/usr/bin/env node
+/**
+ * NEX CLI Post-Install Script
+ * Runs after npm install to configure the CLI
+ */
+
+import inquirer from 'inquirer'
+import fs from 'fs-extra'
+import path from 'path'
+import os from 'os'
+import chalk from 'chalk'
+import { fileURLToPath } from 'url'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+// Get global config path
+export function getGlobalConfigPath() {
+  const homeDir = os.homedir()
+  
+  if (process.platform === 'win32') {
+    // Windows: %APPDATA%\nex\config.json
+    return path.join(process.env.APPDATA || path.join(homeDir, 'AppData', 'Roaming'), 'nex', 'config.json')
+  } else {
+    // Unix-like: ~/.nex/config.json
+    return path.join(homeDir, '.nex', 'config.json')
+  }
+}
+
+export async function runSetup() {
+  // Check if config already exists
+  const configPath = getGlobalConfigPath()
+  const configDir = path.dirname(configPath)
+  
+  if (await fs.pathExists(configPath)) {
+    try {
+      const existingConfig = await fs.readJSON(configPath)
+      // If config exists and is valid, skip setup
+      if (existingConfig.user && existingConfig.user.name) {
+        console.log(chalk.green('\n✅ NEX CLI já está configurado!'))
+        console.log(chalk.gray(`   Config: ${configPath}`))
+        console.log(chalk.gray(`   Para reconfigurar, delete o arquivo ou execute: nex config reset\n`))
+        return
+      }
+    } catch (error) {
+      // Config file exists but is invalid, continue with setup
+    }
+  }
+  
+  console.log(chalk.blue('\n╔══════════════════════════════════════════════════════════╗'))
+  console.log(chalk.blue('║          🚀 Configuração do NEX CLI                        ║'))
+  console.log(chalk.blue('╚══════════════════════════════════════════════════════════╝\n'))
+  
+  const answers = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'userName',
+      message: 'Seu nome:',
+      default: process.env.USER || process.env.USERNAME || 'Developer',
+      validate: (input) => {
+        if (input.trim().length === 0) {
+          return 'Por favor, informe seu nome'
+        }
+        return true
+      }
+    },
+    {
+      type: 'list',
+      name: 'conversationLanguage',
+      message: 'Idioma de conversação:',
+      choices: [
+        { name: 'Português (PT-BR)', value: 'pt-BR' },
+        { name: 'English (EN-US)', value: 'en-US' },
+        { name: 'Español (ES)', value: 'es' },
+        { name: 'Français (FR)', value: 'fr' }
+      ],
+      default: 'pt-BR'
+    },
+    {
+      type: 'list',
+      name: 'documentLanguage',
+      message: 'Idioma para criação de documentos:',
+      choices: [
+        { name: 'Português (PT-BR)', value: 'pt-BR' },
+        { name: 'English (EN-US)', value: 'en-US' },
+        { name: 'Español (ES)', value: 'es' },
+        { name: 'Français (FR)', value: 'fr' }
+      ],
+      default: 'pt-BR'
+    },
+    {
+      type: 'confirm',
+      name: 'cursorIntegration',
+      message: 'Deseja habilitar integração com Cursor IDE?',
+      default: true
+    }
+  ])
+  
+  const config = {
+    user: {
+      name: answers.userName.trim(),
+      conversationLanguage: answers.conversationLanguage,
+      documentLanguage: answers.documentLanguage
+    },
+    cursor: {
+      enabled: answers.cursorIntegration
+    },
+    installedAt: new Date().toISOString(),
+    version: '1.0.18'
+  }
+  
+  // Save config
+  await fs.ensureDir(configDir)
+  await fs.writeJSON(configPath, config, { spaces: 2 })
+  
+  console.log(chalk.green('\n✅ NEX CLI configurado com sucesso!'))
+  console.log(chalk.gray(`   Config salvo em: ${configPath}`))
+  console.log(chalk.gray(`   Nome: ${config.user.name}`))
+  console.log(chalk.gray(`   Idioma de conversação: ${config.user.conversationLanguage}`))
+  console.log(chalk.gray(`   Idioma de documentos: ${config.user.documentLanguage}`))
+  console.log(chalk.gray(`   Integração Cursor: ${config.cursor.enabled ? 'Habilitada' : 'Desabilitada'}`))
+  console.log(chalk.cyan('\n💡 Dica: Para reconfigurar, execute: nex config reset\n'))
+}
+
+// Check if running in interactive mode (TTY available)
+const isInteractive = process.stdin.isTTY && process.stdout.isTTY && process.stderr.isTTY
+const isCI = process.env.CI === 'true'
+const skipSetup = process.env.NEX_SKIP_SETUP === 'true'
+
+// Only run interactive setup if:
+// 1. Not in CI
+// 2. Not explicitly skipped
+// 3. Running in interactive mode (TTY)
+if (!isCI && !skipSetup && isInteractive) {
+  runSetup().catch((error) => {
+    console.error(chalk.red('\n❌ Erro ao configurar NEX CLI:'))
+    console.error(chalk.red(error.message))
+    console.log(chalk.yellow('\n💡 Você pode configurar manualmente depois executando: nex config reset\n'))
+    process.exit(0) // Don't fail the install
+  })
+} else {
+  // Non-interactive mode: create default config silently
+  const configPath = getGlobalConfigPath()
+  const configDir = path.dirname(configPath)
+  const defaultConfig = {
+    user: {
+      name: process.env.USER || process.env.USERNAME || 'Developer',
+      conversationLanguage: 'pt-BR',
+      documentLanguage: 'pt-BR'
+    },
+    cursor: {
+      enabled: false
+    },
+    installedAt: new Date().toISOString(),
+    version: '1.0.18'
+  }
+  
+  fs.ensureDir(configDir)
+    .then(() => fs.writeJSON(configPath, defaultConfig, { spaces: 2 }))
+    .then(() => {
+      if (!isCI && isInteractive) {
+        console.log(chalk.green('\n✅ NEX CLI instalado com configuração padrão'))
+        console.log(chalk.gray('   Para configurar: nex config reset\n'))
+      }
+    })
+    .catch(() => {
+      // Silently fail in non-interactive mode
+    })
+}

package/src/services/nex-marketplace/NEXMarketplace.js

@@ -6,10 +6,12 @@
 import fs from 'fs-extra'
 import { existsSync } from 'fs'
 import path from 'path'
+import os from 'os'
 import yaml from 'yaml'
 import chalk from 'chalk'
 import ora from 'ora'
 import semver from 'semver'
+import inquirer from 'inquirer'
 import { createClient } from '@supabase/supabase-js'
 import { fileURLToPath } from 'url'
 
@@ -57,11 +59,16 @@ export default class NEXMarketplace {
     
     // Supabase client
     this.supabase = null
+    this.apiUrl = null
+    this.anonKey = null
     this.initializeSupabase()
     
     // Config
     this.config = null
+    this.globalConfig = null
+    this.projectConfig = null
     this.loadConfig()
+    this.loadGlobalConfig()
   }
 
   /**
@@ -128,6 +135,103 @@ export default class NEXMarketplace {
     return this.config
   }
 
+  /**
+   * Get global config path (user's home directory)
+   */
+  getGlobalConfigPath() {
+    const homeDir = os.homedir()
+    
+    if (process.platform === 'win32') {
+      // Windows: %APPDATA%\nex\config.json
+      return path.join(process.env.APPDATA || path.join(homeDir, 'AppData', 'Roaming'), 'nex', 'config.json')
+    } else {
+      // Unix-like: ~/.nex/config.json
+      return path.join(homeDir, '.nex', 'config.json')
+    }
+  }
+
+  /**
+   * Load global configuration from user's home directory
+   */
+  async loadGlobalConfig() {
+    try {
+      const configPath = this.getGlobalConfigPath()
+      
+      if (await fs.pathExists(configPath)) {
+        this.globalConfig = await fs.readJSON(configPath)
+        return this.globalConfig
+      }
+    } catch (error) {
+      // Config file doesn't exist or is invalid
+    }
+    
+    this.globalConfig = null
+    return null
+  }
+
+  /**
+   * Get global configuration with defaults
+   */
+  getGlobalConfig() {
+    if (!this.globalConfig) {
+      return {
+        user: {
+          name: process.env.USER || process.env.USERNAME || 'Developer',
+          conversationLanguage: 'pt-BR',
+          documentLanguage: 'pt-BR'
+        },
+        cursor: {
+          enabled: false
+        }
+      }
+    }
+    return this.globalConfig
+  }
+
+  /**
+   * Load project configuration (.nex-core/config.json)
+   * @deprecated Use getGlobalConfig() instead - project config is now optional
+   */
+  async loadProjectConfig() {
+    const configPath = path.join(this.projectRoot, '.nex-core', 'config.json')
+    
+    if (await fs.pathExists(configPath)) {
+      try {
+        this.projectConfig = await fs.readJSON(configPath)
+      } catch (error) {
+        this.projectConfig = null
+      }
+    } else {
+      this.projectConfig = null
+    }
+    
+    return this.projectConfig
+  }
+
+  /**
+   * Get project configuration with defaults
+   * @deprecated Use getGlobalConfig() instead
+   */
+  getProjectConfig() {
+    // Prefer global config, fallback to project config
+    const global = this.getGlobalConfig()
+    if (this.projectConfig) {
+      return {
+        ...global,
+        ...this.projectConfig,
+        user: {
+          ...global.user,
+          ...(this.projectConfig.user || {})
+        },
+        cursor: {
+          ...global.cursor,
+          ...(this.projectConfig.cursor || {})
+        }
+      }
+    }
+    return global
+  }
+
   /**
    * Default configuration
    */
@@ -844,12 +948,32 @@ export default class NEXMarketplace {
       // 7. Track installation
       await this.trackInstallation(agentId, version, method)
       
+      // 8. Integrate with Cursor if BMAD agent
+      if (manifest.bmad?.cursor_integration === true) {
+        // Use global config (set during CLI installation)
+        const globalConfig = this.getGlobalConfig()
+        const shouldIntegrate = globalConfig.cursor?.enabled === true
+        
+        if (shouldIntegrate) {
+          await this.integrateWithCursor(agentId, manifest, sourcePath)
+        } else {
+          console.log(chalk.gray(`\n💡 Integração com Cursor desabilitada. Para habilitar, execute: nex config reset\n`))
+        }
+      }
+      
       spinner.succeed(chalk.green(`✅ ${manifest.icon} ${manifest.name} v${version} installed!`))
       
-      // 8. Show quick start
+      // 9. Show quick start
       console.log(chalk.cyan('\n📖 Quick Start:'))
-      console.log(chalk.gray(`   @${agentId}`))
-      console.log(chalk.gray(`   nex agent run ${agentId} <command>\n`))
+      if (manifest.bmad?.cursor_integration === true) {
+        const trigger = manifest.bmad?.activation_trigger || `@${agentId}`
+        console.log(chalk.gray(`   ${trigger} <command>`))
+        console.log(chalk.gray(`   (No Cursor, use: nex agent run ${agentId} <command>)`))
+      } else {
+        console.log(chalk.gray(`   @${agentId}`))
+        console.log(chalk.gray(`   nex agent run ${agentId} <command>`))
+      }
+      console.log()
       
       return true
       
@@ -896,6 +1020,107 @@ export default class NEXMarketplace {
     throw new Error(errorMsg)
   }
 
+  /**
+   * Integrate BMAD agent with Cursor
+   */
+  async integrateWithCursor(agentId, manifest, sourcePath) {
+    try {
+      const rulesFile = manifest.bmad?.rules_file
+      if (!rulesFile) {
+        return // No rules file specified
+      }
+      
+      // Path to .cursorrules file in agent directory
+      let agentRulesPath = path.join(sourcePath, rulesFile)
+      
+      // Check if rules file exists
+      if (!await fs.pathExists(agentRulesPath)) {
+        // Try alternative locations
+        const alternativePaths = [
+          path.join(sourcePath, '..', rulesFile), // Parent directory
+          path.join(this.registryPath, manifest.category || 'bmad', agentId, rulesFile), // Registry root
+          path.join(this.registryPath, 'bmad', agentId, rulesFile) // BMAD category
+        ]
+        
+        let foundPath = null
+        for (const altPath of alternativePaths) {
+          if (await fs.pathExists(altPath)) {
+            foundPath = altPath
+            break
+          }
+        }
+        
+        if (!foundPath) {
+          // Create a basic .cursorrules file from manifest
+          const trigger = manifest.bmad?.activation_trigger || `@${agentId}`
+          const basicRules = `# ${manifest.name}
+# ${manifest.tagline || manifest.description?.substring(0, 100)}
+
+# Activation: ${trigger}
+
+# ${manifest.name} - ${manifest.description || 'BMAD Expert Agent'}
+
+# Usage in Cursor:
+# ${trigger} <command>
+
+# Example:
+# ${trigger} analyze-page https://example.com
+`
+          
+          // Write basic rules file to agent directory
+          await fs.writeFile(agentRulesPath, basicRules, 'utf8')
+          console.log(chalk.cyan(`\n📝 Created basic Cursor rules file: ${rulesFile}`))
+        } else {
+          agentRulesPath = foundPath
+        }
+      }
+      
+      // Create .cursorrules directory in project (for storing individual agent rules)
+      const cursorRulesDir = path.join(this.projectRoot, '.cursorrules')
+      await fs.ensureDir(cursorRulesDir)
+      
+      // Copy rules file to .cursorrules directory
+      const targetRulesPath = path.join(cursorRulesDir, rulesFile)
+      await fs.copy(agentRulesPath, targetRulesPath)
+      
+      // Update main .cursorrules file (in project root)
+      const mainCursorRulesPath = path.join(this.projectRoot, '.cursorrules')
+      const importLine = `import .cursorrules/${rulesFile}`
+      const commentLine = `# ${manifest.name} - ${manifest.tagline || manifest.description?.substring(0, 50)}`
+      const trigger = manifest.bmad?.activation_trigger || `@${agentId}`
+      const agentComment = `# Use: ${trigger} <command>`
+      
+      let cursorRulesContent = ''
+      if (await fs.pathExists(mainCursorRulesPath)) {
+        cursorRulesContent = await fs.readFile(mainCursorRulesPath, 'utf8')
+      }
+      
+      // Check if already imported
+      if (cursorRulesContent.includes(importLine) || cursorRulesContent.includes(rulesFile)) {
+        // Already integrated, skip
+        return
+      }
+      
+      // Add import to .cursorrules
+      const newContent = cursorRulesContent + 
+        (cursorRulesContent ? '\n\n' : '') +
+        commentLine + '\n' +
+        agentComment + '\n' +
+        importLine + '\n'
+      
+      await fs.writeFile(mainCursorRulesPath, newContent, 'utf8')
+      
+      console.log(chalk.green(`\n✅ Cursor integration complete!`))
+      console.log(chalk.gray(`   Added ${rulesFile} to .cursorrules`))
+      const trigger = manifest.bmad?.activation_trigger || `@${agentId}`
+      console.log(chalk.gray(`   Use: ${trigger} <command> in Cursor\n`))
+      
+    } catch (error) {
+      console.log(chalk.yellow(`\n⚠️  Cursor integration failed: ${error.message}`))
+      console.log(chalk.gray(`   Agent installed but Cursor integration skipped.\n`))
+    }
+  }
+
   /**
    * Get latest version of agent
    */