Add complete Manual Installation instructions to README.md

Fixes missing "Option 3: Manual Installation" guide Added comprehensive manual installation steps: - Prerequisites (Node.js, Python, Claude Code) - Step 1: Configure Claude Code (Anthropic/Z.AI) - Step 2: Install Agents (38 agents with git clone) - Step 3: Install MCP Tools (3 packages) - Step 4: Install UI/UX Pro Max Skill - Step 5: Configure MCP Tools (settings.local.json) - Step 6: Install Ralph CLI (Optional, Advanced) * Full hook script with background spawning * hooks.json configuration * Environment variables - Step 7: Verify Installation Users now have 3 complete installation options: 1. Master Prompt (copy-paste) 2. Interactive Installer (automated) 3. Manual Installation (step-by-step control) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-16 10:14:51 +00:00
parent 8fc4565690
commit fd6dcca2f7
1 changed files with 219 additions and 1 deletions
--- a/README.md
+++ b/README.md
@@ -165,7 +165,225 @@ chmod +x interactive-install-claude.sh

 ### Option 3: Manual Installation

-Follow the step-by-step guide below for full control over each component.
+For users who want complete control over each component, follow these steps manually:
+
+#### Prerequisites
+
+**Required:**
+- Node.js 14+ and npm
+- Python 3 (optional, for some MCP tools)
+- Claude Code installed: `npm install -g @anthropic-ai/claude-code`
+
+#### Step 1: Configure Claude Code
+
+**For Anthropic Claude:**
+```bash
+mkdir -p ~/.claude
+cat > ~/.claude/settings.json << 'EOF'
+{
+  "env": {
+    "ANTHROPIC_AUTH_TOKEN": "sk-ant-your-api-key-here",
+    "ANTHROPIC_BASE_URL": "https://api.anthropic.com"
+  }
+}
+EOF
+```
+
+**For Z.AI / GLM (90% cheaper):**
+```bash
+npm install -g @z_ai/coding-helper
+npx @z_ai/coding-helper init
+# Follow the wizard to configure GLM
+```
+
+#### Step 2: Install Agents (38 agents with PROACTIVELY auto-triggering)
+
+```bash
+# Clone the agents repository
+git clone https://github.com/contains-studio/agents.git /tmp/contains-studio-agents
+
+# Copy all agents to Claude Code
+mkdir -p ~/.claude/agents
+cp -r /tmp/contains-studio-agents/agents/* ~/.claude/agents/
+
+# Verify
+find ~/.claude/agents -name "*.md" | wc -l
+# Should show 39 files (38 agents + README)
+```
+
+#### Step 3: Install MCP Tools
+
+```bash
+# Install vision and analysis tools
+npm install -g @z_ai/mcp-server
+
+# Install web search and GitHub integration
+npm install -g @z_ai/coding-helper
+
+# Install TLDR for token-efficient code analysis
+npm install -g llm-tldr
+
+# Verify
+npx @z_ai/mcp-server --help
+npx @z_ai/coding-helper --help
+tldr --help
+```
+
+#### Step 4: Install UI/UX Pro Max Skill
+
+```bash
+# Clone the skill repository
+git clone https://github.com/nextlevelbuilder/ui-ux-pro-max-skill.git /tmp/ui-ux-skill
+
+# Copy to Claude skills directory
+mkdir -p ~/.claude/skills
+cp -r /tmp/ui-ux-skill/* ~/.claude/skills/
+```
+
+#### Step 5: Configure MCP Tools
+
+```bash
+# Create MCP configuration
+cat > ~/.claude/settings.local.json << 'EOF'
+{
+  "mcpServers": {
+    "zai-vision": {
+      "command": "npx",
+      "args": ["@z_ai/mcp-server"]
+    },
+    "zai-web": {
+      "command": "npx",
+      "args": ["@z_ai/coding-helper"]
+    }
+  }
+}
+EOF
+```
+
+#### Step 6: Install Ralph CLI (Advanced - Optional)
+
+> **⚠️ Optional:** Ralph CLI provides autonomous agent looping with background execution. Skip if not needed.
+
+```bash
+# Install Ralph CLI
+npm install -g @iannuttall/ralph
+
+# Create auto-trigger hook
+mkdir -p ~/.claude/hooks
+cat > ~/.claude/hooks/ralph-auto-trigger.sh << 'EOF'
+#!/bin/bash
+# Ralph Auto-Trigger Hook - Background Spawning
+# (Full script in MASTER-PROMPT.md Step 6)
+CLAUDE_DIR="$HOME/.claude"
+RALPH_PID_FILE="$CLAUDE_DIR/ralph.pid"
+RALPH_LOG_FILE="$CLAUDE_DIR/ralph-output.log"
+RALPH_LOCK_FILE="$CLAUDE_DIR/ralph.lock"
+RALPH_AUTO_MODE="${RALPH_AUTO_MODE:-agents}"
+RALPH_MAX_ITERATIONS="${RALPH_MAX_ITERATIONS:-50}"
+
+# Read input
+HOOK_INPUT=$(cat)
+USER_PROMPT=$(echo "$HOOK_INPUT" | jq -r '.prompt // empty' 2>/dev/null || echo "")
+
+# Check if already running
+if [[ -f "$RALPH_LOCK_FILE" ]]; then
+    LOCK_PID=$(cat "$RALPH_LOCK_FILE" 2>/dev/null || echo "")
+    if [[ -n "$LOCK_PID" ]] && kill -0 "$LOCK_PID" 2>/dev/null; then
+        exit 0
+    else
+        rm -f "$RALPH_LOCK_FILE" "$RALPH_PID_FILE"
+    fi
+fi
+
+# Detect agent request
+AGENTS=("ai-engineer" "backend-architect" "devops-automator" "frontend-developer" "mobile-app-builder" "rapid-prototyper" "test-writer-fixer" "tiktok-strategist" "growth-hacker" "content-creator" "instagram-curator" "reddit-builder" "twitter-engager" "app-store-optimizer" "brand-guardian" "ui-designer" "ux-researcher" "visual-storyteller" "whimsy-injector" "ui-ux-pro-max" "feedback-synthesizer" "sprint-prioritizer" "trend-researcher" "experiment-tracker" "project-shipper" "studio-producer" "studio-coach" "analytics-reporter" "finance-tracker" "infrastructure-maintainer" "legal-compliance-checker" "support-responder" "api-tester" "performance-benchmarker" "test-results-analyzer" "tool-evaluator" "workflow-optimizer" "joker" "agent-updater" "explore" "plan" "general-purpose")
+
+agent_detected=false
+detected_agent=""
+for agent in "${AGENTS[@]}"; do
+    if echo "$USER_PROMPT" | grep -iq "$agent"; then
+        agent_detected=true
+        detected_agent="$agent"
+        break
+    fi
+done
+
+# Should trigger?
+should_trigger=false
+case "$RALPH_AUTO_MODE" in
+    "always") should_trigger=true ;;
+    "agents")
+        if [[ "$agent_detected" == true ]] || echo "$USER_PROMPT" | grep -qiE "build|create|implement|develop|fix|add|refactor|optimize|write|generate|delegate|autonomous"; then
+            should_trigger=true
+            [[ "$agent_detected" == false ]] && detected_agent="general-development"
+        fi
+        ;;
+esac
+
+if [[ "$should_trigger" == true ]] && command -v ralph &> /dev/null; then
+    mkdir -p "$CLAUDE_DIR"
+    cat > "$CLAUDE_DIR/ralph-loop.local.md" << STATEEOF
+# Ralph Loop State - Auto-Triggered
+**User Request:** $USER_PROMPT
+**Detected Agent:** $detected_agent
+**Mode:** $RALPH_AUTO_MODE
+STATEEOF
+
+    touch "$RALPH_LOG_FILE"
+    echo "[$(date -u +"%Y-%m-%d %H:%M:%S UTC")] Starting Ralph in background..." >> "$RALPH_LOG_FILE"
+    nohup ralph build "$RALPH_MAX_ITERATIONS" >> "$RALPH_LOG_FILE" 2>&1 &
+    RALPH_PID=$!
+    echo "$RALPH_PID" > "$RALPH_PID_FILE"
+    echo "$RALPH_PID" > "$RALPH_LOCK_FILE"
+    echo "🔄 Ralph CLI auto-started in background (PID: $RALPH_PID)" >&2
+fi
+exit 0
+EOF
+
+chmod +x ~/.claude/hooks/ralph-auto-trigger.sh
+
+# Configure hooks
+cat > ~/.claude/hooks.json << 'EOF'
+{
+  "description": "User hooks for Ralph auto-trigger",
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "type": "command",
+        "command": "bash",
+        "args": ["~/.claude/hooks/ralph-auto-trigger.sh", "{{userPrompt}}"]
+      }
+    ]
+  }
+}
+EOF
+```
+
+**Configure Ralph environment:**
+```bash
+# Add to your shell profile (~/.bashrc or ~/.zshrc)
+export RALPH_AUTO_MODE="agents"  # Options: agents, always, off
+export RALPH_MAX_ITERATIONS="50"
+```
+
+#### Step 7: Verify Installation
+
+```bash
+# Check agents
+find ~/.claude/agents -name "*.md" | wc -l
+# Should show 39
+
+# Check MCP tools
+npx @z_ai/mcp-server --help
+npx @z_ai/coding-helper --help
+
+# Check Ralph (if installed)
+ralph --version
+ls -la ~/.claude/hooks/ralph-auto-trigger.sh
+
+# Start Claude Code
+claude
+```

 ---