Aider
π Quick overview
Aider is a command-line programming agent. It modifies local files, understands a repository via a repo map, uses Git, and can connect to many LLMs, including local models via Ollama12.
π‘ Why this project interests us
Aider fits the minimal custodian agent well: terminal, Git, local files, configurable model, no heavy UI.
For a Markdown vault, it can reread pages, apply fixes, create commits on a branch, and leave validation to a human.
β Strengths
- Open-source, simple CLI.
- Works with cloud or local models.
- Documented Ollama support2.
- No Aider intermediary server: requests go to the configured provider3.
- Opt-in analytics (Aider asks a random subset of users for consent), permanently disableable with
aider --analytics-disable, no code, prompts, or keys per the docs4.
β οΈ Limitations and risks
- Quality depends heavily on the local model: sovereign does not mean competent.
- Weak local models can break edit format, miss precise replacements, or loop on a fix.
- A 7B/8B generalist is too fragile to modify files: aim at least at a coder 14B class model, preferably 24β32B or more (sizing table in the target architecture).
- Ollama silently truncates beyond its window (4,096 tokens by default on the server side as of Q4 2026); Aider sets
num_ctxitself, but the docs recommend runningOLLAMA_CONTEXT_LENGTH=8192 ollama serveor settingnum_ctxin.aider.model.settings.yml2. - If a cloud provider is used, code goes to that provider.
- Commands and allowed files must be controlled carefully.
π Sovereignty and privacy
- Data: stays local except what is sent to the configured LLM.
- Model: local possible via Ollama.
- Memory: session context + local Git.
- Telemetry: analytics disableable; must not include code/prompts per docs.
- 100% offline mode: yes with a pre-downloaded local model.
- Verdict: β native sovereign if configured locally.
π Possible integration in this vault
Aider remains the simplest candidate for a first sovereign trial, provided you accept a tool frozen since May 2026 (durable alternative: see Maturity):
aider --model ollama_chat/<recent coder model>(model choice: target architecture); since Aider no longer knows the models released after May 2026, ignore its βmodel warningsβ after manually checking the context window2;- dedicated branch;
- vault plan/rules in context;
- final Markdown report.
π Project maturity
Mature project (Apache-2.0, about 49,000 GitHub stars) specialized in code editing, but effectively frozen as of Q4 2026: no commit since 2026-05-22, last release v0.86.0 (2025-08-09) and last PyPI publication 0.86.2 (2026-02-12), with no announcement from the maintainers15. It remains narrower than OpenHands and much simpler to operate, but new models are no longer referenced and no security fix is to be expected: use it knowingly, with a replacement plan.
For a durable target, prefer a maintained, model-agnostic agent such as OpenHands (CLI, SDK or Agent Canvas, MIT license), whose documentation covers local models via Ollama, vLLM or SGLang6. If Aider does not resume, the other maintained model-agnostic candidates as of Q4 2026 are, to be evaluated, Goose (Block, Apache-2.0) and Cline (Apache-2.0, CLI 3.x), both on weekly releases; their support for local models has not been verified in this vault7.
π See also
π Sources
Footnotes
-
Aider GitHub README. https://github.com/Aider-AI/aider β© β©2
-
Aider Docs, Ollama (
num_ctxset by Aider,OLLAMA_CONTEXT_LENGTH=8192recommended), read on 2026-10-09. https://aider.chat/docs/llms/ollama.html β© β©2 β©3 β©4 -
Aider GitHub issue #3627 β clarifications on data/code and absence of Aider server. https://github.com/Aider-AI/aider/issues/3627 β©
-
Aider Docs, Analytics (opt-in offered to a random subset of users,
--analytics-disablepermanent), read on 2026-10-09. https://aider.chat/docs/more/analytics.html β© -
PyPI, aider-chat (last publication 0.86.2 on 2026-02-12), accessed 2026-10-09. https://pypi.org/project/aider-chat/ β©
-
OpenHands Docs, Local LLMs (LM Studio, Ollama, vLLM, SGLang), updated 2026-05-21. https://docs.openhands.dev/openhands/usage/llms/local-llms β©
-
Block, Goose Releases (v1.54.0 of 2026-10-08, Apache-2.0) and Cline, Cline Releases (releases of 2026-10-08, Apache-2.0), accessed 2026-10-09. https://github.com/block/goose/releases Β· https://github.com/cline/cline/releases β©