Skip to main content
Before creating a Review agent, you need to connect SenseLab to your version control system. This gives the agent access to your repositories so it can perform local and PR reviews.
Connectors are configured under Settings → Connectors in the SenseLab dashboard.

​
What you need

ConnectorRequired for
GitHub or GitLabLocal and PR reviews
SenseLab GitHub App (GitHub Marketplace)PR reviews
Local code reviews work with just the connector. PR reviews additionally require the SenseLab GitHub App installed on your repository.

​
Step 1 — Add a VCS connector

Navigate to Settings → Connectors in the dashboard. Under the VCS section, select GitHub or GitLab.
Screenshot 2026 04 06 At 10 32 04 AM
Click Configure on the connector you want to add, then click + Create to set up a new connection.
Screenshot 2026 04 06 At 10 32 13 AM
You’ll be asked to provide:
  • A name for this connection (e.g. git-dev-myorg)
  • An access token or OAuth credentials with repository access
Once saved, the connection will appear in the connector’s connection list with a status indicator. You can create multiple connections — for example, one per GitHub organization or GitLab group — and set one as the default.
Minimum required token scopes:
  • repo — read repository access
  • read:org — read organization membership
  • read:user — read user profile
Generate a token at GitHub → Settings → Developer settings → Personal access tokens.

​
Step 2 — Install the SenseLab GitHub App (PR reviews only)

This step is only required if you want your Review agent to perform PR reviews. If you only need local code reviews, skip this step and proceed to creating your agent.
The SenseLab GitHub App allows the Review agent to post findings directly to pull requests and receive PR events from GitHub.
  1. Go to the GitHub Marketplace and search for SenseLab
  2. Click Install and select the GitHub organization or account where your repositories live
  3. Choose which repositories to grant access to — you can scope it to specific repos or grant access to all repositories in the org
  4. Complete the installation — GitHub will redirect you back to SenseLab
Once installed, the SenseLab app will receive PR open/update events from GitHub and automatically trigger the Review agent assigned for that repo for every new pull request.
The GitHub App must be installed on the same repositories that you assign to your Review agent. If a repository is not covered by the app installation, PR reviews will not trigger for that repo.

​
Verify your connection

After adding a connector, confirm it’s working:
  1. Go to Settings → Connectors and open the connector you just configured
  2. The connection should show a green checkmark indicating it’s active
  3. You can also check Agent History after creating your first Review agent to confirm it successfully reached your repositories

​
Next step

With your connector set up and the GitHub App installed, you’re ready to create your first Review agent.

Create a Review agent

Configure your agent, assign repositories, and set the types of reviews you want it to perform.