Lintro

Lintro Logo

A comprehensive CLI tool that unifies various code formatting, linting, and quality assurance tools under a single command-line interface.

Documentation

🚀 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
# npm ships no Intel Mac binary; Intel Macs install via Homebrew or PyPI

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 line_length: 88 once, applied everywhere
Fallback defaults when needed - Tools without native configs use sensible defaults

See the Configuration Guide for details on the 5-tier config system.

🛠️ Supported Tools

Tool	Language	Auto-fix	Install
Linters
	⚙️ GitHub Actions	-	GitHub Releases
	🦀 Rust	✅	`rustup component add clippy`
	🔀 Git commits	-	`bun add -D @commitlint/cli @commitlint/config-conventional` `npm install -D @commitlint/cli @commitlint/config-conventional`
	🔧 C/C++	-	`brew install cppcheck` `apt-get install cppcheck`
	🐹 Go	✅	`brew install golangci-lint` Install docs
	🐳 Dockerfile	-	GitHub Releases
	🌐 HTML	-	`bun add -D html-validate` `npm install -D html-validate`
	🐍 Python	-	📦
	📝 Markdown	-	`bun add -D markdownlint-cli2` `npm install -D markdownlint-cli2`
	📝 Prose / Docs	-	`brew install vale` GitHub Releases
	🟨 JS/TS	✅	`bun add -D oxlint` `npm install -D oxlint`
	🐍 Python	-	📦
	🐍 Python	-	📦
	🐚 Shell Scripts	-	`brew install shellcheck` GitHub Releases
	📘 OpenAPI/AsyncAPI/JSON Schema	-	`bun add -D @stoplight/spectral-cli` `npm install -D @stoplight/spectral-cli`
	🧾 YAML	-	📦
Formatters
	🐍 Python	✅	📦
	🟨 JS/TS	✅	`bun add -D oxfmt` `npm install -D oxfmt`
	🟨 JS/TS · 🧾 JSON	✅	`bun add -D prettier` `npm install -D prettier`
	🐚 Shell Scripts	✅	`brew install shfmt` GitHub Releases
	🦀 Rust	✅	`rustup component add rustfmt`
Lint + Format
	🧩 Protobuf	✅	`brew install bufbuild/buf/buf` GitHub Releases
	🐍 Python	✅	📦
	🗃️ SQL	✅	`pipx install sqlfluff`
	🧾 TOML	✅	`brew install taplo` GitHub Releases
	🔑 .env Files	✅	`brew install dotenv-linter` GitHub Releases
	🎨 CSS/SCSS/Sass/Less	✅	`bun add -D stylelint` `npm install -D stylelint`
	🔤 Spelling	✅	`brew install typos-cli` `cargo install typos-cli`
Type Checkers
	🚀 Astro	-	`bun add astro` + `bun add -D @astrojs/check` `npm install astro` + `npm install -D @astrojs/check`
	🐍 Python	-	📦
	🔥 Svelte	-	`bun add -D svelte-check` `npm install -D svelte-check`
	🟨 JS/TS	-	`bun add -D typescript` `npm install -D typescript`
	💚 Vue	-	`bun add -D vue-tsc` `npm install -D vue-tsc`
Security
	🐍 Python	-	📦
	🏗️ Terraform (IaC)	-	`uv tool install checkov`
	🔐 Secret Detection	-	`brew install gitleaks` GitHub Releases
	🦀 Rust	-	`cargo install cargo-audit`
	🦀 Rust	-	`cargo install cargo-deny`
	🔒 Multi-ecosystem	-	GitHub Releases
	🐍 Python	-	`pip install pip-audit` `uv add pip-audit` `brew install pip-audit`
	🔒 Multi-language	-	`./scripts/utils/install-semgrep.sh` `uv tool install semgrep` `brew install semgrep`
	🔐 Secret Detection	-	`brew install trufflehog` GitHub Releases
AI Tools
	🤖 AI · Multi-language	-	`uv pip install 'lintro[ai]'` + API key

📦 = bundled with lintro — no separate install needed
⚡ Node.js tools support --auto-install to install dependencies automatically
🟨 Every Node.js tool resolves the same way: the checked project's node_modules/.bin first, then a binary on PATH, then a version-pinned bunx/npx fetch. A project devDependency (-D, shown above) is therefore always the best answer — it is lockfile-pinned and needs no network. A global (-g) or Homebrew install still works and is used when no local install exists. See Node.js tool resolution.

🤖 AI-Powered Features (Optional)

Lintro includes optional AI-powered features that provide actionable summaries and interactive fix suggestions. AI features are BYO (Bring Your Own) API key — not enabled by default.

Providers: Anthropic Claude, OpenAI GPT
AI Summary — high-level assessment with pattern analysis (1 API call per run)
Interactive Fix Suggestions — AI-generated code diffs with risk classification
Post-fix Summary — contextualizes what was fixed and what remains

# Install with AI support
uv pip install 'lintro[ai]'
export ANTHROPIC_API_KEY=sk-ant-...   # or OPENAI_API_KEY

# Enable in config
# .lintro-config.yaml
# ai:
#   enabled: true
#   provider: anthropic

See the AI Features Guide for full documentation.

📦 Installation

Python 3.11+ is required. Check tool versions with lintro list-tools.

