Aider Watch 模式Aider (Watch mode)

模型与开放条件Model & openness

与 CLI 形态同一套模型入口：支持云端与本地 LLM，可连接几乎任何模型。

README 当前推荐列表停留在上一代模型 （Claude 3.7 Sonnet / DeepSeek R1 / OpenAI o1 等）。

该 README 的状态与该项目的 release 状态一致。

这个项目 13 个月未发 release。

所以参考这份列表时要自行核对。

Same model entry point as the CLI form: supports cloud and local LLMs, and can connect to almost any model.

The README's current recommended list is stuck on the previous generation of models (Claude 3.7 Sonnet / DeepSeek R1 / OpenAI o1, etc.).

The state of that README matches the project's release state.

This project has not shipped a release in 13 months.

So verify this list yourself when using it as a reference.

运行位置Where it runs

它的形态是后台常驻进程，不装进编辑器。

Aider 在后台 watch 你的文件。

你在任意 IDE 或文本编辑器里加 AI 注释，它就响应。

官方文档标题即为「Aider in your IDE」。

但实现上跑的是 Aider 自己的浏览器 UI。

这与 Cline / Codex 的「编辑器扩展」是不同的形态。

It is not an editor plugin; it is a usage mode.

Aider watches your files in the background.

You add AI comments in any IDE or text editor, and it responds.

The official docs page is literally titled "Aider in your IDE".

But the implementation runs Aider's own browser UI.

This is a different form factor from the "editor extension" approach of Cline / Codex.

本地文件Local files

watch 模式监听 git 仓库内所有文件的变化并响应 AI 注释。

官方原文："watch all files in your repo"

（出自官方 docs/usage/watch.html 的 --watch-files。）

范围受 .gitignore / .aiderignore 约束。

• --aiderignore 指定忽略文件，默认 git 根目录的 .aiderignore
• --subtree-only 只考虑当前子树

仓库须是 git 仓库。官方 docs/git.html 写：无 git 时会先问你是否新建。

核心的 Repo Map 能力与 CLI 形态完全相同——同一项目的同一机制， 官方文档见 docs/repomap.md。

它用「一份简洁的整个 git 仓库的地图」提供上下文。

这份地图含最重要的类与函数及其类型与调用签名。

每次改动请求都随附该 map。

它的第二个作用在 watch 模式下尤其有用： 帮助写新代码时复用代码库里已有的库、模块与抽象。

支持 100+ 编程语言。

map 的 token 预算由 --map-tokens 控制。

刷新频率由 --map-refresh 控制，取值为 auto/always/files/manual。

大仓库的实际耗时与 token 开销，官方未给数字，本站未做端到端实测。

Watch mode monitors changes to all files inside the git repository and responds to AI comments.

Official wording: "watch all files in your repo"

(from --watch-files in the official docs/usage/watch.html.)

Scope is constrained by .gitignore / .aiderignore.

• --aiderignore specifies the ignore file; defaults to .aiderignore at the git root
• --subtree-only considers only the current subtree

The repository must be a git repository. The official docs/git.html states: without git, it first asks whether to create one.

The core Repo Map capability is exactly the same as in the CLI form — the same mechanism of the same project; official docs at docs/repomap.md.

It provides context via "a concise map of your whole git repository".

This map contains the most important classes and functions along with their types and call signatures.

The map is attached to every change request.

Its second purpose is especially useful in watch mode: when writing new code, it helps reuse libraries, modules and abstractions already in the codebase.

Supports 100+ programming languages.

The map's token budget is controlled by --map-tokens.

Refresh frequency is controlled by --map-refresh, with values auto/always/files/manual.

Actual time and token cost on large repos: the official docs give no numbers, and this site has not run measurements.

关机后的任务Tasks after shutdown

需要 Aider 进程常驻才能响应注释——这与「后台云端任务」不是一回事。

进程关闭后 watch 即失效。

也不存在客户端关闭后继续运行的云端形态。

The Aider process must stay resident to respond to comments — this is not the same thing as "background cloud tasks".

When the process exits, watch stops.

There is also no cloud form that keeps running after the client closes.

工具与扩展Tools & extensions

两大核心能力是文件编辑与 Git 自动提交，与 CLI 形态是同一机制。

可配置 lint / 测试命令自动运行。

官方文档见 docs/usage/lint-test.html。

• --lint-cmd / --auto-lint：默认对编辑过的文件跑 lint
• --test-cmd / --auto-test
• /run：跑 shell 命令
• /web：抓网页转 markdown
• /paste：贴图

watch 模式下，可从编辑器直接拖文件到智能体面板，或把编辑器选区发送到对话。

在文件里加 # AI 注释，即可把该文件加入 chat。

