docs: move getting started to top of README

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

Author: adriandmitroca

README.md

@@ -8,29 +8,73 @@ Relay connects to your existing project management tools, picks up tasks, and us
 
 No API keys to manage. No per-token billing. No workflow files to write. Relay runs locally on your machine using your Claude Code subscription (Pro, Max, or Team) and plugs directly into the tools you already use.
 
-### Why Relay?
+---
 
-- **Works with your Claude Code plan** — uses the `claude` CLI you already have. No separate API keys, no surprise bills
-- **Connects to what you use** — Asana, Linear, Jira, and Sentry out of the box. Not just one tracker
-- **Fully local** — runs on your machine, against your repos, with your credentials. Nothing leaves your environment
-- **Zero config overhead** — point it at a project board and go. No spec files, no workflow DSLs, no Elixir runtime
-- **Human in the loop** — every task is triaged, then confirmed before work starts, then approved before anything ships. You stay in control
-- **Real-time visibility** — a full React dashboard with live streaming progress, diffs, triage results, and action buttons
+## Get started in 2 minutes
+
+**Prerequisites:** [Bun](https://bun.sh) · [Claude Code](https://docs.anthropic.com/en/docs/claude-code) · [GitHub CLI](https://cli.github.com) (`gh auth login`)
+
+```sh
+bunx @adriandmitroca/relay
+```
+
+Your browser opens at `localhost:7842/setup`. The setup wizard walks you through connecting your first integration (Asana, Linear, Jira, or Sentry) and pointing Relay at a repo. Done.
 
-### How it works
+After setup, Relay polls your board, triages tasks with Claude, and waits for your go-ahead before touching any code.
+
+### The full loop
 
 ```
 Your backlog (Asana / Linear / Jira / Sentry)
   → Relay picks up new tasks
   → Claude triages: is this actionable?
   → You confirm: "Start this one"
   → Claude implements in an isolated worktree
-  → You review the diff
-  → Accept → branch pushed + PR created
-  → Discard → worktree removed
+  → You review the diff in the dashboard
+  → Accept → branch pushed, PR created
+  → Discard → worktree removed, nothing changes
   → Skip → task ignored
 ```
 
+### Install globally
+
+```sh
+bun install -g @adriandmitroca/relay
+# or
+npm install -g @adriandmitroca/relay
+```
+
+### Run as a background service (macOS)
+
+Install once, runs forever — auto-starts on login, restarts on crash.
+
+```sh
+bash scripts/install-service.sh
+
+# To remove:
+bash scripts/uninstall-service.sh
+```
+
+### CLI
+
+```
+relay start     Start the daemon and open the dashboard
+relay stop      Stop the daemon
+relay update    Update to the latest version
+relay doctor    Check your setup for problems
+relay version   Show version
+```
+
+---
+
+## Why Relay?
+
+- **Works with your Claude Code plan** — uses the `claude` CLI you already have. No separate API keys, no surprise bills
+- **Connects to what you use** — Asana, Linear, Jira, and Sentry out of the box
+- **Fully local** — runs on your machine, against your repos, with your credentials. Nothing leaves your environment
+- **Human in the loop** — every task is triaged, confirmed before work starts, and approved before anything ships
+- **Real-time visibility** — live dashboard with streaming progress, diffs, triage results, and one-click actions
+
 ## Features
 
 ### Integrations
@@ -60,55 +104,19 @@ Optional Telegram integration with forum topics — each task gets its own threa
 
 ### Smart Pipeline
 
-- **Triage first** — Claude reads the codebase and decides if a task is actionable before spending time on it. Skip triage if you prefer
+- **Triage first** — Claude reads the codebase and decides if a task is actionable before spending time on it
 - **Priority queue** — critical issues are handled first. Queue pauses while awaiting your approval
 - **Isolated worktrees** — every fix runs in its own git worktree. Your working tree is never touched
-- **Session continuity** — triage context carries over to implementation, so Claude doesn't re-read the entire codebase twice
-- **Auto-commit** — tests committed separately from code changes for clean PR history
-
-## Getting Started
-
-### Prerequisites
-
-- [Bun](https://bun.sh) v1.1+
-- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI (`claude` in PATH)
-- [GitHub CLI](https://cli.github.com) (`gh auth login` completed)
-
-### Install
-
-```sh
-# Try without installing
-bunx @adriandmitroca/relay
-
-# Install globally
-bun install -g @adriandmitroca/relay
-# or
-npm install -g @adriandmitroca/relay
-```
-
-Your browser opens to `localhost:7842/setup`. Connect your integrations, point Relay at a project, and you're live.
-
-### Run as a background service (macOS)
-
-```sh
-bash scripts/install-service.sh        # auto-starts on login, restarts on crash
-bash scripts/uninstall-service.sh      # stop and remove
-```
+- **Session continuity** — triage context carries over to implementation, so Claude doesn't re-read the codebase twice
+- **Auto-commit** — tests committed separately from code changes for a clean PR history
 
-### CLI
-
-```
-relay start     Start the daemon (opens dashboard)
-relay stop      Stop the daemon
-relay update    Update to the latest version
-relay version   Show version
-```
+---
 
 ## Development
 
 ```sh
 bun run dev      # daemon + Vite dev server with HMR on :5173
-bun test         # 172 tests across 12 files
+bun test         # run the test suite
 ```
 
 ### Adding a new source integration