Aider Configuration

This skill provides a comprehensive Aider configuration optimized for AI-assisted coding with DeepSeek models, intelligent git workflows, and developer-friendly terminal settings.

Features

Instructions

When the user requests an Aider configuration file, create a `.aider.conf.yml` file with the following structure:

1. **Model Configuration**

- Set up model aliases for quick switching between providers

- Configure primary model, weak model (for commits/summaries), and editor model

- Example aliases: `r1:openai/DeepSeek-R1-0528`, `v3:openai/DeepSeek-V3-0324`

2. **API Settings**

- Configure `openai-api-base` if using custom endpoint

- Set up environment variables using `set-env` for API keys

- Reference external model settings and metadata files

3. **Repository Map**

- Set `map-tokens` to control context size (recommended: 2048-8192)

- Configure `map-refresh` strategy (auto/always/files/manual)

4. **Git Workflow**

- Set `auto-commits: false` if user wants manual control

- Configure `dirty-commits` based on workflow preference

- Set `attribute-author: true` to track AI changes

- Consider `attribute-committer: false` for cleaner git history

5. **Terminal Experience**

- Enable `dark-mode: true` for dark terminal backgrounds

- Enable `vim: true` for vim keybindings

- Configure colors for user input, assistant output, tool messages

- Set `fancy-input: true` for history and completion

6. **Read-Only Context**

- Add project-specific files to `read` array (e.g., `.cursorrules`, `README.md`)

- These files provide context without being edited

7. **Lint and Test Integration**

- Configure `lint-cmd` for language-specific linting

- Set `auto-lint` and `auto-test` based on workflow

- Define `test-cmd` for automated testing

8. **Optional Features**

- `notifications`: Enable terminal bell or custom command when responses ready

- `detect-urls`: Auto-detect and offer to add URLs to chat

- `suggest-shell-commands`: Enable shell command suggestions

- `check-update`: Check for Aider updates on launch

Key Configuration Options

```yaml

Model setup

model: r1

weak-model: v3

editor-model: v3

Git behavior

auto-commits: false

dirty-commits: false

attribute-author: true

Terminal

dark-mode: true

vim: true

Context

map-tokens: "8192"

read:

- .cursorrules

```

Usage Example

Create this configuration as `.aider.conf.yml` in the git repository root or user home directory. Aider will automatically detect and load it on startup.

For custom model endpoints, ensure the `openai-api-base` URL is accessible and model names in aliases match the provider's model identifiers.

Notes