# Aider — Open-source terminal AI pair programmer that edits files in your local git repo and commits the changes.

> Source: The Agents Index — https://theagentsindex.com/aider (structured, researched, re-verified)
> Facts last verified: 2026-09-30

Aider is an open-source command-line AI pair programmer that edits files in your local git repository using an LLM you connect with your own API key. It maps the whole repo, auto-commits each change, and can lint and test what it wrote.

| Fact | Value |
| --- | --- |
| Website | https://aider.chat |
| Price | Aider is open source and available on GitHub under an Apache 2.0 license. |
| Free tier | Yes |

The tool itself is free Apache 2.0 software with no plans or seats. Your only cost is LLM inference at your own provider; the docs point to free API providers such as OpenRouter free models, noting "with limitations on daily usage".

## What it does

**Writes code** · Yes — Natural-language requests at the terminal prompt produce edits to named files, and it will create files that do not exist yet, so new code is authored from a description.

> At the aider > prompt, ask for code changes and aider will edit those files to accomplish your request.
> — https://aider.chat/docs/usage.html · Usage page, opening section above the factorial.py transcript

**Debugs and fixes** · Yes — It runs your lint and test commands after edits and iterates on the failures it sees, so a diagnosed failure is followed by an attempted fix rather than only a report.

> Aider will try and fix any errors if the command returns a non-zero exit code.
> — https://aider.chat/docs/usage/lint-test.html · Linting and testing page, Testing section

**Writes tests** · Partly — The vendor advertises asking it for test cases, but every documented testing feature is about running your existing test command and repairing failures, not a dedicated test-generation workflow.

> Request new features, test cases or bug fixes using your voice and let aider implement the changes.
> — https://aider.chat/ · Features grid, Voice-to-code card

**Reviews code** · Partly — Review works by piping a diff into the chat yourself with /run git diff or --read and then asking in ask mode; there is no pull-request integration that reviews someone else's diff automatically.

> You can also use aider to review PR branches:
> — https://aider.chat/docs/faq.html · FAQ, "How do I include the git history in the context?" section

**Whole-codebase work** · Partly — A ranked map of the whole git repo gives it repository-wide context, but the vendor warns performance is not optimised for very large monorepos and only one repo can be open at a time.

> Aider will work in any size repo, but is not optimized for quick performance and response time in very large repos.
> — https://aider.chat/docs/faq.html · FAQ, "Can I use aider in a large (mono) repo?" section

**Ships it** · No — The documented end of the loop is a git commit in your local repo; no page on the site describes deploying, pushing a release or publishing to an environment.

> Aider automatically commits changes with sensible commit messages. Use familiar git tools to easily diff, manage and undo AI changes.
> — https://aider.chat/ · Features grid, Git integration card

**Done-for-you service** · No — You install and operate the software yourself from pip, uv, pipx or Docker; the site advertises no implementation, consulting or managed-service engagement, only self-service install instructions.

> If you already have python 3.8-3.13 installed, you can get started quickly like this.
> — https://aider.chat/docs/install.html · Get started quickly with aider-install, opening line

## How much it does unattended

**Runs autonomously** · Partly — It can be driven headlessly with a single message and blanket approval so one task completes without a human, but the default interactive mode is pair programming with prompts.

> Specify a single message to send GPT, process reply then exit (disables chat mode)
> — https://aider.chat/docs/scripting.html · Scripting aider, Command line section, --message option block

**Multi-agent** · Partly — Architect mode splits one task across two model roles, an architect that proposes and an editor that writes the edits, which is role separation rather than several agents coordinating freely.

> An architect model will propose changes and an editor model will translate that proposal into specific file edits.
> — https://aider.chat/docs/usage/modes.html · Chat modes page, bullet list of modes, architect entry

**Agent permissions** · Partly — By default it asks before absorbing command output or adding files and you approve each step, while a single switch removes every confirmation for scripted runs.

> --yes                 Always say yes to every confirmation [env var: AIDER_YES]
> — https://aider.chat/docs/scripting.html · Scripting aider, Command line section, options block

## Which models it runs on

**Claude** · Yes — Anthropic Claude is named as one of the models aider works best with, and the quick-start shows launching it with an Anthropic key.

> Aider works best with these models, which are skilled at editing code:
> — https://aider.chat/docs/llms.html · Connecting to LLMs, Best models list (includes Claude 3.7 Sonnet)

