Aider with Gemini 2.5 Pro

Advanced Aider configuration optimized for Google Gemini models with structured commit messages and development workflow preferences.

Description

This skill configures Aider to use Google's Gemini 2.5 Pro as the main model with Gemini 2.5 Flash as the weak model for faster operations. It includes a custom commit message prompt that generates structured, conventional commit messages prefixed with "Aider:" and follows best practices for Git history.

Configuration Features

Commit Message Format

The configuration generates commit messages in this format:

```

Aider: <type>: <description>

```

Supported types:

Instructions

Step 1: Set Up API Key

Replace `<Insert your key here>` in the configuration with your actual Google Gemini API key:

```yaml

api-key:

- gemini=YOUR_ACTUAL_API_KEY

```

Get your API key from [Google AI Studio](https://makersuite.google.com/app/apikey).

Step 2: Create Configuration File

Save this configuration as `.aider.conf.yml` in your project root or home directory:

```yaml

api-key:

- gemini=YOUR_API_KEY_HERE

model: gemini/gemini-2.5-pro-preview-05-06

weak-model: gemini/gemini-2.5-flash-preview-04-17

dark-mode: true

map-tokens: 0

commit-prompt: "You are an expert software engineer that generates concise, one-line Git commit messages based on the provided diffs. Review the provided context and diffs which are about to be committed to a git repo. Review the diffs carefully. Generate a one-line commit message for those changes. The commit message should be structured as follows: `Aider: <type>: <description>`. Use these for <type>: Fix, Feature, Build, Chore, CI, Docs, Style, Refactor, Performance, Test. Ensure the commit message:{language_instruction} - Starts with the appropriate prefix. - Is in the imperative mood (e.g., \"Add feature\" not \"Added feature\" or \"Adding feature\"). - Does not exceed 72 characters. Reply only with the one-line commit message, without any additional text, explanations, or line breaks."

```

Step 3: Launch Aider

Start Aider in your project directory:

```bash

aider

```

Aider will automatically load the configuration from `.aider.conf.yml`.

Step 4: Add Files to Chat

Add files you want to edit:

```

/add src/main.py

/add tests/test_main.py

```

Step 5: Request Changes

Describe what you want to accomplish:

```

Add error handling to the main function with proper logging

```

Step 6: Review and Commit

Aider will:

1. Generate code changes using Gemini 2.5 Pro

2. Show you the proposed changes

3. Ask for confirmation

4. Create a structured commit message using Gemini 2.5 Flash

5. Commit the changes with the format: `Aider: <type>: <description>`

Alternative Model Configuration

To use Gemini 2.0 Flash Experimental instead (faster, lower cost), uncomment this line in your config:

```yaml

model: gemini/gemini-2.0-flash-exp

```

Advanced Usage

Auto-lint after changes

```yaml

auto-lint: true

lint-cmd:

- "python: ruff check --fix"

- "typescript: eslint --fix"

```

Auto-test after changes

```yaml

auto-test: true

test-cmd: pytest

```

Enable repository map (if needed)

```yaml

map-tokens: 2048 # Adjust based on your needs

```

Important Notes

Example Workflow

```bash

Start aider with the configuration

aider

Add files to work with

/add src/api.py src/models.py

Make a request

Add input validation to the create_user endpoint

Aider generates changes, you approve

Resulting commit:

Aider: Feature: Add input validation to create_user endpoint

```

Constraints