debtx
AI-generated code debt scanner. Grade your codebase A-F.
Install
pip install debtx
Usage
debtx scan .
debtx scan ./src --format md
debtx scan . --strict
debtx badge
What it detects
12 categories of "vibe code" anti-patterns that AI coding agents commonly produce:
| Detector | What it catches |
|---|---|
| Giant Functions | Functions over 100 lines |
| Empty Catches | Silent error swallowing |
| Hardcoded Values | URLs, IPs, secrets, magic numbers |
| Duplicated Blocks | Copy-paste code patterns |
| Missing Error Handling | IO ops without try/except |
| Orphaned Imports | Unused imports |
| No Test Coverage | Source files with no tests |
| Massive Files | Files over 500 lines |
| TODO/FIXME Comments | Unresolved markers |
| Inconsistent Naming | Mixed camelCase/snake_case |
| Deep Nesting | 4+ levels of indentation |
| Dead Code | Unreachable code after return/break |
Grading Scale
| Grade | Score | Meaning |
|---|---|---|
| A | 90-100 | Clean codebase |
| B | 75-89 | Minor issues |
| C | 55-74 | Needs attention |
| D | 35-54 | Significant debt |
| F | 0-34 | Critical debt |
License
MIT
1 maintainer
Release files for debtx 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| debtx-0.1.0.tar.gz | 18.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| debtx-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 46.8 kB
Release files / debtx-0.1.0.tar.gz
| Download URL | debtx-0.1.0.tar.gz |
|---|---|
| Size | 18.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e026e057834dedb688b0ad8f3753385c659dbaf07e17ab8a64ceaf6c2badd961
|
|
BLAKE2b-256 checksum How to use checksums |
7fc156066add6d65da94f22b24114001a5a6744b693a1b241668aefad14c976f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.10
|
Release files / debtx-0.1.0-py3-none-any.whl
| Download URL | debtx-0.1.0-py3-none-any.whl |
|---|---|
| Size | 28.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d434561cf018a91845eb86ff81a18af3c79f1267d7bd26b47d5c8e679ac920e7
|
|
BLAKE2b-256 checksum How to use checksums |
d1d34ff1c833bd93ea763e562dd1292fd0fcfd459cca335c771e96d1ee176300
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.10
|