**GPT** · Yes — OpenAI models are listed among the best-supported engines and have their own provider page, with the entry command shown using an OpenAI key.

> Aider works best with Claude 3.7 Sonnet, DeepSeek R1 & Chat V3, OpenAI o1, o3-mini & GPT-4o, but can connect to almost any LLM, including local models.
> — https://aider.chat/ · Features grid, Cloud and local LLMs card

**Open models** · Yes — Local open-weight models are explicitly supported through Ollama, LM Studio and any OpenAI-compatible endpoint, so inference can stay on your own hardware.

> Aider can work also with local models, for example using Ollama.
> — https://aider.chat/docs/llms.html · Connecting to LLMs, Local models section

**Model choice** · Yes — You choose the model per session with --model and can switch mid-chat with /model, and the vendor claims connectivity to almost any LLM rather than a fixed engine.

> Or you can run aider --model XXX to launch aider with another model. During your chat you can switch models with the in-chat /model command.
> — https://aider.chat/docs/usage.html · Usage page, LLMs section

## Where you use it

**In your editor** · Partly — There is no editor plugin; instead a file watcher picks up AI comments you type in whatever IDE you use, so the agent itself still runs as a separate terminal process.

> If you run aider with --watch-files, it will watch all files in your repo and look for any AI coding instructions you add using your favorite IDE or text editor.
> — https://aider.chat/docs/usage/watch.html · Aider in your IDE, AI comments section

**On the command line** · Yes — The terminal is the primary and default surface: you launch aider with filenames and talk to it at its own prompt in the shell.

> Aider lets you pair program with LLMs to start a new project or build on your existing codebase.
> — https://aider.chat/ · Hero section under the heading "AI pair programming in your terminal"

**In your pipeline** · Partly — Non-interactive runs are scriptable from a shell loop with --message and --yes, but nothing on the site documents acting on a pull request or a hosted CI integration.

> Or you can write simple shell scripts to apply the same instruction to many files:
> — https://aider.chat/docs/scripting.html · Scripting aider, Command line section

**In a browser** · Partly — A browser UI exists but the vendor labels it experimental, and it is a local server you start yourself rather than a hosted web product.

> Use aider's new experimental browser UI to collaborate with LLMs to edit code in your local git repo.
> — https://aider.chat/docs/usage/browser.html · Aider in your browser, paragraph under the demo video

## Whose machine it runs on

**Self-hosted** · Yes — Aider is installed on your own machine with pip, uv, pipx or Docker and edits files in your local repo, so there is no vendor runtime to depend on.

> This will install aider in its own separate python environment.
> — https://aider.chat/docs/install.html · Installation, "Get started quickly with aider-install" section

**Open source** · Yes — The company behind the tool states the source is on GitHub under a permissive Apache 2.0 licence, and documents running and modifying it from source.

> Aider is open source and available on GitHub under an Apache 2.0 license.
> — https://aider.chat/docs/faq.html · FAQ, "What is Aider AI LLC?" section

## What it costs to run

**How it meters** · Partly — The tool itself costs nothing; what you pay is token consumption at whichever LLM provider your key belongs to, and the docs treat context size as a direct cost to you.

> Addings extra files will also increase your token costs.
> — https://aider.chat/docs/faq.html · FAQ, "How can I add ALL the files to the chat?" section

**Free tier** · Yes — There is no paid plan, account or sales call anywhere on the site: you pip-install Apache 2.0 licensed software, and the docs even point at free LLM providers to run it with.

> Aider works with a number of free API providers:
> — https://aider.chat/docs/llms.html · Connecting to LLMs, Free models section

**API access** · Partly — You can drive it from your own stack via the CLI or a Python Coder object, but the vendor states the Python API is neither supported nor documented and may break between releases.

> The python scripting API is not officially supported or documented, and could change in future releases without providing backwards compatibility.
> — https://aider.chat/docs/scripting.html · Scripting aider, Python section, closing paragraph

**MCP server** · No — No MCP server or client: the options reference is presented as the complete list of aider's switches and contains none, and MCP appears nowhere in the docs or the site's 132-URL sitemap, so another agent cannot query it that way.

> You can use aider --help to see all the available options, or review them below.
> — https://aider.chat/docs/config/options.html · Options reference, completeness statement above the full usage summary

