ddd42d0063
Added comprehensive one-line installation options for all scripts: Quick One-Liners Section (top of README): - SuperCharge installer one-liner - Claude Code + Z.AI installer one-liner - Manual instructions one-liner Detailed Installation Guide: - SuperCharge Installer with all options - Claude Code + Z.AI Installer with all options - All scripts support argument passing via bash -s -- Available Scripts Reference: - supercharge.sh: Main installer with --skip-deps, --dev-mode - install-claude-code.sh: Claude Code + Z.AI with --auto, --manual, --skip-install Total: 16 one-liner command examples Features: - curl | bash for direct execution - bash -s -- for argument passing - All script options documented - Clear tables showing options and descriptions
547 lines
16 KiB
Markdown
547 lines
16 KiB
Markdown
# SuperCharged Claude Code - Ultimate Upgrade Package
|
|
|
|
> 🚀 Transform your Claude Code into an autonomous AI development powerhouse with 30+ custom skills, autonomous agents, and Z.AI GLM model integration. Install in 2 minutes.
|
|
|
|
[](https://claude.com/claude-code)
|
|
[](https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade)
|
|
[](https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade)
|
|
[](LICENSE)
|
|
[](https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade)
|
|
|
|
## ⚡ Quick One-Liners
|
|
|
|
```bash
|
|
# 🎯 SuperCharge Claude Code (all customizations)
|
|
curl -fsSL https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/raw/main/supercharge.sh | bash
|
|
|
|
# 🔧 Install Claude Code + Z.AI API
|
|
curl -fsSL https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/raw/main/install-claude-code.sh | bash
|
|
|
|
# 📖 Show manual instructions (no installation)
|
|
curl -fsSL https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/raw/main/install-claude-code.sh | bash -s -- --manual
|
|
```
|
|
|
|
---
|
|
|
|
## ⚡ Why SuperCharge Claude Code?
|
|
|
|
**Claude Code is powerful. SuperCharge makes it unstoppable.**
|
|
|
|
This comprehensive customization package transforms your Claude Code installation with:
|
|
|
|
- ✨ **30+ Custom Skills** - Cognitive enhancement, development workflows, UI/UX intelligence
|
|
- 🤖 **Autonomous Agents** - RalphLoop "Tackle Until Solved" agent for complex tasks
|
|
- 🌐 **Z.AI API Integration** - GLM-4.5-air and GLM-4.7 model support with 10% OFF discount
|
|
- 🔌 **MCP Servers** - Image analysis, web search, GitHub integration built-in
|
|
- 🎯 **Agent Management** - Complete library with sync capabilities
|
|
- 🪝 **Smart Hooks** - Session automation and multi-AI consultation
|
|
|
|
**Perfect for:** Developers, AI enthusiasts, teams building with AI assistants, and anyone wanting to maximize their Claude Code productivity.
|
|
|
|
---
|
|
|
|
## 🎯 What Gets Installed
|
|
|
|
### 🧠 Cognitive Skills
|
|
| Skill | Purpose |
|
|
|-------|---------|
|
|
| `always-use-superpowers` | Auto-applies relevant skills before any action (Priority: 9999) |
|
|
| `cognitive-core` | Core cognitive processing framework |
|
|
| `cognitive-planner` | Strategic planning and architecture design |
|
|
| `cognitive-safety` | Security validation and best practices |
|
|
|
|
### 🤖 Autonomous Agents
|
|
| Agent | Capability |
|
|
|-------|------------|
|
|
| **RalphLoop** | Iterates autonomously until task completion |
|
|
| **Brainstorming** | Multi-AI collaborative ideation |
|
|
| **Test-Driven Development** | Automated TDD workflow |
|
|
| **Systematic Debugging** | Step-by-step bug resolution |
|
|
| **Verification** | Pre-completion validation checks |
|
|
|
|
### 🎨 Development Tools
|
|
| Tool | Features |
|
|
|------|----------|
|
|
| `ui-ux-pro-max` | 50 styles, 21 palettes, 50 font pairings |
|
|
| `agent-pipeline-builder` | Multi-agent workflow construction |
|
|
| `dispatching-parallel-agents` | Concurrent agent execution |
|
|
| `finishing-a-development-branch` | PR and merge automation |
|
|
|
|
### 🌐 Integrations
|
|
- **Z.AI GLM Models** - glm-4.5-air (fast), glm-4.7 (powerful)
|
|
- **Qwen Consultation** - Get second opinions from Qwen models
|
|
- **Dev-Browser** - Persistent browser automation
|
|
- **MCP Servers** - Vision, search, web reader, GitHub
|
|
|
|
### 📁 Installation Structure
|
|
```
|
|
~/.claude/
|
|
├── skills/ # 30+ custom skills
|
|
├── agents/ # 100+ agent library
|
|
├── hooks/ # Session automation
|
|
├── commands/ # Custom commands
|
|
├── plugins/ # MCP servers & integrations
|
|
└── settings.json # Z.AI API configuration
|
|
|
|
~/.local/bin/
|
|
└── ralphloop # Ralph Orchestrator wrapper
|
|
```
|
|
|
|
---
|
|
|
|
## 📖 Detailed Installation Guide
|
|
|
|
### 🎯 SuperCharge Installer (Main Script)
|
|
|
|
#### One-Line Installation
|
|
```bash
|
|
curl -fsSL https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/raw/main/supercharge.sh | bash
|
|
```
|
|
|
|
#### One-Line with Options
|
|
```bash
|
|
# Skip dependency installation
|
|
curl -fsSL https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/raw/main/supercharge.sh | bash -s -- --skip-deps
|
|
|
|
# Development mode (verbose output)
|
|
curl -fsSL https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/raw/main/supercharge.sh | bash -s -- --dev-mode
|
|
```
|
|
|
|
#### Manual Installation
|
|
```bash
|
|
# Clone the repository
|
|
git clone https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade.git
|
|
cd SuperCharged-Claude-Code-Upgrade
|
|
|
|
# Run the supercharge installer
|
|
./supercharge.sh
|
|
|
|
# With options
|
|
./supercharge.sh --skip-deps
|
|
./supercharge.sh --dev-mode
|
|
```
|
|
|
|
### 🔧 Claude Code + Z.AI Installer (Optional)
|
|
|
|
#### One-Line Installation
|
|
```bash
|
|
curl -fsSL https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/raw/main/install-claude-code.sh | bash
|
|
```
|
|
|
|
#### One-Line with Options
|
|
```bash
|
|
# Automatic installation (prompts for API key)
|
|
curl -fsSL https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/raw/main/install-claude-code.sh | bash -s -- --auto
|
|
|
|
# Manual instructions only (no installation)
|
|
curl -fsSL https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/raw/main/install-claude-code.sh | bash -s -- --manual
|
|
|
|
# Configure API only (skip Claude Code installation)
|
|
curl -fsSL https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/raw/main/install-claude-code.sh | bash -s -- --skip-install
|
|
```
|
|
|
|
#### Manual Installation
|
|
```bash
|
|
# Clone the repository
|
|
git clone https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade.git
|
|
cd SuperCharged-Claude-Code-Upgrade
|
|
|
|
# Run the Claude Code installer
|
|
./install-claude-code.sh --auto
|
|
|
|
# Other options
|
|
./install-claude-code.sh --manual # Show instructions only
|
|
./install-claude-code.sh --skip-install # Configure API only
|
|
```
|
|
|
|
---
|
|
|
|
## 📋 Available Scripts & Options
|
|
|
|
### supercharge.sh - Main SuperCharge Installer
|
|
Transforms existing Claude Code with all customizations.
|
|
|
|
| Option | Description |
|
|
|--------|-------------|
|
|
| (default) | Interactive installation with all prompts |
|
|
| `--skip-deps` | Skip dependency installation checks |
|
|
| `--dev-mode` | Enable verbose output for debugging |
|
|
|
|
**One-liners:**
|
|
```bash
|
|
# Full installation
|
|
curl -fsSL https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/raw/main/supercharge.sh | bash
|
|
|
|
# Skip dependencies
|
|
curl -fsSL https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/raw/main/supercharge.sh | bash -s -- --skip-deps
|
|
|
|
# Verbose mode
|
|
curl -fsSL https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/raw/main/supercharge.sh | bash -s -- --dev-mode
|
|
```
|
|
|
|
### install-claude-code.sh - Claude Code + Z.AI Installer
|
|
Installs Claude Code and configures Z.AI GLM models.
|
|
|
|
| Option | Description |
|
|
|--------|-------------|
|
|
| `--auto` (default) | Automated installation with API key prompt |
|
|
| `--manual` | Show manual installation steps only |
|
|
| `--skip-install` | Skip Claude Code install, configure API only |
|
|
|
|
**One-liners:**
|
|
```bash
|
|
# Auto install with API prompt
|
|
curl -fsSL https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/raw/main/install-claude-code.sh | bash
|
|
|
|
# Show manual instructions
|
|
curl -fsSL https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/raw/main/install-claude-code.sh | bash -s -- --manual
|
|
|
|
# Configure API only
|
|
curl -fsSL https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/raw/main/install-claude-code.sh | bash -s -- --skip-install
|
|
```
|
|
|
|
---
|
|
|
|
## 🔧 Claude Code Installation Details
|
|
|
|
If you don't have Claude Code installed yet, we've got you covered with **Z.AI API support**.
|
|
|
|
### What is Z.AI API?
|
|
|
|
[Z.AI](https://docs.z.ai/devpack/tool/claude) provides GLM (General Language Model) models optimized for Claude Code:
|
|
|
|
- **glm-4.5-air** - Fast, efficient model (Haiku class) - ideal for quick iterations
|
|
- **glm-4.7** - Powerful model (Sonnet/Opus class) - for complex tasks
|
|
|
|
> [!TIP]
|
|
> **🎁 Grab 10% OFF Token for z.ai coding plan**: [https://z.ai/subscribe?ic=R0K78RJKNW](https://z.ai/subscribe?ic=R0K78RJKNW)
|
|
|
|
### Manual Claude Code Installation
|
|
|
|
```bash
|
|
# 1. Install Claude Code via npm
|
|
npm install -g @anthropic-ai/claude-code
|
|
|
|
# 2. Configure Z.AI API in ~/.claude/settings.json:
|
|
{
|
|
"env": {
|
|
"ANTHROPIC_API_KEY": "your-zai-api-key-here",
|
|
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
|
|
"ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
|
|
"ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.7"
|
|
}
|
|
}
|
|
|
|
# 3. Start Claude Code
|
|
claude
|
|
|
|
# 4. Check model status
|
|
/status
|
|
```
|
|
|
|
### Documentation
|
|
- **Z.AI Official Docs**: https://docs.z.ai/devpack/tool/claude
|
|
- **Claude Code Docs**: https://docs.anthropic.com/en/docs/claude-code/overview
|
|
|
|
---
|
|
|
|
## 💡 Usage Examples
|
|
|
|
### RalphLoop - Autonomous Agent
|
|
|
|
```bash
|
|
# Let Ralph tackle complex problems autonomously
|
|
claude
|
|
> /ralph "Design a microservices architecture for an e-commerce platform"
|
|
|
|
# Ralph iterates until completion:
|
|
# - Creates .ralph/PROMPT.md with success criteria
|
|
# - Iterates continuously until all criteria met
|
|
# - Updates .ralph/state.json with progress
|
|
# - Outputs final result to .ralph/iterations/final.md
|
|
```
|
|
|
|
**Configuration:**
|
|
```bash
|
|
export RALPH_AGENT=claude # Agent selection
|
|
export RALPH_MAX_ITERATIONS=100 # Max iterations
|
|
export RALPH_MAX_RUNTIME=14400 # 4 hours
|
|
export RALPH_VERBOSE=true # Debug output
|
|
```
|
|
|
|
### Multi-AI Brainstorming
|
|
|
|
```bash
|
|
> /brainstorming "Create a viral TikTok marketing strategy"
|
|
|
|
# Collaborates with multiple AI perspectives:
|
|
# - Content strategist (copy & messaging)
|
|
# - SEO expert (keywords & optimization)
|
|
# - Social media manager (platforms & tactics)
|
|
# - Product manager (goals & metrics)
|
|
# - Developer (implementation)
|
|
```
|
|
|
|
### Test-Driven Development
|
|
|
|
```bash
|
|
> /test-driven-development "Implement user authentication"
|
|
|
|
# Automated TDD workflow:
|
|
# 1. Write failing tests
|
|
# 2. Implement minimal code
|
|
# 3. Refactor while tests green
|
|
```
|
|
|
|
### Systematic Debugging
|
|
|
|
```bash
|
|
> /systematic-debugging "Database connection timing out"
|
|
|
|
# Step-by-step resolution:
|
|
# 1. Gather error information
|
|
# 2. Form hypotheses
|
|
# 3. Test each hypothesis
|
|
# 4. Verify fix doesn't break functionality
|
|
```
|
|
|
|
---
|
|
|
|
## 🎨 UI/UX Intelligence
|
|
|
|
The `ui-ux-pro-max` skill provides comprehensive design capabilities:
|
|
|
|
### 50 Design Styles
|
|
Glassmorphism, Claymorphism, Neumorphism, Brutalism, Minimalism, Bento Grid, Dark Mode, Skeuomorphism, Flat Design, and more...
|
|
|
|
### 21 Color Palettes
|
|
Pre-configured themes for instant visual consistency
|
|
|
|
### 50 Font Pairings
|
|
Typographic combinations proven to work well together
|
|
|
|
### 9 Tech Stacks
|
|
React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui
|
|
|
|
---
|
|
|
|
## ⚙️ Configuration
|
|
|
|
### Environment Variables
|
|
|
|
```bash
|
|
# Ralph Configuration
|
|
export RALPH_AGENT=claude # claude|gemini|kiro|q|auto
|
|
export RALPH_MAX_ITERATIONS=100 # Maximum iterations
|
|
export RALPH_MAX_RUNTIME=14400 # Max runtime (4 hours)
|
|
|
|
# Qwen Consultation
|
|
export QWEN_CONSULT_MODE=always # always|delegate|off
|
|
export QWEN_MODEL=qwen-coder-plus # Model selection
|
|
export QWEN_MAX_ITERATIONS=3 # Max consultation iterations
|
|
|
|
# Auto Superpowers
|
|
export AUTO_SUPERPOWERS=true # Auto-inject context
|
|
```
|
|
|
|
### Settings Files
|
|
|
|
**~/.claude/settings.json**
|
|
```json
|
|
{
|
|
"customInstructions": "enabled",
|
|
"permissions": {
|
|
"allowedTools": ["*"],
|
|
"allowedPrompts": ["*"]
|
|
}
|
|
}
|
|
```
|
|
|
|
**~/.claude/hooks.json**
|
|
```json
|
|
{
|
|
"sessionStart": ["session-start-superpowers.sh"],
|
|
"userPromptSubmit": ["qwen-consult.sh", "ralph-auto-trigger.sh"]
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## 📦 Package Contents
|
|
|
|
| Component | Count | Description |
|
|
|-----------|-------|-------------|
|
|
| **Skills** | 30+ | Cognitive, development, UI/UX, autonomous agents |
|
|
| **Agents** | 100+ | Engineering, marketing, product, testing, design |
|
|
| **Hooks** | 5+ | Session automation, multi-AI consultation |
|
|
| **Commands** | 3 | /brainstorm, /write-plan, /execute-plan |
|
|
| **MCP Servers** | 6 | Vision, search, web reader, GitHub, feedback, usage |
|
|
| **Binaries** | 1 | ralphloop wrapper |
|
|
| **Size** | 126MB | Complete package |
|
|
|
|
### Full Inventory
|
|
See [INVENTORY.md](INVENTORY.md) for complete component listing.
|
|
|
|
---
|
|
|
|
## 🔍 Troubleshooting
|
|
|
|
### Ralph Loop Not Working
|
|
|
|
```bash
|
|
# Check Ralph installation
|
|
ralph --version
|
|
|
|
# Reinstall Ralph Orchestrator
|
|
pip3 install --upgrade ralph-orchestrator
|
|
|
|
# Check RalphLoop wrapper
|
|
which ralphloop
|
|
ls -la ~/.local/bin/ralphloop
|
|
```
|
|
|
|
### Skills Not Loading
|
|
|
|
```bash
|
|
# Check skills directory
|
|
ls -la ~/.claude/skills/
|
|
|
|
# Verify skill syntax
|
|
cat ~/.claude/skills/your-skill/SKILL.md
|
|
|
|
# Check for errors
|
|
claude --debug
|
|
```
|
|
|
|
### Claude Code Not Found
|
|
|
|
The supercharge script will offer to install Claude Code automatically if not detected.
|
|
|
|
```bash
|
|
# Or install manually
|
|
npm install -g @anthropic-ai/claude-code
|
|
|
|
# Then run supercharge again
|
|
./supercharge.sh
|
|
```
|
|
|
|
### Z.AI API Configuration
|
|
|
|
```bash
|
|
# Check settings
|
|
cat ~/.claude/settings.json | grep ANTHROPIC
|
|
|
|
# Verify API key works
|
|
curl -X POST https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions \
|
|
-H "Authorization: Bearer YOUR_API_KEY" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"model":"glm-4.7","messages":[{"role":"user","content":"test"}]}'
|
|
```
|
|
|
|
---
|
|
|
|
## 🔄 Updates & Maintenance
|
|
|
|
### Update SuperCharge Package
|
|
|
|
```bash
|
|
cd SuperCharged-Claude-Code-Upgrade
|
|
git pull origin main
|
|
./supercharge.sh
|
|
```
|
|
|
|
### Update Agents
|
|
|
|
```bash
|
|
~/.claude/scripts/sync-agents.sh
|
|
```
|
|
|
|
### Backup Current Setup
|
|
|
|
```bash
|
|
~/.claude/agents/export-claude-customizations.sh
|
|
```
|
|
|
|
---
|
|
|
|
## 🗑️ Uninstallation
|
|
|
|
```bash
|
|
# Remove customizations
|
|
rm -rf ~/.claude/skills/*
|
|
rm -rf ~/.claude/agents/*
|
|
rm -rf ~/.claude/hooks/*
|
|
rm -rf ~/.claude/commands/*
|
|
rm -rf ~/.claude/plugins/*
|
|
rm ~/.claude/hooks.json
|
|
rm ~/.local/bin/ralphloop
|
|
|
|
# Restore from backup if needed
|
|
cp -r ~/.claude-backup-YYYYMMDD_HHMMSS/* ~/.claude/
|
|
```
|
|
|
|
---
|
|
|
|
## 🤝 Contributing
|
|
|
|
Contributions welcome! Please:
|
|
|
|
1. Fork the repository
|
|
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
|
|
3. Commit your changes (`git commit -m 'Add amazing feature'`)
|
|
4. Push to the branch (`git push origin feature/amazing-feature`)
|
|
5. Open a Pull Request
|
|
|
|
### Adding Custom Skills
|
|
|
|
Create `~/.claude/skills/your-skill/SKILL.md`:
|
|
|
|
```markdown
|
|
# Your Custom Skill
|
|
|
|
## When to Use
|
|
Use this skill when...
|
|
|
|
## What It Does
|
|
This skill provides...
|
|
```
|
|
|
|
---
|
|
|
|
## 📄 License
|
|
|
|
MIT License - See [LICENSE](LICENSE) file for details
|
|
|
|
---
|
|
|
|
## 🙏 Credits
|
|
|
|
- **[Ralph Orchestrator](https://github.com/mikeyobrien/ralph-orchestrator)** - Autonomous agent iteration
|
|
- **[Claude Code](https://claude.com/claude-code)** - Anthropic's AI coding assistant
|
|
- **[Z.AI](https://docs.z.ai/devpack/tool/claude)** - GLM model integration
|
|
- **Community Contributors** - Skills, agents, and plugins
|
|
|
|
---
|
|
|
|
## 📞 Support
|
|
|
|
- **Issues**: [Gitea Issues](https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/issues)
|
|
- **Discussions**: [Gitea Discussions](https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/discussions)
|
|
- **Documentation**: [Full Docs](INVENTORY.md)
|
|
|
|
---
|
|
|
|
## 🌟 Star History
|
|
|
|
[](https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade)
|
|
|
|
---
|
|
|
|
**Made with ❤️ for the Claude Code community**
|
|
|
|
*SuperCharge your AI development workflow today!*
|
|
|
|
---
|
|
|
|
**Keywords:** Claude Code customization, Claude Code skills, Claude Code agents, AI coding assistant, Z.AI API, GLM models, RalphLoop, autonomous AI development, CLI tools, developer tools, Claude Code plugins, MCP servers, Qwen integration, AI workflow automation
|