Skip to main content

Repotoire Documentation

Welcome to the Repotoire documentation. Repotoire is a graph-powered code health platform that analyzes codebases using Neo4j knowledge graphs to detect code smells, architectural issues, and technical debt.

Getting Started
Set up Repotoire and analyze your first codebase in 5 minutes
CLI Reference
Command-line interface for local development and CI/CD pipelines
REST API
Programmatic access to all platform features via REST endpoints
Webhooks
Real-time notifications for analysis events and findings

What is Repotoire?

Unlike traditional linters that examine files in isolation, Repotoire builds a Neo4j knowledge graph combining:

  • Structural Analysis - AST parsing to understand code structure
  • Semantic Understanding - NLP and AI to understand code meaning
  • Relational Patterns - Graph algorithms to detect architectural issues

How to Use Repotoire

CLI (Command Line)

Best for local development and CI/CD pipelines:

# Install
pip install repotoire

# Analyze a codebase
repotoire ingest ./my-project
repotoire analyze ./my-project

# Ask questions with natural language
repotoire ask "Where is authentication handled?"

REST API

Best for integrating with web applications and services:

curl -X POST https://api.repotoire.io/api/v1/analysis/trigger \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"repository_id": "550e8400-e29b-41d4-a716-446655440000"}'

Web Dashboard

Use the web dashboard for a visual interface with repository health dashboards, finding browser with code context, AI-powered fix suggestions, and team analytics.

Support