Documentation

Everything you need to get started with Repobility

Getting Started

  1. Create an account — Sign up with your email or GitHub account. The free tier includes 3 repositories and 5 analyses per month.
  2. Add a repository — Paste a Git URL or connect your GitHub account to import repositories directly.
  3. Wait for analysis — Our engine runs 48+ analysis services against your code. This typically takes 1-5 minutes depending on repository size.
  4. Review findings — Browse your dashboard to see quality scores, security vulnerabilities, tech debt estimates, and more.
  5. Use AI prompts — Copy the generated fix prompts into your AI coding assistant (Claude, ChatGPT, Copilot) to automatically fix issues.

Connecting Repositories

GitHub (Recommended)

Connect your GitHub account via OAuth to import repositories with one click. This gives Repobility read access to your repositories for analysis. We request repo and read:org scopes.

Git URL

Paste any public Git URL (HTTPS) to analyze repositories from any provider. For private repositories, provide authentication via the settings panel.

Supported Providers
  • GitHub (github.com, GitHub Enterprise)
  • GitLab (gitlab.com, self-hosted)
  • Bitbucket (bitbucket.org, Bitbucket Server)
  • Any Git-compatible hosting (Gitea, Gogs, Azure DevOps)

Understanding Results

After analysis completes, your repository dashboard shows:

  • Quality Score (A-E): Overall health grade based on 8 dimensions
  • Security Score: Vulnerability and secret exposure rating
  • Tech Debt: Estimated remediation effort in hours
  • Findings: Individual issues categorized by type and severity
  • Languages & Frameworks: Detected tech stack
  • DORA Metrics: Deployment and operational health indicators

AI Fix Prompts

Each finding includes a tailored prompt designed for AI coding assistants. These prompts include:

  • Exact file path and line number
  • Current problematic code
  • Suggested fix approach
  • CWE/OWASP reference for security issues
  • Best practice explanation

Simply copy the prompt and paste it into Claude, ChatGPT, GitHub Copilot, or any AI assistant to get an immediate fix.

Quality Scores

Quality is measured across 8 dimensions:

DimensionWhat It Measures
StructureFile organization, module boundaries, naming conventions
Code QualityComplexity, duplication, code smells
DocumentationREADME, inline docs, API documentation coverage
TestingTest file presence, coverage indicators, test patterns
Best PracticesLinting config, CI/CD, containerization, .gitignore
SecurityVulnerability count, secret exposure, OWASP compliance
DependenciesOutdated packages, vulnerability exposure, license risk
MaintainabilityCognitive complexity, tech debt ratio, change risk

Security Findings

Security findings are classified by severity:

  • Critical: Actively exploitable vulnerabilities, leaked production credentials
  • High: SQL injection, XSS, known CVEs in dependencies
  • Medium: Insecure configurations, missing security headers
  • Low: Informational findings, deprecated practices

Exports

Analysis results can be exported in multiple formats:

  • JSON: Full structured data for programmatic consumption
  • CSV: Tabular data for spreadsheets and data analysis
  • PDF: Formatted report for stakeholders and audits
  • SARIF: Static Analysis Results Interchange Format for IDE integration
  • SBOM (CycloneDX): Software Bill of Materials in CycloneDX format
  • SBOM (SPDX): Software Bill of Materials in SPDX format

API Reference

The REST API is available on Team and Enterprise plans. Full API documentation will be available at /api/v1/docs/ once your account is activated.

# Example: List your repositories
curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://repobility.com/api/v1/repos/

# Example: Get analysis findings
curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://repobility.com/api/v1/repos/123/findings/