Deployed ad9903b with MkDocs version: 1.6.1

agent-install.html

@@ -411,6 +411,17 @@
     </span>
   </a>
 
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#ai-guided-setup-recommended-for-new-users" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        AI-Guided Setup (Recommended for New Users)
+      
+    </span>
+  </a>
+  
 </li>
 
         <li class="md-nav__item">
@@ -1361,6 +1372,17 @@
     </span>
   </a>
 
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#ai-guided-setup-recommended-for-new-users" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        AI-Guided Setup (Recommended for New Users)
+      
+    </span>
+  </a>
+  
 </li>
 
         <li class="md-nav__item">
@@ -1866,6 +1888,15 @@ <h2 id="table-of-contents">Table of Contents<a class="headerlink" href="#table-o
 <li><a href="#skills-reference">Skills Reference</a></li>
 <li><a href="#uninstalling">Uninstalling</a></li>
 </ul>
+<h2 id="ai-guided-setup-recommended-for-new-users">AI-Guided Setup (Recommended for New Users)<a class="headerlink" href="#ai-guided-setup-recommended-for-new-users" title="Permanent link">&para;</a></h2>
+<p>The <strong>install-mentor agent</strong> can guide you through the entire setup process conversationally. It detects your environment, installs packages, configures studyctl, and verifies everything works using <code>studyctl doctor</code>.</p>
+<p>The prompt lives at <a href="../agents/shared/install-mentor.md"><code>agents/shared/install-mentor.md</code></a> and works with any AI coding tool. To use it:</p>
+<div class="highlight"><pre><span></span><code><span class="c1"># In Claude Code — just ask:</span>
+<span class="c1"># &quot;Read agents/shared/install-mentor.md and follow it to set up studyctl&quot;</span>
+
+<span class="c1"># Or in any AI tool that can run shell commands, paste the prompt contents</span>
+</code></pre></div>
+<p>The install-mentor uses <code>studyctl doctor --json</code> as its contract — it parses the health check output and fixes issues automatically (up to 3 iterations).</p>
 <h2 id="what-are-ai-agents">What are AI Agents?<a class="headerlink" href="#what-are-ai-agents" title="Permanent link">&para;</a></h2>
 <p>AI agents are custom personas you load into tools like kiro-cli or Claude Code. Instead of a generic assistant, you get a Socratic mentor that knows your learning style, tracks your progress, and teaches through questioning rather than lecturing.</p>
 <p>This project ships agents for five platforms:

contributing.html

@@ -1196,7 +1196,7 @@ <h2 id="code-style">Code Style<a class="headerlink" href="#code-style" title="Pe
 <li><strong>Linter/formatter</strong>: <a href="https://docs.astral.sh/ruff/">ruff</a> (configured in each <code>pyproject.toml</code>)</li>
 <li><strong>Type checker</strong>: <a href="https://github.com/microsoft/pyright">pyright</a> in basic mode</li>
 <li><strong>Line length</strong>: 100 characters</li>
-<li><strong>Target</strong>: Python 3.10+ (agent-session-tools), Python 3.12+ (studyctl)</li>
+<li><strong>Target</strong>: Python 3.12+ (both studyctl and agent-session-tools)</li>
 </ul>
 <p>Run checks manually:</p>
 <div class="highlight"><pre><span></span><code>uv<span class="w"> </span>run<span class="w"> </span>ruff<span class="w"> </span>check<span class="w"> </span>.<span class="w">              </span><span class="c1"># Lint</span>

search/search_index.js

@@ -2002,7 +2002,7 @@ <h2 id="table-of-contents">Table of Contents<a class="headerlink" href="#table-o
 </ul>
 <h2 id="prerequisites">Prerequisites<a class="headerlink" href="#prerequisites" title="Permanent link">&para;</a></h2>
 <ul>
-<li><strong>Python 3.10+</strong> (studyctl requires 3.12+, agent-session-tools works with 3.10+)</li>
+<li><strong>Python 3.12+</strong> (both studyctl and agent-session-tools require 3.12+)</li>
 <li><strong><a href="https://docs.astral.sh/uv/">uv</a></strong> — Python package manager</li>
 <li><strong>Obsidian</strong> — for study notes (any vault structure works)</li>
 <li><strong>Optional</strong>: <code>notebooklm-py</code> for Google NotebookLM sync</li>
@@ -2015,7 +2015,7 @@ <h3 id="automatic-recommended">Automatic (recommended)<a class="headerlink" href
 ./scripts/install.sh
 </code></pre></div>
 <p>This will:
-1. Verify Python 3.10+ is installed
+1. Verify Python 3.12+ is installed
 2. Install <code>uv</code> if not already available
 3. Run <code>uv sync</code> to install both packages
 4. Run <code>install-agents.sh</code> to set up AI agent definitions
@@ -2425,7 +2425,7 @@ <h2 id="windows-wsl2">Windows (WSL2)<a class="headerlink" href="#windows-wsl2" t
 <h3 id="prerequisites_1">Prerequisites<a class="headerlink" href="#prerequisites_1" title="Permanent link">&para;</a></h3>
 <ol>
 <li>Install WSL2 with Ubuntu: <code>wsl --install -d Ubuntu</code></li>
-<li>Inside WSL2, install Python 3.10+ and uv:
+<li>Inside WSL2, install Python 3.12+ and uv:
    <div class="highlight"><pre><span></span><code>curl<span class="w"> </span>-LsSf<span class="w"> </span>https://astral.sh/uv/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>sh
 </code></pre></div></li>
 <li>Clone and install as normal (all commands run inside WSL2)</li>