Aider
Use reza with Aider via --read to inject full project context into every session. Supports auto-sync via file watcher.
reza Integration — Aider
reza works with Aider via --read to inject project context into every session.
Setup
# Install reza from GitHub source once:
git clone https://github.com/swebreza/reza
cd reza
pip install -e .
cd your-project
reza initUsage with Aider
Option 1 — Auto-inject context (recommended)
Generate the context file first:
reza export --format contextThen start Aider with it:
aider --read .reza/CONTEXT.mdThis gives Aider instant project awareness — framework, files, purposes, active sessions.
Option 2 — Regenerate context before each Aider session
Add this to your workflow:
reza export && aider --read .reza/CONTEXT.mdOr create a shell alias:
alias aider-reza='reza export && aider --read .reza/CONTEXT.md'Option 3 — Add to .aider.conf.yml
# .aider.conf.yml
read:
- .reza/CONTEXT.mdThen just run aider — the context file is always included.
Cross-LLM Handoff with Aider
Before starting Aider, check what Claude or Cursor left off:
reza session handoffAfter an Aider session, save progress so Claude or others can pick up:
reza session start --llm aider --task "refactoring auth module"
# ... do your work ...
reza session save --id aider-XXXXXXXX \
--summary "Extracted JWT logic to auth/tokens.py" \
--context "Next: update middleware to use new token module. models.py has circular import — avoid it." \
--files "auth/tokens.py, auth/middleware.py"
reza session end --id aider-XXXXXXXXWatch mode (real-time sync)
Start reza's watcher alongside Aider so the DB stays current:
reza watch &
aider --read .reza/CONTEXT.mdEvery file Aider modifies is automatically recorded in the context DB.
Tips
- After a big refactor:
reza upgradeto re-scan all file purposes - Regenerate CONTEXT.md after each session:
reza export - Use
reza query --find "keyword"from another terminal to locate files