Aider Layer

This layer adds support for Aider, an AI pair programming tool that helps you edit code in your local git repository. Aider works with various language models (GPT-4, Claude, etc.) to make changes to your codebase.

To use this configuration layer, add it to your ~/.spacemacs. You will need to add aider to the existing dotspacemacs-configuration-layers list in this file.

You will also need to install the Aider tool itself:

uv tool install --with pip aider-chat@latest

For more installation information, please check the Aider Installation.

Before using this layer, you need make sure the aider command works in your terminal first.

Create a .aider.conf.yml on your home directory for global configuration, and create a .aider.conf.yml in your project directory for local configurations.

Configure Aider by following the Aider Configuration Guide.

This layer provides comprehensive integration with Aider through Emacs. The main entry point is the transient menu accessible via SPC $ a y.

Basic workflow:

• Open your project in Spacemacs
• Start an Aider session with SPC $ a a
• Add files to Aider's context with SPC $ a f or SPC $ a F
• Use SPC $ a * to question symbole under cursor
• Use SPC $ a c to change code by description
• Use SPC $ a y to open the Aider transient menu for all actions

The layer supports multiple AI modes:

• Code mode (SPC $ a 1): For direct code editing
• Ask mode (SPC $ a 2): For questions and explanations
• Architect mode (SPC $ a 3): For high-level design discussions
• Help mode (SPC $ a 4): For getting help with Aider itself