aidr
Use aidr to delegate large-context, low-reasoning tasks to Aider.
Quick Start
bash scripts/setup.sh
aidr doctor
aidr models
Core Commands
scan <goal> [paths...]: run read-only discovery and return minimal relevant files/symbols.patch <goal> [paths...]: run small scoped edits; defaults to dry-run unless--apply.run <goal> [paths...]: run a universal freeform task; defaults to dry-run unless--apply.models: list provider-visible Gemini models throughaider --list-models gemini/.doctor: checkaider,uv,GEMINI_API_KEY, and active model mappings.
Modes
--mode fast: default modelgemini-2.5-flash-lite.--mode universal: default modelgemini-3-flash-preview.--mode advanced: default modelgemini-3-flash-preview-2with stronger reasoning hints.
Override defaults with:
AIDR_MODEL_FASTAIDR_MODEL_UNIVERSALAIDR_MODEL_ADVANCED
Safe Workflow
- Start with
aidr --mode fast scan "<goal>" [paths...]. - Apply repetitive edits with
aidr --mode fast patch "<goal>" [paths...] --apply. - Escalate mode only when results are insufficient.
- Use
--aider-args "..."for extra Aider options when required.
Compatibility
Legacy commands remain supported and map to core commands:
map/find/retrieve/explain->scanrefactor->patchtask->run