From 73e65c23d577ef4c4ad49a1c568df69d49d069ec Mon Sep 17 00:00:00 2001
From: PTah <papatramp@gmail.com>
Date: Tue, 21 Apr 2026 15:30:47 +1000
Subject: [PATCH] docs: add Windows PowerShell for OpenClaude, ripgrep note,
 ollama launch

Made-with: Cursor
---
 README.md                      | 47 ++++++++++++++++++++++++++++++++++
 docs/quickstart-30min.md       |  2 ++
 docs/rag-mcp-starter/status.sh |  7 ++++-
 3 files changed, 55 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 0aae5a8..e768308 100644
--- a/README.md
+++ b/README.md
@@ -42,8 +42,12 @@
 npm install -g @gitlawb/openclaude
 ```
 
+Если при запуске появится предупреждение вроде `ripgrep not found`, установите **ripgrep** (`rg`) в систему и проверьте `rg --version` в том же терминале, где стартуете OpenClaude.
+
 ### 4.2 Локальный Ollama-профиль (бесплатно)
 
+macOS / Linux:
+
 ```bash
 export CLAUDE_CODE_USE_OPENAI=1
 export OPENAI_BASE_URL=http://127.0.0.1:11434/v1
@@ -51,8 +55,26 @@ export OPENAI_MODEL=qwen2.5-coder:7b
 openclaude
 ```
 
+Windows PowerShell:
+
+```powershell
+$env:CLAUDE_CODE_USE_OPENAI="1"
+$env:OPENAI_BASE_URL="http://127.0.0.1:11434/v1"
+$env:OPENAI_MODEL="qwen2.5-coder:7b"
+
+openclaude
+```
+
+Альтернатива без ручных переменных (если установлен Ollama и доступна команда `ollama launch`):
+
+```bash
+ollama launch openclaude --model qwen2.5-coder:7b
+```
+
 ### 4.3 OpenAI-профиль
 
+macOS / Linux:
+
 ```bash
 export CLAUDE_CODE_USE_OPENAI=1
 export OPENAI_API_KEY=sk-...
@@ -60,8 +82,20 @@ export OPENAI_MODEL=gpt-4o
 openclaude
 ```
 
+Windows PowerShell:
+
+```powershell
+$env:CLAUDE_CODE_USE_OPENAI="1"
+$env:OPENAI_API_KEY="sk-..."
+$env:OPENAI_MODEL="gpt-4o"
+
+openclaude
+```
+
 ### 4.4 DeepSeek-профиль
 
+macOS / Linux:
+
 ```bash
 export CLAUDE_CODE_USE_OPENAI=1
 export OPENAI_BASE_URL=https://api.deepseek.com/v1
@@ -70,6 +104,17 @@ export OPENAI_MODEL=deepseek-chat
 openclaude
 ```
 
+Windows PowerShell:
+
+```powershell
+$env:CLAUDE_CODE_USE_OPENAI="1"
+$env:OPENAI_BASE_URL="https://api.deepseek.com/v1"
+$env:OPENAI_API_KEY="sk-..."
+$env:OPENAI_MODEL="deepseek-chat"
+
+openclaude
+```
+
 ## 5) Локальные бесплатные модели: где брать и что ставить
 
 ### Где брать
@@ -179,6 +224,8 @@ EOF
 direnv allow
 ```
 
+На **Windows** нативный `direnv` используют реже; задайте переменные в текущей сессии PowerShell через `$env:ИМЯ="значение"`, добавьте их в профиль PowerShell, либо работайте в **WSL** и следуйте Linux-инструкциям выше.
+
 ## 8) Минимальный RAG стек (локально)
 
 Рекомендуемая база:
diff --git a/docs/quickstart-30min.md b/docs/quickstart-30min.md
index e37a01d..e60378e 100644
--- a/docs/quickstart-30min.md
+++ b/docs/quickstart-30min.md
@@ -2,6 +2,8 @@
 
 Короткий маршрут "с нуля до рабочего стенда" на Ubuntu.
 
+Если вы на **Windows**, установите Ollama и Node.js локально, затем для запуска OpenClaude на локальной модели используйте блоки **Windows PowerShell** в `README.md` (раздел «4) Быстрый запуск OpenClaude»). Полный стек ниже (Docker, bash-скрипты, пути `~/...`) удобнее повторять в **WSL2** или на Linux-сервере с тем же репозиторием.
+
 ## 0) Что получится
 
 - локальный LLM через Ollama
diff --git a/docs/rag-mcp-starter/status.sh b/docs/rag-mcp-starter/status.sh
index 3e422d9..12d06c2 100755
--- a/docs/rag-mcp-starter/status.sh
+++ b/docs/rag-mcp-starter/status.sh
@@ -92,8 +92,13 @@ fi
 
 echo
 echo "=== Quick Commands ==="
-echo "local run:"
+echo "local run (bash):"
 echo "  export CLAUDE_CODE_USE_OPENAI=1"
 echo "  export OPENAI_BASE_URL=http://127.0.0.1:11434/v1"
 echo "  export OPENAI_MODEL=$MODEL"
 echo "  openclaude"
+echo "local run (Windows PowerShell):"
+echo '  $env:CLAUDE_CODE_USE_OPENAI="1"'
+echo '  $env:OPENAI_BASE_URL="http://127.0.0.1:11434/v1"'
+echo "  \$env:OPENAI_MODEL=\"$MODEL\""
+echo "  openclaude"