ai-rulez 2.0.1 → 2.1.2

package/README.md

@@ -32,7 +32,7 @@ Tired of manually managing rule files, subagents, and custom commands across dif
 ### Powerful Tooling
 - **Custom Commands:** Define custom commands that your AI assistant can execute, enabling powerful, interactive workflows.
 - **Specialized AI Agents:** Create specialized "sub-agents" with their own system prompts and tools, perfect for complex tasks like code reviews or database queries.
-- **MCP Servers:** Launch a Model Context Protocol (MCP) server to allow AI assistants to programmatically interact with your configuration.
+- **MCP Integration:** Automatically configure MCP servers across CLI tools (Claude, Gemini) and generate config files for others (Cursor, VS Code). One configuration, every tool connected.
 - **Full-Featured CLI:** Manage your entire configuration from the command line. Add rules, update agents, and generate files without ever opening a YAML file.
 
 ### Flexible Integrations
@@ -73,6 +73,13 @@ agents:
   - name: "go-developer"
     description: "Go language expert for core development"
     system_prompt: "You are an expert Go developer. Your key responsibilities include writing idiomatic Go, using proper error handling, and creating comprehensive tests."
+
+# MCP servers for direct AI tool integration
+mcp_servers:
+  - name: "ai-rulez"
+    command: "ai-rulez"
+    args: ["mcp"]
+    description: "AI-Rulez MCP server for configuration management"
 ```
 
 Run `ai-rulez generate` → get all your configuration files, perfectly synchronized.
@@ -80,14 +87,107 @@ Run `ai-rulez generate` → get all your configuration files, perfectly synchron
 ## Quick Start
 
 ```bash
-# 1. Initialize your project with a preset (recommended)
+# 1. AI-powered initialization (recommended)
+ai-rulez init "My Project" --preset popular --use-agent claude
+
+# 2. Generate all AI instruction files
+ai-rulez generate
+
+# 3. Your AI tools now have comprehensive, project-specific context!
+```
+
+**That's it!** The AI will analyze your codebase and generate tailored rules, documentation, and specialized agents automatically.
+
+**Prefer manual setup?**
+```bash
+# Basic initialization without AI assistance
 ai-rulez init "My Project" --preset popular
 
-# 2. Add your project-specific context
+# Add your project-specific context  
 ai-rulez add rule "Tech Stack" --priority critical --content "This project uses Go and PostgreSQL."
 
-# 3. Generate all AI instruction files
+# Generate files
+ai-rulez generate
+```
+
+## MCP Server Integration
+
+`ai-rulez` provides seamless **Model Context Protocol (MCP)** integration, automatically configuring both file-based and CLI-based AI tools with your MCP servers.
+
+### Automatic CLI Configuration
+
+When you run `ai-rulez generate`, MCP servers are **automatically configured** for available CLI tools:
+
+```bash
 ai-rulez generate
+# ✅ Generated 3 file(s) successfully
+# ✅ Configured claude MCP server: ai-rulez
+# ✅ Configured gemini MCP server: database-tools
+```
+
+**Supported CLI tools:**
+- **Claude CLI**: `claude mcp add` with full env/transport support
+- **Gemini CLI**: `gemini mcp add` with automatic configuration
+
+### Hybrid Configuration
+
+`ai-rulez` supports both CLI and file-based configurations simultaneously:
+
+```yaml
+mcp_servers:
+  - name: "database-tools"
+    command: "uvx"
+    args: ["mcp-server-postgres"]
+    env:
+      DATABASE_URL: "postgresql://localhost/mydb"
+    targets: 
+      - "@claude-cli"        # Configure Claude CLI
+      - "@gemini-cli"        # Configure Gemini CLI  
+      - ".cursor/mcp.json"   # Generate Cursor config file
+```
+
+This single configuration:
+- ✅ Executes `claude mcp add` commands
+- ✅ Executes `gemini mcp add` commands  
+- ✅ Generates `.cursor/mcp.json` file
+
+### Control Options
+
+**Default behavior** (recommended):
+```bash
+ai-rulez generate
+# Configures all available CLI tools + generates files
+```
+
+**Disable CLI configuration** when needed:
+```bash
+ai-rulez generate --no-configure-cli-mcp
+# Only generates files, skips CLI tool configuration
+```
+
+**Target specific tools:**
+```yaml
+mcp_servers:
+  - name: "github-integration"
+    command: "npx"
+    args: ["@modelcontextprotocol/server-github"]
+    targets: ["@claude-cli"]  # Only configure Claude CLI
+```
+
+### Built-in MCP Server
+
+`ai-rulez` includes its own MCP server for configuration management:
+
+```bash
+# Start the ai-rulez MCP server
+ai-rulez mcp
+
+# Or configure it automatically via your ai-rulez.yaml
+mcp_servers:
+  - name: "ai-rulez"
+    command: "ai-rulez" 
+    args: ["mcp"]
+    description: "Configuration management server"
 ```
 
 ## Installation
@@ -146,7 +246,7 @@ Add the following to your `.pre-commit-config.yaml`:
 ```yaml
 repos:
   - repo: https://github.com/Goldziher/ai-rulez
