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 init

Usage with Aider

Generate the context file first:

reza export --format context

Then start Aider with it:

aider --read .reza/CONTEXT.md

This 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.md

Or 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.md

Then 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 handoff

After 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-XXXXXXXX

Watch mode (real-time sync)

Start reza's watcher alongside Aider so the DB stays current:

reza watch &
aider --read .reza/CONTEXT.md

Every file Aider modifies is automatically recorded in the context DB.

Tips

  • After a big refactor: reza upgrade to re-scan all file purposes
  • Regenerate CONTEXT.md after each session: reza export
  • Use reza query --find "keyword" from another terminal to locate files