Skip to content
QAClan

The local app

QAClan runs as a small app in a browser tab on your own machine. This page is how to get around it.

Address
localhost:7823
Start it with
qaclan serve
Reachable by
You, on this machine only
qaclan serve
The QAClan app: the sidebar on the left, the top bar with project switcher, and the Scripts page listing recorded tests.The QAClan app: the sidebar on the left, the top bar with project switcher, and the Scripts page listing recorded tests.
1 — what you can do. 2 — which project, and syncing. 3 — the page you are on.

Three regions, and that is the whole layout. Nothing is hidden behind a menu.

GroupHoldsCovered in
—EnvironmentEnvironments and secrets
TestingFeatures · Scripts · Suites · RunsWeb testing and Suites, runs and reports
API TestingAPIAPI testing
—SettingsBelow

The Testing group reads in the order you use it: record a script under a feature, put scripts in a suite, and the suite produces runs. Everything for testing APIs sits behind the single API entry.

2 · The top bar

The top bar: theme toggle, Pull and Push buttons, and the project switcher.The top bar: theme toggle, Pull and Push buttons, and the project switcher.
ControlWhat it does
Theme toggleLight or dark. Remembered on this machine.
PullBrings your workspace down from the cloud. For setting up a second machine.
PushSends everything pending now, instead of waiting for the background queue.
Project switcherNames the project you are in, and switches between them.

Syncing runs on its own while you work, so Push and Pull are not part of a normal day. What does and does not travel is in Sync, team and plans.

Pull does not bring back browser run history

It restores what you built — projects, scripts, suites, environments, API collections. Past browser runs stay on the machine that produced them.

Projects

A project is one application under test. Features, scripts, suites, environments and API collections each belong to exactly one, and you only ever see the active one.

Open the switcher at the top right to change project or to add one with + New project. Each row carries a delete control.

Deleting a project takes its contents with it

Features, scripts, suites, runs, environments and API collections in that project go too. There is no undo on the machine; a cloud workspace keeps whatever had already synced.

Settings and the auth key

One card, Auth Key — how this machine identifies itself to your account. It reads Connected with your name and email, or Not connected.

The agent Settings page showing the Auth Key card in its disconnected state, with the key field and the Update Key button.The agent Settings page showing the Auth Key card in its disconnected state, with the key field and the Update Key button.
Shown before a key is entered. Once connected the badge turns green and your account appears beside it.

Your key stays readable at Settings → Auth Key on qaclan.com, so you can look it up whenever you need it.

Changing the key, or signing the machine out

The key field is masked. Click into it, paste a different key and choose Update Key — what you do after regenerating a key, or when moving the machine to another account.

Disconnect signs the machine out. Local projects, scripts and runs stay exactly where they are and the app keeps working; only syncing stops.

Working offline

Recording, editing, running and reading results all happen on your machine and need no connection. Syncing is the only part that does, and it queues quietly until the network comes back.

Where to go next

ToRead
Record your first browser testWeb testing
Test an APIAPI testing
Keep credentials out of your testsEnvironments and secrets
Run tests together and read the resultsSuites, runs and reports