From 06f1d4dcef3f5694b493c319a3108fea702d905c Mon Sep 17 00:00:00 2001
From: Milton Adina <MILTONADINA@GMAIL.COM>
Date: Sun, 15 Mar 2026 05:05:39 -0500
Subject: [PATCH] docs: add Windows quickstart.ps1 instructions to
 getting-started.md (#5668)

- Add Windows (PowerShell) section alongside Linux/macOS
- Reference .\quickstart.ps1 for native Windows users
- Add Set-ExecutionPolicy note for script execution
- Link to environment-setup.md for WSL alternatives
---
 docs/getting-started.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/docs/getting-started.md b/docs/getting-started.md
index e4afd791..0af2b83e 100644
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -13,6 +13,8 @@ This guide will help you set up the Aden Agent Framework and build your first ag
 
 The fastest way to get started:
 
+**Linux / macOS:**
+
 ```bash
 # 1. Clone the repository
 git clone https://github.com/adenhq/hive.git
@@ -25,6 +27,22 @@ cd hive
 uv run python -c "import framework; import aden_tools; print('✓ Setup complete')"
 ```
 
+**Windows (PowerShell):**
+
+```powershell
+# 1. Clone the repository
+git clone https://github.com/adenhq/hive.git
+cd hive
+
+# 2. Run automated setup
+.\quickstart.ps1
+
+# 3. Verify installation (optional, quickstart.ps1 already verifies)
+uv run python -c "import framework; import aden_tools; print('Setup complete')"
+```
+
+> **Note:** On Windows, running `.\quickstart.ps1` requires PowerShell 5.1+. If you see a "running scripts is disabled" error, run `Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass` first. Alternatively, use WSL — see [environment-setup.md](./environment-setup.md) for details.
+
 ## Building Your First Agent
 
 Agents are not included by default in a fresh clone.