luna-agents 2.0.1

package/commands/workflow.md

@@ -0,0 +1,19 @@
+---
+name: workflow
+displayName: Workflow Manager (shortcut)
+description: "Shortcut: Save, load, list named pipelines -> /ll-workflow"
+version: 1.0.0
+category: workflow
+shortcut_for: ll-workflow
+---
+
+# /workflow — Workflow Manager
+
+Shortcut for `/ll-workflow`. Save, load, and share reusable pipeline workflows.
+
+```
+/workflow save quality-gate "(rev ~~ test ~~ sec)"
+/workflow list
+/workflow templates
+/pipe run quality-gate ?>> ship
+```

package/commands/zen.md

@@ -0,0 +1,12 @@
+---
+name: zen
+displayName: Zen (shortcut)
+description: "Shortcut: → /ll-zen"
+version: 1.0.0
+category: shortcut
+shortcut_for: ll-zen
+---
+
+# /zen — Shortcut for /ll-zen
+
+See /ll-zen for full documentation.

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "luna-agents",
+  "version": "2.0.1",
+  "description": "Complete AI-powered development lifecycle management for Claude Code",
+  "main": ".claude-plugin/index.js",
+  "scripts": {
+    "setup": "bash setup.sh",
+    "install:mcp": "cd mcp-servers/luna-nexa-rag && npm install",
+    "install:plugin": "cd .claude-plugin && npm install",
+    "install:all": "npm run install:mcp && npm run install:plugin",
+    "configure:mcp": "cd mcp-servers/luna-nexa-rag && npm run setup",
+    "start:mcp": "cd mcp-servers/luna-nexa-rag && npm start",
+    "link:plugin": "node scripts/link-plugin.js",
+    "test": "echo 'Running Luna Agents tests...' && npm run test:plugin && npm run test:mcp",
+    "test:plugin": "cd .claude-plugin && npm test",
+    "test:mcp": "cd mcp-servers/luna-nexa-rag && npm test",
+    "dev": "concurrently \"npm run start:mcp\" \"npm run watch:plugin\"",
+    "watch:plugin": "cd .claude-plugin && npm run watch",
+    "clean": "rm -rf node_modules .claude-plugin/node_modules mcp-servers/luna-nexa-rag/node_modules",
+    "reinstall": "npm run clean && npm install"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "plugin",
+    "mcp",
+    "ai",
+    "development",
+    "workflow",
+    "automation",
+    "semantic-search",
+    "rag",
+    "agents"
+  ],
+  "author": "Shachar Solomon",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lunaos-ai/luna-agents.git"
+  },
+  "bugs": {
+    "url": "https://github.com/lunaos-ai/luna-agents/issues"
+  },
+  "homepage": "https://github.com/lunaos-ai/luna-agents#readme",
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=8.0.0"
+  },
+  "workspaces": [
+    ".claude-plugin",
+    "mcp-servers/luna-nexa-rag",
+    "mcp-servers/luna-glm-vision",
+    "mcp-servers/luna-vision-rag-client"
+  ],
+  "devDependencies": {
+    "@types/ws": "^8.18.1",
+    "concurrently": "^8.2.2"
+  },
+  "files": [
+    ".claude-plugin/index.js",
+    ".claude-plugin/lib/",
+    ".claude-plugin/claude-plugin.json",
+    ".claude-plugin/package.json",
+    "commands/",
+    "agents/",
+    "setup.sh",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "luna-setup": "./setup.sh"
+  },
+  "dependencies": {
+    "ws": "^8.19.0"
+  }
+}

package/setup.sh

