874b5f8c7a
# Context:
USER: Feature Description
Currently, the /add function accepts directory paths to add the entire directory or spefic file paths to the program's context. A useful enhancement would be to support the use of regex or glob expressions with the /add function. This would give users more flexibility and control to specify exactly which files to include.
Proposed Solution
Allow the /add function to interpret glob or regex patterns. For example, a user could use /add src/*.py to include only Python files from the src directory or /add src/[A-C]* to add only files that start with A, B, or C.
Expected Behavior
When a user runs /add with a regex or glob pattern, the program should add to the context only the files that match the pattern. The program should handle non-matching files or non-existent paths gracefully, preferably by ignoring them and printing a warning message.
Alternatives Considered
An alternative could be providing an additional function, say /addPattern, that accepts regex/glob patterns. This approach would leave the existing /add functionality unchanged for users who don't need the enhanced functionality.
Additional Context
Adding this feature would boost the flexibility of the /add function, making the program more convenient to use for a variety of tasks. Users could, for instance, exclude certain types of files or select a subset of files based on their naming conventions.
ASSISTANT: To implement this feature, we need to modify the `cmd_add` method in the `Commands` class in the `aider/commands.py` file.
The changes will involve:
1. Interpreting the input argument as a glob pattern.
2. Using the `glob` module to find all files that match the pattern.
3. Adding the matched files to the chat session.
Here is the proposed change:
```python
aider/commands.py
<<<<<<< ORIGINAL
def cmd_add(self, args):
"Add matching files to the chat session"
added_fnames = []
files = self.coder.get_all_relative_files()
for word in args.split():
matched_files = [file for file in files if word in file]
=======
import glob
def cmd_add(self, args):
"Add matching files to the chat session using glob patterns"
added_fnames = []
for pattern in args.split():
matched_files = glob.glob(pattern, recursive=True)
>>>>>>> UPDATED
```
This change will allow the `/add` command to accept glob patterns. For example, `/add src/*.py` will add all Python files in the `src` directory to the chat session.
|
||
|---|---|---|
| .github/workflows | ||
| _layouts | ||
| aider | ||
| assets | ||
| benchmark | ||
| docs | ||
| examples | ||
| scripts | ||
| tests | ||
| .dockerignore | ||
| .flake8 | ||
| .pre-commit-config.yaml | ||
| _config.yml | ||
| CNAME | ||
| HISTORY.md | ||
| LICENSE.txt | ||
| MANIFEST.in | ||
| pytest.ini | ||
| README.md | ||
| requirements.txt | ||
| setup.py | ||
aider is GPT powered coding in your terminal
aider is a command-line chat tool that allows you to write and edit
code with OpenAI's GPT models. You can ask GPT to help you start
a new project, or modify code in your existing git repo.
Aider makes it easy to git commit, diff & undo changes proposed by GPT without copy/pasting.
It also has features that help GPT-4 understand and modify larger codebases.
- Getting started
- Example chat transcripts
- Features
- Installation
- Usage
- In-chat commands
- Tips
- GPT-4 vs GPT-3.5
Getting started
$ pip install aider-chat
$ export OPENAI_API_KEY=your-key-goes-here
$ aider myapp.py
Using git repo: .git
Added myapp.py to the chat.
myapp.py> change the fibonacci function from recursion to iteration
Example chat transcripts
Here are some example transcripts that show how you can chat with aider to write and edit code with GPT-4.
-
Hello World Flask App: Start from scratch and have GPT create a simple Flask app with various endpoints, such as adding two numbers and calculating the Fibonacci sequence.
-
Javascript Game Modification: Dive into an existing open-source repo, and get GPT's help to understand it and make modifications.
-
Complex Multi-file Change with Debugging: GPT makes a complex code change that is coordinated across multiple source files, and resolves bugs by reviewing error output and doc snippets.
-
Create a Black Box Test Case: GPT creates a "black box" test case without access to the source of the method being tested, using only a high level map of the repository based on ctags.
You can find more chat transcripts on the examples page.
Features
- Chat with GPT about your code by launching
aiderfrom the command line with set of source files to discuss and edit together. Aider lets GPT see and edit the content of those files. - Request new features, changes, improvements, or bug fixes to your code. Ask for new test cases, updated documentation or code refactors.
- Aider will apply the edits suggested by GPT directly to your source files.
- Aider will automatically commit each changeset to your local git repo with a descriptive commit message. These frequent, automatic commits provide a safety net. It's easy to undo changes or use standard git workflows to manage longer sequences of changes.
- You can use aider with multiple source files at once, so GPT can make coordinated code changes across all of them in a single changeset/commit.
- Aider can give GPT-4 a map of your entire git repo, which helps it understand and modify large codebases.
- You can also edit files by hand using your editor while chatting with aider. Aider will notice these out-of-band edits and ask if you'd like to commit them. This lets you bounce back and forth between the aider chat and your editor, to collaboratively code with GPT.
Installation
- Install the package with pip:
- PyPI:
python -m pip install aider-chat - GitHub:
python -m pip install git+https://github.com/paul-gauthier/aider.git - Local clone:
python -m pip install -e .
- Set up your OpenAI API key:
- As an environment variable:
export OPENAI_API_KEY=sk-...on Linux or Macsetx OPENAI_API_KEY sk-...in Windows PowerShell
- Or include
openai-api-key: sk-...in an.aider.config.ymlfile in your current directory or at the root of your git repo, alongside the.gitdir.
- Optionally, install universal ctags. This is helpful if you plan to use aider and GPT-4 with repositories that have more than a handful of files. This allows aider to build a map of your entire git repo and share it with GPT to help it better understand and modify large codebases.
- The
ctagscommand needs to be on your shell path so that it will run by default when aider invokesctags .... - You need a build which includes the json feature. You can check by running
ctags --versionand looking for+jsonin theOptional compiled featureslist.
Usage
Run the aider tool by executing the following command:
aider <file1> <file2> ...
If your pip install did not place the aider executable on your path, you can invoke aider like this:
python -m aider.main <file1> <file2>
Replace <file1>, <file2>, etc., with the paths to the source code files you want to work on.
These files will be "added to the chat session", so that GPT can see their contents and edit them according to your instructions.
You can also just launch aider anywhere in a git repo without naming
files on the command line. It will discover all the files in the
repo. You can then add and remove individual files in the chat
session with the /add and /drop chat commands described below.
If you or GPT mention one of the repo's filenames in the conversation,
aider will ask if you'd like to add it to the chat.
Aider will work best if you think about which files need to be edited to make your change and add them to the chat. Aider has some ability to help GPT figure out which files to edit all by itself, but the most effective approach is to explicitly add the needed files to the chat yourself.
Aider also has many
additional command-line options, environment variables or configuration file
to set many options. See aider --help for details.
In-chat commands
Aider supports commands from within the chat, which all start with /. Here are some of the most useful in-chat commands:
/add <file>: Add matching files to the chat session./drop <file>: Remove matching files from the chat session./undo: Undo the last git commit if it was done by aider./diff: Display the diff of the last aider commit./run <command>: Run a shell command and optionally add the output to the chat./help: Show help about all commands.
Tips
- Think about which files need to be edited to make your change and add them to the chat. Aider has some ability to help GPT figure out which files to edit all by itself, but the most effective approach is to explicitly add the needed files to the chat yourself.
- Large changes are best performed as a sequence of thoughtful bite sized steps, where you plan out the approach and overall design. Walk GPT through changes like you might with a junior dev. Ask for a refactor to prepare, then ask for the actual change. Spend the time to ask for code quality/structure improvements.
- Use Control-C to safely interrupt GPT if it isn't providing a useful response. The partial response remains in the conversation, so you can refer to it when you reply to GPT with more information or direction.
- Use the
/runcommand to run tests, linters, etc and show the output to GPT so it can fix any issues. - Enter a multiline chat message by entering
{alone on the first line. End the multiline message with}alone on the last line. - If your code is throwing an error, share the error output with GPT using
/runor by pasting it into the chat. Let GPT figure out and fix the bug. - GPT knows about a lot of standard tools and libraries, but may get some of the fine details wrong about APIs and function arguments. You can paste doc snippets into the chat to resolve these issues.
- Aider will notice if you launch it on a git repo with uncommitted changes and offer to commit them before proceeding.
- GPT can only see the content of the files you specifically "add to the chat". Aider also sends GPT-4 a map of your entire git repo. So GPT may ask to see additional files if it feels that's needed for your requests.
- I also shared some general GPT coding tips on Hacker News.
GPT-4 vs GPT-3.5
Aider supports all of OpenAI's chat models, including
the the brand new gpt-3.5-turbo-16k model.
You will probably get the best results with one of the GPT-4 models, because of their large context windows, adherance to system prompt instructions and greater competance at coding tasks. The GPT-4 models are able to structure code edits as simple "diffs" and use a repository map to improve their ability to make changes in larger codebases.
The GPT-3.5 models are supported more experimentally and are limited to editing somewhat smaller codebases. They are less able to follow instructions and aren't able to return code edits in a compact "diff" format. So aider has to ask GPT-3.5 to return a new copy of the "whole file" with edits included. This rapidly uses up tokens and can hit the limits of the context window.
For more detailed information and a quantitative comparison, here are code editing benchmark results for GPT-3.5 and GPT-4.
Aider disables the
repository map feature
when used with GPT-3.5 models.
The gpt-3.5-turbo context window is too small to include a repo map.
Evaluation is still needed to determine if gpt-3.5-turbo-16k can make use of a repo map.
In practice, this means you can use aider to edit a set of source files that total up to the sizes below. You can (and should) add just the specific set of files to the chat that are relevant to the change you are requesting. This minimizes your use of the context window, as well as costs.
| Model | Context Size |
Edit Format |
Max File Size |
Max File Size |
Repo Map? |
|---|---|---|---|---|---|
| gpt-3.5-turbo | 4k tokens | whole file | 2k tokens | ~8k bytes | no |
| gpt-3.5-turbo-16k | 16k tokens | whole file | 8k tokens | ~32k bytes | no |
| gpt-4 | 8k tokens | diffs | 8k tokens | ~32k bytes | yes |
| gpt-4-32k | 32k tokens | diffs | 32k tokens | ~128k bytes | yes |
Kind words from users
- The best AI coding assistant so far." -- Matthew Berman
- "Aider ... has easily quadrupled my coding productivity." -- SOLAR_FIELDS
- "What an amazing tool. It's incredible." -- valyagolev
- "It was WAY faster than I would be getting off the ground and making the first few working versions." -- Daniel Feldman