DebtDrone CLI

Stop counting lines. Start fixing debt.

Scanning a complex repo in <200ms

---

Why DebtDrone?

Traditional linters check style. DebtDrone analyzes architecture.

Most code quality tools rely on regex pattern matching—they're fast but fragile. A complex function signature with nested generics? False positive. A callback wrapped in middleware? Missed entirely.

DebtDrone uses Abstract Syntax Trees (AST) via Tree-sitter, the same technology that powers GitHub's code navigation. It understands your code the way a compiler does: parsing structure, not strings. This means:

• ✅ Zero false positives on complex type signatures
• ✅ Context-aware analysis of function complexity
• ✅ Multi-language support with high accuracy

If your linter is guessing, you're not measuring debt—you're measuring noise.

---

🎯 Key Features

• 🌳 True AST Analysis
  Deep parsing for Go, Python, JavaScript/TypeScript, Java, and Rust. Not regex. Not heuristics.

• 🔒 Security Built-In
  Detects hardcoded secrets, API keys, and CVEs via integrated Trivy scanning.

• 🏠 Privacy First
  Runs 100% locally. In-memory processing. Zero database. Your source code never leaves your machine.

• ⚙️ CI/CD Ready
  Returns exit code 1 on critical issues. Break builds on high debt. Enforce standards automatically.

• ⚡ Blazing Fast
  Written in Go. Scans large repositories in milliseconds.

---

📦 Installation

via Homebrew (Recommended for macOS & Linux)

brew install endrilickollari/tap/debtdrone

via Shell Script (Linux & macOS)

curl -sL https://raw.githubusercontent.com/endrilickollari/debtdrone-cli/main/installation_scripts/install.sh | bash

via PowerShell (Windows)

iwr -useb https://raw.githubusercontent.com/endrilickollari/debtdrone-cli/main/installation_scripts/install.ps1 | iex

Manual Download

Download pre-compiled binaries from the Releases Page.

---

🛠️ Build from Source

Prerequisites:

• Go 1.22+
• C Compiler (gcc/clang) - Required for Tree-sitter engine

git clone https://github.com/endrilickollari/debtdrone-cli.git
cd debtdrone-cli
go build -o debtdrone ./cmd/debtdrone
./debtdrone -version

---

🚀 Usage

Basic Scan

Run inside your project root:

debtdrone

Or specify a path:

debtdrone ./src/my-project

CI/CD Pipeline

Fail the build if critical issues are found:

debtdrone -path . -fail-on critical

JSON Output

Generate a report for other tools:

debtdrone -output json > report.json

---

🤖 AI-Powered Fixes (Cloud)

DebtDrone CLI finds the issues. DebtDrone Cloud fixes them.

Connect to DebtDrone Cloud (Launching Soon) to auto-fix issues with AI, track historical trends, and manage team access.

---

📄 License

DebtDrone CLI is distributed under the MIT License. Free to use, modify, and distribute.

See LICENSE for full details.

---

🤝 Contributing

This repository serves as the public distribution channel for DebtDrone CLI. The source code is proprietary, but we welcome:

• 🐛 Bug reports
• 💡 Feature requests
• 📖 Documentation improvements

Read our Contributing Guide to get started.

Quick Links

• 📖 Contributing Guidelines - How to contribute
• 🔨 Build Guide - Build system and release process
• 📋 Issues - Report bugs or request features

---

Built with ❤️.

---

☕ Support the Project

If DebtDrone helped you fix a critical issue or saved you time, consider buying me a coffee!