Windows Setup

Windows-specific installation and usage notes.

Installation on Windows

Via winget (Recommended)

Claude Code supports Windows Package Manager:

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

# 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

git clone https://github.com/OthmanAdi/planning-with-files.git
Copy-Item -Recurse planning-with-files\skills\* $env:USERPROFILE\.claude\skills\

Path Differences

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:

./scripts/init-session.sh

Option 2: Use WSL

wsl ./scripts/init-session.sh

Option 3: Manual alternative

Instead of running scripts, manually create the files:

# 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:

# Windows
$env:USERPROFILE\.claude\skills\

# Not Unix-style
~/.claude/skills/

Line endings

If templates appear corrupted, check line endings:

# 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:

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