-    rev: v2.0.0
+    rev: v2.1.0
     hooks:
       - id: ai-rulez-validate
       - id: ai-rulez-generate

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-rulez",
-  "version": "2.0.1",
+  "version": "2.1.2",
   "description": "⚡ One config to rule them all. Centralized AI assistant configuration management - generate rules for Claude, Cursor, Copilot, Windsurf and more from a single YAML file.",
   "keywords": [
     "ai",

package/bin/ai-rulez

@@ -1,193 +0,0 @@
-#!/usr/bin/env node
-
-const path = require('path');
-const fs = require('fs');
-const { spawn } = require('child_process');
-
-// Path to the actual binary that install.js will create
-// The binary has a different name to avoid conflict with this wrapper script
-const BINARY_NAME = process.platform === 'win32' ? 'ai-rulez-bin.exe' : 'ai-rulez-bin';
-const BINARY_PATH = path.join(__dirname, BINARY_NAME);
-
-const REPO_URL = 'https://github.com/Goldziher/ai-rulez';
-const ISSUES_URL = `${REPO_URL}/issues`;
-
-function isNetworkError(error) {
-  const networkErrors = [
-    'ENOTFOUND', 'ECONNREFUSED', 'ECONNRESET', 'ETIMEDOUT',
-    'EHOSTUNREACH', 'ENETUNREACH', 'EADDRNOTAVAIL', 'ENETDOWN'
-  ];
-  
-  return networkErrors.includes(error.code) ||
-         error.message.includes('network') ||
-         error.message.includes('fetch') ||
-         error.message.includes('download') ||
-         error.message.includes('timeout');
-}
-
-function isPermissionError(error) {
-  return error.code === 'EACCES' || 
-         error.code === 'EPERM' ||
-         error.message.includes('permission') ||
-         error.message.includes('access denied');
-}
-
-async function runInstallScript() {
-  console.error('⚡ ai-rulez binary not found. Installing...');
-  console.error(`   Looking for: ${BINARY_PATH}`);
-  
-  const installScript = path.join(__dirname, '..', 'install.js');
-  console.error(`   Running install script: ${installScript}`);
-  
-  return new Promise((resolve, reject) => {
-    let errorOutput = '';
-    
-    const child = spawn('node', [installScript], {
-      stdio: ['inherit', 'inherit', 'pipe'],
-      cwd: path.dirname(installScript),
-      env: { ...process.env, AI_RULEZ_DEBUG: '1' }
-    });
-    
-    child.stderr.on('data', (data) => {
-      process.stderr.write(data);
-      errorOutput += data.toString();
-    });
-    
-    child.on('exit', (code) => {
-      console.error(`   Install script exited with code: ${code}`);
-      if (code === 0) {
-        resolve();
-      } else {
-        const error = new Error(`Install script failed with code ${code}`);
-        error.output = errorOutput;
-        reject(error);
-      }
-    });
-    
-    child.on('error', (err) => {
-      console.error(`   Install script error: ${err.message}`);
-      reject(err);
-    });
-  });
-}
-
-async function main() {
-  // Check if binary exists
-  if (!fs.existsSync(BINARY_PATH)) {
-    try {
-      // Run the install script if binary is missing
-      await runInstallScript();
-      
-      console.error(`   Checking if binary exists at: ${BINARY_PATH}`);
-      
-      // Double-check that binary now exists
-      if (!fs.existsSync(BINARY_PATH)) {
-        console.error('\n❌ Error: Binary still not found after installation attempt');
-        console.error('\n🔧 This is unexpected. Please report this issue:');
-        console.error(`   ${ISSUES_URL}`);
-        console.error('\nInclude your platform info:');
-        console.error(`   Platform: ${process.platform}`);
-        console.error(`   Architecture: ${process.arch}`);
-        console.error(`   Node version: ${process.version}`);
-        process.exit(1);
-      }
-    } catch (error) {
-      console.error('\n❌ Installation failed');
-      
-      if (isNetworkError(error)) {
-        console.error('\n🌐 Network Issue Detected');
-        console.error('   Unable to download ai-rulez binary from GitHub releases.');
-        console.error('\n   Possible causes:');
-        console.error('   • No internet connection');
-        console.error('   • GitHub is temporarily unreachable');
-        console.error('   • Corporate firewall/proxy blocking GitHub');
-        console.error('\n   Solutions:');
-        console.error('   1. Check your internet connection');
-        console.error('   2. Try again in a few moments');
-        console.error('   3. If behind a proxy, configure npm proxy settings');
-        console.error('   4. Download the binary manually from:');
-        console.error(`      ${REPO_URL}/releases`);
-      } else if (isPermissionError(error)) {
-        console.error('\n🔒 Permission Denied');
-        console.error(`   Cannot write to: ${path.dirname(BINARY_PATH)}`);
-        console.error('\n   Solutions:');
-        console.error('   1. Run with appropriate permissions');
-        console.error('   2. Install globally with: npm install -g ai-rulez');
-        console.error('   3. Check directory permissions');
-      } else {
-        console.error('\n⚠️  Unexpected Error');
-        console.error(`   ${error.message}`);
-        if (error.output && error.output.trim()) {
-          console.error('\n   Details:');
-          console.error(`   ${error.output.trim().split('\n').join('\n   ')}`);
-        }
-        console.error('\n   This shouldn\'t happen. Please report this issue:');
-        console.error(`   ${ISSUES_URL}`);
-        console.error('\n   Include:');
-        console.error('   • The error message above');
-        console.error(`   • Platform: ${process.platform}/${process.arch}`);
-        console.error(`   • Node version: ${process.version}`);
-      }
-      
-      process.exit(1);
-    }
-  }
-  
-  // Run the actual binary with all arguments
-  const proc = spawn(BINARY_PATH, process.argv.slice(2), {
-    stdio: 'inherit',
-    env: process.env
-  });
-  
-  proc.on('exit', (code) => {
-    process.exit(code || 0);
-  });
-  
-  proc.on('error', (err) => {
-    console.error('\n❌ Failed to execute ai-rulez binary');
-    
-    if (err.code === 'ENOENT') {
-      console.error('\n📁 File Not Found');
-      console.error(`   Binary path: ${BINARY_PATH}`);
-      console.error('\n   The file exists but cannot be executed.');
-      console.error('   Try reinstalling: npm install -g ai-rulez');
-    } else if (err.code === 'EACCES' || err.code === 'EPERM') {
-      console.error('\n🔒 Permission Denied');
-      console.error(`   Binary path: ${BINARY_PATH}`);
-      console.error('\n   The binary is not executable.');
-      console.error('\n   Solutions:');
-      if (process.platform !== 'win32') {
-        console.error(`   1. Make it executable: chmod +x ${BINARY_PATH}`);
-        console.error('   2. Reinstall: npm install -g ai-rulez');
-      } else {
-        console.error('   1. Check file permissions in Windows');
-        console.error('   2. Reinstall: npm install -g ai-rulez');
-      }
-    } else {
-      console.error('\n⚠️  Unexpected Execution Error');
-      console.error(`   Error code: ${err.code}`);
-      console.error(`   Message: ${err.message}`);
-      console.error('\n   This shouldn\'t happen. Please report this issue:');
-      console.error(`   ${ISSUES_URL}`);
-      console.error('\n   Include:');
-      console.error('   • The error details above');
-      console.error(`   • Platform: ${process.platform}/${process.arch}`);
-      console.error(`   • Node version: ${process.version}`);
-    }
-    
-    process.exit(1);
-  });
-}
-
-main().catch(err => {
-  console.error('\n❌ Unexpected error in wrapper script');
-  console.error(`   ${err.message}`);
-  if (err.stack) {
-    console.error('\n   Stack trace:');
-    console.error(`   ${err.stack.split('\n').slice(1).join('\n   ')}`);
-  }
-  console.error('\n   This shouldn\'t happen. Please report this issue:');
-  console.error(`   ${ISSUES_URL}`);
-  console.error('\n   Include the full error output above.');
-  process.exit(1);
-});

package/bin/ai-rulez.js

@@ -1,39 +0,0 @@
-#!/usr/bin/env node
-
-const { spawn } = require("node:child_process");
-const path = require("node:path");
-const fs = require("node:fs");
-const { getPlatform, getBinaryName } = require("../install");
-
-const binaryName = getBinaryName(getPlatform().os);
-const binaryPath = path.join(__dirname, "..", "bin", binaryName);
-
-function runBinary(args) {
-	const child = spawn(binaryPath, args, {
-		stdio: "inherit",
-	});
-
-	child.on("close", (code) => {
-		process.exit(code);
-	});
-}
-
-async function main() {
-	if (fs.existsSync(binaryPath)) {
-		runBinary(process.argv.slice(2));
-	} else {
-		console.log(
-			"🚀 First run detected - downloading ai-rulez binary...\n   This will only happen once and takes a few seconds.\n",
-		);
-		const { install } = require("../install");
-		try {
-			await install(true); // Pass a flag to indicate this is a post-install step
-			runBinary(process.argv.slice(2));
-		} catch (error) {
-			console.error("Failed to install or run ai-rulez:", error);
-			process.exit(1);
-		}
-	}
-}
-
-main();