diff --git a/README.md b/README.md index 4339dcd..2c24cf6 100644 --- 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 +``` ---