Workflows
Aider
Terminal pair-programming with a repo, Apache-2.0, and several model providers.
Aider-AI/aider is an Apache-2.0 terminal pair programmer. The site is aider.chat. You name files in a repository and edit them with a model. It can talk to more than one provider. Compared with newer fully automatic agents, it puts more weight on the files you explicitly include.
On the first try, limit the map to two files and read the diff. Commit only after that. Do not let it walk through many directories while nobody is reading the diff.
This page is a guide, not the original text.
Note (verified 15 November 2026): The repository is not archived. The README has no deprecation or pause notice and still presents Aider as a maintained product, but the last push was at 22:02 Asia/Shanghai on 22 May 2026, about six months ago. The README still highlights older models such as Claude 3.7 Sonnet and o3-mini. This review found no official statement that Claude Code Agent Skills have replaced it.
What problem it solves
Aider-AI/aider is a terminal pair-programming tool for a Git repository. The site is aider.chat. The codebase is Apache-2.0. You name the files you want to change, the model proposes edits in that scope, and Aider writes them back. It puts more weight on the context you explicitly include than on a fully automatic agent walking the tree by itself.
Official docs say it can talk to many providers, including local models, and that it builds a repository map for larger codebases. Git integration is tight: it commits each change by default, and it exposes /diff, /undo, and related commands. On a first try, limit the map to a few files and read the diff yourself.
Who it is for
It is for people who already work in a terminal and want to name files before a model edits them. It also fits repositories that already have tests and linters, and that want those checks to run after each change. If you mainly work in the Cursor or Claude Code GUI, Aider is not the same product, and you do not need to install it just to "have an agent."
Use it only in a repository you are allowed to change. Put keys in environment variables or flags, not in the chat log or in Git. Aider edits files and may auto-commit, so it is a poor fit for unsupervised edits across many directories.
How to install it
Verified on 2026-11-16 (Asia/Shanghai). The commands come from the official Installation page and the repository README. The recommended entry point is to install aider-install, then let it install Aider in a separate environment:
python -m pip install aider-install
aider-installOfficial docs say you can start that way if you already have Python 3.8–3.13. aider-install uses a separate environment and may install Python 3.12 for Aider. On this review date, PyPI listed aider-chat 0.86.2 with requires_python >=3.10,<3.13, while the install page says pipx and direct pip work with 3.9–3.12. Those ranges are not identical, and this page does not invent a single official range. The official uv example is:
uv tool install --force --python python3.12 --with pip aider-chat@latestOfficial docs do not recommend installing Aider from a system package manager as the first choice, because the dependencies are often wrong. A direct pip install -U --upgrade-strategy only-if-needed aider-chat is supported, but the docs suggest a virtual environment.
Once you are in a repository, the README still starts from these older model examples:
cd /to/your/project
# DeepSeek
aider --model deepseek --api-key deepseek=<key>
# Claude 3.7 Sonnet
aider --model sonnet --api-key anthropic=<key>
# o3-mini
aider --model o3-mini --api-key openai=<key>You can use environment variables instead of command-line keys. Supported models belong on Connecting to LLMs. Do not treat the README examples as a current best-model list.
A worked example
This example asks for one small edit across two files that you name yourself, to confirm that install, the model, and Git integration work. Use a scratch branch. Nothing was run here, so this page does not invent a diff or a commit message.
- Finish
aider-installfrom the previous section, and enter a Git repository. If the directory is not a repository yet, official behavior is to ask whether to create one. Decide that yourself first. - If you do not want a commit after every edit, add
--no-auto-commits. Automatic commits are the official default. The off switch is documented in Git integration. - Start Aider with two named files, for example:
aider --no-auto-commits README.md CHANGELOG.md- In the chat, send:
Add a one-sentence project overview to README.md only if that section is missing. Do not edit CHANGELOG.md. Show the diff and wait for me to approve a commit. - The expected effect is that Aider proposes a change inside the files you included, that you can inspect it with
/diff, and that you decide whether to/commitonly after that review. If it edits a file you did not name, or commits before you have looked, stop, use/undoor the Git history, and re-check the launch flags.
Common pitfalls
- Treating Aider as a rapidly shipping product without re-checking maintenance. The repository is not archived, and the README has no deprecation notice, but the last push was at 22:02 Asia/Shanghai on 22 May 2026, about six months earlier. The README still highlights older models such as Claude 3.7 Sonnet and o3-mini. That last push did add newer Claude names, including opus 4.5, to the Anthropic model list, but the homepage recommendations were not updated. This review found no official statement that Claude Code Agent Skills have replaced it.
- Forgetting automatic commits. Aider commits its edits by default, and it skips pre-commit hooks with
--no-verifyunless you pass--git-commit-verify. Use--no-auto-commitsif you do not want automatic commits. - Mixing up the Python version requirements. The install page,
aider-install, pipx / pip, and therequires_pythonfield on PyPI foraider-chatdo not fully agree. When an install fails, follow the installer you chose and the PyPI metadata that day. - Letting it edit many directories without limiting the file map. The catalog entry and this page both suggest starting with two files and reading the diff yourself.
- Leaving API keys in the shell history and also in a script or a repository. Prefer environment variables.
- Starting in a dirty worktree without realizing that Aider, by default, may first commit those existing changes. Official docs offer
--no-dirty-commits.
FAQ
Is Aider still actively maintained?
As of 16 November 2026, the repository is not archived and the README still presents Aider as a maintained product, but the last push was about six months earlier. This review found no official shutdown notice, and no official statement that Claude Code Agent Skills have replaced it. For current model advice, use the LLM docs and the release notes, not only the README homepage.
Are the models on the README out of date?
On this review date, the homepage still highlighted older models such as Claude 3.7 Sonnet and o3-mini. That matches a repository that had not been pushed for about six months. The last commit did expand the Anthropic model list, so the software is not necessarily limited to those older names, but the README is not a current leaderboard. Follow the official LLM documentation for what you can actually connect.
How do I turn off automatic commits?
Launch with --no-auto-commits. To stop Aider from first committing dirty files, add --no-dirty-commits. --no-git disables Git entirely; official docs do not recommend it unless you already have your own backups. See Git integration.
Which install method should I use?
The official first path is python -m pip install aider-install followed by aider-install. The docs also describe uv, pipx, and install scripts. Use a virtual environment if you install with pip directly. System package-manager builds often have incorrect dependencies, and official docs do not recommend that path.
Which Python version do I need?
The install page says aider-install can start from a machine Python 3.8–3.13 and may install 3.12 separately. pipx and direct pip are described as 3.9–3.12. PyPI listed aider-chat 0.86.2 with requires_python >=3.10,<3.13 on this review date. Those statements do not line up completely. This page does not pick a single "correct" range. Check the installer you are using.
Sources and license
Aider-AI/aider is licensed under Apache-2.0. This page is a paraphrase, for CQBase — Context & Query Base, of the README, the installation guide, the Git integration page, and the PyPI metadata, checked on 16 November 2026. The most recent push on that review was at 22:02 Asia/Shanghai on 22 May 2026. If install commands, model lists, or Git defaults change, official docs win.
In this category
- Workflows
Firecrawl
A web-crawling library for AI agents, licensed AGPL-3.0. The official MCP server is cataloged separately.
firecrawl - Workflows
MarkItDown
Microsoft’s Python tool for turning office documents into Markdown that a model or agent can read.
microsoft - Workflows
Claude Code
Anthropic’s terminal coding agent: it reads the repo, edits files, and runs commands.
anthropics