Aider Vision Core is a maintained fork of Aider used as the headless coding engine behind Aider Vision. Feature development, community, and user support for the product live there and at aider.chat — not on this site.

Headless Aider engine for Vision

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.

Who builds what

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.

Aider Vision Core (this repo)

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.

Vision Core additions

Capabilities added for Aider Vision and other headless clients. Everything else in the docs below still describes the shared Aider engine unless noted.

HTTP API & SSE

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.

Headless runtime

Non-interactive stdio and confirmation flows suited to GUI confirm/cancel instead of terminal prompts — the default path when Vision owns the UI.

Git submodule workspaces

Superproject roots with nested submodules: discover repos, track files across submodules, and commit pointer updates from a single workspace root.

Upstream alignment

We merge from Aider-AI/aider regularly. Engine behavior, models, and edit formats follow upstream; Vision-only deltas stay small and documented here.

Shared Aider engine

Inherited from upstream — full detail and tutorials on aider.chat/docs.

Getting started (engine)

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.

Links

Vision Core (this site)

Install, API, and fork-specific behavior

Product & upstream

Support, community, and the main Aider project