docs: make CLI quickstart watcher-first

Author: jonathanpopham

cli/quickstart.mdx

@@ -1,31 +1,38 @@
 ---
 title: 'Quickstart'
-description: 'Authenticate and run your first analysis'
+description: 'Start the live graph watcher'
 icon: 'bolt'
 ---
 
-## 1. Authenticate
+## 1. Run Supermodel in your repo
 
 ```bash
-supermodel login
+cd /path/to/your/repo
+supermodel
 ```
 
-Opens your browser, creates an API key, and saves it to `~/.supermodel/config.yaml`. For CI, pass the key directly:
+On first run, `supermodel` opens the setup flow automatically. It authenticates you, confirms the repo, offers to install the Claude Code hook, and enables `.graph.*` sidecar files.
 
-```bash
-supermodel login --token smsk_live_...
+After setup, the same command starts the live graph watcher:
+
+```text
+[supermodel] [step:1] Building code graph
+[supermodel] [step:2] Starting listeners
+[supermodel] [step:3] Ready — listening on UDP :7734
 ```
 
-## 2. Analyze a repo
+Leave it running while you code. It updates the graph when files change, writes graph sidecars next to source files, and cleans generated sidecars when you stop it with `Ctrl+C`.
+
+## 2. Tell your agent the graph files exist
 
 ```bash
-cd /path/to/your/repo
-supermodel analyze
+supermodel skill >> CLAUDE.md
+# or AGENTS.md, .cursorrules, etc.
 ```
 
-Uploads the repo, runs call graph + dependency + domain analysis, caches the result locally by content hash, and writes `.graph.*` sidecar files next to each source file.
+The prompt explains the naming convention (`Foo.py` → `Foo.graph.py`) and tells your agent to read the graph file before the source file.
 
-## 3. Use the results
+## 3. Use the live graph
 
 | Goal | Command |
 |---|---|
@@ -36,9 +43,19 @@ Uploads the repo, runs call graph + dependency + domain analysis, caches the res
 | Token-efficient context for one file | `supermodel focus path/to/file.go` |
 | Print the full graph | `supermodel graph` |
 
-Subsequent commands reuse the cached graph automatically. Pass `--force` to any command to bypass the cache.
+These commands reuse the cached graph automatically. Pass `--force` to bypass the cache.
+
+## 4. One-shot analysis
+
+Use `analyze` when you want to build or refresh the graph once and exit instead of keeping the watcher running:
+
+```bash
+supermodel analyze
+```
+
+`analyze` uploads the repo, runs call graph + dependency + domain analysis, caches the result locally by content hash, and writes `.graph.*` sidecar files next to source files. Add `--no-shards` to skip writing sidecars.
 
-## 4. Configure (optional)
+## 5. Configure (optional)
 
 Settings live at `~/.supermodel/config.yaml`. Environment variables override file values.
 

index.mdx

@@ -13,7 +13,7 @@ title: Introduction
 
 ## CLI quickstart
 
-The fastest path: install the binary and run `setup`. The wizard authenticates you, detects your repo, offers to install the Claude Code hook, and starts the live graph daemon — one command, end to end.
+The fastest path: install the binary, go to your repo, and run `supermodel`. On first run it handles setup automatically; after that it starts the live graph watcher.
 
 ### 1. Install
 
@@ -23,21 +23,16 @@ curl -fsSL https://supermodeltools.com/install.sh | sh
 
 Other options: `npm install -g @supermodeltools/cli` or build from source. See [Installation](/cli/install).
 
-### 2. Run the setup wizard
+### 2. Start the live graph watcher
 
 ```bash
 cd /path/to/your/repo
-supermodel setup
+supermodel
 ```
 
-The wizard walks four steps:
-
-1. **Authentication** — opens your browser to create an API key and saves it to `~/.supermodel/config.yaml`.
-2. **Repository** — detects the git root and confirms the directory.
-3. **Agent hook** — if Claude Code is installed, offers to add a `PostToolUse` hook so `.graph.*` files refresh on every `Write`/`Edit`. Cursor, Copilot, Windsurf, and Aider read the files directly — no hook needed.
-4. **Shard mode** — enables writing `.graph.*` sidecars next to your source files.
+If this is your first run, `supermodel` launches setup automatically. It authenticates you, confirms the repo, offers to install the Claude Code hook, and enables writing `.graph.*` sidecars next to source files.
 
-It then runs the live graph daemon for you. Press `Ctrl+C` to stop.
+Then `supermodel` builds the graph and stays running as the live watcher. Press `Ctrl+C` to stop and clean generated sidecars.
 
 ### 3. Tell your agent the sidecars exist
 
@@ -52,7 +47,7 @@ The prompt explains the naming convention (`Foo.py` → `Foo.graph.py`), the thr
 
 ### 4. What you get
 
-After setup runs, each source file gets one `.graph.*` sidecar with dependency, call, and impact sections:
+After the watcher runs, each source file gets one `.graph.*` sidecar with dependency, call, and impact sections:
 
 ```
 src/
@@ -85,7 +80,7 @@ Your agent reads these via `cat` and `grep` like any other file. No prompt chang
 
 ### 5. Keep it running
 
-The bare `supermodel` command is the live graph daemon. Run it any time you want graph files to stay fresh as you code:
+The bare `supermodel` command is the live graph watcher. Run it any time you want graph files to stay fresh as you code:
 
 ```bash
 supermodel