Aider Configuration

Production-ready Aider configuration optimized for AI-assisted coding with Gemini 3 Pro Preview as the primary model and Claude 3.7 Haiku as the weak model (via OpenRouter).

What This Does

Provides a comprehensive `.aider.conf.yml` configuration that:

Instructions

When the user asks you to create or configure Aider settings:

1. **Create the configuration file** at `.aider.conf.yml` in the project root (or user's home directory if they want it global):

```yaml

Main model

model: gemini/gemini-3-pro-preview

Alternative: model: openrouter/anthropic/claude-3.7-sonnet

Weak model for commit messages and summaries

weak-model: openrouter/anthropic/claude-3-haiku

Output settings

dark-mode: true

code-theme: one-dark

Git settings

auto-commits: false

Updates

check-update: true

```

2. **Explain key settings**:

- `model`: Primary model for code generation and editing

- `weak-model`: Faster/cheaper model for auxiliary tasks (commit messages, chat history summarization)

- `auto-commits: false`: Prevents automatic git commits; gives user control over when to commit

- `dark-mode: true` and `code-theme: one-dark`: Optimized for dark terminal backgrounds

3. **Optional customizations** the user might want:

- **Enable auto-commits**: Change `auto-commits: false` to `auto-commits: true`

- **Switch to Claude**: Uncomment the OpenRouter Claude line and comment out Gemini

- **Add linting**: Uncomment `auto-lint: true` and configure `lint-cmd` for their language

- **Add testing**: Set `auto-test: true` and configure `test-cmd`

- **Enable notifications**: Set `notifications: true` for bell notifications when responses are ready

4. **API keys required**:

- Gemini: Set `GEMINI_API_KEY` environment variable

- OpenRouter (for weak model): Set `OPENROUTER_API_KEY` environment variable

5. **Verify configuration**:

```bash

aider --show-prompts

```

This will load the config and show the configured models without starting a chat.

Examples

**Basic usage with this config:**

```bash

cd /path/to/project

aider

```

**Override model for a single session:**

```bash

aider --model openrouter/anthropic/claude-3.7-sonnet

```

**Enable auto-commits for a single session:**

```bash

aider --auto-commits

```

**Run with specific files:**

```bash

aider src/main.py tests/test_main.py

```

Important Notes