Aider Vision
The product we support: a ground-up desktop GUI (Rust + React), not an IDE skin. Install, settings, chat UX, and day-to-day help — aider-vision.digitaldefiance.org.
This repository is the core of Aider Vision: a beheaded, API-first fork of Aider that powers the native desktop app. It is not another VS Code clone — the UI lives in React and Tauri; this package is the pair-programming brain you run locally or embed via HTTP.
We track upstream Aider closely and add only what Vision needs: structured sessions, submodule-aware git workspaces, and reliable headless operation.
The product we support: a ground-up desktop GUI (Rust + React), not an IDE skin. Install, settings, chat UX, and day-to-day help — aider-vision.digitaldefiance.org.
Python engine fork: CLI, HTTP API, git/submodule logic, and docs for integrators. Issues here should be engine or API bugs; praise and roadmap belong upstream or on the Vision site.
The original terminal pair programmer and most engine concepts. aider.chat — Aider-AI/aider.
Capabilities added for Aider Vision and other headless clients. Everything else in the docs below still describes the shared Aider engine unless noted.
Run aider-vision-core-serve and drive sessions from the Vision
app, Tauri, or any client. JSONL-style events over Server-Sent Events; optional
bearer auth for local serve.
Non-interactive stdio and confirmation flows suited to GUI confirm/cancel instead of terminal prompts — the default path when Vision owns the UI.
Superproject roots with nested submodules: discover repos, track files across submodules, and commit pointer updates from a single workspace root.
We merge from Aider-AI/aider regularly. Engine behavior, models, and edit formats follow upstream; Vision-only deltas stay small and documented here.
Inherited from upstream — full detail and tutorials on aider.chat/docs.
Connect to Claude, GPT, DeepSeek, local models, and most OpenAI-compatible APIs.
Repo map for larger projects so the model sees the right context.
Python, JavaScript, Rust, Go, C++, and dozens more via tree-sitter.
Automatic commits with sensible messages; diff and undo with normal git tools.
Run linters and tests on changes; the model can fix reported problems.
Upstream supports IDE-style watch mode in a terminal workflow. Aider Vision uses the HTTP API instead of copying that UX.
For the desktop app, use Aider Vision. To run or integrate the core directly:
# Install the engine package
python -m pip install -U aider-vision-core
# Headless HTTP server (default http://127.0.0.1:8741)
aider-vision-core-serve --workspace /path/to/git/repo
# Classic CLI (same as upstream aider, renamed binary)
cd /path/to/your/project
aider-vision-core --model sonnet --api-key anthropic=<key>
Documentation on this site covers the fork; upstream guides apply to most usage.
Install, API, and fork-specific behavior
Support, community, and the main Aider project