MatthewZMD / aidermacs

# Aidermacs: AI Pair Programming in Emacs
Aidermacs brings AI-powered development to Emacs by integrating Aider, one of the most powerful open-source AI pair programming tools. If you're missing Cursor but prefer living in Emacs, Aidermacs provides similar AI capabilities while staying true to Emacs workflows.
### Key Features
- Intelligent model selection with multiple backends
- Built-in Ediff integration for AI-generated changes
- Enhanced file management from Emacs
- Great customizability and flexible ways to add content
### Community Speaks
Here's what the community is saying about Aidermacs:
> "Are you using aidermacs? For me superior to cursor." - u/berenddeboer
> "This is amazing... every time I upgrade my packages I see your new commits. I feel this the authentic aider for emacs" - u/wchmbo
> "Between Aidermacs and Gptel it's wild how bleeding edge Emacs is with this stuff. My workplace is exploring MCP registries and even clients that are all the rage (E.g Cursor) lag behind what I can do with mcp.el and gptel for tool use." - u/no_good_names_avail
> "This looks amazing... I have been using ellama with local llms, looks like that will work here too. Great stuff!!" - u/lugpocalypse
> "Honestly huge fan of this. Thank you for the updates!" - u/ieoa
## Quick Start
1. Requirements
- Emacs ≥ 26.1
- Aider or its community fork Aider Community Experimentation.
- Transient
2. Download Aidermacs through Melpa or Non-GNU Elpa, or clone manually
3. Modify this **sample config** and place it in your Emacs `init.el`:
 [code] 
4. Open a project and run `M-x aidermacs-transient-menu` or `SPC a a` (or your chosen binding).
5. Add files and start coding with AI!
### Spacemacs
For **Spacemacs** users:
1. Add `aidermacs` to your `dotspacemacs-additional-packages` list in your `.spacemacs` file:
 [code] 
2. Add the keybinding to your `dotspacemacs/user-config` function in `.spacemacs`:
 [code] 
3. Open a project and run `M-x aidermacs-transient-menu` or `SPC a a` (or your chosen binding).
4. Add files and start coding with AI!
## Usage
### Getting Started
The main interface to Aidermacs is through its transient menu system (similar to Magit). Access it with:
 [code] 
Or bind it to a key in your config:
 [code] 
Once the transient menu is open, you can navigate and execute commands using the displayed keys. Here's a summary of the main menu structure:
##### Core
- `a`: Start/Open Session (auto-detects project root)
- `.`: Start in Current Directory (good for monorepos)
- `l`: Clear Chat History
- `s`: Reset Session
- `x`: Exit Session
##### Persistent Modes
- `1`: Code Mode
- `2`: Chat/Ask Mode
- `3`: Architect Mode
- `4`: Help Mode
##### Utilities
- `^`: Show Last Commit (if auto-commits enabled)
- `u`: Undo Last Commit (if auto-commits enabled)
- `R`: Refresh Repo Map
- `h`: Session History
- `o`: Change Main Model
- `v`: Send Voice Command
- `W`: Fetch Web Content
- `?`: Aider Meta-level Help
##### File Actions
- `f`: Add File (C-u: read-only)
- `F`: Add