Aider Git Repository Configuration

Configure Aider AI pair programming assistant with custom settings for your git repository, including model selection, git workflow preferences, output formatting, and automated code quality checks.

What This Does

Creates or updates an `.aider.conf.yml` configuration file at the root of your git repository with customized settings for:

AI model selection and API configuration

Git commit behavior and attribution

Code formatting and linting automation

Chat history and output preferences

Repository map generation

File watching and read-only references

Instructions

Step 1: Analyze Project Requirements

Review the project to determine appropriate Aider settings:

Check if the repository has existing `.aider.conf.yml` or similar config

Identify the preferred AI model (Gemini, Claude, GPT, DeepSeek, etc.)

Review git workflow preferences (auto-commits, dirty commits, attribution)

Check for existing linting/testing commands in project

Identify convention files that should be read-only (CONVENTIONS.md, CONTRIBUTING.md, etc.)

Step 2: Determine Key Configuration Options

Based on project analysis, decide on:

**Model Settings:**

Main model to use (e.g., `gemini-2.5-pro`, `anthropic/claude-3-7-sonnet-20250219`)

Reasoning effort level (low/medium/high) if supported

Editor model for quick edits (optional)

Weak model for commit messages (optional)

**Git Workflow:**

`auto-commits: false` if user prefers manual commits

`auto-commits: true` for automatic commits after LLM changes

`attribute-author: true/false` for git author attribution

`dirty-commits: true/false` to allow/prevent commits when repo is dirty

**Code Quality:**

`lint: false` (manual linting) or `true` (automatic)

`lint-cmd` entries for language-specific linters

`auto-lint: true/false` for automatic linting after changes

`test-cmd` if automated testing is desired

**File Management:**

`read` array with convention/documentation files

`file` array with default files to always include (optional)

Step 3: Create Configuration File

Generate `.aider.conf.yml` with the determined settings. Use YAML format with clear sections:

```yaml

Main model

model: gemini-2.5-pro

Model settings

reasoning-effort: high

Git settings

auto-commits: false

dirty-commits: true

attribute-author: true

attribute-committer: true

Code quality

lint: false

auto-lint: true

Read-only reference files

read: CONVENTIONS.md

History files

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

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

```

Step 4: Add Commonly Used Customizations

Include project-specific customizations such as:

**Language-specific lint commands:**

```yaml

lint-cmd:

- "python: flake8 --select=E,W,F"

- "javascript: eslint --fix"

```

**Test automation:**

```yaml

test-cmd: npm test

auto-test: false

```

**Map tokens for large repos:**

```yaml

map-tokens: 2048

map-refresh: auto

```

**Color scheme:**

```yaml

dark-mode: true

code-theme: monokai

```

Step 5: Document Configuration Choices

Add comments explaining non-obvious settings:

```yaml

Disable auto-commits to allow manual review before committing

auto-commits: false

Reference conventions file without modifying it

read: CONVENTIONS.md

Use high reasoning effort for complex refactoring tasks

reasoning-effort: high

```

Step 6: Verify and Test

1. Save the `.aider.conf.yml` file to the repository root

2. Run `aider --help` to verify configuration is loaded

3. Start an aider session to confirm settings are applied

4. Test key workflows (committing, linting, file inclusion)

5. Adjust settings based on actual usage patterns

Important Notes

**API Keys:** Only OpenAI and Anthropic API keys can be stored in YAML config. All other provider keys must go in `.env` file

**File Location:** Must be placed at git repository root for automatic detection

**Gitignore:** Aider automatically adds `.aider*` files to `.gitignore` (disable with `gitignore: false`)

**Environment Variables:** Use `set-env` for provider-specific API settings

**Model Aliases:** Use `alias` to create shortcuts for frequently used models

**Read-only Files:** Use `read:` for convention/documentation files that should inform AI but not be modified

Common Patterns

**Minimal Configuration (Use Defaults):**

```yaml

model: gemini-2.5-pro

auto-commits: false

```

**Quality-Focused Setup:**

```yaml

model: anthropic/claude-3-7-sonnet-20250219

reasoning-effort: high

lint: true

auto-lint: true

auto-test: false

test-cmd: pytest

```

**Large Repository Setup:**

```yaml

model: gemini-2.5-pro

map-tokens: 4096

map-refresh: files

subtree-only: true

```

Example Usage

After creating `.aider.conf.yml`, simply run:

```bash

aider

```

Aider will automatically load the configuration and apply all specified settings. You can override any setting with command-line flags:

```bash

aider --model gpt-4o --auto-commits

```

Aider Git Repository Configuration

Safety Concern

Aider Git Repository Configuration

What This Does

Instructions

Step 1: Analyze Project Requirements

Step 2: Determine Key Configuration Options

Step 3: Create Configuration File

Main model

Model settings

Git settings

Code quality

Read-only reference files

History files

Step 4: Add Commonly Used Customizations

Step 5: Document Configuration Choices

Disable auto-commits to allow manual review before committing

Reference conventions file without modifying it

Use high reasoning effort for complex refactoring tasks

Step 6: Verify and Test

Important Notes

Common Patterns

Example Usage

Reviews (0)