fix: resolve ty type-check failures for optional UI deps and add agent setup guide to Getting Started

Exclude src/ralphify/ui/ from ty checking since fastapi/uvicorn/pydantic
are optional dependencies. Add inline ignore for the uvicorn import in
cli.py. Expand the Getting Started prerequisites with concrete Claude Code
install, auth, and verification steps so new users don't get stuck before
step 1.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: 2 people

docs/getting-started.md

@@ -8,9 +8,32 @@ This tutorial walks through setting up ralphify on a project, adding checks and
 
 ## Prerequisites
 
-- Python 3.11+
-- [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) installed and authenticated (or any agent CLI that accepts piped input)
-- A project with a test suite (we'll use this for the feedback loop)
+- **Python 3.11+**
+- **An AI coding agent CLI** — this tutorial uses Claude Code, but ralphify works with [any agent that accepts piped input](agents.md)
+- **A project with a test suite** (we'll use this for the feedback loop)
+
+### Install Claude Code (if you don't have it)
+
+```bash
+npm install -g @anthropic-ai/claude-code
+```
+
+Then authenticate:
+
+```bash
+claude  # Opens an interactive session — follow the login prompts
+```
+
+Once authenticated, verify it works non-interactively:
+
+```bash
+echo "Say hello" | claude -p
+```
+
+You should see a text response. If this works, you're ready.
+
+!!! tip "Using a different agent?"
+    See [Using with Different Agents](agents.md) for setup guides for Aider, Codex CLI, or your own custom wrapper.
 
 ## Step 1: Install ralphify
 

pyproject.toml

@@ -47,5 +47,8 @@ build-backend = "hatchling.build"
 packages = ["src/ralphify"]
 exclude = ["src/ralphify/ui/frontend/"]
 
+[tool.ty.src]
+exclude = ["src/ralphify/ui/"]
+
 [tool.pytest.ini_options]
 testpaths = ["tests"]

src/ralphify/cli.py

@@ -487,7 +487,7 @@ def ui(
     except ImportError:
         rprint("[red]UI deps not installed. Run: pip install ralphify[ui][/red]")
         raise typer.Exit(1)
-    import uvicorn
+    import uvicorn  # ty: ignore[unresolved-import]
 
     rprint(f"[bold]Starting Ralphify UI at http://{host}:{port}[/bold]")
     uvicorn.run(create_app(), host=host, port=port)