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

lintro check .                     # Find issues (alias: chk)
lintro format .                    # Fix issues (alias: fmt)
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 -g @commitlint/cli @commitlint/config-conventional` `brew install commitlint`
	🐹 Go	✅	`brew install golangci-lint` Install docs
	🐳 Dockerfile	-	GitHub Releases
	🌐 HTML	-	`bun add -D html-validate` `npm install -D html-validate`
	📝 Markdown	-	`bun add -g markdownlint-cli2` `npm install -g markdownlint-cli2`
	📝 Prose / Docs	-	`brew install vale` GitHub Releases
	🟨 JS/TS	✅	`bun add -D oxlint` `npm install -D oxlint`
	🐍 Python	-	📦
	🐚 Shell Scripts	-	`brew install shellcheck` GitHub Releases
	🧾 YAML	-	📦
Formatters
	🐍 Python	✅	📦
	🟨 JS/TS	✅	`bun add -D oxfmt` `npm install -D oxfmt`
	🟨 JS/TS · 🧾 JSON	✅	`bun add -g prettier` `npm install -g prettier`
	🐚 Shell Scripts	✅	`brew install shfmt` GitHub Releases
	🦀 Rust	✅	`rustup component add rustfmt`
Lint + Format
	🐍 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`
Type Checkers
	🚀 Astro	-	`bun add astro` `npm install astro`
	🐍 Python	-	📦
	🔥 Svelte	-	`bun add -D svelte-check` `npm install -D svelte-check`
	🟨 JS/TS	-	`bun add -g typescript` `npm install -g typescript` `brew install typescript`
	💚 Vue	-	`bun add -D vue-tsc` `npm install -D vue-tsc`
Security
	🐍 Python	-	📦
	🔐 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	-	`pipx install semgrep` `pip 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
🟨 Node.js tools do not all resolve the same way — the command above is the one that works for that tool. Tools shown with -D (oxlint, oxfmt, stylelint, html-validate) are run through bunx/npx, which look in the checked project's node_modules and never at PATH, so a global or Homebrew install is not what Lintro picks up. The rest prefer a binary on PATH, which is what -g and brew install provide. 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

# Full (bundled Python tools: ruff, black, mypy, bandit, pydoclint, 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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lintro-0.111.0.tar.gz (3.3 MB view details)

Uploaded Aug 5, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

lintro-0.111.0-py3-none-any.whl (1.3 MB view details)

Uploaded Aug 5, 2026 Python 3

File details

Details for the file lintro-0.111.0.tar.gz.

File metadata

Download URL: lintro-0.111.0.tar.gz
Upload date: Aug 5, 2026
Size: 3.3 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for lintro-0.111.0.tar.gz
Algorithm	Hash digest
SHA256	`0917191e3d4752c71dc3143a97786daa71ee19ff8f41276f191cfa1ff4491fc5`
MD5	`95fea9466f5300218f5524d3993f10da`
BLAKE2b-256	`1e9ca93e0b75a27f2d180e2848692cb5a1ebfd7a381c2322c3ee2527ecc454cd`

See more details on using hashes here.

Provenance

The following attestation bundles were made for lintro-0.111.0.tar.gz:

Publisher: publish-pypi-on-tag.yml on lgtm-hq/py-lintro

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: lintro-0.111.0.tar.gz
- Subject digest: 0917191e3d4752c71dc3143a97786daa71ee19ff8f41276f191cfa1ff4491fc5
- Sigstore transparency entry: 2343931262
- Sigstore integration time: Aug 5, 2026
Source repository:
- Permalink: lgtm-hq/py-lintro@006c3675c12b6d87748414d5e470c97f84895996
- Branch / Tag: refs/tags/v0.111.0
- Owner: https://github.com/lgtm-hq
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-pypi-on-tag.yml@006c3675c12b6d87748414d5e470c97f84895996
- Trigger Event: push