mirror of https://github.com/SuperClaude-Org/SuperClaude_Framework.git synced 2025-12-26 06:07:30 +00:00

NomenAK 5d0546e041 🔖 Complete version standardization to 4.0.3

- Update all remaining version references to 4.0.3
- Fix documentation files (SECURITY.md, CODE_OF_CONDUCT.md, CONTRIBUTING.md)
- Update PUBLISHING.md version references and examples
- Fix all component metadata versions (mcp, modes, mcp_docs)
- Update setup/data/features.json versions
- Fix SuperClaude __main__.py version strings
- Update all documentation command examples
- Standardize version across 15+ files

All components now consistently at v4.0.3 for dual PyPI/NPM release.

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>

2025-08-22 20:49:39 +02:00

1.5 KiB

Raw Blame History

SuperClaude Common Issues - Quick Reference 🚀

Problem Solving Guide: Most frequent issues with practical solutions.

Top 5 Quick Fixes (90% of Issues)

1. Commands Not Working in Claude Code ⚡

Problem: /sc:brainstorm doesn't work
Solution: Restart Claude Code completely
Test: /sc:brainstorm "test" should ask questions

2. Installation Verification

python3 -m SuperClaude --version    # Should show 4.0.3

# If not working:
pip install --upgrade SuperClaude
python3 -m SuperClaude install

3. Permission Issues

# Permission denied errors:
pip install --user SuperClaude
# Or: sudo chown -R $USER ~/.claude

4. MCP Server Issues

/sc:analyze . --no-mcp              # Test without MCP servers
node --version                      # Check Node.js 16+ if needed

5. Component Missing

python3 -m SuperClaude install --components core commands agents modes --force

Platform-Specific Issues

Windows:

set CLAUDE_CONFIG_DIR=%USERPROFILE%\.claude
python -m SuperClaude install --install-dir "%CLAUDE_CONFIG_DIR%"

macOS:

brew install python3 node
pip3 install SuperClaude

Linux:

sudo apt install python3 python3-pip nodejs
pip3 install SuperClaude

Verification Checklist

python3 -m SuperClaude --version returns 4.0.3
/sc:brainstorm "test" works in Claude Code
SuperClaude install --list-components shows components

When Quick Fixes Don't Work

See Troubleshooting Guide for advanced diagnostics.

1.5 KiB Raw Blame History