Get Started with BugViper in 5 Minutes

Install the BugViper GitHub App, connect your account, and get your first AI-powered code review on a pull request in under 5 minutes.

BugViper requires no configuration files, no CI changes, and no local tooling. You install the GitHub App, sign in to the dashboard once, and then trigger reviews by commenting on any pull request. This guide walks you through each step from installation to your first inline review comment.

1. Install the GitHub App

   Go to the GitHub Marketplace or click Install GitHub App in the BugViper dashboard. Choose the organization or personal account where you want BugViper to run, then select the repositories it can access — either all repositories or specific ones.

   BugViper requires the following permissions to operate:

   Permission	Access
   Contents	Read
   Issues	Read & Write
   Pull requests	Read & Write
   Metadata	Read
   Commit comments	Read & Write
   GitHub Actions	Read

2. Sign in to the BugViper dashboard

   Open the BugViper dashboard and click Sign in with GitHub. BugViper uses GitHub OAuth to authenticate you and link your account to the GitHub App installation you just completed.

3. Complete onboarding — link your GitHub App installation

   After signing in, BugViper’s onboarding flow guides you through linking your GitHub App installation to your dashboard account. If you installed the app before signing in, BugViper will have stored your pending installation and will connect it automatically at this step.

4. Trigger a review on a pull request

   Open any pull request in a connected repository and leave a comment:

   @bugviper full review
   

   For a faster static-analysis-only pass, use:

   @bugviper run lint
   

   BugViper will acknowledge the command and begin processing immediately.

5. Review inline comments and the summary

   BugViper posts high-confidence findings as inline comments directly on the relevant lines of the diff, then adds a structured summary review to the PR. All issues are also logged to your dashboard with full lifecycle tracking — open, resolved, and fixed — and your analytics are updated automatically.

Comment @bugviper help on any pull request to see the full list of available commands and a brief description of each.

Next steps

Now that BugViper is running, explore everything you can trigger from a PR comment.

Bot Commands

See all available @bugviper commands and when to use each one.