> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useswarm.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Swarm Documentation

> AI-powered UX testing that finds friction before your users do.

# Swarm Documentation

Swarm sends AI personas through your product to find usability issues before you ship. Point it at any URL, define a goal, and get actionable UX insights in minutes.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/getting-started/quickstart">
    Install the CLI and run your first test in under 5 minutes.
  </Card>

  <Card title="How It Works" icon="lightbulb" href="/getting-started/introduction">
    Learn how Swarm generates personas and evaluates your product.
  </Card>

  <Card title="MCP for Claude / Codex / Cursor" icon="sparkles" href="/mcp/setup">
    Drive a test → fix → retest loop from inside your AI editor. One command sets it up: `npx @useswarm/mcp setup`.
  </Card>

  <Card title="MCP Sample Prompts" icon="messages" href="/mcp/prompts">
    Copy-paste prompts for auth flows, multi-step loops, cookie injection, and diagnostics.
  </Card>

  <Card title="CLI Reference" icon="terminal" href="/cli/commands">
    Full reference for all commands, flags, and options.
  </Card>

  <Card title="Dashboard" icon="browser" href="/getting-started/dashboard">
    Create tests and view results from the web UI.
  </Card>
</CardGroup>

## Get started

```bash theme={null}
npm install -g @useswarm/cli
swarm login
swarm test --url localhost:3000 --goal "Sign up for an account"
```

## Guides

<CardGroup cols={3}>
  <Card title="Local Testing" icon="globe" href="/guides/local-testing">
    Tunneling, split frontend/backend, and framework-specific tips.
  </Card>

  <Card title="Persistent Tunnels" icon="link" href="/guides/persistent-tunnels">
    Stable localhost tunnel hostnames for OAuth callbacks and repeat local tests.
  </Card>

  <Card title="Authenticated Testing" icon="lock" href="/guides/authenticated-testing">
    Test flows behind a login page.
  </Card>

  <Card title="Personas & Swarms" icon="users" href="/concepts/personas">
    Create and reuse custom persona sets.
  </Card>
</CardGroup>