Get started with QAClan

Sign in to QAClan

Head over to qaclan.com and sign in using your Google account. This creates your workspace and gives you access to the cloud dashboard.

Grab your Auth Key

After signing in you'll land on the Settings page. Your unique auth key is displayed here — copy it. You'll need this to connect the CLI agent to your cloud workspace.

Install the Agent

Open your terminal and run the install command below. It downloads the QAClan CLI agent and sets everything up automatically.

$ curl -fsSL https://raw.githubusercontent.com/qaclan/agent/master/install.sh | sh

Launch the Agent

Run the serve command to start the QAClan agent. It will open the local application in your browser where you can manage everything.

$ qaclan serve

Create a Project

From the agent dashboard, create your first project. Projects are top-level containers that group all your features, scripts, suites, and runs together.

Add a Feature

Inside your project, add a feature. Features represent functional areas of your application — like Authentication, Checkout, or Search.

Record Your First Script

Navigate to Scripts and click Record. Fill in the details on the record modal and hit Record — a Playwright browser will launch automatically.

• Interact with your app as a real user would
• Add assertions to validate expected behavior
• Close the Playwright browser when you're done recording

Script Created

Once the Playwright browser closes, your new test script is saved automatically. You can view the generated Playwright code, edit it, or re-record.

Record More Scripts

Record additional test cases following the same flow. For example, record a Logout test — just stop recording in Playwright for any steps you want to skip (like the login part), then start recording once you're ready.

• Stop recording during setup steps you want to skip
• Start recording again when the actual test begins
• Close the browser to save the script

Create a Suite

Click New Suite and give it a name — for example "Authentication". Suites let you run multiple test scripts together in a specific order.

Configure the Suite

Click Edit on your new suite and add the test scripts in the order you want them to run. For our Authentication suite, that's Login first, then Logout.

Run the Suite

Click Run on your suite. You'll be asked to select an environment — if you haven't set one up yet, choose "None" and hit Run Suite. The agent executes each script in sequence.

View Results

After execution completes, you'll see the results for every test in the suite — passed, failed, or partial. Each result includes detailed logs and timing.

Run History

Head to the Runs section to browse your complete run history. Every suite and script execution is logged with timestamps, status, and environment details.