Retext
AiderCopilot

Aider Prompt Templates

Prompts that work well in Aider, with the setup steps that matter in this tool. Add the files it should edit with /add before you send the prompt. Aider only edits files you have added. Start with the general brief below, or pick a task-specific prompt from the related list.

Installs as a snippet — type ;aider to paste this prompt anywhere on your Mac.
Prompt Template
I'm working in Aider and need help with [describe the task in one sentence].

What I have:
- [the code, document or data involved]
- [what I've tried so far]

What a good result looks like:
- [the outcome you want]
- [constraints: style, length, libraries, deadlines]

Before you start, list any assumptions you're making. Then give the result, followed by one sentence on how to check it.

Context
- Files involved: [list the files, or reference them in the chat]
- How I build and test: [e.g. npm test]

How to use this prompt

  1. 1

    Open Aider

    Start aider in your repository and paste the prompt at the aider prompt.

  2. 2

    Give it context

    Add the files it should edit with /add before you send the prompt. Aider only edits files you have added.

  3. 3

    Review and iterate

    Aider commits each change to git, so review with git diff and use /undo if a change is wrong.

Working in Aider

  • •Only /add the files that need changes. Extra files cost context and invite unrelated edits.
  • •Because every change is a git commit, you can keep requests small and roll back cheaply.
  • •Paste test output or error messages directly; aider works well in a fix, run, paste-error loop.

Example task: Bug Fix

What you give it

Expected: average([]) returns 0.
Actual: ZeroDivisionError: division by zero
Language: Python 3.12

def average(nums):
    total = 0
    for n in nums:
        total += n
    return total / len(nums)

Already ruled out: nums is always a list, never None. It only fails when a user has no orders yet.

What a good answer looks like (shortened)

1. Root cause: when nums is empty, len(nums) is 0, so the return line divides by zero.

2. Fixed code:
def average(nums):
    if not nums:
        return 0
    return sum(nums) / len(nums)

3. Why it works: the guard returns before any division happens. sum() replaces the manual loop and gives the same result for non-empty lists.

4. Check:
assert average([]) == 0
assert average([2, 4]) == 3.0

Tips for better results

  • •Add the files it should edit with /add before you send the prompt. Aider only edits files you have added.
  • •Aider commits each change to git, so review with git diff and use /undo if a change is wrong.
  • •Only /add the files that need changes. Extra files cost context and invite unrelated edits.

Get the free prompt pack

Our best coding prompts in one Markdown file, delivered by email. The templates here stay free either way — the pack just saves you the copying.

Variations

Plan first

Add this line: Before changing anything, give me a numbered plan and wait for my OK.

Explain as you go

Add this line: After the result, explain the two decisions that matter most and why you made them.

Starter task (Bug Fix)

Fix with a regression test: Add this line under Output format: 5. A unit test that fails on the old code and passes on the fixed code.

Save it as a Retext snippet

Retext is a free text expander for Mac. Save this prompt once, then type ;aider in any app (ChatGPT, Claude, your editor, a browser tab) and the full prompt is pasted in.

  1. Click Add to Retext. The prompt installs as a snippet with the trigger ;aider.
  2. Change the trigger in Retext if you prefer a different one.
  3. Type the trigger wherever you want the prompt, then fill in the brackets.

Frequently asked questions

Why didn't aider change the file I meant?

Aider edits only files added to the chat. Run /add with that file, then resend the prompt.

How do I undo a bad edit?

Use /undo in aider to revert its last commit, or use git as usual, since each change is committed.

How do I reuse this prompt without copying it every time?

Click Add to Retext to save it as a snippet. Then type ;aider in any Mac app, including your AI tool, and the full prompt is pasted in.

Related Templates

Get the free prompt pack

Our best coding prompts in one Markdown file, delivered by email. The templates here stay free either way — the pack just saves you the copying.