Aider Configuration

This skill provides comprehensive configuration for Aider, an AI pair programming tool that assists with code editing, git operations, and automated testing.

What This Skill Does

Configures Aider with settings for:

Configuration Instructions

1. Model Selection

Choose your primary AI model:

**Example:**

```yaml

model: anthropic/claude-3-7-sonnet-20250219

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

architect: true

```

2. API Configuration

Set API keys and environment variables:

**Example:**

```yaml

api-key:

- anthropic=sk-ant-xxx

set-env:

- ANTHROPIC_API_KEY=sk-ant-xxx

```

3. Git Integration

Configure git behavior:

**Example:**

```yaml

auto-commits: true

dirty-commits: true

attribute-co-authored-by: true

commit-prompt: "Custom commit message template"

```

4. Repository Mapping

Control context awareness:

**Example:**

```yaml

map-tokens: 2048

map-refresh: auto

```

5. Output Customization

Configure terminal appearance:

**Example:**

```yaml

dark-mode: true

code-theme: monokai

user-input-color: "#00cc00"

assistant-output-color: "#0088ff"

```

6. Automated Testing & Linting

Set up quality checks:

**Example:**

```yaml

auto-lint: true

lint-cmd:

- "python: ruff check --fix"

- "javascript: eslint --fix"

auto-test: true

test-cmd: "pytest tests/"

```

7. File Management

Specify files to work with:

**Example:**

```yaml

file:

- src/main.py

- src/utils.py

read:

- docs/API.md

- README.md

```

8. Advanced Features

Enable special modes:

**Example:**

```yaml

watch-files: true

cache-prompts: true

notifications: true

load: ./AGENT.md

```

Usage Examples

Basic Development Setup

```yaml

model: anthropic/claude-3-7-sonnet-20250219

dark-mode: true

auto-commits: true

auto-lint: true

map-tokens: 2048

```

Production Code Review

```yaml

model: gpt-4o

dry-run: true

show-diffs: true

auto-commits: false

lint-cmd:

- "python: ruff check"

test-cmd: "pytest --cov"

```

Multi-File Refactoring

```yaml

model: anthropic/claude-3-7-sonnet-20250219

architect: true

file:

- src/models/*.py

- src/controllers/*.py

map-tokens: 4096

map-refresh: always

```

Important Constraints

1. **API Keys**: Only OpenAI and Anthropic keys can be stored in YAML config. Other providers require `.env` file.

2. **Config File Locations**: Aider searches for `.aider.conf.yml` in:

- Git repository root

- Current working directory

- Home directory

3. **Model Warnings**: Set `show-model-warnings: false` to disable warnings for models without metadata.

4. **Playwright**: Web scraping features require Playwright unless disabled with `--disable-playwright`.

5. **Analytics**: Analytics are randomized by default. Use `--analytics-disable` to permanently opt out.

Configuration File Location

Place `.aider.conf.yml` in:

Override with `--config /path/to/config.yml`