@@ -0,0 +1,382 @@
+#!/bin/bash
+
+# Luna Agents - Automated Setup Script
+# This script sets up the complete Luna Agents plugin and MCP server
+
+set -e
+
+echo "🌙 Luna Agents Setup"
+echo "===================="
+echo ""
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Function to print colored output
+print_success() {
+    echo -e "${GREEN}✓${NC} $1"
+}
+
+print_error() {
+    echo -e "${RED}✗${NC} $1"
+}
+
+print_info() {
+    echo -e "${YELLOW}➜${NC} $1"
+}
+
+# Check prerequisites
+print_info "Checking prerequisites..."
+
+# Check Node.js
+if ! command -v node &> /dev/null; then
+    print_error "Node.js is not installed. Please install Node.js 18+ first."
+    exit 1
+fi
+
+NODE_VERSION=$(node -v | cut -d'v' -f2 | cut -d'.' -f1)
+if [ "$NODE_VERSION" -lt 18 ]; then
+    print_error "Node.js version 18+ is required. Current version: $(node -v)"
+    exit 1
+fi
+print_success "Node.js $(node -v) detected"
+
+# Check Git
+if ! command -v git &> /dev/null; then
+    print_error "Git is not installed. Please install Git first."
+    exit 1
+fi
+print_success "Git $(git --version | cut -d' ' -f3) detected"
+
+# Check npm
+if ! command -v npm &> /dev/null; then
+    print_error "npm is not installed. Please install npm first."
+    exit 1
+fi
+print_success "npm $(npm -v) detected"
+
+echo ""
+print_info "All prerequisites met!"
+echo ""
+
+# Get project root
+PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "$PROJECT_ROOT"
+
+# Setup MCP Server
+print_info "🔍 Luna RAG Tools: MCP Server..."
+cd mcp-servers/luna-nexa-rag
+
+if [ -f "package.json" ]; then
+    print_info "Installing MCP server dependencies..."
+    npm install
+    print_success "MCP server dependencies installed"
+else
+    print_error "MCP server package.json not found"
+    exit 1
+fi
+
+# Run MCP setup
+print_info "Configuring MCP server..."
+echo ""
+echo "You'll be asked to configure the MCP server."
+echo "Press Enter to accept defaults or enter custom values."
+echo ""
+
+npm run setup
+
+cd "$PROJECT_ROOT"
+
+# Setup Claude Plugin
+print_info "Setting up Claude Code Plugin..."
+cd .claude-plugin
+
+if [ -f "package.json" ]; then
+    print_info "Installing plugin dependencies..."
+    npm install
+    print_success "Plugin dependencies installed"
+fi
+
+cd "$PROJECT_ROOT"
+
+# Create symlink or copy plugin to Claude config
+CLAUDE_CONFIG_DIR=""
+if [[ "$OSTYPE" == "darwin"* ]]; then
+    CLAUDE_CONFIG_DIR="$HOME/Library/Application Support/Claude"
+elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
+    CLAUDE_CONFIG_DIR="$HOME/.config/Claude"
+elif [[ "$OSTYPE" == "msys" || "$OSTYPE" == "win32" ]]; then
+    CLAUDE_CONFIG_DIR="$APPDATA/Claude"
+fi
+
+if [ -n "$CLAUDE_CONFIG_DIR" ]; then
+    PLUGINS_DIR="$CLAUDE_CONFIG_DIR/plugins"
+    mkdir -p "$PLUGINS_DIR"
+    
+    print_info "Installing plugin to Claude..."
+    PLUGIN_DEST="$PLUGINS_DIR/luna-agents"
+    
+    if [ -L "$PLUGIN_DEST" ] || [ -d "$PLUGIN_DEST" ]; then
+        print_info "Removing existing plugin installation..."
+        rm -rf "$PLUGIN_DEST"
+    fi
+    
+    ln -s "$PROJECT_ROOT/.claude-plugin" "$PLUGIN_DEST"
+    print_success "Plugin installed to $PLUGIN_DEST"
+    
+    # Configure Luna Vision RAG MCP Server
+    print_info "Configuring Luna Vision RAG MCP Server..."
+    CLAUDE_CONFIG_FILE="$CLAUDE_CONFIG_DIR/claude_desktop_config.json"
+    
+    # Create config file if it doesn't exist
+    if [ ! -f "$CLAUDE_CONFIG_FILE" ]; then
+        echo '{"mcpServers":{}}' > "$CLAUDE_CONFIG_FILE"
+        print_success "Created Claude Desktop config file"
+    fi
+    
+    # Add Luna RAG MCP servers to config
+    python3 -c "
+import json
+import sys
+import os
+
+config_file = '$CLAUDE_CONFIG_FILE'
+project_root = '$PROJECT_ROOT'
+
+try:
+    with open(config_file, 'r') as f:
+        config = json.load(f)
+except:
+    config = {}
+
+if 'mcpServers' not in config:
+    config['mcpServers'] = {}
+
+# Add Luna RAG local MCP server (for free tier)
+config['mcpServers']['luna-nexa-rag'] = {
+    'command': 'node',
+    'args': [os.path.join(project_root, 'mcp-servers/luna-nexa-rag/index.js')],
+    'startOnLaunch': False,
+    'disabled': True  # Disabled by default, user can enable
+}
+
+# Add Luna Vision RAG cloud MCP server (premium features)
+config['mcpServers']['luna-vision-rag'] = {
+    'url': 'https://luna-vision-rag-mcp.broad-dew-49ad.workers.dev/mcp'
+}
+
+# Add Luna GLM Vision cloud MCP server (premium features)
+config['mcpServers']['luna-glm-vision'] = {
+    'url': 'https://luna-glm-vision-mcp.broad-dew-49ad.workers.dev/mcp'
+}
+
+with open(config_file, 'w') as f:
+    json.dump(config, f, indent=2)
+
+print('✓ Luna RAG MCP servers configured')
+print('✓ Luna Vision RAG cloud server configured')
+print('✓ Luna GLM Vision cloud server configured')
+" 2>/dev/null || {
+    # Fallback if python3 is not available
+    print_info "Python3 not found, skipping automatic MCP configuration"
+    print_info "Please manually add to $CLAUDE_CONFIG_FILE:"
+    echo ""
+    echo '{
+  "mcpServers": {
+    "luna-nexa-rag": {
+      "command": "node",
+      "args": ["'$PROJECT_ROOT'/mcp-servers/luna-nexa-rag/index.js"],
+      "startOnLaunch": false,
+      "disabled": true
+    },
+    "luna-vision-rag": {
+      "url": "https://luna-vision-rag-mcp.broad-dew-49ad.workers.dev/mcp"
+    },
+    "luna-glm-vision": {
+      "url": "https://luna-glm-vision-mcp.broad-dew-49ad.workers.dev/mcp"
+    }
+  }
+}'
+    echo ""
+}
+
+    print_success "Luna RAG MCP servers configured"
+
+# Setup ChromaDB for local RAG (optional, for free tier)
+print_info "Setting up ChromaDB for local RAG (optional)..."
+if command -v docker &> /dev/null; then
+    if docker ps | grep -q luna-chroma; then
+        print_success "ChromaDB already running"
+    else
+        print_info "Starting ChromaDB container..."
+        docker run -d --name luna-chroma -p 8000:8000 chromadb/chroma 2>/dev/null || {
+            print_info "Docker not running or ChromaDB failed to start"
+            print_info "Run this command later to enable local RAG:"
+            echo "  docker run -d --name luna-chroma -p 8000:8000 chromadb/chroma"
+        }
+        if [ $? -eq 0 ]; then
+            print_success "ChromaDB started on port 8000"
+        fi
+    fi
+else
+    print_info "Docker not installed - local RAG requires ChromaDB"
+    print_info "Install Docker or use cloud-based RAG features"
+fi
+fi
+
+# Create quick start guide
+print_info "Creating quick start guide..."
+cat > QUICK_START.md << 'EOF'
+# 🚀 Luna Agents Quick Start
+
+## What You Just Installed
+
+Luna Agents provides:
+- **10 AI Agents** for complete development lifecycle
+- **Luna RAG** - Semantic code search MCP server
+- **Luna Vision RAG™** - Context-aware GUI testing (cloud-based)
+- **Commands** for workflow automation
+
+## Usage
+
+### In Claude Code:
+
+1. **Start a new project workflow:**
+   ```
+   /luna-requirements
+   ```
+
+2. **Design architecture:**
+   ```
+   /luna-design
+   ```
+
+3. **Create implementation plan:**
+   ```
+   /luna-plan
+   ```
+
+4. **Execute tasks:**
+   ```
+   /luna-execute
+   ```
+
+5. **Review code:**
+   ```
+   /luna-review
+   ```
+
+### Available Commands:
+- `/luna-requirements` - Analyze requirements
+- `/luna-design` - Create technical design
+- `/luna-plan` - Generate task plan
+- `/luna-execute` - Implement tasks
+- `/luna-review` - Code review
+- `/luna-test` - Create tests
+- `/luna-deploy` - Deploy to production
+- `/luna-docs` - Generate documentation
+- `/luna-monitor` - Setup monitoring
+- `/luna-review-launch` - Post-launch review
+
+### 🧠 Semantic Code Search (Luna RAG) - Built into Claude Code!
+
+RAG works automatically in Claude Code - no manual commands needed! Just ask questions:
+
+**Examples:**
+- "How does authentication work in this project?"
+- "Find similar implementations to user profiles"
+- "What are the error handling patterns?"
+- "Search for database connection code"
+- "Show me examples of API endpoints"
+
+**What's Available:**
+- **Free Tier**: Local RAG with ChromaDB (auto-installed)
+- **Premium**: Cloud-based Luna Vision RAG™ + GLM Vision
+
+**To enable local RAG (Free Tier):**
+1. Ensure Docker is running
+2. Run: `docker run -d --name luna-chroma -p 8000:8000 chromadb/chroma`
+3. Restart Claude Desktop
+4. Start asking questions about your code!
+
+**Premium Features:**
+- Get API key: https://agent.lunaos.ai/pricing
+- Luna Vision RAG™: Screenshot analysis + code context
+- GLM Vision: Advanced visual AI testing
+- `get_coding_patterns` - Extract patterns
+
+### Context-Aware GUI Testing (Luna Vision RAG™):
+
+11 powerful tools for testing:
+- `rag_query` - Query codebase with natural language
+- `rag_setup` - Configure RAG for projects
+- `glm_analyze` - AI-powered UI analysis
+- `glm_capture` - Screenshot capture
+- `integration_generate` - Generate automated tests
+- `integration_validate` - Validate UI vs code
+- And 5 more tools...
+
+## Configuration
+
+### MCP Server
+Config location: `~/.luna-nexa-rag/config.json`
+
+To reconfigure:
+```bash
+cd mcp-servers/luna-nexa-rag
+npm run setup
+```
+
+### Plugin
+Plugin location: `~/.config/Claude/plugins/luna-agents` (or similar)
+
+## Next Steps
+
+1. **Restart Claude Desktop** to load the plugin
+2. Open your project in Claude Code
+3. Run `/luna-requirements` to start
+4. Follow the workflow commands in order
+
+## Getting Help
+
+- Check generated files in `.luna/[project-name]/`
+- Review agent documentation in `.claude-plugin/`
+- See main README.md for detailed information
+
+---
+
+**Happy coding with Luna! 🌙**
+EOF
+
+print_success "Quick start guide created: QUICK_START.md"
+
+echo ""
+echo "=========================================="
+print_success "Setup Complete!"
+echo "=========================================="
+echo ""
+echo "📝 What's Next:"
+echo ""
+echo "1. Restart Claude Desktop to load the plugin"
+echo "2. Open your project in Claude Code"
+echo "3. Run '/luna-requirements' to start your workflow"
+echo ""
+echo "📖 Documentation:"
+echo "   - Quick Start: ./QUICK_START.md"
+echo "   - Full Guide: ./README.md"
+echo "   - Plugin Docs: ./.claude-plugin/README.md"
+echo ""
+echo "🔧 Configuration:"
+echo "   - MCP Config: ~/.luna-nexa-rag/config.json"
+echo "   - Plugin: $PLUGINS_DIR/luna-agents"
+echo ""
+echo "🆘 Troubleshooting:"
+echo "   - Run 'npm run setup' in mcp-servers/luna-nexa-rag/ to reconfigure"
+echo "   - Check Claude Desktop logs for plugin issues"
+echo "   - Ensure ChromaDB is running if using Nexa embeddings"
+echo ""
+print_success "Luna Agents is ready to use! 🌙"
+echo ""