From 720ebb00901892f65048911b3b299ea964646b1a Mon Sep 17 00:00:00 2001
From: Mithun Gowda B <mithungowda.b7411@gmail.com>
Date: Thu, 17 Jul 2025 12:57:44 +0530
Subject: [PATCH] Update installation-guide.md

Signed-off-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
---
 Docs/installation-guide.md | 52 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)

diff --git a/Docs/installation-guide.md b/Docs/installation-guide.md
index 8426960..c9444fe 100644
--- a/Docs/installation-guide.md
+++ b/Docs/installation-guide.md
@@ -10,6 +10,58 @@ pip install SuperClaude
 SuperClaude install --quick
 # That's it! 🎉
 ```
+---
+## 🔧 UV / UVX Setup Guide
+
+SuperClaude v3 also supports installation via [`uv`](https://github.com/astral-sh/uv) (a faster, modern Python package manager) or `uvx` for cross-platform usage.
+
+### 🌀 Install with `uv`
+
+Make sure `uv` is installed:
+
+```bash
+curl -Ls https://astral.sh/uv/install.sh | sh
+```
+
+> Or follow instructions from: [https://github.com/astral-sh/uv](https://github.com/astral-sh/uv)
+
+Once `uv` is available, you can install SuperClaude like this:
+
+```bash
+uv venv
+source .venv/bin/activate
+uv pip install SuperClaude
+```
+
+### ⚡ Install with `uvx` (Cross-platform CLI)
+
+If you’re using `uvx`, just run:
+
+```bash
+uvx pip install SuperClaude
+```
+
+### ✅ Finish Installation
+
+After installing, continue with the usual installer step:
+
+```bash
+python3 -m SuperClaude install
+```
+
+Or using bash-style CLI:
+
+```bash
+SuperClaude install
+```
+
+### 🧠 Note:
+
+* `uv` provides better caching and performance.
+* Compatible with Python 3.8+ and works smoothly with SuperClaude.
+
+---
+
 ### ⚠️ Important Note 
 **After installing the SuperClaude.**
 **You can use `SuperClaude commands`