From c8d96952df08e2dc370dc7de988e60695328afd8 Mon Sep 17 00:00:00 2001
From: Lex Christopherson <lex@glittercowboy.com>
Date: Tue, 10 Mar 2026 22:32:14 -0600
Subject: [PATCH] docs: add multi-model/provider section to README

- 20+ built-in providers (Anthropic, OpenAI, Google, OpenRouter, etc.)
- OAuth support for Claude Max, Codex, GitHub Copilot subscriptions
- OpenRouter for access to hundreds of models
- Per-phase model selection example in preferences
- Updated requirements to note Node 22+ recommended
---
 README.md | 36 ++++++++++++++++++++++++++++++++++--
 1 file changed, 34 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 5091b392f..6919cda43 100644
--- a/README.md
+++ b/README.md
@@ -320,8 +320,8 @@ gsd (CLI binary)
 
 ## Requirements
 
-- **Node.js** ≥ 20.6.0
-- **Anthropic API key** — handled by Pi's built-in auth flow on first launch
+- **Node.js** ≥ 20.6.0 (22+ recommended)
+- **An LLM provider** — Anthropic API key (handled by Pi's built-in auth flow on first launch), or any of the 20+ supported providers
 - **Git** — initialized automatically if missing
 
 Optional:
@@ -331,6 +331,38 @@ Optional:
 
 ---
 
+## Use Any Model
+
+GSD isn't locked to one provider. It runs on the [Pi SDK](https://github.com/nicholasgasior/pi-coding-agent), which supports **20+ model providers** out of the box. Use different models for different phases — Opus for planning, Sonnet for execution, a fast model for research.
+
+### Built-in Providers
+
+Anthropic, OpenAI, Google (Gemini), OpenRouter, GitHub Copilot, Amazon Bedrock, Azure OpenAI, Google Vertex, Groq, Cerebras, Mistral, xAI, HuggingFace, Vercel AI Gateway, and more.
+
+### OAuth / Max Plans
+
+If you have a **Claude Max**, **Codex**, or **GitHub Copilot** subscription, you can use those directly — Pi handles the OAuth flow. No API key needed.
+
+### OpenRouter
+
+[OpenRouter](https://openrouter.ai) gives you access to hundreds of models through a single API key. Use it to run GSD with Llama, DeepSeek, Qwen, or anything else OpenRouter supports.
+
+### Per-Phase Model Selection
+
+In your preferences (`/gsd prefs`), assign different models to different phases:
+
+```yaml
+models:
+  research: openrouter/deepseek/deepseek-r1
+  planning: claude-opus-4-6
+  execution: claude-sonnet-4-6
+  completion: claude-sonnet-4-6
+```
+
+Use expensive models where quality matters (planning, complex execution) and cheaper/faster models where speed matters (research, simple completions). GSD tracks cost per-model so you can see exactly where your budget goes.
+
+---
+
 ## License
 
 [Business Source License 1.1](LICENSE)