Quick Start

Overview

You can go from sign-up to seeing your first complexity scores in under five minutes. GitVelocity connects to your repositories on GitHub, Bitbucket, or GitLab during the signup process, watches for merged pull requests, and scores each one automatically.

Step 1: Sign Up

Navigate to the GitVelocity app and create your account, or accept a team invite.

Step 2: Choose Your Provider

During the signup flow, you are presented with two provider options: GitHub or Bitbucket. Select the platform where your repositories are hosted.

Step 3: Install and Connect

For GitHub, you will be prompted to install the GitVelocity GitHub App on your organization. For Bitbucket, you will connect via OAuth to your Bitbucket workspace. If your organization requires admin approval for new integrations, the request will be sent to an organization owner or workspace admin.

Step 4: Confirm Your Organization

After connecting your provider, review and confirm your organization details. Choose which repositories GitVelocity should track. You can select individual repositories or grant access to all repositories in the organization.

For detailed information on permissions and setup options, see Connecting Your Repositories.

Step 5: Automatic Scoring Begins

Once installed, GitVelocity begins scoring new merged pull requests automatically. There is nothing else to configure. Each PR is analyzed by Claude across six complexity dimensions, and the result is a score from 0 to 100. You can switch models at any time from Review Settings.

Analysis takes approximately 30 seconds per pull request.

Step 6: View Your Dashboard

Open the GitVelocity dashboard to see scores as they come in. Scores typically appear within a few minutes of a PR merging. The dashboard shows individual PR scores, engineer summaries, and team-level trends.

Optional: Historical Backfill

By default, GitVelocity only scores pull requests that merge after installation. If you want scores for previously merged PRs, you can trigger a historical backfill from the repository settings page. The backfill processes past PRs at the same rate -- roughly 30 seconds each -- so large repositories may take some time to complete.

Next Steps