**Bring your own key** · Yes — Inference is always your own: the tool ships no bundled model and documents four ways to supply your provider key, including any OpenAI-compatible or local endpoint.

> Aider lets you specify API keys in a few ways: On the command line As environment variables In a .env file In your .aider.conf.yml config file
> — https://aider.chat/docs/config/api-keys.html · API Keys page, opening list of ways to set keys

## Buying it for a team

**A company can buy it** · No — Nothing is for sale: no pricing page, no plans, no enterprise tier. An organisation adopts it under the Apache 2.0 licence.

> Aider is open source and available on GitHub under an Apache 2.0 license
> — https://aider.chat/docs/faq.html · FAQ, 'What is Aider AI LLC?'

**Seat model** · No — Not licensed per seat at all, so no floor and no ceiling; each developer installs it and pays their own model provider.

> Aider is open source and available on GitHub under an Apache 2.0 license
> — https://aider.chat/docs/faq.html · FAQ, 'What is Aider AI LLC?'

**Admin controls** · Partly — Behaviour can be constrained per machine or per repo, disabling shell-command suggestions, auto-commits or git entirely, plus .aiderignore and a checked-in YAML config, but there is no org-level console enforcing policy across users.

> --suggest-shell-commands Enable/disable suggesting shell commands (default: True)
> — https://aider.chat/docs/config/options.html · Options reference, Other settings group

**Audit log** · Partly — Its actions are traceable through git, which tags authored and committed changes with '(aider)', and local chat, LLM and analytics logs can be written to files, but there is no tamper-resistant administrative audit trail.

> Aider marks commits that it either authored or committed.
> — https://aider.chat/docs/git.html · Git integration, 'Commit attribution' section

**Single sign-on** · No — There is no account to sign in to: install is two shell commands and the only credential is your model provider's API key.

> python -m pip install aider-install aider-install
> — https://aider.chat/docs/install.html · 'Get started quickly with aider-install' code block

## What happens to your code

**Opt out of training** · Yes — The vendor states its telemetry never touches your code, prompts or keys, analytics are opt-in only, and one command disables collection permanently.

> Analytics are only collected if you agree and opt-in. Aider respects your privacy and never collects your code, chat messages, keys or personal info.
> — https://aider.chat/docs/more/analytics.html · Analytics page, "Opt-in, anonymous, no personal info" section

**Data residency** · Partly — Your code stays on your own machine because the tool edits local files, but the vendor's own services and any analytics it receives are hosted in the United States with no regional choice offered.

> Our Services are hosted in the United States and intended for visitors located within the United States.
> — https://aider.chat/docs/legal/privacy.html · Privacy policy, International Visitors section

**Getting out** · Yes — Nothing is locked in a vendor store: edits land as commits in your own git repo and the chat transcript is a plain markdown file you can copy, and there are no credits that could expire.

> Copy the markdown logs you want to share from .aider.chat.history.md and make a github gist.
> — https://aider.chat/docs/faq.html · FAQ, "Can I share my aider chat transcript?" section

_Not established: Certifications_

## Platform record (as of 2026-08-30)

Reported by the code-hosting platform, not by the vendor.

| Fact | Value |
| --- | --- |
| Licence | Apache-2.0 |
| Stars | 48601 |
| Forks | 4900 |
| Last push | 2026-05-22 |

## Provenance

1 of 22 sources behind the facts above are independent of the vendor.

## Coverage elsewhere

Pages about this product that the vendor does not control. The label states how independent each one is.

| Source | Kind | Read |
| --- | --- | --- |
| augmentcode.com | A competitor's comparison | 2026-08-20 |

## What changed

- 2026-09-30 — Capabilities · Commercial terms · Free tier
- 2026-09-09 — Capabilities · Commercial terms · Free tier · Price
- 2026-09-02 — Capabilities · Commercial terms · Free tier
- 2026-08-31 — Capabilities · Commercial terms · Free tier · Links
- 2026-08-30 — Capabilities · Links
- 2026-08-20 — One-liner · Summary

## Correcting this record

Anything marked "Not established" is a question we have not answered — it is not a No. If you represent Aider, or anything here is wrong or out of date, you can supply it with a source: the operations this site accepts from an agent are listed at https://theagentsindex.com/.well-known/agents.json — that catalogue needs no key to read, and each entry states its own auth.

Supplying evidence is free. Nothing that can be bought here changes what a field says, whether a gap is closed, or how this record is scored.
