Getting Started

Set up your account, create a project, and run your first task in minutes.

What is qtrl

qtrl is a QA platform that combines structured test management with AI-powered browser testing. You write high-level instructions describing what you want to test, and qtrl's AI agents execute those tests in real browsers. The platform handles everything from test generation and execution to reporting, while keeping you in full control of what gets tested and how.

Whether your team is managing test cases manually, automating execution with AI, or doing a mix of both, qtrl adapts to your workflow. You decide how much autonomy the AI has at every step.

Creating your account

To get started, head to the sign-in page and enter your email address. qtrl uses a passwordless authentication flow. You will receive a one-time code via email that you enter to verify your identity. There is no password to remember or manage.

Once verified, your profile is created automatically. You can then create or join an organization to start working with your team.

Setting up your organization

Organizations are how teams are structured in qtrl. Every project, test, and team member belongs to an organization. When you create a new organization, you become its owner with full administrative access.

To create an organization, click the organization selector in the sidebar and choose "Create Organization." Give it a name that represents your team or company.

Once your organization exists, you can invite team members by email. Each member can be assigned one of three roles:

  • Owner has full control over the organization, including billing, member management, and all projects.
  • Admin can manage projects, members, and settings, but cannot modify billing or delete the organization.
  • Member can work within projects they are assigned to, create and execute tests, and view results.

Creating your first project

A project in qtrl represents the application or service you want to test. Each project has its own set of tests, tasks, test runs, and configuration.

To create a project, navigate to your organization's dashboard and click "New Project." You will need to provide:

  • Project name: a descriptive name for what you are testing (for example, "Customer Portal" or "Admin Dashboard").
  • Description: a brief summary of the application and what the project covers.

After creation, you can configure the project further by setting up environments, adding environment variables, and inviting specific team members. See the Projects concept page for details on project configuration.

Running your first task

Tasks are how you tell qtrl what to do. A task is a high-level instruction that the AI agent picks up and executes. To create your first task, open your project and go to the Tasks tab.

Click "Add Task" and you will see a dialog where you can describe what you want. For your first task, try one of these approaches:

  • Generate test cases: describe a feature or user flow and let the AI create structured test cases for it. For example: "Generate test cases for the user login flow, including email validation, successful login, and password reset."
  • Execute instructions: give the AI a one-time instruction to execute directly in the browser. For example: "Go to the homepage, verify the navigation links work, and check that the footer is visible on all pages."

Select the environment you want the task to run against (such as staging or development), then submit. The AI agent will begin working on your task, and you can monitor its progress in real time from the Tasks tab.

Once a "Generate test cases" task completes, the generated tests appear in your Tests tab, ready for review. You can approve, edit, or reject them before they become part of your test suite.

Next steps

Now that you have your first project and task running, explore these resources to get the most out of qtrl: