From 3d87d888ab1c72b847d95b80f74659704a7140ce Mon Sep 17 00:00:00 2001
From: rob <robdickson444@hotmail.com>
Date: Sun, 18 Jan 2026 01:50:57 -0400
Subject: [PATCH] Add GUI provider installer to provider-setup documentation

- Add new "Visual Installer (GUI)" section explaining the desktop wizard
- Update intro to mention both GUI and CLI options
- Rename "Interactive Installer" to "Command-Line Installer" for clarity
- Update headings list

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 src/cmdforge/web/docs_content.py | 40 +++++++++++++++++++++++++++-----
 1 file changed, 34 insertions(+), 6 deletions(-)

diff --git a/src/cmdforge/web/docs_content.py b/src/cmdforge/web/docs_content.py
index 1f3a760..9c933d4 100644
--- a/src/cmdforge/web/docs_content.py
+++ b/src/cmdforge/web/docs_content.py
@@ -3658,22 +3658,49 @@ moving up to parent directories. This means you can have:</p>
         "description": "Install and configure AI providers for your tools",
         "content": """
 <p class="lead">CmdForge is the brain, but AI providers are the muscle. Before your tools can do
-anything smart, you need at least one provider configured. The good news? CmdForge has an
-interactive installer that makes this painless.</p>
+anything smart, you need at least one provider configured. The good news? CmdForge makes
+provider setup painless—whether you prefer a graphical wizard or the command line.</p>
 
 <div class="bg-indigo-50 border-l-4 border-indigo-500 p-4 my-6">
     <p class="font-semibold text-indigo-800">What You'll Learn</p>
     <ul class="mt-2 text-indigo-700">
-        <li>Using the interactive provider installer</li>
+        <li>Using the visual provider installer (GUI)</li>
+        <li>Using the command-line installer</li>
         <li>Available provider options and their tradeoffs</li>
         <li>Testing your provider setup</li>
         <li>Managing multiple providers</li>
     </ul>
 </div>
 
-<h2 id="interactive-install">The Interactive Installer</h2>
+<h2 id="gui-install">Visual Installer (GUI)</h2>
 
-<p>The easiest way to get started:</p>
+<p>The friendliest way to install providers—a point-and-click wizard right in the desktop app:</p>
+
+<ol>
+    <li>Launch CmdForge: <code>cmdforge</code></li>
+    <li>Go to <strong>Tools → Install AI Provider...</strong> (or click "Install Provider..." on the Providers page)</li>
+    <li>Select a provider from the list</li>
+    <li>Click <strong>Install Selected</strong></li>
+    <li>Watch the installation progress in real-time</li>
+    <li>Choose which model variants to add</li>
+</ol>
+
+<div class="bg-gray-100 rounded-lg p-4 my-4">
+    <p class="text-sm text-gray-600 mb-2">The installer shows you:</p>
+    <ul class="text-sm text-gray-700">
+        <li><strong>Which providers are already installed</strong> (marked in green)</li>
+        <li><strong>Cost information</strong> for each provider</li>
+        <li><strong>Available models</strong> you can use</li>
+        <li><strong>Live installation output</strong> so you know what's happening</li>
+    </ul>
+</div>
+
+<p>After installation, the wizard offers to add provider variants (like <code>claude-haiku</code>,
+<code>claude-opus</code>) to your configuration automatically.</p>
+
+<h2 id="interactive-install">Command-Line Installer</h2>
+
+<p>Prefer the terminal? Use the interactive CLI installer:</p>
 
 <pre><code class="language-bash">cmdforge providers install</code></pre>
 
@@ -3850,7 +3877,8 @@ cat file.txt | summarize --provider mock</code></pre>
 </ul>
 """,
         "headings": [
-            ("interactive-install", "The Interactive Installer"),
+            ("gui-install", "Visual Installer (GUI)"),
+            ("interactive-install", "Command-Line Installer"),
             ("provider-options", "Choosing a Provider"),
             ("testing", "Testing Your Setup"),
             ("listing", "Viewing Configured Providers"),