[GH-ISSUE #120] Windows support #46

New issue

Open

opened 2026-02-27 10:21:56 +03:00 by kerem · 4 comments

kerem commented

2026-02-27 10:21:56 +03:00

Owner

Originally created by @killaragorn on GitHub (Jan 26, 2026).
Original GitHub issue: https://github.com/mikeyobrien/ralph-orchestrator/issues/120

any plan support windows?

Originally created by @killaragorn on GitHub (Jan 26, 2026). Original GitHub issue: https://github.com/mikeyobrien/ralph-orchestrator/issues/120 any plan support windows?

kerem commented

2026-02-27 10:21:57 +03:00

Author

Owner

@nirvanalinlei commented on GitHub (Jan 29, 2026):

pump, we need windows supported.

@nirvanalinlei commented on GitHub (Jan 29, 2026): pump, we need windows supported.

kerem commented

2026-02-27 10:21:57 +03:00

Author

Owner

@xobosox commented on GitHub (Feb 7, 2026):

I've made a Windows compatible version.. I'm making sure it doesn't break the Mac/Linux functionality/install, then I'll do a PR for it.

@xobosox commented on GitHub (Feb 7, 2026): I've made a Windows compatible version.. I'm making sure it doesn't break the Mac/Linux functionality/install, then I'll do a PR for it.

kerem commented

2026-02-27 10:21:57 +03:00

Author

Owner

@gwin003 commented on GitHub (Feb 7, 2026):

Found it strange this doesn't support Windows already, looking forward to someone adding it!

@gwin003 commented on GitHub (Feb 7, 2026): Found it strange this doesn't support Windows already, looking forward to someone adding it!

kerem commented

2026-02-27 10:21:57 +03:00

Author

Owner

@mick2025s commented on GitHub (Feb 14, 2026):

@killaragorn I've been running it daily. The whole thing takes about 5 minutes.

My environment:

Windows 11 (Build 26200)
WSL 2.6.3 / Ubuntu 24.04 LTS
Ralph 2.5.0

Setup steps:

Install WSL2 (skip if you already have it):
```
wsl --install
```
Reboot when prompted. This installs Ubuntu by default.
Create a non-root user (important — don't run as root):
```
sudo adduser yourname
sudo usermod -aG sudo yourname
```
Then set it as default: open PowerShell and run:
```
ubuntu config --default-user yourname
```
Restart WSL. Claude Code and npm don't play well with root.

Install Node.js inside WSL:

sudo apt update && sudo apt install -y nodejs npm

Install Claude Code inside WSL (native installer — no npm needed):
```
curl -fsSL https://claude.ai/install.sh | bash
```
Then launch claude — it opens your browser to log in with your Claude account. No API key needed if you have a Pro/Max subscription.

Install and initialize Ralph in your project:

npm i -D @ralph-orchestrator/ralph-cli
npx ralph --version
npx ralph init --backend claude

Run Ralph:
```
npx ralph run
```

That's it. Everything runs natively inside the Linux environment — no compatibility patches needed.

Tips:

Access your Windows files from WSL at /mnt/c/...
VS Code's "Remote - WSL" extension lets you edit WSL files seamlessly
Claude Code auto-updates in the background with the native installer
WSL2 also supports Claude Code's Bash tool sandboxing (WSL1 does not)

@mick2025s commented on GitHub (Feb 14, 2026): @killaragorn I've been running it daily. The whole thing takes about 5 minutes. **My environment:** - Windows 11 (Build 26200) - WSL 2.6.3 / Ubuntu 24.04 LTS - Ralph 2.5.0 **Setup steps:** 1. **Install WSL2** (skip if you already have it): ``` wsl --install ``` Reboot when prompted. This installs Ubuntu by default. 2. **Create a non-root user** (important — don't run as root): ```bash sudo adduser yourname sudo usermod -aG sudo yourname ``` Then set it as default: open PowerShell and run: ``` ubuntu config --default-user yourname ``` Restart WSL. Claude Code and npm don't play well with root. 3. **Install Node.js** inside WSL: ```bash sudo apt update && sudo apt install -y nodejs npm ``` 4. **Install Claude Code** inside WSL (native installer — no npm needed): ```bash curl -fsSL https://claude.ai/install.sh | bash ``` Then launch `claude` — it opens your browser to log in with your Claude account. No API key needed if you have a Pro/Max subscription. 5. **Install and initialize Ralph** in your project: ```bash npm i -D @ralph-orchestrator/ralph-cli npx ralph --version npx ralph init --backend claude ``` 6. **Run Ralph**: ```bash npx ralph run ``` That's it. Everything runs natively inside the Linux environment — no compatibility patches needed. **Tips:** - Access your Windows files from WSL at `/mnt/c/...` - VS Code's "Remote - WSL" extension lets you edit WSL files seamlessly - Claude Code auto-updates in the background with the native installer - WSL2 also supports Claude Code's [Bash tool sandboxing](https://code.claude.com/docs/en/setup) (WSL1 does not)