aider runner invokes the aider CLI binary as a subprocess, making it a flexible choice if you want to use models other than Claude — including self-hosted models via Ollama.
Requirements
- Python 3.9 or later
- pip
Model and API key configuration
Aider reads model configuration from environment variables or its own config files. Configure your preferred model before using it with RemoteAgent.CHAT.~/.aider.conf.yml file to set defaults permanently. See Aider’s configuration docs for details.
Setup
aider when prompted by the interactive wizard.
During remoteagent init, the wizard will ask for:
- API key — saved and passed to Aider via environment variable
- Model (e.g.
claude-3-5-sonnet-20241022,gpt-4o) — saved and passed as the--modelflag on every run - Architect mode (yes/no) — if enabled, the
--architectflag is appended to every invocation
~/.remoteagent/agents/{agentId}.json and applied automatically on every run.
How it works
The runner executes:--messagepasses the prompt non-interactively--no-auto-commitsprevents Aider from committing changes automatically (you remain in control of your git history)--yesanswers any confirmation prompts automatically (required for non-interactive operation)--model <model>is included if a model was specified during init--architectis included if architect mode was enabled during init
Aider with git
By default, Aider is designed to work inside a git repository and uses git context to understand your codebase. Make sure your project directory is a git repo, or pass--no-git in your Aider config to disable git integration.