无内置 MCP 支持——官方选项表与文档站导航都没有任何 MCP 条目 （已查 config/options.html 与 docs 目录）。

所以不能接 MCP server。

The two core capabilities are file editing and Git auto-commit, the same mechanisms as in the CLI form.

Lint / test commands can be configured to run automatically.

Official docs at docs/usage/lint-test.html.

• --lint-cmd / --auto-lint: by default run lint on edited files
• --test-cmd / --auto-test
• /run: run a shell command
• /web: fetch a web page and convert it to markdown
• /paste: paste an image

In watch mode, you can drag files from the editor into the agent panel, or send the editor selection to the chat.

Adding a # AI comment in a file adds that file to the chat.

No built-in MCP support — neither the official options table nor the docs-site navigation has any MCP entry (checked config/options.html and the docs directory).

So you cannot connect MCP servers.

上下文与记忆Context & memory

Repo Map 提供全库结构视图，每次请求随附，见 local_files。

上下文超限用「摘要压缩」而非简单截断。

官方选项 --max-chat-history-tokens 的描述是：

官方原文："Soft limit on tokens for chat history, after which summarization begins"

也就是说，超过软上限即开始摘要；摘要由 --weak-model 生成。

--map-tokens 控 repo map 的 token 预算。

每个模型的上下文窗口与费用，由 --model-metadata-file 提供。

会话内可用 /tokens 查看用量。

腾空间还有 /drop、/clear、/reset。

默认不跨启动恢复（--restore-chat-history 默认 False）。

chat 历史默认写 .aider.chat.history.md。

Repo Map provides a whole-repo structural view, attached to every request; see local_files.

Context overflow is handled by "summarization compression" rather than simple truncation.

The official option --max-chat-history-tokens is described as:

Official wording: "Soft limit on tokens for chat history, after which summarization begins"

That is, summarization begins once the soft limit is exceeded; summaries are generated by --weak-model.

--map-tokens controls the repo map's token budget.

Each model's context window and cost come from --model-metadata-file.

Within a session, /tokens shows usage.

To free space there are also /drop, /clear, /reset.

No cross-launch restoration by default (--restore-chat-history defaults to False).

Chat history is written to .aider.chat.history.md by default.

权限与限制Permissions & limits

默认自动提交。

官方 --auto-commits 默认 True：每次编辑都用合理的 commit message 提交。

--dirty-commits 默认 True：会先把已有的未提交改动也提交， 让你的改动与 AI 的改动分开。

撤销路径是 git 本身（/undo）。

存在确认环节。

官方提供 --yes-always（别名 --yes）。

官方原文："Always say yes to every confirmation"

含义是：默认会对某些操作询问，加此开关才全自动。

--dry-run 可不改文件地预演。

提交时默认跳过 pre-commit hook（--git-commit-verify 默认 False，即用 --no-verify）。

无沙箱机制（官方选项表无任何沙箱项）。

watch 模式复用同一 coder。

官方 watch 页写它用 /undo 撤销、用 /tokens 管上下文。

所以上述自动提交与确认机制同样适用。

常驻进程 + 自动提交 + 需显式开关才不询问，三者叠加风险高。

Auto-commit is on by default.

The official --auto-commits defaults to True: every edit is committed with a sensible commit message.

--dirty-commits defaults to True: existing uncommitted changes are committed first, separating your changes from AI changes.

The undo path is git itself (/undo).

A confirmation step exists.

The official docs provide --yes-always (alias --yes).

Official wording: "Always say yes to every confirmation"

Meaning: by default it asks about certain operations; only with this flag does it go fully automatic.

--dry-run previews without changing files.

Commits skip pre-commit hooks by default (--git-commit-verify defaults to False, i.e. it uses --no-verify).

No sandboxing mechanism (the official options table has no sandbox entry).

Watch mode reuses the same coder.

The official watch page says it uses /undo to revert and /tokens to manage context.

So the auto-commit and confirmation mechanics above apply equally.

The combination of a resident process + auto-commit + explicit flags needed to avoid asking is high-risk.

适合什么任务Best for

适合两类人：

• 习惯在任意编辑器里工作，不愿切换到专门的 Agent 界面的人
• 需要「加注释 → 自动响应」这种轻量交互的人

Fits two kinds of people:

• those who work comfortably in any editor and don't want to switch to a dedicated agent UI
• those who want the lightweight "add a comment → automatic response" interaction

Aider can watch your files and respond to AI comments
you add in your favorite IDE or text editor.

Aider can watch your files and respond to AI comments
you add in your favorite IDE or text editor.

本页由This page is generated from the ai-handbook 数据层生成（CC BY 4.0）。data layer (CC BY 4.0). 方法论与坐标系定义见仓库内For the methodology and coordinate definitions, see METHODOLOGY.md.