Documentation and Other Notes

• Agent Mode
• MCP Configuration
• Session Management
• Aider Original Documentation (still mostly applies)
• Changelog
• Discord Community

Installation Instructions

This project can be installed using several methods:

Package Installation

pip install aider-ce

or

uv pip install aider-ce

The package exports an aider-ce command that accepts all of Aider's configuration options

Tool Installation

uv tool install --python python3.12 aider-ce

Use the tool installation so aider doesn't interfere with your development environment

Configuration

The documentation above contains the full set of allowed configuration options but I highly recommend using an .aider.conf.yml file. A good place to get started is:

model: <model of your choice>
agent: true
analytics: false
auto-commits: true
auto-save: true
auto-load: false
cache-prompts: true
check-update: true
debug: false
enable-context-compaction: true
env-file: .aider.env
multiline: true
preserve-todo-list: true
show-model-warnings: true
watch-files: false
agent-config: |
  {
    "large_file_token_threshold": 12500,
    "skip_cli_confirmations": false
  }
mcp-servers: |
  {
    "mcpServers":
      {
        "context7":{
          "transport":"http",
          "url":"https://mcp.context7.com/mcp"
        }      
      }   
  }

Use the adjacent .aider.env file to store model api keys as environment variables, e.g:

ANTHROPIC_API_KEY="..."
GEMINI_API_KEY="..."
OPENAI_API_KEY="..."
OPENROUTER_API_KEY="..."
DEEPSEEK_API_KEY="..."

Project Roadmap/Goals

The current priorities are to improve core capabilities and user experience of the Aider project

1. Base Asynchronicity (aider-ce coroutine-experiment branch)

• Refactor codebase to have the main loop run asynchronously
• Update test harness to work with new asynchronous methods

2. Repo Map Accuracy - Discussion

• Bias page ranking toward active/editable files in repo map parsing
• Include import information in repo map for richer context
• Handle non-unique symbols that break down in large codebases

3. Context Discovery - Discussion

• Develop AST-based search capabilities
• Enhance file search with ripgrep integration
• Implement RAG (Retrieval-Augmented Generation) for better code retrieval
• Build an explicit workflow and local tooling for internal discovery mechanisms

4. Context Delivery - Discussion

• Use workflow for internal discovery to better target file snippets needed for specific tasks
• Add support for partial files and code snippets in model completion messages

5. TUI Experience - Discussion

• Add a full TUI (probably using textual) to have a visual interface competitive with the other coding agent terminal programs
• Re-integrate pretty output formatting
• Implement a response area, a prompt area with current auto completion capabilities, and a helper area for management utility commands

6. Agent Mode - Discussion

• Renaming "navigator mode" to "agent mode" for simplicity
• Add an explicit "finished" internal tool
• Add a configuration json setting for agent mode to specify allowed local tools to use, tool call limits, etc.
• Add a RAG tool for the model to ask questions about the codebase
• Make the system prompts more aggressive about removing unneeded files/content from the context
• Add a plugin-like system for allowing agent mode to use user-defined tools in simple python files
• Add a dynamic tool discovery tool to allow the system to have only the tools it needs in context

All Contributors (Both Aider Main and Aider-CE)

@paul-gauthier @dwash96 @tekacs @ei-grad @joshuavial @chr15m @fry69 @quinlanjager @caseymcc @shladnik @itlackey @tomjuggler @vk4s @titusz @daniel-vainsencher @bphd @akaihola @jalammar @schpet @iamFIREcracker @KennyDizi @ivanfioravanti @mdeweerd @fahmad91 @itsmeknt @cheahjs @youknow04 @pcamp @miradnanali @o-nix