Aider Configuration Template

This skill provides a comprehensive configuration template for Aider, an AI-powered coding assistant. The template covers all available settings including model selection, API configuration, git integration, output formatting, and workflow automation.

What This Does

Provides a complete `.aider.conf.yml` configuration file template that can be placed in your home directory or at the root of your git repository. The template includes all valid configuration entries with explanations for each setting.

Configuration Categories

The template covers these major areas:

1. **Model Selection** - Choose and configure AI models (Claude, GPT-4, DeepSeek, etc.)

2. **API Settings** - Configure API keys and endpoints for various AI providers

3. **Git Integration** - Control commit behavior, attribution, and git workflows

4. **Output & UI** - Customize colors, themes, and display options

5. **Repo Mapping** - Configure code context and token limits

6. **Testing & Linting** - Automate code quality checks

7. **Voice Settings** - Configure voice input options

8. **Workflow Automation** - Set up auto-commits, auto-lint, auto-test

Instructions

1. **Choose Your Location**

- Place in home directory (`~/.aider.conf.yml`) for global settings

- Or place at git repo root (`.aider.conf.yml`) for project-specific settings

2. **Configure API Keys**

- Uncomment and set `openai-api-key` or `anthropic-api-key`

- Or store keys in a `.env` file (recommended for security)

3. **Select Your Model**

- Uncomment and set `model` to your preferred AI model

- Examples: `claude-3-opus-20240229`, `gpt-4o`, `deepseek/deepseek-chat`

4. **Customize Git Behavior**

- Enable/disable `auto-commits` for automatic committing of changes

- Configure attribution with `attribute-author`, `attribute-committer`, or `attribute-co-authored-by`

- Set `auto-lint` and `auto-test` for automated quality checks

5. **Set Output Preferences**

- Choose `dark-mode` or `light-mode` for terminal colors

- Customize color scheme with `*-color` settings

- Select `code-theme` for syntax highlighting

6. **Configure Repo Map**

- Adjust `map-tokens` to control context size

- Set `map-refresh` strategy (auto, always, files, manual)

7. **Add Custom Commands**

- Set `lint-cmd` for language-specific linters

- Set `test-cmd` for your test runner

8. **Optional Advanced Settings**

- Configure caching with `cache-prompts` and `cache-keepalive-pings`

- Set token limits with `max-chat-history-tokens`

- Enable voice input with `voice-format` and `voice-language`

Key Settings Explained

Essential Settings

Attribution Options

Performance Settings

Example Configurations

Minimal Setup

```yaml

model: claude-3-opus-20240229

anthropic-api-key: sk-ant-xxx

auto-commits: true

dark-mode: true

```

Power User Setup

```yaml

model: claude-3-opus-20240229

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

auto-commits: true

auto-lint: true

lint-cmd:

- "python: ruff check --fix"

- "javascript: eslint --fix"

test-cmd: pytest

cache-prompts: true

map-tokens: 2048

attribute-co-authored-by: true

dark-mode: true

```

Notes