7a491b1548
Features: - 30+ Custom Skills (cognitive, development, UI/UX, autonomous agents) - RalphLoop autonomous agent integration - Multi-AI consultation (Qwen) - Agent management system with sync capabilities - Custom hooks for session management - MCP servers integration - Plugin marketplace setup - Comprehensive installation script Components: - Skills: always-use-superpowers, ralph, brainstorming, ui-ux-pro-max, etc. - Agents: 100+ agents across engineering, marketing, product, etc. - Hooks: session-start-superpowers, qwen-consult, ralph-auto-trigger - Commands: /brainstorm, /write-plan, /execute-plan - MCP Servers: zai-mcp-server, web-search-prime, web-reader, zread - Binaries: ralphloop wrapper Installation: ./supercharge.sh
140 lines
2.7 KiB
Markdown
140 lines
2.7 KiB
Markdown
# Windows Setup
|
|
|
|
Windows-specific installation and usage notes.
|
|
|
|
---
|
|
|
|
## Installation on Windows
|
|
|
|
### Via winget (Recommended)
|
|
|
|
Claude Code supports Windows Package Manager:
|
|
|
|
```powershell
|
|
winget install Anthropic.ClaudeCode
|
|
```
|
|
|
|
Then install the skill:
|
|
|
|
```
|
|
/plugin marketplace add OthmanAdi/planning-with-files
|
|
/plugin install planning-with-files@planning-with-files
|
|
```
|
|
|
|
### Manual Installation
|
|
|
|
```powershell
|
|
# Create plugins directory
|
|
mkdir -p $env:USERPROFILE\.claude\plugins
|
|
|
|
# Clone the repository
|
|
git clone https://github.com/OthmanAdi/planning-with-files.git $env:USERPROFILE\.claude\plugins\planning-with-files
|
|
```
|
|
|
|
### Skills Only
|
|
|
|
```powershell
|
|
git clone https://github.com/OthmanAdi/planning-with-files.git
|
|
Copy-Item -Recurse planning-with-files\skills\* $env:USERPROFILE\.claude\skills\
|
|
```
|
|
|
|
---
|
|
|
|
## Path Differences
|
|
|
|
| Unix/macOS | Windows |
|
|
|------------|---------|
|
|
| `~/.claude/skills/` | `%USERPROFILE%\.claude\skills\` |
|
|
| `~/.claude/plugins/` | `%USERPROFILE%\.claude\plugins\` |
|
|
| `.claude/plugins/` | `.claude\plugins\` |
|
|
|
|
---
|
|
|
|
## Shell Script Compatibility
|
|
|
|
The helper scripts (`init-session.sh`, `check-complete.sh`) are bash scripts.
|
|
|
|
### Option 1: Use Git Bash
|
|
|
|
If you have Git for Windows installed, run scripts in Git Bash:
|
|
|
|
```bash
|
|
./scripts/init-session.sh
|
|
```
|
|
|
|
### Option 2: Use WSL
|
|
|
|
```bash
|
|
wsl ./scripts/init-session.sh
|
|
```
|
|
|
|
### Option 3: Manual alternative
|
|
|
|
Instead of running scripts, manually create the files:
|
|
|
|
```powershell
|
|
# Copy templates to current directory
|
|
Copy-Item templates\task_plan.md .
|
|
Copy-Item templates\findings.md .
|
|
Copy-Item templates\progress.md .
|
|
```
|
|
|
|
---
|
|
|
|
## Hook Commands
|
|
|
|
The hooks use Unix-style commands. On Windows with Claude Code:
|
|
|
|
- Hooks run in a Unix-compatible shell environment
|
|
- Commands like `cat`, `head`, `echo` work automatically
|
|
- No changes needed to the skill configuration
|
|
|
|
---
|
|
|
|
## Common Windows Issues
|
|
|
|
### Path separators
|
|
|
|
If you see path errors, ensure you're using the correct separator:
|
|
|
|
```powershell
|
|
# Windows
|
|
$env:USERPROFILE\.claude\skills\
|
|
|
|
# Not Unix-style
|
|
~/.claude/skills/
|
|
```
|
|
|
|
### Line endings
|
|
|
|
If templates appear corrupted, check line endings:
|
|
|
|
```powershell
|
|
# Convert to Windows line endings if needed
|
|
(Get-Content template.md) | Set-Content -Encoding UTF8 template.md
|
|
```
|
|
|
|
### Permission errors
|
|
|
|
Run PowerShell as Administrator if you get permission errors:
|
|
|
|
```powershell
|
|
# Right-click PowerShell → Run as Administrator
|
|
```
|
|
|
|
---
|
|
|
|
## Terminal Recommendations
|
|
|
|
For best experience on Windows:
|
|
|
|
1. **Windows Terminal** - Modern terminal with good Unicode support
|
|
2. **Git Bash** - Unix-like environment on Windows
|
|
3. **WSL** - Full Linux environment
|
|
|
|
---
|
|
|
|
## Need Help?
|
|
|
|
Open an issue at [github.com/OthmanAdi/planning-with-files/issues](https://github.com/OthmanAdi/planning-with-files/issues).
|