Quickstart
Prerequisites
- Node.js 18+ installed
- A running web app (local or deployed)
- A Swarm account. The CLI and MCP are on every plan, including Free. Manage the plan on Billing.
1. Install the CLI
2. Log in
3. Run your first test
Start your dev server, then run:- Detect that the URL is local and open a tunnel automatically
- Ask you a few questions (audience, number of agents)
- Generate AI personas and start the test
- Stream results to your terminal in real time
4. Review results
Once the test completes, you’ll see:- Individual persona results with UX scores
- A synthesized executive summary
- A judge verdict on whether the goal was achievable
- Actionable tickets for issues found
Next steps
MCP for AI editors
Run the full test → fix → retest loop from inside Claude Code, Codex, or Cursor. One command:
npx @useswarm/mcp setup.CLI Reference
Learn all available commands and flags.
Testing Local Apps
Tunneling, split frontend/backend setups, and authenticated testing.
Personas & Swarms
Create and reuse custom persona sets.
Authenticated Testing
Test flows that require login credentials.

