Aider Lint Fixer Documentation¶
Automated lint error detection and fixing powered by aider.chat and AI
Welcome to the comprehensive documentation for Aider Lint Fixer - an intelligent tool that automatically detects lint errors in your codebase and fixes them using AI-powered code generation through aider.chat.
🚀 Quick Start¶
New to Aider Lint Fixer? Start here:
# Install
pip install aider-lint-fixer
# Basic usage
aider-lint-fixer ./src
# With specific linters
aider-lint-fixer --linters flake8,eslint ./src
📚 Learning-Oriented: Tutorials¶
Perfect for beginners - step-by-step guides to get you started:
- Getting Started - Your first lint fixing session
- Getting Started with Containers - Docker and container usage
- Setting Up Your Development Environment - Complete development setup
- Writing and Running Tests - Testing your lint fixes
- Container Deployment - Production deployment guide
🔧 Task-Oriented: How-To Guides¶
Practical solutions for specific tasks:
Configuration & Setup¶
- Configure Linters - Set up and customize linters
- Setup Development Environment - Development environment setup
- Integrate with Aider - Advanced aider.chat integration
Development & Debugging¶
- Add a New Feature - Extend functionality
- Debug Common Issues - Troubleshooting guide
- Run Tests - Testing strategies
Deployment & Operations¶
- Deploy to Production - Production deployment
- Deploy Your Application - Application deployment
- Monitor Performance - Performance monitoring
- Security Best Practices - Security guidelines
📖 Information-Oriented: Reference¶
Detailed technical reference documentation:
API & Configuration¶
- API Documentation - Complete API reference
- API Reference - API usage examples
- Configuration Reference - Comprehensive configuration guide
- Command Line Interface - CLI reference
Linters & Errors¶
- Linter Plugins - Supported linters and plugins
- Error Codes - Error codes and troubleshooting
- FAQ - Frequently asked questions
💡 Understanding-Oriented: Explanation¶
Deep dives into concepts, architecture, and design decisions:
Architecture & Design¶
- Architecture Overview - System architecture
- Container Architecture - Container design
- Design Decisions - Why we made certain choices
- Technology Stack - Technologies used
🏗️ Architecture Decision Records (ADRs)¶
Historical decisions and their rationale:
- Record Architecture Decisions
- AI Integration Architecture
- Modular Plugin System
- Python Ecosystem Focus
- Python Linter Ecosystem
- JavaScript TypeScript Ecosystem
- Infrastructure DevOps Linter Ecosystem
- Deployment Environments
- RHEL Container Build Requirements
🎯 Key Features¶
🧠 AI-Powered Intelligence¶
- Native Lint Detection: Automatically discovers project lint configurations
- Pre-Lint Risk Assessment: Analyzes codebase health before fixing
- Intelligent Force Mode: ML-powered with confidence-based auto-forcing
- Cost Monitoring: Real-time LLM API cost tracking and budget controls
📊 Supported Linters¶
| Language | Linters | Profile Support |
|---|---|---|
| Python | flake8, pylint, black, isort, mypy | ✅ Basic, Default, Strict |
| JavaScript/TypeScript | ESLint, JSHint, Prettier | ✅ Basic, Default, Strict |
| Ansible | ansible-lint | ✅ Basic, Production |
| Go | golint, gofmt, go vet | ✅ Basic, Default, Strict |
| Rust | rustfmt, clippy | ✅ Basic, Default, Strict |
🚀 Enterprise Features¶
- Docker Support: Production-ready containerization
- Multi-Architecture: ARM64 and x86_64 support
- Session Recovery: Resume interrupted operations
- Progress Tracking: Visual progress and metrics
- Community Learning: Improve classifications over time
🆘 Getting Help¶
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Documentation: You're reading it! 📖
🤝 Contributing¶
We welcome contributions! Check out our contributor guides:
- Contributor Version Guide - Version-specific contribution info
- Installation Guide - Development setup
- Linter Testing Guide - Testing linter integrations
- Node.js Linters Guide - JavaScript/TypeScript development
This documentation is organized using the Diataxis framework for maximum clarity and usability.