# BugViper

## Docs

- [Authenticate requests to the BugViper API](https://personal-ce79cb71.mintlify.app/api-reference/authentication.md): Pass a Firebase ID token as a Bearer token in the Authorization header on every BugViper API request. Tokens expire after one hour and must be refreshed.
- [BugViper REST API: endpoints and authentication](https://personal-ce79cb71.mintlify.app/api-reference/overview.md): Overview of the BugViper REST API: base URL, versioning, authentication with Firebase tokens, and links to ingestion, search, and webhook endpoint groups.
- [Ingest GitHub repositories — BugViper API](https://personal-ce79cb71.mintlify.app/api-reference/repositories/ingest.md): POST /api/v1/ingest/github starts repository ingestion into the knowledge graph. POST /api/v1/ingest/{owner}/{repo}/embed generates semantic embeddings.
- [Ingestion job status — BugViper API](https://personal-ce79cb71.mintlify.app/api-reference/repositories/jobs.md): GET /api/v1/ingest/jobs/{job_id} returns the status and stats for an ingestion job. Poll this endpoint to track repository indexing progress.
- [List and delete repositories — BugViper API](https://personal-ce79cb71.mintlify.app/api-reference/repositories/list.md): GET /api/v1/repos/ lists all indexed repositories. DELETE /api/v1/repos/{owner}/{repo_name} removes a repository and its graph data from BugViper.
- [Code Finder endpoints — BugViper API](https://personal-ce79cb71.mintlify.app/api-reference/search/code-finder.md): GET /api/v1/query/code-finder/* endpoints find functions, classes, variables, modules, imports by name and return cyclomatic complexity metrics.
- [Full-text code search endpoints — BugViper API](https://personal-ce79cb71.mintlify.app/api-reference/search/fulltext.md): GET /api/v1/query/search searches functions, classes, variables, and file content with optional repo filtering, returning ranked results with source locations.
- [Semantic code search — BugViper API](https://personal-ce79cb71.mintlify.app/api-reference/search/semantic.md): POST /api/v1/query/semantic embeds your question and returns code ranked by vector cosine similarity, enabling intent-based search across indexed repositories.
- [GitHub webhook events handled by BugViper](https://personal-ce79cb71.mintlify.app/api-reference/webhooks/events.md): Reference for the three GitHub webhook events BugViper processes: push for graph ingestion, pull_request for merge updates, and issue_comment for AI reviews.
- [GitHub webhook endpoint — BugViper API](https://personal-ce79cb71.mintlify.app/api-reference/webhooks/github.md): POST /api/v1/webhook/onComment handles GitHub push, pull_request, and issue_comment events to trigger automated ingestion updates and AI code reviews.
- [Full-text and semantic code search in BugViper](https://personal-ce79cb71.mintlify.app/concepts/code-search.md): BugViper offers Lucene full-text search and vector semantic search over your indexed repositories, with results anchored to exact line numbers in the source.
- [Cyclomatic complexity analysis in BugViper](https://personal-ce79cb71.mintlify.app/concepts/complexity.md): BugViper calculates cyclomatic complexity for every function at ingestion time, helping you identify high-risk code that is most likely to contain bugs.
- [What is the BugViper knowledge graph?](https://personal-ce79cb71.mintlify.app/concepts/knowledge-graph.md): BugViper parses your codebase into a Neo4j property graph with nodes for functions, classes, files, and modules, enabling deep code intelligence queries.
- [How BugViper reviews pull requests](https://personal-ce79cb71.mintlify.app/concepts/pr-reviews.md): BugViper's AI agent queries your knowledge graph for context, then posts inline GitHub comments pinpointing bugs, security issues, and code quality problems.
- [BugViper environment variable reference](https://personal-ce79cb71.mintlify.app/configuration/environment-variables.md): Complete reference for all BugViper environment variables, covering Neo4j, OpenRouter, GitHub App, Firebase, and optional observability settings.
- [Configure AI models for BugViper code reviews](https://personal-ce79cb71.mintlify.app/configuration/review-models.md): Choose and configure any OpenRouter-compatible language model for BugViper's code review agent, balancing review quality against cost per pull request.
- [Configure BugViper GitHub webhooks](https://personal-ce79cb71.mintlify.app/configuration/webhooks.md): Set up GitHub webhooks to enable automatic push ingestion, PR merge graph updates, and @bugviper review triggers from pull request comments.
- [Query your codebase with the Ask Agent](https://personal-ce79cb71.mintlify.app/guides/ask-agent.md): Use BugViper's Ask Agent to ask natural language questions about your codebase and receive AI answers with cited source files and code snippets.
- [Index a repository with BugViper](https://personal-ce79cb71.mintlify.app/guides/index-repository.md): Learn how to ingest a GitHub repository into BugViper's knowledge graph using the dashboard or REST API, and monitor ingestion progress with job polling.
- [Search your codebase with BugViper](https://personal-ce79cb71.mintlify.app/guides/search-codebase.md): Use BugViper's full-text, content, and semantic search to find functions, classes, variables, and code patterns across all indexed repositories.
- [Trigger an AI pull request review with BugViper](https://personal-ce79cb71.mintlify.app/guides/trigger-review.md): Learn how to request a BugViper AI review on GitHub pull requests using @bugviper mention commands and understand the review output format.
- [BugViper: AI-powered code review platform](https://personal-ce79cb71.mintlify.app/introduction.md): BugViper indexes GitHub repositories into a knowledge graph and deploys an AI agent that reviews pull requests with inline bug, security, and quality findings.
- [BugViper quickstart: index a repo and run a review](https://personal-ce79cb71.mintlify.app/quickstart.md): Learn how to install the GitHub App, configure your environment, index your first repository, and trigger an AI pull request review with BugViper.
- [Configure BugViper environment variables](https://personal-ce79cb71.mintlify.app/setup/environment.md): Reference for all BugViper environment variables including Neo4j, OpenRouter, GitHub App, and Firebase credentials required to run the platform.
- [Install the BugViper GitHub App](https://personal-ce79cb71.mintlify.app/setup/github-app.md): Set up the BugViper GitHub App to receive webhook events, clone repositories, and post inline code review comments on pull requests.
- [Troubleshoot BugViper errors and issues](https://personal-ce79cb71.mintlify.app/troubleshooting/common-errors.md): Solutions for common BugViper errors including Neo4j connection failures, Firebase auth issues, GitHub webhook problems, and ingestion failures.
- [BugViper frequently asked questions](https://personal-ce79cb71.mintlify.app/troubleshooting/faq.md): Answers to common questions about BugViper repository indexing, pull request reviews, code search, supported languages, and GitHub App setup.

## OpenAPI Specs

- [openapi](https://personal-ce79cb71.mintlify.app/api-reference/openapi.json)