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>
This commit is contained in:
uroma
220
README.md
220
README.md
@@ -165,7 +165,225 @@ chmod +x interactive-install-claude.sh
|
|||||||
|
|
||||||
### Option 3: Manual Installation
|
### 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
|
||||||
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user