From a0fecee44e5bcc1d7280e6607af69a1f4fc10fed Mon Sep 17 00:00:00 2001
From: Lucas Trzesniewski <lucas.trzesniewski@gmail.com>
Date: Sat, 17 Jan 2026 17:47:22 +0100
Subject: docs: add PowerShell install instructions
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Mateusz Łoskot <mateusz@loskot.net>
---
 README.md                          |  1 +
 docs/docs/guide/dotfiles.md        |  1 +
 docs/docs/guide/getting-started.md |  1 +
 docs/docs/guide/installation.md    | 33 +++++++++++++++++++++++++++++++++
 docs/docs/index.md                 |  1 +
 5 files changed, 37 insertions(+)

diff --git a/README.md b/README.md
index 787e5c3e..60eaa000 100644
--- a/README.md
+++ b/README.md
@@ -83,6 +83,7 @@ I wanted to. And I **really** don't want to.
 - fish
 - nushell
 - xonsh
+- powershell (tier 2 support)
 
 ## Community
 
diff --git a/docs/docs/guide/dotfiles.md b/docs/docs/guide/dotfiles.md
index 79a571ce..d4157cb7 100644
--- a/docs/docs/guide/dotfiles.md
+++ b/docs/docs/guide/dotfiles.md
@@ -13,6 +13,7 @@ The following shells are supported:
 - bash
 - fish
 - xonsh
+- powershell
 
 Note: Atuin handles your configuration internally, so once it is installed you
 no longer need to edit your config files manually.
diff --git a/docs/docs/guide/getting-started.md b/docs/docs/guide/getting-started.md
index c25645d0..85140b25 100644
--- a/docs/docs/guide/getting-started.md
+++ b/docs/docs/guide/getting-started.md
@@ -20,6 +20,7 @@ If you have any problems, please open an [issue](https://github.com/ellie/atuin/
 - fish
 - nushell
 - xonsh
+- powershell (tier 2 support)
 
 ## Quickstart
 
diff --git a/docs/docs/guide/installation.md b/docs/docs/guide/installation.md
index 72130af4..aeb33518 100644
--- a/docs/docs/guide/installation.md
+++ b/docs/docs/guide/installation.md
@@ -2,6 +2,8 @@
 
 ## Recommended installation approach
 
+### On Unix
+
 Let's get started! First up, you will want to install Atuin. The recommended
 approach is to use the installation script, which automatically handles the
 installation of Atuin including the requirements for your environment.
@@ -16,6 +18,21 @@ curl --proto '=https' --tlsv1.2 -LsSf https://setup.atuin.sh | sh
 
 [**Set up sync** - Move on to the next step, or read on to manually install Atuin instead.](sync.md)
 
+### On Windows
+
+The recommended approach on Windows is to use WinGet to install Atuin. Then, if you use PowerShell,
+add the initialization command to your PowerShell profile, and restart your shell.
+
+```shell
+winget install -e Atuinsh.Atuin
+if (-not (Test-Path -Path $PROFILE)) { New-Item -ItemType File -Path $PROFILE -Force | Out-Null }
+Write-Output 'atuin init powershell | Out-String | Invoke-Expression' >> $PROFILE
+```
+
+Note that the `$PROFILE` path may depend on your PowerShell version.
+
+[**Set up sync** - Move on to the next step.](sync.md)
+
 ## Manual installation
 
 ### Installing the binary
@@ -105,6 +122,14 @@ If you don't wish to use the installer, the manual installation steps are as fol
     zinit light atuinsh/atuin
     ```
 
+=== "WinGet"
+
+    Atuin is available on WinGet:
+
+    ```shell
+    winget install -e Atuinsh.Atuin
+    ```
+
 === "Source"
 
     Atuin builds on the latest stable version of Rust, and we make no
@@ -232,6 +257,14 @@ After installing, remember to restart your shell.
     ```
     to the end of your `~/.xonshrc`
 
+=== "PowerShell"
+
+    Add the following to the end of your `$PROFILE` file:
+
+    ```shell
+    atuin init powershell | Out-String | Invoke-Expression
+    ```
+
 ## Upgrade
 
 Run `atuin update`, and if that command is not available, run the install script again.
diff --git a/docs/docs/index.md b/docs/docs/index.md
index 76a4b51f..43ef2f9c 100644
--- a/docs/docs/index.md
+++ b/docs/docs/index.md
@@ -22,6 +22,7 @@ Alternatively, get in touch on our [Discord](https://discord.gg/Fq8bJSKPHh) or o
 - fish
 - nushell
 - xonsh
+- powershell (tier 2 support)
 
 ## Quickstart
 
-- 
cgit v1.3.1