Quickstart
Get CrossCheck reviewing your first PR in about five minutes.
What you'll do
- Sign up and create an organization.
- Install the CrossCheck GitHub App on the repos you want reviewed.
- Add your first repo to CrossCheck.
- Review the AI-suggested checks and save the ones you want.
- Open a PR and watch the review post.
1. Sign up
Go to cross-check.dev and click Start your trial. Sign up with email, Google, or your company SSO.
2. Create an organization
After sign-up you land on /onboarding. Enter an organization name and click Continue to checkout.
You'll be sent to Stripe Checkout to add a card and start your trial. After checkout you return to CrossCheck and land on /<your-org>.
You won't be charged until the trial ends. See Credits and billing for the credit model.
3. Install the GitHub App
From your org's home page, open Settings and click Install GitHub App. GitHub will ask which account or organization to install on, and whether to grant access to all repos or a selected subset.
After the install you're returned to CrossCheck. See Installing the GitHub App for the permissions granted and what to do if you need to change the repo selection later.
4. Add your first repo
Click Repos → New repo, pick a repository from the dropdown (these are repos the GitHub App can see), and click Create.
CrossCheck will automatically run the Suggest checks agent against your default branch — it reads your code and proposes 5–20 checks tailored to your stack. While it runs you can keep working; the suggestions surface as a Review N suggestions button on the repo's Checks tab when they're ready.
Open that dialog, tick the checks you want, and save them into a new or existing check group. Every check group attached to the repo runs on every PR.
See Adding your first repo for the full picker UI and tips on writing your own checks.
5. Open a PR
That's it. The next time someone opens a pull request (or pushes to an existing one) against the repo, CrossCheck will:
- Post a CrossCheck check on the PR that shows
in_progresswhile the review runs. - Post a single sticky comment listing each check as
pass,fail, orneeds_review, with file:line references and a link to the full run on CrossCheck. - Mark the check
success/failure/neutralbased on the result.
By default CrossCheck only reports — it doesn't approve, merge, or block. You can turn on auto-approve, auto-merge, and inline general code review per repo. See PR workflow for the controls.
Next
- Writing good checks — phrase statements the agent can evaluate consistently.
cross-check.yaml— commit your config to the repo instead of editing it in the dashboard.- PR workflow — trigger modes, auto-approve, general review, blocking.