mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-29 16:16:08 +00:00
fdfb05e981
* The -i flag has been removed from the `_run_command_cross_platform` function in `setup/components/mcp.py`. * fix: Prevent installer from hanging during MCP installation The SuperClaude installer was hanging during the installation of MCP components on non-Windows systems. This was caused by the use of an interactive shell (`-i`) when executing the `claude mcp add` command. The interactive shell would attempt to read from standard input, causing the process to be suspended by the shell. This commit fixes the issue by removing the `-i` flag from the `_run_command_cross_platform` function in `setup/components/mcp.py`. This ensures that the installation process runs non-interactively and completes without hanging. * fix: Add 'cmd /c' for Windows and refactor shell execution This commit resolves an issue with `npx` command execution on Windows by prepending `cmd /c` to the command. It also refactors the shell command execution for non-Windows systems to use the `executable` argument in `subprocess.run` for a cleaner and more robust implementation. * fix: Add 'cmd /c' for Windows and refactor shell execution This commit resolves an issue with `npx` command execution on Windows by prepending `cmd /c` to the command. It also refactors the shell command execution for non-Windows systems to use the `executable` argument in `subprocess.run` for a cleaner and more robust implementation. * docs: Update Chrome DevTools MCP documentation This commit updates the documentation for the Chrome DevTools MCP server to be more comprehensive and consistent with the existing documentation structure. The file `SuperClaude/MCP/MCP_Chrome-DevTools.md` has been updated with detailed information about the server's purpose, triggers, and usage examples. * docs: Update documentation for Chrome DevTools MCP This commit updates the main README.md and the MCP servers user guide to include information about the new Chrome DevTools MCP server. The documentation has been updated to reflect the new server count and provide details about the new server's functionality. * chore: Bump version to 4.1.5 This commit updates the version number from 4.1.4 to 4.1.5 across the entire codebase. This includes updates to: - CHANGELOG.md - Documentation files - Configuration files (package.json, pyproject.toml) - Source code fallbacks - The main VERSION file --------- Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
79 lines
1.7 KiB
Markdown
79 lines
1.7 KiB
Markdown
# 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
|
|
```bash
|
|
python3 -m SuperClaude --version # Should show 4.1.5
|
|
|
|
# If not working:
|
|
# For pipx users
|
|
pipx upgrade SuperClaude
|
|
|
|
# For pip users
|
|
pip install --upgrade SuperClaude
|
|
|
|
# Then reinstall
|
|
python3 -m SuperClaude install
|
|
```
|
|
|
|
### 3. Permission Issues
|
|
```bash
|
|
# Permission denied / PEP 668 errors:
|
|
# Option 1: Use pipx (recommended)
|
|
pipx install SuperClaude
|
|
|
|
# Option 2: Use pip with --user
|
|
pip install --user SuperClaude
|
|
|
|
# Option 3: Fix permissions
|
|
sudo chown -R $USER ~/.claude
|
|
```
|
|
|
|
### 4. MCP Server Issues
|
|
```bash
|
|
/sc:analyze . --no-mcp # Test without MCP servers
|
|
node --version # Check Node.js 16+ if needed
|
|
```
|
|
|
|
### 5. Component Missing
|
|
```bash
|
|
python3 -m SuperClaude install --components core commands agents modes --force
|
|
```
|
|
|
|
## Platform-Specific Issues
|
|
|
|
**Windows:**
|
|
```cmd
|
|
set CLAUDE_CONFIG_DIR=%USERPROFILE%\.claude
|
|
python -m SuperClaude install --install-dir "%CLAUDE_CONFIG_DIR%"
|
|
```
|
|
|
|
**macOS:**
|
|
```bash
|
|
brew install python3 node
|
|
pip3 install SuperClaude
|
|
```
|
|
|
|
**Linux:**
|
|
```bash
|
|
sudo apt install python3 python3-pip nodejs
|
|
pip3 install SuperClaude
|
|
```
|
|
|
|
## Verification Checklist
|
|
- [ ] `python3 -m SuperClaude --version` returns 4.1.5
|
|
- [ ] `/sc:brainstorm "test"` works in Claude Code
|
|
- [ ] `SuperClaude install --list-components` shows components
|
|
|
|
## When Quick Fixes Don't Work
|
|
See [Troubleshooting Guide](troubleshooting.md) for advanced diagnostics. |