Aider Configuration Template

A comprehensive configuration template for Aider, the AI pair programming tool that works in your terminal. This template includes every available configuration option organized by category.

What This Skill Provides

This is a complete `.aider.conf.yml` configuration file template that documents all valid configuration entries for Aider. Place this file in your home directory or at the root of your git repository to customize Aider's behavior.

Configuration Categories

Main Model Settings

API Configuration

Repository Map

Git Integration

Output Customization

Linting and Testing

Voice Settings

Advanced Options

Usage Instructions

1. **Create configuration file**: Copy this template to `.aider.conf.yml` in your project root or home directory

2. **Uncomment desired settings**: Remove the `#` prefix from any option you want to configure

3. **Set values**: Replace placeholder values (xxx) with your actual configuration

4. **Multiple values**: For options that accept multiple values, use the list syntax shown in comments

5. **API keys**: Note that only OpenAI and Anthropic keys can be stored in YAML; use `.env` files for other providers

6. **Priority order**: Aider searches for config in: git root → current directory → home directory

Key Configuration Examples

**Basic model setup:**

```yaml

model: claude-3-7-sonnet-20250219

weak-model: claude-3-5-haiku-20241022

```

**Dark mode with custom colors:**

```yaml

dark-mode: true

user-input-color: "#00cc00"

assistant-output-color: "#0088ff"

```

**Auto-testing with linting:**

```yaml

auto-lint: true

auto-test: true

test-cmd: pytest

lint-cmd:

- "python: ruff check --fix"

- "javascript: eslint --fix"

```

**Git attribution:**

```yaml

auto-commits: true

attribute-author: true

attribute-commit-message-author: true

```

Important Notes

Security Considerations

Further Reading