From b8c17547b4ab68256748d56ce54ad7a50fcaf584 Mon Sep 17 00:00:00 2001
From: Abdul-Omira <32625230+Abdul-Omira@users.noreply.github.com>
Date: Wed, 9 Sep 2026 15:59:00 +0300
Subject: [PATCH] docs: give Windows a working install command
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The Install section offered only `curl … | bash`, which cannot work in
PowerShell — the shell Windows users get. It fails with "the term 'bash' is
not recognized", or, where WSL is installed, with "Invoke-WebRequest: A
parameter cannot be found that matches parameter name 'fsSL'", because
PowerShell 5.1 aliases curl to Invoke-WebRequest. Both reproduced on
Windows 11 / PowerShell 5.1.

Adds the PowerShell one-liner, and the scriptblock form for passing options.

Platform support also claimed "the shell installer above is for macOS and
Linux" and sent Windows users to a manual tarball download. That was wrong:
`install` has handled Windows for months. What it cannot do is run outside a
bash, or put koder on a PATH that PowerShell and cmd can see — which is what
install.ps1 is for. Says that instead, and keeps the manual download as the
fallback it is.
---
 README.md | 33 ++++++++++++++++++++++++++++++---
 1 file changed, 30 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 18f7895..7533f9e 100644
--- a/README.md
+++ b/README.md
@@ -33,10 +33,23 @@ tools, and works against the models in your aixplain account.
 
 ## Install
 
+macOS and Linux:
+
 ```sh
 curl -fsSL https://github.com/aixplain/koder/releases/latest/download/install | bash
 ```
 
+Windows, in PowerShell:
+
+```powershell
+irm https://github.com/aixplain/koder/releases/latest/download/install.ps1 | iex
+```
+
+> Don't paste the `curl … | bash` line into PowerShell. `bash` isn't a Windows
+> command, and PowerShell 5.1 aliases `curl` to `Invoke-WebRequest`, which rejects
+> `-fsSL`. Use the PowerShell line above — it also puts `koder` on your PATH for
+> PowerShell, cmd and Windows Terminal, which a Git Bash install cannot do.
+
 Open a new terminal afterwards, then run `koder` from inside a project:
 
 ```sh
@@ -54,6 +67,14 @@ curl -fsSL https://github.com/aixplain/koder/releases/latest/download/install |
 curl -fsSL https://github.com/aixplain/koder/releases/latest/download/install | bash -s -- --no-modify-path
 ```
 
+The same, in PowerShell. A piped `iex` has nowhere to put options, so the script
+has to be materialised first:
+
+```powershell
+& ([scriptblock]::Create((irm https://github.com/aixplain/koder/releases/latest/download/install.ps1))) -Version 0.3.1
+& ([scriptblock]::Create((irm https://github.com/aixplain/koder/releases/latest/download/install.ps1))) -NoModifyPath
+```
+
 ## First run
 
 Koder asks for an aixplain API key the first time it starts.
@@ -193,9 +214,15 @@ curl -fsSL https://github.com/aixplain/koder/releases/latest/download/install |
 | Linux | x64, arm64 |
 | Windows | x64 |
 
-macOS 12 or later. On Windows, download `koder-windows-x64.tar.gz` from the
-[releases page](https://github.com/aixplain/koder/releases/latest) and put `koder.exe`
-somewhere on your PATH; the shell installer above is for macOS and Linux.
+macOS 12 or later. On Windows, use the PowerShell installer in [Install](#install) —
+it puts `koder.exe` in `~/.koder/bin` and adds that to your user PATH, so `koder`
+works in PowerShell, cmd and Windows Terminal.
+
+The `curl … | bash` installer also supports Windows, but only from inside Git Bash
+or WSL, and the PATH entry it writes is visible only to that shell. You can always
+download `koder-windows-x64.tar.gz` from the
+[releases page](https://github.com/aixplain/koder/releases/latest) and place
+`koder.exe` on your PATH by hand instead.
 
 ## Verifying a download