# Lightweight (CLI only — detects tools on PATH)
uv pip install lintro
brew tap lgtm-hq/tap && brew install lintro
# Homebrew ships a prebuilt binary on Apple silicon; Intel Macs install from PyPI

# Full (bundled Python tools: ruff, black, mypy, bandit, import-linter,
# pydoclint, pylint, yamllint)
uv pip install 'lintro[full]'
brew tap lgtm-hq/tap && brew install lintro-full

# Docker (all tools)
docker run --rm -v $(pwd):/code ghcr.io/lgtm-hq/py-lintro:latest check

# Docker (CLI only)
docker run --rm -v $(pwd):/code ghcr.io/lgtm-hq/py-lintro-base:latest check

# First run after lightweight install
lintro init
lintro doctor
lintro install --profile recommended

See Getting Started for detailed installation options.

💻 Usage

# Check all files (alias: chk)
lintro check .

# Auto-fix issues (alias: fmt)
lintro format .

# Grid output with grouping
lintro check --output-format grid --group-by file

# Run specific tools
lintro check --tools ruff,prettier,mypy

# Auto-install Node.js dependencies
lintro check --tools tsc --auto-install

# Exclude directories
lintro check --exclude "node_modules,dist,venv"

# Only scan files changed vs a git base ref (fast PR-scoped checks)
lintro check --diff              # vs the repo default branch (origin/HEAD)
lintro check --diff main         # vs an explicit ref
lintro format --diff             # format only changed files

# List available tools
lintro list-tools

🐳 Docker

# Run from GHCR (tools image - recommended)
docker run --rm -v $(pwd):/code ghcr.io/lgtm-hq/py-lintro:latest check

# With formatting
docker run --rm -v $(pwd):/code ghcr.io/lgtm-hq/py-lintro:latest check --output-format grid

# Base image (minimal, no external tools; separate GHCR package)
docker run --rm -v $(pwd):/code ghcr.io/lgtm-hq/py-lintro-base:latest check

📚 Documentation

Guide	Description
Getting Started	Installation, first steps, requirements
Configuration	Tool configuration, options, presets
AI Features	AI summaries, fix suggestions, config
Docker Usage	Containerized development
GitHub Integration	CI/CD setup, workflows
Pre-commit Integration	Run lintro as a pre-commit hook
Contributing	Development guide, adding tools
Troubleshooting	Common issues and solutions

Advanced: Tool Analysis · Architecture · Security

🔨 Development

# Clone and install
git clone https://github.com/lgtm-hq/py-lintro.git
cd py-lintro
uv sync --dev

# Run tests
./scripts/local/run-tests.sh

# Run lintro on itself
./scripts/local/local-lintro.sh check --output-format grid

🤝 Community

📄 License

MIT License - see LICENSE for details.

Release files for lintro 0.156.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for lintro 0.156.2
File	Size	Uploaded
lintro-0.156.2.tar.gz	2.8 MB	Sep 12, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for lintro 0.156.2
File	Interpreter	ABI	Platform	Reset
lintro-0.156.2-py3-none-any.whl 1.8 MB Sep 12, 2026	Python 3	none	any	Details

Total release size: 4.6 MB

Release files / lintro-0.156.2.tar.gz

Download URL	lintro-0.156.2.tar.gz
Size	2.8 MB
Tags	Source
SHA-256 checksum How to use checksums	`effd5decb14aaca3bff3856ac86ef4c5c13891a718a1c2600f0b7c59872603b5`
BLAKE2b-256 checksum How to use checksums	`fb7674cfe8a2ae53bfeff511ed9eda882c24ed5d34ab13634a5935f3a84af638`
Upload date	Sep 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/lgtm-hq/py-lintro
Publishing commit: github.com/lgtm-hq/py-lintro/tree/fa594e295460038602f930a187a56ba49d6ebbcf

Workflow

Publishing configuration: github.com/lgtm-hq/py-lintro/blob/fa594e295460038602f930a187a56ba49d6ebbcf/.github/workflows/publish-pypi-on-tag.yml
Publishing logs: github.com/lgtm-hq/py-lintro/actions/runs/34670217755/attempts/1

Artifact

Subject: lintro-0.156.2.tar.gz
SHA-256 checksum: effd5decb14aaca3bff3856ac86ef4c5c13891a718a1c2600f0b7c59872603b5 Verifying attestations

Release files / lintro-0.156.2-py3-none-any.whl

Download URL	lintro-0.156.2-py3-none-any.whl
Size	1.8 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`a51aafb816eb171b5a416840c4d350d2317b94c313d44f4d4d2737345cc20c36`
BLAKE2b-256 checksum How to use checksums	`1e03bcabd0ed83909dabfefcc8886a441377418f5ab6832ce0b602aac7c0ce6b`
Upload date	Sep 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/lgtm-hq/py-lintro
Publishing commit: github.com/lgtm-hq/py-lintro/tree/fa594e295460038602f930a187a56ba49d6ebbcf

Workflow

Publishing configuration: github.com/lgtm-hq/py-lintro/blob/fa594e295460038602f930a187a56ba49d6ebbcf/.github/workflows/publish-pypi-on-tag.yml
Publishing logs: github.com/lgtm-hq/py-lintro/actions/runs/34670217755/attempts/1

Artifact

Subject: lintro-0.156.2-py3-none-any.whl
SHA-256 checksum: a51aafb816eb171b5a416840c4d350d2317b94c313d44f4d4d2737345cc20c36 Verifying attestations