Lintro
<p align="center" <img src="https://raw.githubusercontent.com/lgtm-hq/py-lintro/main/assets/images/lintro.png" alt="Lintro Logo" style="width:100%;max-width:800px;height:auto;" </p
<p align="center" A comprehensive CLI tool that unifies various code formatting, linting, and quality assurance tools under a single command-line interface. </p
<p align="center" <a href="https://lgtm-hq.github.io/py-lintro/"Documentation</a </p
<p align="center" <a href="https://github.com/lgtm-hq/py-lintro/actions/workflows/docker-ci.yml?query=branch%3Amain"<img src="https://img.shields.io/github/actions/workflow/status/lgtm-hq/py-lintro/docker-ci.yml?label=ci&branch=main&logo=githubactions&logoColor=white" alt="CI"</a <a href="https://github.com/lgtm-hq/py-lintro/actions/workflows/docker-build-publish.yml?query=branch%3Amain"<img src="https://img.shields.io/github/actions/workflow/status/lgtm-hq/py-lintro/docker-build-publish.yml?label=docker&logo=docker&branch=main" alt="Docker"</a <a href="https://codecov.io/gh/lgtm-hq/py-lintro"<img src="https://codecov.io/gh/lgtm-hq/py-lintro/branch/main/graph/badge.svg" alt="Coverage"</a </p
<p align="center" <a href="https://github.com/lgtm-hq/py-lintro/releases/latest"<img src="https://img.shields.io/github/v/release/lgtm-hq/py-lintro?label=release" alt="Release"</a <a href="https://pypi.org/project/lintro/"<img src="https://img.shields.io/pypi/v/lintro?label=pypi" alt="PyPI"</a <a href="https://www.python.org/downloads/"<img src="https://img.shields.io/badge/python-3.11+-blue" alt="Python"</a <a href="LICENSE"<img src="https://img.shields.io/badge/license-MIT-green" alt="License"</a </p
<p align="center" <a href="https://github.com/lgtm-hq/py-lintro/actions/workflows/codeql.yml?query=branch%3Amain"<img src="https://github.com/lgtm-hq/py-lintro/actions/workflows/codeql.yml/badge.svg?branch=main" alt="CodeQL"</a <a href="https://scorecard.dev/viewer/?uri=github.com/lgtm-hq/py-lintro"<img src="https://api.securityscorecards.dev/projects/github.com/lgtm-hq/py-lintro/badge" alt="OpenSSF Scorecard"</a <a href="https://www.bestpractices.dev/projects/11142"<img src="https://www.bestpractices.dev/projects/11142/badge" alt="OpenSSF Best Practices"</a <a href="docs/security/assurance.md"<img src="https://img.shields.io/badge/SBOM-CycloneDX-brightgreen" alt="SBOM"</a <a href="https://github.com/lgtm-hq/py-lintro/actions/workflows/sbom-on-main.yml?query=branch%3Amain"<img src="https://img.shields.io/github/actions/workflow/status/lgtm-hq/py-lintro/sbom-on-main.yml?label=sbom&branch=main" alt="SBOM Status"</a </p <!-- markdownlint-enable MD033 MD013 --
🚀 Quick Start
# Install (choose one)
uv pip install lintro # Python / PyPI (or: pip install lintro)
bun add -g @lgtm-hq/lintro # Node / npm — self-contained, no Python
lintro check . # Find issues (alias: chk)
lintro format . # Fix issues (alias: fmt)
lintro badge # shields.io issue-count badge
lintro check --output-format grid # Beautiful output✨ Why Lintro?
- 🎯 Unified Interface - One command for all your linting and formatting tools
- 📊 Consistent Output - Beautiful, standardized output formats across all tools
- 🔧 Auto-fixing - Automatically fix issues where possible
- 🐳 Docker Ready - Run in isolated containers for consistent environments
- 📈 Rich Reporting - Multiple formats: grid, JSON, HTML, CSV, Markdown
- ⚡ Fast - Optimized parallel execution
🔌 Works With Your Existing Configs
Lintro respects your native tool configurations. If you have a .prettierrc, pyproject.toml [tool.ruff], or .yamllint, Lintro uses them automatically - no migration required.
- Native configs are detected - Your existing .prettierrc, .oxlintrc.json, etc.
work as-is
- Enforce settings override consistently - Set linelength: 88 once, applied
everywhere
- Fallback defaults when needed - Tools without native configs use sensible defaults