Aider Configuration

AI-powered development assistant that streamlines coding workflows through intelligent file management, automated code generation, and seamless Git integration. Built on Aider with support for multiple LLM providers (OpenAI, Anthropic, DeepSeek).

What This Skill Does

This skill provides a comprehensive Aider configuration template that enables:

Instructions

1. Create Configuration File

Create `.aider.conf.yml` in your project root or home directory with your desired settings. The configuration supports all Aider features including:

**Model Selection:**

**API Configuration:**

**Repository Mapping:**

**Git Integration:**

**Development Workflow:**

**History & Caching:**

2. Basic Configuration Example

```yaml

Essential settings for getting started

Model selection

model: claude-3-5-sonnet-20241022

API keys

anthropic-api-key: your-key-here

openai-api-key: your-key-here

Repository mapping

map-tokens: 1024

map-refresh: auto

Git settings

auto-commits: true

attribute-author: true

gitignore: true

Output preferences

dark-mode: true

stream: true

pretty: true

Auto-linting

auto-lint: true

lint-cmd:

- "python: ruff check --fix"

- "javascript: eslint --fix"

```

3. Advanced Configuration Example

```yaml

Advanced settings for teams and complex projects

Main and fallback models

model: gpt-4o

weak-model: gpt-4o-mini

editor-model: claude-3-5-sonnet-20241022

Prompt caching for performance

cache-prompts: true

cache-keepalive-pings: 3

Expanded repo mapping

map-tokens: 2048

map-multiplier-no-files: 3

Custom history files

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

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

llm-history-file: .aider.llm.history

Comprehensive linting

auto-lint: true

lint-cmd:

- "python: ruff check --fix"

- "python: mypy --strict"

- "javascript: eslint --fix"

- "typescript: tsc --noEmit"

Automated testing

auto-test: true

test-cmd: pytest tests/

Git attribution

attribute-author: true

attribute-committer: true

attribute-commit-message-author: true

Color scheme (dark mode)

dark-mode: true

code-theme: monokai

user-input-color: "#00cc00"

assistant-output-color: "#0088ff"

```

4. Run Aider

```bash

Start aider with config file

aider

Or specify config explicitly

aider --config .aider.conf.yml

Edit specific files

aider file1.py file2.py

Add read-only context files

aider --read README.md --file main.py

One-shot message mode

aider --message "Add error handling to the login function"

```

5. Common Use Cases

**Code Generation:**

```bash

aider --message "Create a REST API endpoint for user authentication"

```

**Automated Fixes:**

```bash

aider --lint # Fix linting issues in dirty files

aider --test # Run tests and fix failures

```

**Git Workflow:**

```bash

aider --commit # Commit all changes with AI-generated message

aider --show-diffs # Review changes before committing

```

**Voice Input:**

```bash

aider --voice-format wav --voice-language en

```

Configuration Options

Model Aliases

Create shortcuts for frequently used models:

```yaml

alias:

- "fast: gpt-4o-mini"

- "smart: claude-3-5-sonnet-20241022"

- "cheap: gpt-3.5-turbo"

```

Language-Specific Linting

```yaml

lint-cmd:

- "python: ruff check --fix && black ."

- "javascript: eslint --fix && prettier --write"

- "go: gofmt -w . && golint ./..."

- "rust: cargo fmt && cargo clippy --fix"

```

Custom Test Commands

```yaml

test-cmd: "npm run test:ci && npm run test:e2e"

auto-test: true

```

Important Notes

Constraints

Examples

**Minimal config for quick start:**

```yaml

model: gpt-4o

auto-commits: true

auto-lint: true

```

**Team configuration with strict checks:**

```yaml

model: claude-3-5-sonnet-20241022

weak-model: gpt-4o-mini

cache-prompts: true

auto-lint: true

auto-test: true

lint-cmd:

- "python: ruff check --fix && mypy ."

test-cmd: pytest --cov=src tests/

attribute-commit-message-author: true

show-diffs: true

```

**Performance-optimized config:**

```yaml

model: gpt-4o-mini

cache-prompts: true

cache-keepalive-pings: 5

map-tokens: 512

stream: true

timeout: 60

```