thai-lint
The AI Linter - Catch the mistakes AI coding assistants keep making.
thailint detects anti-patterns that AI tools frequently introduce: duplicate code, excessive nesting, magic numbers, SRP violations, and more. It works across Python, TypeScript, JavaScript, and Rust with unified rules - filling gaps that existing linters miss.
Installation
pip install thailint
Or run instantly with uvx (no install required):
uvx thailint dry src/
Or with Docker:
docker run --rm -v $(pwd):/data washad/thailint:latest --help
Quick Start
# Generate a config file (optional)
thailint init-config
# Run any linter
thailint dry src/
That's it. See violations, fix them, ship better code.
Available Linters
| Linter | What It Catches | Command | Docs |
|---|---|---|---|
| DRY | Duplicate code across files | thailint dry src/ |
Guide |
| Nesting | Deeply nested if/for/while blocks | thailint nesting src/ |
Guide |
| Magic Numbers | Unnamed numeric literals | thailint magic-numbers src/ |
Guide |
| Performance | O(n²) patterns: string += in loops, regex in loops | thailint perf src/ |
Guide |
| SRP | Classes doing too much | thailint srp src/ |
Guide |
| File Header | Missing documentation headers | thailint file-header src/ |
Guide |
| Stateless Class | Classes that should be functions | thailint stateless-class src/ |
Guide |
| Collection Pipeline | Loops with embedded filtering | thailint pipeline src/ |
Guide |
| Method Property | Methods that should be @property | thailint method-property src/ |
Guide |
| File Placement | Files in wrong directories | thailint file-placement src/ |
Guide |
| Lazy Ignores | Unjustified linting suppressions | thailint lazy-ignores src/ |
Guide |
| Improper Logging | Print statements and conditional verbose patterns | thailint improper-logging src/ |
Guide |
| Stringly Typed | Strings that should be enums | thailint stringly-typed src/ |
Guide |
| LBYL | Look Before You Leap anti-patterns | thailint lbyl src/ |
Guide |
| Law of Demeter | Deep object chain access (reaching through objects) | thailint law-of-demeter src/ |
Guide |
| Version Freshness | EOL/outdated runtime versions in infra files | thailint version-freshness . |
Guide |
| Unwrap Abuse | .unwrap()/.expect() that panic at runtime (Rust) |
thailint unwrap-abuse src/ |
Guide |
| Clone Abuse | .clone() abuse: loops, chains, unnecessary (Rust) |
thailint clone-abuse src/ |
Guide |
| Blocking Async | Blocking std:: calls in async functions (Rust) | thailint blocking-async src/ |
Guide |
Configuration
Create .thailint.yaml in your project root:
dry:
enabled: true
min_duplicate_lines: 4
nesting:
enabled: true
max_nesting_depth: 3
magic-numbers:
enabled: true
allowed_numbers: [-1, 0, 1, 2, 10, 100]
Or add a [tool.thailint] section to your pyproject.toml:
[tool.thailint]
dry = {enabled = true, min_duplicate_lines = 4}
nesting = {enabled = true, max_nesting_depth = 3}
magic-numbers = {enabled = true, allowed_numbers = [-1, 0, 1, 2, 10, 100]}
Config precedence: .thailint.yaml > .thailint.json > pyproject.toml.
Or generate one automatically:
thailint init-config --preset lenient # or: strict, standard
See Configuration Reference for all options.
Output Formats
# Human-readable (default)
thailint dry src/
# JSON for CI/CD
thailint dry --format json src/
# SARIF for GitHub Code Scanning
thailint dry --format sarif src/ > results.sarif
Ignoring Violations
# Line-level
timeout = 3600 # thailint: ignore[magic-numbers]
# File-level
# thailint: ignore-file[dry]
Or in config:
dry:
ignore:
- "tests/"
- "**/generated/**"
See How to Ignore Violations for all 5 ignore levels.
CI/CD Integration
# GitHub Actions
- name: Run thailint
run: |
pip install thailint
thailint --parallel dry src/
thailint --parallel nesting src/
Use --parallel for faster linting on large codebases (2-4x speedup on multi-core systems).
Exit codes: 0 = success, 1 = violations found, 2 = error.
Documentation
- Quick Start Guide - Get running in 5 minutes
- Configuration Reference - All config options
- Troubleshooting - Common issues
- Full Documentation - Everything else
Contributing
Contributions welcome! See CONTRIBUTING.md for guidelines.
git clone https://github.com/be-wise-be-kind/thai-lint.git
cd thai-lint
poetry install
just test
License
MIT License - see LICENSE for details.
Support
2 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file thailint-0.23.0.tar.gz.
File metadata
- Download URL: thailint-0.23.0.tar.gz
- Upload date:
- Size: 341.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
poetry/2.4.1 CPython/3.12.3 Linux/6.18.7-76061807-generic
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
626d5f1de58478404aa5841e80150a0956d3dcd7d091fa4ed9c2d924a9819874
|
|
| MD5 |
2ddb48bbf6f8648912c5bafd51bfcb9c
|
|
| BLAKE2b-256 |
fa68b692fe0287db1a6ddc9238a3c970371395de558fb20f243cc02bfc39a893
|
File details
Details for the file thailint-0.23.0-py3-none-any.whl.
File metadata
- Download URL: thailint-0.23.0-py3-none-any.whl
- Upload date:
- Size: 489.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
poetry/2.4.1 CPython/3.12.3 Linux/6.18.7-76061807-generic
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8a5133290584c3f774a4a9f17c1bf4325c8b05da0d028a0ac7056e53e3e789bf
|
|
| MD5 |
c01bd3bb9add68ca52d311c2ec5bf90e
|
|
| BLAKE2b-256 |
361d21abd4e167d6a678cebede69371079666d9980525a73d65204d30fd6b4e3
|
