Aider
A terminal pair-programmer: you name the files, it edits them and commits each change with a tidy message. Less autonomous than the other tools here — and often the right trade when you want the model close to the code but the initiative to stay with you.
Install
pip install aider-chatPython 3.10 or newer is recommended.
pip often prints a warning like “The script aider is installed in ~/.local/bin which is not on
PATH”. Read that line — it names the exact directory — and add it:
export PATH=$HOME/.local/bin:$PATHPersist it in ~/.zshrc or ~/.bashrc, otherwise aider will not be found in a new shell.
Configure
export OPENAI_API_BASE=https://api.devotel.com/v1
export OPENAI_API_KEY=dvt-YOUR_KEYRun it in a repository
cd ~/code/my-project
aider --model openai/kimi-k3The openai/ prefix tells Aider to use its OpenAI-compatible client, which is what makes
OPENAI_API_BASE apply. Without it, Aider tries to guess the provider from the model name.
Using it
Add the files you want it to work on, describe the change, and it edits them and commits:
$ aider --model openai/kimi-k3
> /add src/parser.py tests/test_parser.py
> handle the human-readable size suffixes (12Gi, 400M) in parse_size
src/parser.py
tests/test_parser.py
Applied edit to src/parser.py
Applied edit to tests/test_parser.py
Commit 4f1c9ab parse human-readable size suffixes in parse_sizeOne commit per change keeps the history reviewable and makes any single step easy to undo with
git revert. For scratch work outside a repository — or when you would rather commit yourself:
aider --no-git --model openai/kimi-k3Aider is a pair-programmer, not a fully autonomous agent. It edits and commits, but it will not go off and run your test suite in a loop deciding what to do next. For that, use OpenHarness or OpenCode.
Troubleshooting
| Symptom | Cause and fix |
|---|---|
aider: command not found | The directory from pip’s PATH warning is not on PATH |
| Requests go to OpenAI | OPENAI_API_BASE unset, or the model given without the openai/ prefix |
401 | OPENAI_API_KEY is not your dvt- key |
404 / model_not_found | Use openai/kimi-k3 exactly |
| Commits you did not want | Run with --no-git, or use /undo in the session |