Aider Configuration

Configure Aider, the AI pair programming tool, with custom settings for models, git integration, output formatting, and development workflow automation.

What This Skill Does

This skill generates a comprehensive `.aider.conf.yml` configuration file based on the reference configuration from jrodal98/dotfiles. It configures Aider with sensible defaults and extensive customization options including:

Instructions

When a user requests Aider configuration, follow these steps:

1. **Assess Requirements**: Ask the user about their preferences:

- Which AI model they want to use (or keep default)

- Whether they want auto-commits enabled (default: disabled in this config)

- Git attribution preferences (author, committer, co-authored-by)

- Color scheme (dark mode, light mode, or custom colors)

- Linting and testing automation preferences

- Any API keys they need to configure

2. **Generate Configuration**: Create a `.aider.conf.yml` file with appropriate settings:

- Start with the model selection (default: meta_llama/Llama-4-Maverick-17B-128E-Instruct-FP8 from reference)

- Configure git settings (gitignore: true, auto-commits: false as baseline)

- Set up output preferences (colors, streaming, pretty output)

- Add lint/test commands if specified

- Include any API keys or environment variables (with security warnings)

3. **Explain Key Settings**: Provide a brief explanation of important configuration choices:

- Model selection and why it matters

- Git workflow implications (auto-commits, attribution)

- How to add files for editing vs read-only

- Linting and testing automation behavior

4. **Security Considerations**:

- Warn users NOT to commit API keys in the YAML file

- Recommend using `.env` file for sensitive credentials

- Suggest using `--set-env` or `.env` for provider API keys

5. **Additional Recommendations**:

- Create `.aiderignore` for files to exclude

- Set up lint commands for their specific languages

- Configure test commands if they have automated tests

- Consider enabling `--watch-files` for AI coding comments

Example Usage

**User Request**: "Set up Aider configuration for my Python project with auto-linting"

**AI Response**:

1. Create `.aider.conf.yml` with:

- Model: User's choice or sensible default

- Git: `gitignore: true`, `auto-commits: false` (user can enable)

- Linting: `auto-lint: true`, `lint-cmd: "python: ruff check --fix"`

- Colors: Dark mode by default

2. Create `.aiderignore` excluding `__pycache__`, `.venv`, etc.

3. Explain how to run Aider with this config

Configuration Categories

Essential Settings

Development Workflow

Output Customization

Git Attribution

Advanced Features

Important Notes

Security Warning

Never commit API keys directly in `.aider.conf.yml`. Use environment variables or a `.env` file:

```yaml

.aider.conf.yml - GOOD (no secrets)

model: claude-3-5-sonnet-20241022

.env - Store secrets here (add to .gitignore)

ANTHROPIC_API_KEY=your_key_here

```