Getting started

codqual reviews your code the way a senior engineer would — no rules to write, nothing to configure. Here is how to go from signup to your first results in under ten minutes.

Using a coding agent? codqual is built to be driven by agents. Set it up for Claude Code, Cursor, or any coding agent in two minutes — the agent quickstart covers the skill, the API key, and the feedback loop. Go to the AI agents guide →
Or let your agent do the work — paste this prompt:
I want to add codqual (AI code review) to this project. Read https://codqual.com/docs/agents and help me set it up step by step — The account, repo setup, the skill, the API key, and a first check that it works. Ask me for anything you need.

1. Create your account

Sign up with email and password, GitHub, or Google at codqual.com/login. The moment you finish, a welcome page shows your API key once — copy it somewhere safe. You can always mint a new one in Settings → API Keys.

2. Connect GitHub

In the dashboard, open Repositories and choose Connect GitHub. This installs the codqual GitHub App on your account or organization, where you pick exactly which repositories it may see. Only organization owners and admins can connect.

Signing in with GitHub and installing the GitHub App are two different things — this step is the App install, and it is what lets codqual read your code.

3. Enroll repositories

Connecting does not automatically track anything. When you return to the dashboard, the Manage repositories picker opens — check the repositories codqual should scan. Only the repositories you enroll here are ever processed.

4. Get your first results

Press Scan now on any enrolled repository for a full scan: a health score, prioritized issues, and a maturity rubric. Then open a pull request — every PR gets an automatic review with a Pass, Warn, or Fail verdict, posted straight to GitHub as a check.

Next steps