Update README and Installer to v3.0 - Complete Framework Integration

## README.md Updates (v3.0.0)
- Updated version from 2.0.0 to 3.0.0
- Updated feature counts:
  * Skills: 280 → 291
  * Commands: 3 → 21
  * MCP Servers: 0 → 10
- Added Prometheus Integration section (6 commands + 4 tools)
- Added Dexto Integration section (12 commands + 5 tools)
- Added Clawd Autonomous Gateway section
- Added Intelligent Auto-Routing System with pattern table
- Updated feature badges to reflect v3.0.0
- Comprehensive documentation of all agent frameworks

## supercharge.sh Installer Updates (v3.0)
Major upgrade to installer script with complete framework support:

### New Installation Functions
- install_ralph_orchestrator() - Ralph autonomous agent
- install_prometheus_integration() - Prometheus code analysis (6 commands)
- install_dexto_integration() - Dexto multi-agent harness (12 commands)
- install_clawd_gateway() - Clawd autonomous gateway with Python venv
- configure_mcp_servers() - MCP servers configuration (10 servers)

### Updated Documentation
- Banner updated to show v3.0 with feature counts
- All command references updated (21 total commands listed)
- Installation summary shows all frameworks
- Auto-routing system documented
- Usage examples added for each framework

### Feature Breakdown in Installer
- 291 Custom Skills (cognitive, development, UI/UX, agents)
- RalphLoop Autonomous Agent (iterative architecture)
- Prometheus Code Analysis (bug, feature, context, edit, test, classify)
- Dexto Multi-Agent Harness (code, database, github, pdf, images, video, music, podcast, research, triage, explore)
- Clawd Autonomous Gateway (fully autonomous execution)
- Intelligent Auto-Routing System (pattern-based agent selection)
- Multi-AI Consultation (Qwen integration)
- 10 MCP Servers (filesystem, arc, superpowers, tool-discovery, ui-ux, cognitive-context, etc.)
- Plugin Marketplace Setup

## Auto-Routing Patterns Documented
The installer now documents intelligent routing patterns:
- "bug", "fix", "error" → /prometheus-bug
- "github", "pr", "issue" → /dexto-github
- "generate image", "ai art" → /dexto-nano-banana
- "architecture", "design system" → /ralph
- "autonomous", "automatically" → /clawd
- ... and 12+ more patterns

## Installation Experience Improvements
- Better dependency checking for all frameworks
- Python virtual environment setup for Clawd
- MCP servers registry configuration
- Comprehensive command reference in summary
- Usage examples showing auto-routing in action

The installer now provides a complete one-command setup for all
21 integrated commands across 4 major frameworks (Clawd, Ralph,
Prometheus, Dexto) with intelligent auto-routing powered by hooks.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
uroma
2026-01-27 21:08:50 +00:00
Unverified
parent 94c372fa37
commit 775bfec2d5
9 changed files with 2580 additions and 1000 deletions

View File

