Skip to main content
BugViper offers two review modes that give you control over the trade-off between speed and depth. Both modes build a full call graph, score files by blast radius, and run a verifier pass — the difference is in how many agents review your code and how thoroughly each batch is analyzed. You can set a default for your repository and override it at any time using a comment on the PR.
Normal mode routes all file batches through a single generalist agent that understands bugs, security issues, and performance concerns in one pass.How it works:
  • Your PR’s changed files are grouped into up to 4 batches using Louvain community detection.
  • Each batch is reviewed sequentially by one generalist agent.
  • The agent has access to the call graph, blast radius scores, and the PR diff for full context.
  • Findings go through the verifier pass and dedup before being posted.
Best for:
  • Everyday pull requests with moderate scope
  • Fast feedback loops where speed matters
  • Smaller PRs where a single agent can hold all the context
  • Teams that want consistent, low-latency reviews on every commit
Normal mode is the default configuration for new repositories.

​
Mode Comparison

​
How to Trigger Each Mode

BugViper uses the review mode configured for your repository by default. You can change your default mode from the BugViper dashboard under repository settings. To trigger a review from a PR comment, use:
This always uses your configured default mode. The @bugviper review command also respects the same default and is useful for incremental reviews as you push new commits.
Not sure which to use? Start with Normal mode for most PRs — it catches the majority of real issues with minimal latency. Switch to Deep mode when you’re merging into a protected branch, touching authentication or payment logic, or making a change that affects a high blast-radius module. You can always re-run in Deep mode by commenting again after a Normal review.