TheJoeSchr's Aider Configuration

A production-ready Aider configuration file featuring multi-model setup with Gemini 3 Pro Preview as the primary model, Claude Opus/Sonnet fallbacks, architect mode enabled, automatic linting, file watching, and vim-style editing.

What This Configuration Provides

This `.aider.conf.yml` file configures Aider with:

- Weak model: Claude 3.5 Haiku (for summaries/commits)

- Editor model: Claude 3.7 Sonnet (for precise edits)

Setup Instructions

1. **Copy the configuration file to your desired location**:

```bash

# For project-specific configuration

cp .aider.conf.yml /path/to/your/project/.aider.conf.yml

# For global configuration

cp .aider.conf.yml ~/.aider.conf.yml

```

2. **Set up API keys** (required):

Create a `.env` file in the same directory with your API keys:

```bash

# For Gemini

GEMINI_API_KEY=your_gemini_api_key_here

# For Claude fallback models

ANTHROPIC_API_KEY=your_anthropic_api_key_here

```

3. **Verify the configuration**:

```bash

cd /path/to/your/project

aider --show-prompts # Test that config loads correctly

```

4. **Start using Aider**:

```bash

aider file1.py file2.py # Add files to work with

```

Key Features Explained

Model Strategy

Development Workflow

Git Behavior

UI/UX

Editor Integration

Customization Tips

Switch Primary Model

Uncomment alternative model lines and comment out the current one:

```yaml

Use Claude Opus 4 as primary

model: anthropic/claude-opus-4-20250514

Use Vertex AI Gemini

model: vertex_ai/gemini-2.5-pro-exp-03-25

```

Add Lint Commands

Uncomment and configure language-specific linters:

```yaml

lint-cmd:

- "python: ruff check --fix"

- "javascript: eslint --fix"

- "typescript: eslint --fix"

```

Enable Auto-Testing

Uncomment and set your test command:

```yaml

test-cmd: pytest tests/

auto-test: true

```

Adjust Repo Map Tokens

For larger codebases, increase map tokens:

```yaml

map-tokens: 2048 # Default is 1024

```

Important Notes

Constraints

Troubleshooting

**Model not found**: Verify API keys are set correctly in `.env` file.

**Git attribution issues**: If you want attribution, set the relevant flags to `true`:

```yaml

attribute-author: true

attribute-committer: true

```

**Linting errors**: Ensure linters are installed in your environment before enabling `auto-lint`.

**Vim mode issues**: Set `vim: false` if experiencing terminal input problems.