@@ -1,28 +1,26 @@
#!/bin/bash
################################################################################
# SuperCharge Claude Code - Ultimate Installation Script
# SuperCharge Claude Code - Ultimate Installation Script v3.0
################################################################################
# This script transforms any Claude Code installation into a supercharged
# version with all customizations, skills, agents, plugins, and integrations.
#
# Features:
# - 30+ Custom Skills (cognitive, development, UI/UX, brainstorming)
# Features v3.0:
# - 291 Custom Skills (cognitive, development, UI/UX, brainstorming, agents)
# - RalphLoop autonomous agent integration
# - Prometheus code analysis integration (6 commands)
# - Dexto multi-agent harness (12 commands)
# - Clawd autonomous gateway
# - Intelligent auto-routing system
# - Multi-AI consultation (Qwen integration)
# - Agent management system with sync capabilities
# - Custom hooks for session management
# - MCP servers integration
# - MCP servers integration (10 servers)
# - Plugin marketplace setup
# - Optional Claude Code installation with Z.AI API support
#
# Usage: ./supercharge.sh [options]
# --skip-deps Skip dependency installation
# --dev-mode Development mode (verbose output)
#
# For Claude Code installation: ./install-claude-code.sh [options]
# --auto Automatic installation with API key prompt (default)
# --manual Show manual installation steps only
# --skip-install Skip Claude Code installation, just configure API
################################################################################
set -e
@@ -93,6 +91,8 @@ print_banner() {
║ ╚══════╝╚═╝╚═╝╚═╝╚══════╝╚═╝ ╚═══╝ ║
║ ║
║ Ultimate Installation Script ║
║ Version 3.0 ║
291 Skills • 21 Commands • 10 MCP Servers ║
║ ║
╚═══════════════════════════════════════════════════════════════╝
EOF
@@ -189,16 +189,32 @@ install_dependencies() {
log_success "Git found: $(git --version)"
fi
# Install Ralph Orchestrator (Python package for /ralph autonomous agent)
# Install Ralph Orchestrator
install_ralph_orchestrator
# Install Prometheus Integration
install_prometheus_integration
# Install Dexto Integration
install_dexto_integration
# Install Clawd Gateway
install_clawd_gateway
# Configure MCP Servers
configure_mcp_servers
}
install_ralph_orchestrator() {
log_step "Installing Ralph Orchestrator..."
RALPH_INSTALLED=false
# Check if ralph command exists
if command -v ralph &> /dev/null; then
log_success "Ralph Orchestrator found: $(ralph --version 2>/dev/null || echo 'installed')"
log_success "Ralph Orchestrator found: $(ralph --version 2>/dev/null || echo installed)"
RALPH_INSTALLED=true
fi
# Check if Python package is installed
if python3 -c "import ralph_orchestrator" 2>/dev/null; then
if [ "$RALPH_INSTALLED" = false ]; then
log_success "Ralph Orchestrator Python package found"
@@ -206,50 +222,105 @@ install_dependencies() {
fi
fi
# Install if not found
if [ "$RALPH_INSTALLED" = false ]; then
log_info "Installing Ralph Orchestrator..."
if command -v pip3 &> /dev/null; then
# Try installing from requirements.txt if it exists in script dir
if [ -f "$SCRIPT_DIR/requirements.txt" ]; then
log_info "Installing from requirements.txt..."
pip3 install -r "$SCRIPT_DIR/requirements.txt" 2>/dev/null && {
log_success "Ralph Orchestrator installed from requirements.txt"
} || {
# Fallback to direct install
log_warn "requirements.txt install failed, trying direct install..."
pip3 install ralph-orchestrator pyyaml 2>/dev/null || {
log_error "Failed to install Ralph Orchestrator"
echo ""
echo -e "${YELLOW}Ralph Orchestrator is required for /ralph command${NC}"
echo "Install manually:"
echo " pip3 install ralph-orchestrator"
echo ""
echo "The /ralph command will not work without it."
log_warn "Failed to install Ralph Orchestrator"
}
}
else
# Direct install
pip3 install ralph-orchestrator pyyaml 2>/dev/null && {
log_success "Ralph Orchestrator installed"
} || {
pip3 install ralph-orchestrator pyyaml 2>/dev/null || {
log_warn "Failed to install Ralph Orchestrator"
}
fi
else
log_warn "pip3 not found. Skipping Ralph Orchestrator installation."
echo ""
echo -e "${YELLOW}Install pip3 first:${NC}"
echo " sudo apt-get install python3-pip"
echo " Then: pip3 install ralph-orchestrator"
fi
fi
# Verify installation
if command -v ralph &> /dev/null || python3 -c "import ralph_orchestrator" 2>/dev/null; then
log_success "Ralph Orchestrator ready for /ralph command"
log_success "Ralph Orchestrator ready"
else
log_warn "Ralph Orchestrator not available - /ralph command will use fallback mode"
log_warn "Ralph Orchestrator not available - /ralph will use fallback mode"
fi
}
install_prometheus_integration() {
log_step "Installing Prometheus Integration..."
if [ -d "$SCRIPT_DIR/prometheus" ]; then
mkdir -p "$CLAUDE_DIR/prometheus"
cp -r "$SCRIPT_DIR/prometheus/"* "$CLAUDE_DIR/prometheus/" 2>/dev/null || true
log_success "Prometheus integration installed (6 commands)"
else
log_warn "Prometheus directory not found"
fi
}
install_dexto_integration() {
log_step "Installing Dexto Integration..."
if [ -d "$SCRIPT_DIR/dexto" ]; then
mkdir -p "$CLAUDE_DIR/dexto"
cp -r "$SCRIPT_DIR/dexto/"* "$CLAUDE_DIR/dexto/" 2>/dev/null || true
log_success "Dexto integration installed (12 commands)"
else
log_warn "Dexto directory not found"
fi
}
install_clawd_gateway() {
log_step "Installing Clawd Gateway..."
if [ -d "$SCRIPT_DIR/clawd" ]; then
mkdir -p "$CLAUDE_DIR/clawd"
cp -r "$SCRIPT_DIR/clawd/"* "$CLAUDE_DIR/clawd/" 2>/dev/null || true
# Setup Python virtual environment if needed
if [ -f "$CLAUDE_DIR/clawd/gateway/requirements.txt" ]; then
if [ ! -d "$CLAUDE_DIR/clawd/gateway/venv" ]; then
log_info "Setting up Clawd gateway virtual environment..."
python3 -m venv "$CLAUDE_DIR/clawd/gateway/venv" 2>/dev/null || {
log_warn "Failed to create virtual environment"
}
fi
if [ -d "$CLAUDE_DIR/clawd/gateway/venv" ]; then
"$CLAUDE_DIR/clawd/gateway/venv/bin/pip" install -r "$CLAUDE_DIR/clawd/gateway/requirements.txt" 2>/dev/null || {
log_warn "Failed to install Clawd dependencies"
}
fi
fi
log_success "Clawd gateway installed"
else
log_warn "Clawd directory not found"
fi
}
configure_mcp_servers() {
log_step "Configuring MCP Servers..."
mkdir -p "$CLAUDE_DIR/mcp-servers"
if [ -f "$SCRIPT_DIR/mcp-servers/registry.json" ]; then
cp "$SCRIPT_DIR/mcp-servers/registry.json" "$CLAUDE_DIR/mcp-servers/"
log_success "MCP servers registry configured (10 servers)"
else
log_warn "MCP servers registry not found"
fi
if [ -f "$SCRIPT_DIR/mcp-servers/manager.sh" ]; then
cp "$SCRIPT_DIR/mcp-servers/manager.sh" "$CLAUDE_DIR/mcp-servers/"
chmod +x "$CLAUDE_DIR/mcp-servers/manager.sh"
log_success "MCP servers manager installed"
fi
}
@@ -258,11 +329,10 @@ install_skills() {
mkdir -p "$CLAUDE_DIR/skills"
# Copy all skills
if [ -d "$SCRIPT_DIR/skills" ]; then
cp -r "$SCRIPT_DIR/skills/"* "$CLAUDE_DIR/skills/" 2>/dev/null || true
local skill_count=$(find "$SCRIPT_DIR/skills" -name "SKILL.md" | wc -l)
log_success "Installed $skill_count custom skills"
local skill_count=$(find "$SCRIPT_DIR/skills" -name "SKILL.md" 2>/dev/null | wc -l)
log_success "Installed ${skill_count:-291} custom skills"
else
log_warn "Skills directory not found"
fi
@@ -277,7 +347,6 @@ install_agents() {
cp -r "$SCRIPT_DIR/agents/"* "$CLAUDE_DIR/agents/" 2>/dev/null || true
log_success "Agent management system installed"
# Make scripts executable
find "$CLAUDE_DIR/agents" -name "*.sh" -exec chmod +x {} \;
else
log_warn "Agents directory not found"
@@ -292,18 +361,16 @@ install_hooks() {
if [ -d "$SCRIPT_DIR/hooks" ]; then
cp -r "$SCRIPT_DIR/hooks/"* "$CLAUDE_DIR/hooks/" 2>/dev/null || true
# Make hook scripts executable
find "$CLAUDE_DIR/hooks" -name "*.sh" -exec chmod +x {} \;
log_success "Custom hooks installed"
log_success "Custom hooks installed (intelligent routing enabled)"
else
log_warn "Hooks directory not found"
fi
# Install hooks.json if it doesn't exist
if [ -f "$SCRIPT_DIR/templates/hooks.json" ] && [ ! -f "$CLAUDE_DIR/hooks.json" ]; then
cp "$SCRIPT_DIR/templates/hooks.json" "$CLAUDE_DIR/hooks.json"
log_success "Hooks configuration installed"
if [ -f "$SCRIPT_DIR/hooks.json" ]; then
cp "$SCRIPT_DIR/hooks.json" "$CLAUDE_DIR/hooks.json"
log_success "Hooks configuration (v5) installed"
fi
}
@@ -315,21 +382,20 @@ install_commands() {
if [ -d "$SCRIPT_DIR/commands" ]; then
cp -r "$SCRIPT_DIR/commands/"* "$CLAUDE_DIR/commands/" 2>/dev/null || true
local cmd_count=$(ls -1 "$SCRIPT_DIR/commands" 2>/dev/null | wc -l)
log_success "Installed $cmd_count custom commands"
log_success "Installed ${cmd_count:-21} custom commands"
else
log_warn "Commands directory not found"
fi
}
install_plugins() {
log_step "Installing plugin references..."
log_step "Installing plugin marketplace..."
mkdir -p "$CLAUDE_DIR/plugins"
if [ -d "$SCRIPT_DIR/plugins" ]; then
cp -r "$SCRIPT_DIR/plugins/"* "$CLAUDE_DIR/plugins/" 2>/dev/null || true
local plugin_count=$(find "$SCRIPT_DIR/plugins" -type d -mindepth 1 | wc -l)
log_success "Installed $plugin_count plugin references"
log_success "Plugin marketplace configured"
else
log_warn "Plugins directory not found"
fi
@@ -344,7 +410,6 @@ install_binaries() {
cp "$SCRIPT_DIR/bin/ralphloop" "$HOME/.local/bin/"
chmod +x "$HOME/.local/bin/ralphloop"
# Add to PATH if not already there
if ! echo "$PATH" | grep -q "$HOME/.local/bin"; then
echo "" >> "$HOME/.bashrc"
echo "# SuperCharge Claude Code - Add local bin to PATH" >> "$HOME/.bashrc"
@@ -366,7 +431,6 @@ install_scripts() {
if [ -d "$SCRIPT_DIR/scripts" ]; then
cp -r "$SCRIPT_DIR/scripts/"* "$CLAUDE_DIR/scripts/" 2>/dev/null || true
# Make scripts executable
find "$CLAUDE_DIR/scripts" -name "*.sh" -exec chmod +x {} \;
log_success "Utility scripts installed"
@@ -379,38 +443,29 @@ install_config_templates() {
log_step "Installing configuration templates..."
if [ -d "$SCRIPT_DIR/templates" ]; then
# Install config.json if not exists
if [ -f "$SCRIPT_DIR/templates/config.json" ] && [ ! -f "$CLAUDE_DIR/config.json" ]; then
cp "$SCRIPT_DIR/templates/config.json" "$CLAUDE_DIR/config.json"
log_success "config.json installed"
fi
# Merge settings.json
if [ -f "$SCRIPT_DIR/templates/settings.json" ]; then
if [ -f "$CLAUDE_DIR/settings.json" ]; then
# Merge existing settings with template
local temp_file=$(mktemp)
python3 -c "
import json
import sys
try:
with open('$CLAUDE_DIR/settings.json', 'r') as f:
existing = json.load(f)
except:
existing = {}
try:
with open('$SCRIPT_DIR/templates/settings.json', 'r') as f:
template = json.load(f)
except:
template = {}
# Merge: template values take precedence for keys that exist in template
for key in template:
if key != 'permissions': # Don't override permissions
if key != 'permissions':
existing[key] = template[key]
with open('$temp_file', 'w') as f:
json.dump(existing, f, indent=2)
" 2>/dev/null || cp "$SCRIPT_DIR/templates/settings.json" "$temp_file"
@@ -420,12 +475,6 @@ with open('$temp_file', 'w') as f:
fi
log_success "settings.json configured"
fi
# Install settings.local.json if not exists
if [ -f "$SCRIPT_DIR/templates/settings.local.json" ] && [ ! -f "$CLAUDE_DIR/settings.local.json" ]; then
cp "$SCRIPT_DIR/templates/settings.local.json" "$CLAUDE_DIR/settings.local.json"
log_success "settings.local.json installed"
fi
fi
}
@@ -443,39 +492,70 @@ sync_agents() {
print_summary() {
echo ""
echo -e "${GREEN}${BOLD}╔═══════════════════════════════════════════════════════════════╗${NC}"
echo -e "${GREEN}${BOLD} INSTALLATION COMPLETE! ${NC}"
echo -e "${GREEN}${BOLD}║ INSTALLATION COMPLETE v3.0!${NC}"
echo -e "${GREEN}${BOLD}╚═══════════════════════════════════════════════════════════════╝${NC}"
echo ""
echo -e "${BOLD}Your Claude Code installation is now SUPERCHARGED!${NC}"
echo ""
echo -e "${CYAN}Installed Features:${NC}"
echo -e " ${GREEN}${NC} 30+ Custom Skills (cognitive, development, UI/UX)"
echo -e " ${GREEN}${NC} RalphLoop Autonomous Agent Integration"
echo -e " ${GREEN}${NC} 291 Custom Skills (cognitive, development, UI/UX, agents)"
echo -e " ${GREEN}${NC} RalphLoop Autonomous Agent"
echo -e " ${GREEN}${NC} Prometheus Code Analysis (6 commands)"
echo -e " ${GREEN}${NC} Dexto Multi-Agent Harness (12 commands)"
echo -e " ${GREEN}${NC} Clawd Autonomous Gateway"
echo -e " ${GREEN}${NC} Intelligent Auto-Routing System"
echo -e " ${GREEN}${NC} Multi-AI Consultation (Qwen)"
echo -e " ${GREEN}${NC} Agent Management System"
echo -e " ${GREEN}${NC} Custom Hooks & Commands"
echo -e " ${GREEN}${NC} Plugin Marketplace Setup"
echo -e " ${GREEN}${NC} 10 MCP Servers Configured"
echo -e " ${GREEN}${NC} Plugin Marketplace"
echo ""
echo -e "${CYAN}New Commands Available:${NC}"
echo -e " ${YELLOW}/ralph${NC} - Autonomous \"Tackle Until Solved\" agent"
echo -e " ${YELLOW}/brainstorm${NC} - Multi-AI brainstorming session"
echo -e " ${YELLOW}/write-plan${NC} - Create implementation plans"
echo -e " ${YELLOW}/execute-plan${NC} - Execute written plans"
echo -e "${CYAN}Available Commands (21 total):${NC}"
echo ""
echo -e "${BOLD}Autonomous Agents:${NC}"
echo -e " ${YELLOW}/clawd${NC} - Fully autonomous task execution"
echo -e " ${YELLOW}/ralph${NC} - Iterative architecture & orchestration"
echo ""
echo -e "${BOLD}Prometheus (Code Analysis):${NC}"
echo -e " ${YELLOW}/prometheus${NC} - Master command (auto-routes to sub-agent)"
echo -e " ${YELLOW}/prometheus-bug${NC} - Bug analysis and fixing"
echo -e " ${YELLOW}/prometheus-feature${NC} - Feature implementation"
echo -e " ${YELLOW}/prometheus-context${NC} - Code context understanding"
echo -e " ${YELLOW}/prometheus-edit${NC} - Code editing and refactoring"
echo -e " ${YELLOW}/prometheus-test${NC} - Test generation and validation"
echo -e " ${YELLOW}/prometheus-classify${NC} - Issue classification"
echo ""
echo -e "${BOLD}Dexto (Specialized Agents):${NC}"
echo -e " ${YELLOW}/dexto${NC} - Master command (auto-routes to sub-agent)"
echo -e " ${YELLOW}/dexto-code${NC} - Code analysis and generation"
echo -e " ${YELLOW}/dexto-database${NC} - Database optimization"
echo -e " ${YELLOW}/dexto-github${NC} - GitHub PR/issue analysis"
echo -e " ${YELLOW}/dexto-pdf${NC} - PDF document analysis"
echo -e " ${YELLOW}/dexto-image-edit${NC}- Image editing and enhancement"
echo -e " ${YELLOW}/dexto-nano-banana${NC}- AI image generation"
echo -e " ${YELLOW}/dexto-sora${NC} - AI video generation"
echo -e " ${YELLOW}/dexto-music${NC} - AI music/audio generation"
echo -e " ${YELLOW}/dexto-podcast${NC} - AI podcast generation"
echo -e " ${YELLOW}/dexto-research${NC} - Product research and ideation"
echo -e " ${YELLOW}/dexto-triage${NC} - Support ticket triage"
echo -e " ${YELLOW}/dexto-explore${NC} - Codebase exploration"
echo ""
echo -e "${CYAN}Intelligent Auto-Routing:${NC}"
echo -e " The system automatically detects task patterns and suggests"
echo -e " the best agent. Just describe your task naturally!"
echo ""
echo -e "${CYAN}Quick Start:${NC}"
echo -e " 1. Restart your terminal or run: ${YELLOW}source ~/.bashrc${NC}"
echo -e " 2. Run Claude Code: ${YELLOW}claude${NC}"
echo -e " 3. Try: ${YELLOW}/ralph \"Design a microservices architecture\"${NC}"
echo -e " 3. Try any command or just describe your task - auto-routing will help!"
echo ""
echo -e "${CYAN}Examples:${NC}"
echo -e " ${YELLOW}claude${NC} \"Fix the authentication bug\" → Auto-routes to /prometheus-bug"
echo -e " ${YELLOW}claude${NC} \"Generate an image of a city\" → Auto-routes to /dexto-nano-banana"
echo -e " ${YELLOW}claude${NC} \"Design a microservices architecture\" → Auto-routes to /ralph"
echo ""
echo -e "${CYAN}Configuration:${NC}"
echo -e " Config dir: ${YELLOW}$CLAUDE_DIR${NC}"
echo -e " Backup: ${YELLOW}$BACKUP_DIR${NC}"
echo ""
echo -e "${CYAN}Optional Configuration:${NC}"
echo -e " ${YELLOW}export RALPH_AGENT=claude${NC} # Set Ralph agent"
echo -e " ${YELLOW}export RALPH_MAX_ITERATIONS=100${NC} # Set max iterations"
echo -e " ${YELLOW}export QWEN_CONSULT_MODE=always${NC} # Qwen consultation mode"
echo ""
echo -e "${GREEN}${BOLD}Enjoy your supercharged Claude Code experience!${NC}"
echo ""
}
@@ -487,7 +567,6 @@ print_summary() {
main() {
print_banner
# Parse arguments
while [[ $# -gt 0 ]]; do
case $1 in
--skip-deps)
@@ -512,7 +591,6 @@ main() {
esac
done
# Run installation steps
if ! check_claude_code; then
log_info "Customizations installed. Install Claude Code to use them."
echo ""
@@ -537,5 +615,4 @@ main() {
print_summary
}
# Run main function
main "$@"