From fdce8bb3a1f6b1f0291eb8bf308b2abfc6ea0801 Mon Sep 17 00:00:00 2001
From: LingyeNBird <lingyebird@users.noreply.github.com>
Date: Sat, 4 Jul 2026 22:35:43 +0800
Subject: [PATCH] docs: add PowerShell prompt compatibility note to README

Add a note explaining that zoxide must be initialized after prompt theme tools (e.g. oh-my-posh, starship, posh-git) in PowerShell. This limitation is unique to PowerShell; other shells like Bash and Zsh use array-based hook mechanisms and are not affected.
---
 README.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.md b/README.md
index 6d9af913..eadcf8b8 100644
--- a/README.md
+++ b/README.md
@@ -281,6 +281,12 @@ zoxide can be installed in 4 easy steps:
    > ```powershell
    > Invoke-Expression (& { (zoxide init powershell | Out-String) })
    > ```
+   >
+   > **Note for PowerShell users:** If you use a prompt theme tool (such as
+   > oh-my-posh, starship, or posh-git), make sure zoxide is initialized
+   > **after** it in your profile. This is because zoxide wraps the existing
+   > `prompt` function to record directories. This is not a concern on other
+   > shells like Bash or Zsh.
 
    </details>