Comprehensive Aider Configuration

This skill provides a complete `.aider.conf.yml` configuration template covering all available Aider settings, including API keys, model selection, git integration, output customization, linting, testing, and advanced options.

What This Configuration Does

Provides a comprehensive reference for configuring Aider AI pair programming tool through `.aider.conf.yml`. Place this file in your home directory or at the root of your git repository to customize Aider's behavior.

Instructions

1. Create Configuration File

Create `.aider.conf.yml` in your home directory or git repository root:

```yaml

API Keys (OpenAI and Anthropic only; other keys go in .env)

#openai-api-key: sk-...

#anthropic-api-key: sk-ant-...

Model Selection

#model: claude-3-5-sonnet-20240620

#opus: false

#sonnet: false

#4o: false

#mini: false

Model Settings

#openai-api-base: https://api.openai.com/v1

#verify-ssl: true

#edit-format: diff

#weak-model: gpt-3.5-turbo

#map-tokens: 1024

#cache-prompts: false

History Files

#input-history-file: .aider.input.history

#chat-history-file: .aider.chat.history.md

#restore-chat-history: false

Output Settings

#dark-mode: true

#pretty: true

#stream: true

#user-input-color: "#00cc00"

#assistant-output-color: "#0088ff"

#code-theme: monokai

#show-diffs: false

Git Settings

#git: true

#gitignore: true

#aiderignore: .aiderignore

#auto-commits: true

#dirty-commits: true

#attribute-author: true

#attribute-committer: true

#commit-prompt: "Custom commit message prompt"

Linting and Testing

#lint: false

#lint-cmd:

- "python: flake8 --select=E,W,F"

- "javascript: eslint"

#auto-lint: true

#test-cmd: pytest

#auto-test: false

Files

#file:

- src/main.py

- src/utils.py

#read:

- docs/reference.md

Other Settings

#vim: false

#voice-language: en

#check-update: true

#suggest-shell-commands: true

```

2. Configure for Your Use Case

**For Python projects with strict linting:**

```yaml

model: claude-3-5-sonnet-20240620

dark-mode: true

auto-commits: true

lint-cmd:

- "python: flake8 --max-line-length=100"

- "python: black --check"

auto-lint: true

test-cmd: pytest

attribute-commit-message-author: true

```

**For JavaScript/TypeScript with testing:**

```yaml

model: gpt-4o

pretty: true

stream: true

lint-cmd:

- "javascript: eslint --fix"

- "typescript: tsc --noEmit"

auto-lint: true

test-cmd: npm test

auto-test: false

show-diffs: true

```

**For multi-language projects:**

```yaml

model: claude-3-5-sonnet-20240620

map-tokens: 2048

lint-cmd:

- "python: ruff check"

- "javascript: eslint"

- "go: golangci-lint run"

auto-lint: true

code-theme: solarized-dark

gitignore: true

```

3. Model Configuration

**Use model metadata file for custom models:**

```yaml

model: custom/my-model

model-settings-file: .aider.model.settings.yml

model-metadata-file: .aider.model.metadata.json

show-model-warnings: false

```

4. Advanced Git Integration

**Customize commit attribution:**

```yaml

auto-commits: true

dirty-commits: true

attribute-author: true

attribute-committer: true

attribute-commit-message-author: true

commit-prompt: |

Write a commit message following conventional commits format.

Include scope and breaking changes if applicable.

```

5. Environment-Specific Configuration

**Development environment:**

```yaml

dark-mode: true

verbose: true

show-diffs: true

auto-test: true

cache-prompts: true

```

**CI/CD environment:**

```yaml

yes: true

auto-commits: false

pretty: false

stream: false

test-cmd: npm run ci-test

```

Key Configuration Sections

API Keys

Model Selection

Output Customization

Git Integration

Linting and Testing

Examples

**Minimal configuration (Python project):**

```yaml

model: claude-3-5-sonnet-20240620

dark-mode: true

lint-cmd: ["python: ruff check --fix"]

auto-lint: true

```

**Full-featured configuration (TypeScript monorepo):**

```yaml

model: gpt-4o

weak-model: gpt-3.5-turbo

dark-mode: true

pretty: true

stream: true

code-theme: monokai

map-tokens: 2048

auto-commits: true

attribute-commit-message-author: true

lint-cmd:

- "typescript: eslint --fix"

- "typescript: prettier --check"

auto-lint: true

test-cmd: npm run test:ci

cache-prompts: true

gitignore: true

```

Important Notes

Constraints