lintro 0.57.1

A unified CLI tool for code formatting, linting, and quality assurance

Lintro

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

🚀 Quick Start

uv pip install lintro              # Install (or: pip install lintro)
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 4-tier config system.

🛠️ Supported Tools

Tool	Language	Auto-fix	Install
Linters
	⚙️ GitHub Actions	-	GitHub Releases
	🦀 Rust	✅	rustup component add clippy
	🐳 Dockerfile	-	GitHub Releases
	📝 Markdown	-	bun add -g markdownlint-cli2 npm install -g markdownlint-cli2
	🟨 JS/TS	✅	bun add -g oxlint npm install -g oxlint
	🐍 Python	-	📦
	🐚 Shell Scripts	-	brew install shellcheck GitHub Releases
	🧾 YAML	-	📦
Formatters
	🐍 Python	✅	📦
	🟨 JS/TS	✅	bun add -g oxfmt npm install -g 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
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
	🔒 Multi-language	-	pipx install semgrep pip install semgrep brew install semgrep

📦 = bundled with lintro — no separate install needed
⚡ Node.js tools support --auto-install to install dependencies automatically

🤖 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.

# PyPI (recommended)
uv pip install lintro        # or: pip install lintro

# Homebrew (macOS binary)
brew tap lgtm-hq/tap && brew install lintro-bin

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

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

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"

# 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)
docker run --rm -v $(pwd):/code ghcr.io/lgtm-hq/py-lintro:base 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
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

• 🐛 Bug Reports
• 💡 Feature Requests
• ❓ Questions
• 📖 Contributing Guide

📄 License

MIT License - see LICENSE for details.