Skip to content
FastTest Agent

Getting Started

Prerequisites

  • Node.js 18 or later
  • An AI coding assistant that supports MCP — Claude Code, Cursor, VS Code, Codex, Windsurf, or any other supported IDE

No account or API key is needed to get started — browser tools, testing, and exploration work locally out of the box. AI test generation and persistent suites require a free cloud account.

Quick Install

  1. Add FastTest Agent to your IDE

    For Claude Code:

    Terminal window
    npx -y @fasttest-ai/qa-agent@latest install

    For other IDEs, see the IDE Setup guide.

  2. Install a browser

    Terminal window
    npx playwright install chromium

    You can also install firefox or webkit for cross-browser testing.

  3. Start testing

    Ask your AI assistant:

    Test the login flow on https://myapp.example.com

    Browser tools, testing, exploration, and self-healing work immediately — no setup required.

Connect to Cloud (Optional)

For persistent test suites, CI/CD integration, the dashboard, and shared healing patterns, authenticate with the setup tool:

  1. Ask your AI assistant:

    Run setup

  2. A URL is displayed — open it in your browser to complete the OAuth device code flow.

  3. Once authenticated, your API key is saved to ~/.fasttest/config.json automatically. Cloud features are now active.

Your First Test

  1. Describe what to test

    Ask your AI assistant something like:

    Test the login flow on https://myapp.example.com

    FastTest Agent opens a real browser, navigates to your app, and starts executing test scenarios. Your AI assistant drives the entire process — clicking, filling forms, and checking assertions.

  2. Watch it run

    Tests execute in a real browser on your machine. You’ll see results as they complete:

    Test Run PASSED
    Total: 3 | Passed: 3 | Failed: 0 | Skipped: 0
    Duration: 4.2s

    If any selectors break, FastTest Agent tries to heal them automatically before reporting a failure.

  3. Save as a reusable suite

    After tests pass, save them as a reusable test suite:

    Save these tests as “Login Flow”

    The suite is stored in the cloud and can be re-run from your IDE or CI/CD pipeline.

Project Configuration

FastTest Agent remembers your active project in a .fasttest.json file in your project root:

{
  "project_id": "uuid-of-your-project",
  "project_name": "My SaaS App"
}

This is created automatically the first time you run a test with a project name. Subsequent runs in the same directory use the cached project.

Next Steps