mirror of https://github.com/SuperClaude-Org/SuperClaude_Framework.git synced 2025-12-18 02:06:36 +00:00

* 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

* 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>

2025-09-26 19:37:34 +05:30

1.7 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.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

# 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

/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.1.5
/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.7 KiB Raw Blame History