NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Aider is AI pair programming in your terminal
Last release 7 months ago
12 Feb 2026
Ships unpredictably
gaps range from 8 days to 6 months
Nearly every release is documented
notes for 59 of the last 60 stable releases
18 versions withdrawn
withdrawn after publishing
3 years old
174 releases · first in 2023
One column per quarter.
Nothing published for this version
Added a reasoning_effort setting for GPT-5 models and disabled temperature by default for the GPT-5 family.
Added support for all GPT-5 models.
Added support for all GPT-5 models.
Added support for Grok-4 via xai/grok-4 and openrouter/x-ai/grok-4 model names.
Added support for gemini/gemini-2.5-flash-lite-preview-06-17 model, by Tamir Zahavi-Brunner.
/clear now prints “All chat history cleared.” so you know it worked, by Zexin Yuan.
/undo output now shows only the first line of each commit message, making it easier to read.
Added support for openrouter/moonshotai/kimi-k2 model, by Jack Harrington.
Display model announcements with no-arg /model command.
Fixed an issue where new settings for an existing model didn't replace the old ones, by Andrew Grigorev.
Fixed analytics to support the latest PostHog SDK event-capture API.
Bumped dependencies to pick up latest litellm==1.75.0.
Aider wrote 88% of the code in this release.
Enforced diff edit format for GPT-5 models.
Fixed analytics to support the latest PostHog SDK event-capture API.
Bumped dependencies to pick up latest litellm==1.75.0.
Added support for Grok-4 via xai/grok-4 and openrouter/x-ai/grok-4 model names.
xai/grok-4 and openrouter/x-ai/grok-4 model names.gemini/gemini-2.5-flash-lite-preview-06-17 model, by Tamir Zahavi-Brunner./clear now prints “All chat history cleared.” so you know it worked, by Zexin Yuan./undo output now shows only the first line of each commit message, making it easier to read.openrouter/moonshotai/kimi-k2 model, by Jack Harrington.Display model announcements with no-arg /model command.
/model command.Added support for new Gemini models including gemini-2.5-pro, gemini-2.5-flash, and gemini-2.5-pro-preview-06-05 with thinking tokens support.
gemini-2.5-pro, gemini-2.5-flash, and gemini-2.5-pro-preview-06-05 with thinking tokens support.flash now points to gemini-2.5-flash and gemini now points to gemini-2.5-pro.--add-gitignore-files flag to enable adding files listed in .gitignore to Aider's editing scope, by omarcinkonis.--commit-language option to specify the language for commit messages, by Kyosuke Takayama.--skip-sanity-check-repo is enabled for better performance, by Makar Ivashko.--analytics-posthog-host and --analytics-posthog-project-api-key flags, by Vasil Markoukin.Improved GitHub Copilot token handling with better validation and error messages, by Vincent Taverna and Sebastian Estrella.
Improved inline code rendering in Rich markdown output, by Vamsi Talupula.
Fixed Vertex AI model name prefixes in settings, by Wietse Venema.
Improved /read-only command to resolve literal paths correctly, by Matteo Landi.
Fixed encoding issues in git diff output and LLM history logging.
Fixed search block regex to accept optional closing tags when working with HTML content, by Mathis Beer.
Auto-create parent directories for chat history files to prevent startup errors, by contributor.
Ensure pip is available before package installation.
Aider wrote 21% of the code in this release.
gemini-2.5-pro, gemini-2.5-flash, and gemini-2.5-pro-preview-06-05 with thinking tokens support.flash now points to gemini-2.5-flash and gemini now points to gemini-2.5-pro.--add-gitignore-files flag to enable adding files listed in .gitignore to Aider's editing scope, by omarcinkonis.--commit-language option to specify the language for commit messages, by Kyosuke Takayama./read-only command to resolve literal paths correctly, by Matteo Landi.--skip-sanity-check-repo is enabled for better performance, by Makar Ivashko.--analytics-posthog-host and --analytics-posthog-project-api-key flags, by Vasil Markoukin.Added support for new Claude models including the Sonnet 4 and Opus 4 series (e.g., claude-sonnet-4-20250514, claude-opus-4-20250514) across various p
claude-sonnet-4-20250514,
claude-opus-4-20250514) across various providers. The default sonnet and opus aliases were updated to these newer
versions.vertex_ai/gemini-2.5-flash-preview-05-20 model.deepseek/deepseek-r1:free for the free tier and
anthropic/claude-sonnet-4 for paid tiers..gitignore.--edit-format/--editor-edit-format options./settings command now displays detailed metadata for active main, editor, and weak models.en-US to en) and enhancing the validation of locale results.claude-sonnet-4-20250514,
claude-opus-4-20250514) across various providers. The default sonnet and opus aliases were updated to these newer
versions.vertex_ai/gemini-2.5-flash-preview-05-20 model.deepseek/deepseek-r1:free for the free tier and
anthropic/claude-sonnet-4 for paid tiers.Bumped configargparse to 1.7.1 as 1.7 was pulled.
--edit-format/--editor-edit-format options./settings command now displays detailed metadata for active main, editor, and weak models..gitignore.Improved user language detection by correctly normalizing hyphenated language codes (e.g., en-US to en) and enhancing the validation of locale results
en-US to en) and enhancing the validation of locale results.Added support for gemini-2.5-pro-preview-05-06 models.
gemini-2.5-pro-preview-05-06 models.qwen3-235b models.--attribute-co-authored-by option to add co-author trailer to commit messages, by Andrew Grigorev.gemini, gemini-2.5-pro) to point to the 05-06 preview versions.overeager by default.gemini/gemini-2.5-flash-preview-04-17.gemini-2.5-pro-exp-03-25 model settings to reflect its lack of support for thinking_budget.thinking_tokens and reasoning_effort parameters for OpenRouter models.litellm.completion_cost where available.openrouter/google/gemini-2.5-pro-preview-03-25.--disable-playwright flag to prevent Playwright installation prompts and usage, by Andrew Grigorev.aider scrape command-line tool will now use Playwright for web scraping if it is available, by Jon Keys.oslex for argument quoting, by Titusz Pan.oslex for robust argument quoting, by Titusz Pan./ask mode to instruct the LLM to elide unchanging code in its responses.--disable-playwright flag.reasoning_effort for Gemini 2.5 Flash models.--shell-completions argument to generate shell completion scripts (e.g., for bash, zsh).--attribute-author or --attribute-committer flags now override the default behavior when --attribute-co-authored-by is used, allowing finer control over commit attribution, by Andrew Grigorev./drop after adding a read-only file).aider-args utility (or python -m aider.args) now defaults to printing a sample YAML configuration if no arguments are provided.Full release notes: https://aider.chat/HISTORY.html
Add support for gemini-2.5-flash-preview-04-17 models.
gemini-2.5-flash-preview-04-17 models.udiff-simple edit format, for Gemini 2.5 Pro.gemini-2.5-flash-preview-04-17.--- /dev/null)./commit, by Kay Gosho.overeager prompt setting by default..svg, .pdf) to the default list of ignored files for AI comment scanning (--watch).--watch).Fix editing shell files with diff-fenced, by zjy1412.
Added support for o3 and o4-mini including provider-specific versions for OpenAI, OpenRouter, and Azure.
o3 and o4-mini including provider-specific versions for OpenAI, OpenRouter, and Azure.gpt-4.1 and gpt-4.1-mini models.o3 models since you need identity verification to stream.Support for GPT 4.1, mini and nano.
Support for GPT 4.1, mini and nano.
Improved support for using architect mode with Gemini 2.5 Pro.
Add support for xai/grok-3-beta, xai/grok-3-mini-beta, openrouter/x-ai/grok-3-beta,
openrouter/x-ai/grok-3-mini-beta, and openrouter/openrouter/optimus-alpha models.
Added support for grok-3-fast-beta and grok-3-mini-fast-beta models.
Added new patch edit format for OpenAI's GPT-4.1 model.
Added new editor-diff, editor-whole, and editor-diff-fenced edit formats.
Bugfix for automatically selecting the best edit format to use in architect mode.
Add alias "grok3" for xai/grok-3-beta.
Add alias "optimus" for openrouter/openrouter/optimus-alpha.
Fix URL extraction from error messages.
Allow adding files by full path even if a file with the same basename is already in the chat.
Fix quoting of values containing '#' in the sample aider.conf.yml.
Add support for Fireworks AI model 'deepseek-v3-0324', by Felix Lisczyk.
Aider wrote 92% of the code in this release.
<img width="730" alt="2025-04-14_16-22-29" src="https://github.com/user-attachments/assets/e4bd30b4-7fa4-4784-a10c-50315d7cbac6" />
patch edit format for OpenAI's GPT-4.1 model.editor-diff, editor-whole, and editor-diff-fenced edit formats.grok-3-fast-beta and grok-3-mini-fast-beta models.Commit messages generated by aider are no longer forced to be entirely lowercase, by Peter Hadlaw.
Add support for xai/grok-3-beta, xai/grok-3-mini-beta, openrouter/x-ai/grok-3-beta, openrouter/x-ai/grok-3-mini-beta, and openrouter/openrouter/optimu
xai/grok-3-beta, xai/grok-3-mini-beta, openrouter/x-ai/grok-3-beta, openrouter/x-ai/grok-3-mini-beta, and openrouter/openrouter/optimus-alpha models.xai/grok-3-beta.openrouter/openrouter/optimus-alpha.aider.conf.yml.Added support for the gemini/gemini-2.5-pro-preview-03-25 model.
gemini/gemini-2.5-pro-preview-03-25 model.gemini alias to point to gemini/gemini-2.5-pro-preview-03-25.gemini-exp alias for gemini/gemini-2.5-pro-exp-03-25.Added support for the openrouter/openrouter/quasar-alpha model.
Added support for the openrouter/openrouter/quasar-alpha model.
aider --model quasarOffer OpenRouter OAuth authentication if an OpenRouter model is specified but the API key is missing.
Prevent retrying API calls when the provider reports insufficient credits.
Improve URL detection to exclude trailing double quotes.
Bumped deps to pickup litellm change to properly display the root cause of OpenRouter "choices" errors.
Improve error message for OpenRouter API connection issues to mention potential rate limiting or upstream provider issues.
Configure weak models (gemini/gemini-2.0-flash and openrouter/google/gemini-2.0-flash-exp:free) for Gemini 2.5 Pro models.
Add model metadata for openrouter/google/gemini-2.0-flash-exp:free.
Updated deps for yanked fsspec and aiohttp packages #3699
Removed redundant dependency check during OpenRouter OAuth flow, by Claudia Pellegrino.
Aider wrote 86% of the code in this release.
https://aider.chat/HISTORY.html
<img width="826" alt="2025-04-04_16-17-33" src="https://github.com/user-attachments/assets/4b6c4c8f-6110-4c6c-8f27-03592e36c1d2" />
Bumped deps to pickup litellm change to properly display the root cause of OpenRouter "choices" errors.
Improve error message for OpenRouter API connection issues to mention potential rate limiting or upstream provider issues.
gemini/gemini-2.0-flash and openrouter/google/gemini-2.0-flash-exp:free) for Gemini 2.5 Pro models.openrouter/google/gemini-2.0-flash-exp:free.- Bumped deps.
Updated deps for yanked fsspec and aiohttp packages #3699
Offer to OAuth against OpenRouter if no model and keys are provided.
OpenRouter OAuth integration:
OPENROUTER_API_KEY is set and no model is specified.Prioritize gemini/gemini-2.5-pro-exp-03-25 if GEMINI_API_KEY is set, and vertex_ai/gemini-2.5-pro-exp-03-25 if VERTEXAI_PROJECT is set, when no model is specified.
Validate user-configured color settings on startup and warn/disable invalid ones.
Warn at startup if --stream and --cache-prompts are used together, as cost estimates may be inaccurate.
Boost repomap ranking for files whose path components match identifiers mentioned in the chat.
Change web scraping timeout from an error to a warning, allowing scraping to continue with potentially incomplete content.
Left-align markdown headings in the terminal output, by Peter Schilling.
Update edit format to the new model's default when switching models with /model, if the user was using the old model's default format.
Add the openrouter/deepseek-chat-v3-0324:free model.
Add Ctrl-X Ctrl-E keybinding to edit the current input buffer in an external editor, by Matteo Landi.
Fix linting errors for filepaths containing shell metacharacters, by Mir Adnan ALI.
Add repomap support for the Scala language, by Vasil Markoukin.
Fixed bug in /run that was preventing auto-testing.
Fix bug preventing UnboundLocalError during git tree traversal.
Handle GitCommandNotFound error if git is not installed or not in PATH.
Handle FileNotFoundError if the current working directory is deleted while aider is running.
Fix completion menu current item color styling, by Andrey Ivanov.
Aider wrote 87% of the code in this release.
Full change log: https://aider.chat/HISTORY.html
Added 'gemini' alias for gemini-2.5-pro model.
Improved model listing to include all models in fuzzy matching, including those provided by aider (not litellm).
Added support for SOTA Gemini 2.5 Pro.
/context command that automatically identifies which files need to be edited for a given request./edit as an alias for the /editor command.<img width="939" alt="2025-03-25_10-50-17" src="https://github.com/user-attachments/assets/48795278-5693-441c-8744-653f5ade99a3" />
/context command that automatically identifies which files need to be edited for a given request./edit as an alias for the /editor command.Added support for thinking tokens for OpenRouter Sonnet 3.7.
Added support for thinking tokens for OpenRouter Sonnet 3.7.
Added commands to switch between model types: /editor-model for Editor Model, and /weak-model for Weak Model, by csala.
Added model setting validation to ignore --reasoning-effort and --thinking-tokens if the model doesn't support them.
Added --check-model-accepts-settings flag (default: true) to force unsupported model settings.
Annotated which models support reasoning_effort and thinking_tokens settings in the model settings data.
Improved code block rendering in markdown output with better padding using NoInsetMarkdown.
Added --git-commit-verify flag (default: False) to control whether git commit hooks are bypassed.
Fixed autocompletion for /ask, /code, and /architect commands, by shladnik.
Added vi-like behavior when pressing enter in multiline-mode while in vi normal/navigation-mode, by Marco Mayer.
Added AWS_PROFILE support for Bedrock models, allowing use of AWS profiles instead of explicit credentials, by lentil32.
Enhanced --aiderignore argument to resolve both absolute and relative paths, by mopemope.
Improved platform information handling to gracefully handle retrieval errors.
Bumped dependencies to pickup litellm fix for Ollama.
Added support for openrouter/google/gemma-3-27b-it model.
Updated exclude patterns for help documentation.
Aider wrote 92% of the code in this release.
Full release notes: https://aider.chat/HISTORY.html
Bumped dependencies to pickup litellm fix for Ollama.
openrouter/google/gemma-3-27b-it model.Fixed a bug where default model would be set by deprecated --shortcut switches even when already specified in the command line.
Big upgrade in programming languages supported by adopting tree-sitter-language-pack.
Added /think-tokens command to set thinking token budget with support for human-readable formats (8k, 10.5k, 0.5M).
Added /reasoning-effort command to control model reasoning level.
The /think-tokens and /reasoning-effort commands display current settings when called without arguments.
Display of thinking token budget and reasoning effort in model information.
Changed --thinking-tokens argument to accept string values with human-readable formats.
Added --auto-accept-architect flag (default: true) to automatically accept changes from architect coder format without confirmation.
Added support for cohere_chat/command-a-03-2025 and gemini/gemma-3-27b-it
The bare /drop command now preserves original read-only files provided via args.read.
Fixed a bug where default model would be set by deprecated --shortcut switches even when already specified in the command line.
Improved AutoCompleter to require 3 characters for autocompletion to reduce noise.
Fixed handling of JSONDecodeError when loading model cache file.
Fixed handling of GitCommandError when retrieving git user configuration.
Added ignore_permission_denied option to file watcher to prevent errors when accessing restricted files, by Yutaka Matsubara.
Aider wrote 72% of the code in this release.
Fixed handling of JSONDecodeError when loading model cache file.
Added ignore_permission_denied option to file watcher to prevent errors when accessing restricted files, by Yutaka Matsubara.
Added deprecation warning for remove_reasoning setting, now replaced by reasoning_tag.
Improved support for thinking/reasoning models:
--thinking-tokens CLI option to control token budget for models that support thinking.remove_reasoning setting, now replaced by reasoning_tag.Aider will notify you when it's completed the last request and needs your input:
--notifications flag.--notifications-command.Added/improved support for many models/providers:
--model openrouter/deepseek/deepseek-chat:free.openrouter/anthropic/claude-3.7-sonnetSwitch to tree-sitter-language-pack for tree sitter support.
Improved error handling for EOF (Ctrl+D) in user input prompts.
Added helper function to ensure hex color values have a # prefix.
Fixed handling of Git errors when reading staged files.
Improved SSL verification control for model information requests.
Improved empty LLM response handling with clearer warning messages.
Fixed Git identity retrieval to respect global configuration, by Akira Komamura.
Offer to install dependencies for Bedrock and Vertex AI models.
Deprecated model shortcut args (like --4o, --opus) in favor of the --model flag.
Aider wrote 85% of the code in this release.
https://aider.chat/HISTORY.html
Added support for Claude 3.7 Sonnet models on OpenRouter, Bedrock and Vertex AI.
Added support for openrouter/anthropic/claude-3.7-sonnet
openrouter/anthropic/claude-3.7-sonnetBasic support for Claude 3.7 Sonnet
--model sonnet to use the new 3.7/editor command.Downgrade streamlit dependency to avoid threading bug.
Prevent more than one cache warming thread from becoming active.
Have o1 & o3-mini generate markdown by sending the magic "Formatting re-enabled." string.
Dynamically changes the Ollama context window to hold the current chat.
<think> tags from R1 responses for commit messages (and other weak model uses).use_temperature: <float> in model settings, not just true/false.boto3 for Bedrock.HOME=/app which is the normal project mount-point, to persist
~/.aider.python, php, etc.--timeout/model now correctly reports that the weak model is not changed.node_modules.https://aider.chat/HISTORY.html
Full support for o3-mini: aider --model o3-mini
aider --model o3-mini--reasoning-effort argument: low, medium, high.remove_reasoning: tagname model setting.--model openrouter/deepseek/deepseek-r1:freeopenrouter/deepseek/deepseek-r1https://aider.chat/HISTORY.html
<img width="984" alt="2025-01-31_13-35-29" src="https://github.com/user-attachments/assets/94b0824b-c222-4b1e-98ec-df5947b07f5b" />
Enforce user/assistant turn order to avoid R1 errors, by miradnanali.
Harden against user/assistant turn order problems which cause R1 errors.
Fix model metadata for openrouter/deepseek/deepseek-r1
openrouter/deepseek/deepseek-r1Also via OpenRouter: --model openrouter/deepseek/deepseek-r1
--model r1--model openrouter/deepseek/deepseek-r1--line-endings for file writing, by Titusz Pan.<img width="898" alt="2025-01-20_11-39-50" src="https://github.com/user-attachments/assets/1de1f960-699b-444d-ba6c-28a3aedd0ea3" />
Fix permissions issue in Docker images.
Prompts to help DeepSeek work better when alternating between /ask and /code.
/ask and /code./model o1 and a streaming model/ask, /code and /architect commands now switch the chat mode.https://aider.chat/HISTORY.html
Watch files now honors --subtree-only, and only watches that subtree.
--subtree-only, and only watches that subtree./load or --load.https://aider.chat/HISTORY.html
Fix for gemini model names in model metadata.
Use # ... AI? comments to trigger aider and ask questions about your code.
# ... AI? comments to trigger aider and ask questions about your code.# AI comments, // AI comments, or -- AI comments to give aider instructions in any text file.aider --model flash or aider --model gemini/gemini-2.0-flash-exp--multiline flag and /multiline-mode command makes ENTER a soft newline and META-ENTER send the message, by @miradnanali./copy-context <instructions> now takes optional "instructions" when copying code context to the clipboard./voice now lets you edit the transcribed text before sending.https://github.com/user-attachments/assets/528b6868-f6be-426c-a736-dbe1a208435d
Aider works with LLM web chat UIs.
--copy-paste mode./copy-context command.--api-key provider=key setting.--set-env VAR=value setting.--watch-files.sys.python for self-upgrades.https://github.com/user-attachments/assets/a8dca5f6-a1f8-4282-9cbd-e8219f4a23b6
Use aider in your IDE or editor.
aider --watch-files and it will watch for instructions you add to your source files.# ... or // ... comments that start or end with "AI" are instructions to aider./run or /test have non-zero exit codes, pre-fill "Fix that" into the next message prompt./diff now invokes git diff to use your preferred diff tool.--read now expands ~ home dirs.https://github.com/user-attachments/assets/bea76d8b-5c31-4913-9536-97b7e6c632b5
PDF support for Sonnet and Gemini models.
--voice-input-device to select audio input device for voice recording, by @preynal.--timeout option to configure API call timeouts./drop command to support substring matching for non-glob patterns.--alias.https://github.com/user-attachments/assets/4d9b5187-45e5-47c2-a8ff-1e00542c8b06
- Bugfix to --alias.
--alias.Added --alias config to define custom model aliases.
--alias config to define custom model aliases.--[no-]detect-urls flag to disable detecting and offering to scrape URLs found in the chat./editor returns and prefill the file content into the prompt, so you can use /editor to compose messages that start with /commands, etc.<img width="569" alt="2024-11-26_08-59-06" src="https://github.com/user-attachments/assets/ea13c0e7-a243-4798-96a8-eebb43fba794">
Disable streaming for o1 on OpenRouter.
Added `/editor` command to open system editor for writing prompts, by @thehunmonkgroup.
/editor command to open system editor for writing prompts, by @thehunmonkgroup.gpt-4o-2024-11-20./run and suggested shell commands are less mysterious and now confirm that they "Added XX lines of output to the chat."extra_params for litellm.completion().--show-release-notes to control release notes display on first run of new version.--read.Fixed bug in fuzzy model name matching when litellm provider info is missing.
--read.Your coding agent can read these notes before it upgrades. Set up the MCP server →