External/SuperClaude
1
0
Fork 0
mirror of https://github.com/SuperClaude-Org/SuperClaude_Framework.git synced 2025-12-29 16:16:08 +00:00
Code Issues Packages Projects Releases Wiki Activity

🔧 Fix platform-specific documentation issues and standardize shell syntax

Browse Source 
## Major Platform-Specific Improvements

### Windows Path Standardization
- **Fixed forward slash issues**: All Windows paths now use proper backslashes
- **Standardized path variables**: Consistent use of %USERPROFILE% instead of mixed %USERNAME%
- **Proper error path examples**: Fixed error messages to show correct Windows paths

### Shell Command Organization
- **Clear platform separation**: Added distinct Linux/macOS vs Windows sections
- **Proper language tags**: bash for Unix, cmd for Windows Command Prompt, powershell for PowerShell
- **Platform headers**: Clear "Linux/macOS" and "Windows" labels for all command blocks

### Cross-Platform Command Coverage
- **Diagnostic commands**: Both platforms now have equivalent diagnostic procedures
- **Recovery procedures**: Platform-specific backup/restore operations
- **Installation fixes**: Proper installation commands for both environments

## Files Updated
- `Reference/common-issues.md`: Platform-specific quick fixes with proper shell tags
- `Reference/troubleshooting.md`: Comprehensive cross-platform diagnostic procedures

## Technical Details
- Windows commands use proper path syntax (backslashes, %USERPROFILE%)
- Unix commands maintained with proper forward slash paths
- All code blocks properly tagged with language identifiers
- Platform-specific alternatives provided for all major operations

This resolves platform-specific issues identified in documentation review and ensures
consistent user experience across Windows, Linux, and macOS environments.

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

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
NomenAK
2025-08-18 17:58:39 +02:00
parent 03cc8b814e
commit 88f2b9a296
2 changed files with 200 additions and 38 deletions
Download Patch File Download Diff File Expand all files Collapse all files

44
Docs/Reference/common-issues.md
View File

@@ -82,7 +82,7 @@ python3 -m SuperClaude --version
**Quick Fix**:
```cmd
set CLAUDE_CONFIG_DIR=C:\Users\%USERNAME%\.claude
set CLAUDE_CONFIG_DIR=%USERPROFILE%\.claude
python -m SuperClaude install --install-dir "%CLAUDE_CONFIG_DIR%"
```
@@ -106,10 +106,14 @@ python -m SuperClaude install --install-dir "%CLAUDE_CONFIG_DIR%"
**Error**: `Node.js not found` during MCP installation
**Quick Fix**:
**Linux/macOS**:
```bash
# Linux/macOS:
curl -fsSL https://nodejs.org/dist/v18.17.0/node-v18.17.0-linux-x64.tar.xz | tar -xJ
# Windows:
```
**Windows**:
```cmd
winget install OpenJS.NodeJS
```
@@ -121,6 +125,8 @@ winget install OpenJS.NodeJS
**Error**: Insufficient memory or resources
**Quick Fix**:
**Linux/macOS**:
```bash
# Clear temporary data:
rm -rf ~/.claude/tmp/ ~/.claude/cache/
@@ -128,6 +134,14 @@ rm -rf ~/.claude/tmp/ ~/.claude/cache/
# Close other applications
```
**Windows**:
```cmd
# Clear temporary data:
rmdir /s /q "%USERPROFILE%\.claude\tmp" "%USERPROFILE%\.claude\cache" 2>nul
REM Work with smaller projects
REM Close other applications
```
[Detailed Help →](troubleshooting.md#performance-problems-and-optimization)
---
@@ -136,6 +150,8 @@ rm -rf ~/.claude/tmp/ ~/.claude/cache/
**Error**: Multiple issues, corrupted installation
**Quick Fix**:
**Linux/macOS**:
```bash
rm -rf ~/.claude/
pip uninstall SuperClaude
@@ -143,6 +159,14 @@ pip install SuperClaude
python3 -m SuperClaude install --fresh
```
**Windows**:
```cmd
rmdir /s /q "%USERPROFILE%\.claude"
pip uninstall SuperClaude
pip install SuperClaude
python -m SuperClaude install --fresh
```
[Detailed Help →](troubleshooting.md#reset-and-recovery-procedures)
---
@@ -150,15 +174,29 @@ python3 -m SuperClaude install --fresh
## Emergency Recovery
**Complete Reset** (when everything is broken):
**Linux/macOS**:
```bash
rm -rf ~/.claude/ && pip uninstall SuperClaude && pip install SuperClaude && python3 -m SuperClaude install --fresh
```
**Windows**:
```cmd
rmdir /s /q "%USERPROFILE%\.claude" && pip uninstall SuperClaude && pip install SuperClaude && python -m SuperClaude install --fresh
```
**Test Installation**:
**Linux/macOS**:
```bash
python3 -m SuperClaude --version && echo "✅ Installation OK"
```
**Windows**:
```cmd
python -m SuperClaude --version && echo ✅ Installation OK
```
**Test Claude Code Integration**:
Type `/sc:help` in Claude Code - should show available commands.