├── .dockerignore
├── .flake8
├── .github
    ├── ISSUE_TEMPLATE
    │   └── issue.yml
    └── workflows
    │   ├── docker-build-test.yml
    │   ├── docker-release.yml
    │   ├── issues.yml
    │   ├── pages.yml
    │   ├── release.yml
    │   ├── ubuntu-tests.yml
    │   └── windows-tests.yml
├── .gitignore
├── .pre-commit-config.yaml
├── CNAME
├── CONTRIBUTING.md
├── HISTORY.md
├── LICENSE.txt
├── MANIFEST.in
├── README.md
├── aider
    ├── __init__.py
    ├── __main__.py
    ├── advisors.py
    ├── analytics.py
    ├── args.py
    ├── args_formatter.py
    ├── backtrack.py
    ├── coders
    │   ├── __init__.py
    │   ├── architect_coder.py
    │   ├── architect_prompts.py
    │   ├── ask_coder.py
    │   ├── ask_prompts.py
    │   ├── base_coder.py
    │   ├── base_prompts.py
    │   ├── chat_chunks.py
    │   ├── document_coder.py
    │   ├── document_prompts.py
    │   ├── editblock_coder.py
    │   ├── editblock_fenced_coder.py
    │   ├── editblock_fenced_prompts.py
    │   ├── editblock_func_coder.py
    │   ├── editblock_func_prompts.py
    │   ├── editblock_prompts.py
    │   ├── editor_editblock_coder.py
    │   ├── editor_editblock_prompts.py
    │   ├── editor_whole_coder.py
    │   ├── editor_whole_prompts.py
    │   ├── help_coder.py
    │   ├── help_prompts.py
    │   ├── planning_coder.py
    │   ├── planning_prompts.py
    │   ├── search_replace.py
    │   ├── single_wholefile_func_coder.py
    │   ├── single_wholefile_func_prompts.py
    │   ├── udiff_coder.py
    │   ├── udiff_prompts.py
    │   ├── wholefile_coder.py
    │   ├── wholefile_func_coder.py
    │   ├── wholefile_func_prompts.py
    │   └── wholefile_prompts.py
    ├── commands.py
    ├── commands_advanced.py
    ├── copypaste.py
    ├── deprecated.py
    ├── diffs.py
    ├── dump.py
    ├── editor.py
    ├── exceptions.py
    ├── format_settings.py
    ├── gui.py
    ├── help.py
    ├── help_pats.py
    ├── history.py
    ├── io.py
    ├── linter.py
    ├── llm.py
    ├── main.py
    ├── mdstream.py
    ├── models.py
    ├── prompts.py
    ├── queries
    │   ├── tree-sitter-language-pack
    │   │   ├── csharp-tags.scm
    │   │   └── javascript-tags.scm
    │   └── tree-sitter-languages
    │   │   ├── README.md
    │   │   ├── c-tags.scm
    │   │   ├── c_sharp-tags.scm
    │   │   ├── cpp-tags.scm
    │   │   ├── dart-tags.scm
    │   │   ├── elisp-tags.scm
    │   │   ├── elixir-tags.scm
    │   │   ├── elm-tags.scm
    │   │   ├── go-tags.scm
    │   │   ├── hcl-tags.scm
    │   │   ├── java-tags.scm
    │   │   ├── javascript-tags.scm
    │   │   ├── kotlin-tags.scm
    │   │   ├── ocaml-tags.scm
    │   │   ├── php-tags.scm
    │   │   ├── python-tags.scm
    │   │   ├── ql-tags.scm
    │   │   ├── ruby-tags.scm
    │   │   ├── rust-tags.scm
    │   │   └── typescript-tags.scm
    ├── reasoning_tags.py
    ├── repo.py
    ├── repomap.py
    ├── report.py
    ├── resources
    │   ├── __init__.py
    │   ├── model-metadata.json
    │   └── model-settings.yml
    ├── run_cmd.py
    ├── scrape.py
    ├── sendchat.py
    ├── special.py
    ├── urls.py
    ├── utils.py
    ├── versioncheck.py
    ├── voice.py
    ├── watch.py
    ├── watch_prompts.py
    └── website
    │   ├── Gemfile
    │   ├── HISTORY.md
    │   ├── _config.yml
    │   ├── _data
    │       ├── architect.yml
    │       ├── blame.yml
    │       ├── code-in-json.yml
    │       ├── deepseek-down.yml
    │       ├── edit_leaderboard.yml
    │       ├── o1_polyglot_leaderboard.yml
    │       ├── o1_results.yml
    │       ├── polyglot_leaderboard.yml
    │       ├── quant.yml
    │       ├── qwq.yml
    │       ├── r1_architect.yml
    │       ├── refactor_leaderboard.yml
    │       └── sonnet-fine.yml
    │   ├── _includes
    │       ├── blame.md
    │       ├── code-in-json-benchmark.js
    │       ├── code-in-json-syntax.js
    │       ├── get-started.md
    │       ├── head_custom.html
    │       ├── help-tip.md
    │       ├── help.md
    │       ├── keys.md
    │       ├── leaderboard.js
    │       ├── leaderboard_graph.html
    │       ├── model-warnings.md
    │       ├── multi-line.md
    │       ├── nav_footer_custom.html
    │       ├── python-m-aider.md
    │       ├── quant-chart.js
    │       ├── qwq-chart.js
    │       ├── replit-pipx.md
    │       └── works-best.md
    │   ├── _layouts
    │       └── redirect.html
    │   ├── _posts
    │       ├── 2023-05-25-ctags.md
    │       ├── 2023-07-02-benchmarks.md
    │       ├── 2023-10-22-repomap.md
    │       ├── 2023-11-06-benchmarks-1106.md
    │       ├── 2023-11-06-benchmarks-speed-1106.md
    │       ├── 2023-12-21-unified-diffs.md
    │       ├── 2024-01-25-benchmarks-0125.md
    │       ├── 2024-03-08-claude-3.md
    │       ├── 2024-04-09-gpt-4-turbo.md
    │       ├── 2024-05-02-browser.md
    │       ├── 2024-05-13-models-over-time.md
    │       ├── 2024-05-22-draft.md
    │       ├── 2024-05-22-linting.md
    │       ├── 2024-05-22-swe-bench-lite.md
    │       ├── 2024-05-24-self-assembly.md
    │       ├── 2024-06-02-main-swe-bench.md
    │       ├── 2024-07-01-sonnet-not-lazy.md
    │       ├── 2024-07-25-new-models.md
    │       ├── 2024-08-14-code-in-json.md
    │       ├── 2024-08-26-sonnet-seems-fine.md
    │       ├── 2024-09-12-o1.md
    │       ├── 2024-09-26-architect.md
    │       ├── 2024-11-21-quantization.md
    │       ├── 2024-12-03-qwq.md
    │       ├── 2024-12-21-polyglot.md
    │       ├── 2025-01-15-uv.md
    │       ├── 2025-01-24-r1-sonnet.md
    │       └── 2025-01-28-deepseek-down.md
    │   ├── _sass
    │       └── custom
    │       │   └── custom.scss
    │   ├── assets
    │       ├── 2024-03-07-claude-3.jpg
    │       ├── 2024-03-07-claude-3.svg
    │       ├── 2024-04-09-gpt-4-turbo-laziness.jpg
    │       ├── 2024-04-09-gpt-4-turbo-laziness.svg
    │       ├── 2024-04-09-gpt-4-turbo.jpg
    │       ├── 2024-04-09-gpt-4-turbo.svg
    │       ├── 2024-07-new-models.jpg
    │       ├── aider-browser-social.mp4
    │       ├── aider-square.jpg
    │       ├── aider.jpg
    │       ├── architect.jpg
    │       ├── benchmarks-0125.jpg
    │       ├── benchmarks-0125.svg
    │       ├── benchmarks-1106.jpg
    │       ├── benchmarks-1106.svg
    │       ├── benchmarks-speed-1106.jpg
    │       ├── benchmarks-speed-1106.svg
    │       ├── benchmarks-udiff.jpg
    │       ├── benchmarks-udiff.svg
    │       ├── benchmarks.jpg
    │       ├── benchmarks.svg
    │       ├── blame.jpg
    │       ├── browser.jpg
    │       ├── code-in-json.jpg
    │       ├── codespaces.jpg
    │       ├── codespaces.mp4
    │       ├── copypaste.jpg
    │       ├── copypaste.mp4
    │       ├── figure.png
    │       ├── icons
    │       │   ├── android-chrome-192x192.png
    │       │   ├── android-chrome-384x384.png
    │       │   ├── apple-touch-icon.png
    │       │   ├── browserconfig.xml
    │       │   ├── favicon-16x16.png
    │       │   ├── favicon-32x32.png
    │       │   ├── favicon.ico
    │       │   ├── mstile-150x150.png
    │       │   ├── safari-pinned-tab.svg
    │       │   └── site.webmanifest
    │       ├── install.jpg
    │       ├── install.mp4
    │       ├── leaderboard.jpg
    │       ├── linting.jpg
    │       ├── llms.jpg
    │       ├── models-over-time.png
    │       ├── models-over-time.svg
    │       ├── o1-polyglot.jpg
    │       ├── prompt-caching.jpg
    │       ├── quantization.jpg
    │       ├── qwq.jpg
    │       ├── r1-sonnet-sota.jpg
    │       ├── robot-ast.png
    │       ├── robot-flowchart.png
    │       ├── sample-analytics.jsonl
    │       ├── sample.aider.conf.yml
    │       ├── sample.env
    │       ├── screencast.svg
    │       ├── screenshot.png
    │       ├── self-assembly.jpg
    │       ├── shell-cmds-small.mp4
    │       ├── shell-cmds.jpg
    │       ├── sonnet-not-lazy.jpg
    │       ├── sonnet-seems-fine.jpg
    │       ├── swe_bench.jpg
    │       ├── swe_bench.svg
    │       ├── swe_bench_lite.jpg
    │       ├── swe_bench_lite.svg
    │       ├── thinking.jpg
    │       ├── udiffs.jpg
    │       ├── watch.jpg
    │       └── watch.mp4
    │   ├── blog
    │       └── index.html
    │   ├── docs
    │       ├── benchmarks-0125.md
    │       ├── benchmarks-1106.md
    │       ├── benchmarks-speed-1106.md
    │       ├── benchmarks.md
    │       ├── config.md
    │       ├── config
    │       │   ├── adv-model-settings.md
    │       │   ├── aider_conf.md
    │       │   ├── api-keys.md
    │       │   ├── dotenv.md
    │       │   ├── editor.md
    │       │   ├── model-aliases.md
    │       │   ├── options.md
    │       │   └── reasoning.md
    │       ├── ctags.md
    │       ├── faq.md
    │       ├── git.md
    │       ├── install.md
    │       ├── install
    │       │   ├── codespaces.md
    │       │   ├── docker.md
    │       │   ├── optional.md
    │       │   └── replit.md
    │       ├── languages.md
    │       ├── leaderboards
    │       │   ├── by-release-date.md
    │       │   ├── contrib.md
    │       │   ├── edit.md
    │       │   ├── index.md
    │       │   ├── notes.md
    │       │   └── refactor.md
    │       ├── legal
    │       │   ├── contributor-agreement.md
    │       │   └── privacy.md
    │       ├── llms.md
    │       ├── llms
    │       │   ├── anthropic.md
    │       │   ├── azure.md
    │       │   ├── bedrock.md
    │       │   ├── cohere.md
    │       │   ├── deepseek.md
    │       │   ├── gemini.md
    │       │   ├── groq.md
    │       │   ├── lm-studio.md
    │       │   ├── ollama.md
    │       │   ├── openai-compat.md
    │       │   ├── openai.md
    │       │   ├── openrouter.md
    │       │   ├── other.md
    │       │   ├── vertex.md
    │       │   ├── warnings.md
    │       │   └── xai.md
    │       ├── more-info.md
    │       ├── more
    │       │   ├── analytics.md
    │       │   ├── edit-formats.md
    │       │   └── infinite-output.md
    │       ├── repomap.md
    │       ├── scripting.md
    │       ├── troubleshooting.md
    │       ├── troubleshooting
    │       │   ├── aider-not-found.md
    │       │   ├── edit-errors.md
    │       │   ├── imports.md
    │       │   ├── models-and-keys.md
    │       │   ├── support.md
    │       │   ├── token-limits.md
    │       │   └── warnings.md
    │       ├── unified-diffs.md
    │       ├── usage.md
    │       └── usage
    │       │   ├── browser.md
    │       │   ├── caching.md
    │       │   ├── commands.md
    │       │   ├── conventions.md
    │       │   ├── copypaste.md
    │       │   ├── images-urls.md
    │       │   ├── lint-test.md
    │       │   ├── modes.md
    │       │   ├── not-code.md
    │       │   ├── notifications.md
    │       │   ├── tips.md
    │       │   ├── tutorials.md
    │       │   ├── voice.md
    │       │   └── watch.md
    │   ├── examples
    │       ├── 2048-game.md
    │       ├── README.md
    │       ├── add-test.md
    │       ├── asciinema.md
    │       ├── census.md
    │       ├── chat-transcript-css.md
    │       ├── complex-change.md
    │       ├── css-exercises.md
    │       ├── hello-world-flask.md
    │       ├── hello.md
    │       ├── no-color.md
    │       ├── pong.md
    │       ├── semantic-search-replace.md
    │       └── update-docs.md
    │   ├── index.md
    │   ├── install.ps1
    │   ├── install.sh
    │   └── share
    │       └── index.md
├── benchmark
    ├── Dockerfile
    ├── README.md
    ├── __init__.py
    ├── benchmark.py
    ├── clone-exercism.sh
    ├── cpp-test.sh
    ├── docker.sh
    ├── docker_build.sh
    ├── install-docker-ubuntu.sh
    ├── npm-test.sh
    ├── over_time.py
    ├── plot.sh
    ├── plots.py
    ├── problem_stats.py
    ├── prompts.py
    ├── refactor_tools.py
    ├── rsync.sh
    ├── rungrid.py
    ├── swe-bench-lite.txt
    ├── swe-bench.txt
    ├── swe_bench.py
    └── test_benchmark.py
├── decisions
    ├── git_backtracking_feature.md
    └── repo_map_content_filtering.md
├── docker
    └── Dockerfile
├── issues
    ├── cmd_prioritize_command.md
    ├── failed_attempts_documentation.md
    ├── git_backtracking_implementation.md
    ├── natural_language_git_commands.md
    ├── prioritize_prompt_design.md
    ├── repo_map_content_prioritization.md
    ├── repo_map_file_filtering.md
    └── repo_map_issue_summarization.md
├── personas
    ├── c_programmer.md
    ├── game_developer.md
    └── risk_management.md
├── pyproject.toml
├── pytest.ini
├── requirements.txt
├── requirements
    ├── common-constraints.txt
    ├── requirements-browser.in
    ├── requirements-browser.txt
    ├── requirements-dev.in
    ├── requirements-dev.txt
    ├── requirements-help.in
    ├── requirements-help.txt
    ├── requirements-playwright.in
    ├── requirements-playwright.txt
    ├── requirements.in
    └── tree-sitter.in
├── scripts
    ├── Dockerfile.jekyll
    ├── __init__.py
    ├── blame.py
    ├── history_prompts.py
    ├── issues.py
    ├── jekyll_build.sh
    ├── jekyll_run.sh
    ├── my_models.py
    ├── pip-compile.sh
    ├── update-blame.sh
    ├── update-docs.sh
    ├── update-history.py
    ├── versionbump.py
    └── yank-old-versions.py
└── tests
    ├── __init__.py
    ├── basic
        ├── test_analytics.py
        ├── test_coder.py
        ├── test_commands.py
        ├── test_deprecated.py
        ├── test_editblock.py
        ├── test_editor.py
        ├── test_exceptions.py
        ├── test_find_or_blocks.py
        ├── test_history.py
        ├── test_io.py
        ├── test_linter.py
        ├── test_main.py
        ├── test_model_info_manager.py
        ├── test_models.py
        ├── test_reasoning.py
        ├── test_repo.py
        ├── test_repomap.py
        ├── test_run_cmd.py
        ├── test_sanity_check_repo.py
        ├── test_scripting.py
        ├── test_sendchat.py
        ├── test_special.py
        ├── test_ssl_verification.py
        ├── test_udiff.py
        ├── test_urls.py
        ├── test_voice.py
        ├── test_watch.py
        └── test_wholefile.py
    ├── browser
        └── test_browser.py
    ├── fixtures
        ├── chat-history-search-replace-gold.txt
        ├── chat-history.md
        ├── languages
        │   ├── c
        │   │   └── test.c
        │   ├── cpp
        │   │   └── test.cpp
        │   ├── csharp
        │   │   └── test.cs
        │   ├── elisp
        │   │   └── test.el
        │   ├── elixir
        │   │   └── test.ex
        │   ├── elm
        │   │   └── test.elm
        │   ├── go
        │   │   └── test.go
        │   ├── hcl
        │   │   └── test.tf
        │   ├── java
        │   │   └── test.java
        │   ├── javascript
        │   │   └── test.js
        │   ├── kotlin
        │   │   └── test.kt
        │   ├── ocaml
        │   │   └── test.ml
        │   ├── php
        │   │   └── test.php
        │   ├── python
        │   │   └── test.py
        │   ├── ql
        │   │   └── test.ql
        │   ├── ruby
        │   │   └── test.rb
        │   ├── rust
        │   │   └── test.rs
        │   ├── tsx
        │   │   └── test.tsx
        │   └── typescript
        │   │   └── test.ts
        ├── sample-code-base-repo-map.txt
        ├── sample-code-base
        │   ├── sample.js
        │   └── sample.py
        ├── watch.js
        ├── watch.py
        └── watch_question.js
    ├── help
        └── test_help.py
    └── scrape
        └── test_scrape.py


/.dockerignore:
--------------------------------------------------------------------------------
 1 | .BC.*
 2 | tmp*
 3 | *~
 4 | OLD*
 5 | *.pyc
 6 | .DS_Store
 7 | .env
 8 | .venv
 9 | .aider.*
10 | build
11 | 


--------------------------------------------------------------------------------
/.flake8:
--------------------------------------------------------------------------------
1 | [flake8]
2 | ignore = E203,W503
3 | max-line-length = 100
4 | 


--------------------------------------------------------------------------------
/.github/ISSUE_TEMPLATE/issue.yml:
--------------------------------------------------------------------------------
 1 | name: Question or bug report
 2 | description: Submit a question or bug report to help us improve aider
 3 | labels: []
 4 | body:
 5 |   - type: textarea
 6 |     attributes:
 7 |       label: Issue
 8 |       description: Please describe your problem or question.
 9 |     validations:
10 |       required: true      
11 |   - type: textarea
12 |     attributes:
13 |       label: Version and model info
14 |       description: Please include aider version, model being used (`gpt-4-xxx`, etc) and any other switches or config settings that are active.
15 |       placeholder: |          
16 |         Aider v0.XX.Y
17 |         Model: gpt-N-... using ???? edit format
18 |         Git repo: .git with ### files
19 |         Repo-map: using #### tokens
20 |     validations:
21 |       required: false


--------------------------------------------------------------------------------
/.github/workflows/docker-release.yml:
--------------------------------------------------------------------------------
 1 | name: Docker Release
 2 | 
 3 | on:
 4 |   workflow_dispatch:
 5 |   push:
 6 |     tags:
 7 |       - 'v[0-9]+.[0-9]+.[0-9]+'
 8 | 
 9 | jobs:
10 |   docker_build_and_push:
11 |     runs-on: ubuntu-latest
12 |     steps:
13 |     - name: Checkout code
14 |       uses: actions/checkout@v4
15 |       with:
16 |         fetch-depth: 0
17 | 
18 |     - name: Set up QEMU
19 |       uses: docker/setup-qemu-action@v3
20 | 
21 |     - name: Set up Docker Buildx
22 |       uses: docker/setup-buildx-action@v3
23 | 
24 |     - name: Login to DockerHub
25 |       uses: docker/login-action@v3
26 |       with:
27 |         username: ${{ secrets.DOCKERHUB_USERNAME }}
28 |         password: ${{ secrets.DOCKERHUB_PASSWORD }}
29 | 
30 |     - name: Build and push Docker images
31 |       uses: docker/build-push-action@v5
32 |       with:
33 |         context: .
34 |         file: ./docker/Dockerfile
35 |         platforms: linux/amd64,linux/arm64
36 |         push: true
37 |         tags: |
38 |           ${{ secrets.DOCKERHUB_USERNAME }}/aider:${{ github.ref_name }}
39 |           ${{ secrets.DOCKERHUB_USERNAME }}/aider:latest
40 |         target: aider
41 | 
42 |     - name: Build and push Docker full image
43 |       uses: docker/build-push-action@v5
44 |       with:
45 |         context: .
46 |         file: ./docker/Dockerfile
47 |         platforms: linux/amd64,linux/arm64
48 |         push: true
49 |         tags: |
50 |           ${{ secrets.DOCKERHUB_USERNAME }}/aider-full:${{ github.ref_name }}
51 |           ${{ secrets.DOCKERHUB_USERNAME }}/aider-full:latest
52 |         target: aider-full
53 | 


--------------------------------------------------------------------------------
/.github/workflows/issues.yml:
--------------------------------------------------------------------------------
 1 | name: Process GitHub Issues
 2 | on:
 3 |   schedule:
 4 |     - cron: '0 */12 * * *'  # Run every 12 hours
 5 |   workflow_dispatch:  # Allow manual triggers
 6 | 
 7 | jobs:
 8 |   process-issues:
 9 |     runs-on: ubuntu-latest
10 |     permissions:
11 |       issues: write  # Required to modify issues
12 |     
13 |     steps:
14 |       - uses: actions/checkout@v3
15 |       
16 |       - name: Set up Python
17 |         uses: actions/setup-python@v4
18 |         with:
19 |           python-version: '3.x'
20 |           
21 |       - name: Install dependencies
22 |         run: |
23 |           python -m pip install --upgrade pip
24 |           pip install requests python-dotenv tqdm
25 |           
26 |       - name: Run issues script
27 |         env:
28 |           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
29 |         run: python scripts/issues.py --yes
30 | 


--------------------------------------------------------------------------------
/.github/workflows/release.yml:
--------------------------------------------------------------------------------
 1 | name: PyPI Release
 2 | 
 3 | on:
 4 |   workflow_dispatch:
 5 |   push:
 6 |     tags:
 7 |       - 'v[0-9]+.[0-9]+.[0-9]+'
 8 | 
 9 | jobs:
10 |   build_and_publish:
11 |     runs-on: ubuntu-latest
12 |     steps:
13 |     - name: Checkout code
14 |       uses: actions/checkout@v4
15 |       with:
16 |         fetch-depth: 0
17 | 
18 |     - name: Set up Python
19 |       uses: actions/setup-python@v5
20 |       with:
21 |         python-version: 3.x
22 | 
23 |     - name: Install dependencies
24 |       run: |
25 |         python -m pip install --upgrade pip
26 |         pip install build setuptools wheel twine importlib-metadata==7.2.1
27 | 
28 |     - name: Build and publish
29 |       env:
30 |         TWINE_USERNAME: __token__
31 |         TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
32 |       run: |
33 |         python -m build
34 |         twine upload dist/*
35 | 


--------------------------------------------------------------------------------
/.github/workflows/ubuntu-tests.yml:
--------------------------------------------------------------------------------
 1 | name: Ubuntu Python Tests
 2 | 
 3 | on:
 4 |   push:
 5 |     paths-ignore:
 6 |       - 'aider/website/**'
 7 |       - 'README.md'
 8 |       - 'HISTORY.md'
 9 |       - '.github/workflows/*'
10 |       - '!.github/workflows/ubuntu-tests.yml'
11 |     branches:
12 |       - main
13 |   pull_request:
14 |     paths-ignore:
15 |       - 'aider/website/**'
16 |       - 'README.md'
17 |       - 'HISTORY.md'
18 |       - '.github/workflows/*'
19 |       - '!.github/workflows/ubuntu-tests.yml'
20 |     branches:
21 |       - main
22 | 
23 | jobs:
24 |   build:
25 |     runs-on: ubuntu-latest
26 |     strategy:
27 |       matrix:
28 |         python-version: ["3.9", "3.10", "3.11", "3.12"]
29 | 
30 |     steps:
31 |     - name: Check out repository
32 |       uses: actions/checkout@v4
33 |       with:
34 |         fetch-depth: 0
35 | 
36 |     - name: Set up Python ${{ matrix.python-version }}
37 |       uses: actions/setup-python@v5
38 |       with:
39 |         python-version: ${{ matrix.python-version }}
40 | 
41 |     - name: Install system dependencies
42 |       run: |
43 |         sudo apt-get update
44 |         sudo apt-get install -y libportaudio2
45 | 
46 |     - name: Install dependencies
47 |       run: |
48 |         python -m pip install --upgrade pip
49 |         pip install pytest
50 |         pip install .
51 | 
52 |     - name: Run tests
53 |       env:
54 |         AIDER_ANALYTICS: false
55 |       run: |
56 |         pytest
57 | 


--------------------------------------------------------------------------------
/.github/workflows/windows-tests.yml:
--------------------------------------------------------------------------------
 1 | name: Windows Python Tests
 2 | 
 3 | on:
 4 |   push:
 5 |     paths-ignore:
 6 |       - 'aider/website/**'
 7 |       - 'README.md'
 8 |       - 'HISTORY.md'
 9 |       - '.github/workflows/*'
10 |       - '!.github/workflows/windows-tests.yml'
11 |     branches:
12 |       - main
13 |   pull_request:
14 |     paths-ignore:
15 |       - 'aider/website/**'
16 |       - 'README.md'
17 |       - 'HISTORY.md'
18 |       - '.github/workflows/*'
19 |       - '!.github/workflows/windows-tests.yml'
20 |     branches:
21 |       - main
22 | 
23 | jobs:
24 |   build:
25 |     runs-on: windows-latest
26 |     strategy:
27 |       matrix:
28 |         python-version: ["3.9", "3.10", "3.11", "3.12"]
29 | 
30 |     steps:
31 |     - name: Check out repository
32 |       uses: actions/checkout@v4
33 |       with:
34 |         fetch-depth: 0
35 | 
36 |     - name: Set up Python ${{ matrix.python-version }}
37 |       uses: actions/setup-python@v5
38 |       with:
39 |         python-version: ${{ matrix.python-version }}
40 | 
41 |     - name: Install dependencies
42 |       run: |
43 |         python -m pip install --upgrade pip
44 |         pip install pytest
45 |         pip install .
46 | 
47 |     - name: Run tests
48 |       env:
49 |         AIDER_ANALYTICS: false
50 |       run: |
51 |         pytest
52 |         
53 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
 1 | .DS_Store
 2 | .vscode/
 3 | aider.code-workspace
 4 | *.pyc
 5 | .aider*
 6 | aider_chat.egg-info/
 7 | build
 8 | dist/
 9 | Gemfile.lock
10 | _site
11 | .jekyll-cache/
12 | .jekyll-metadata
13 | aider/__version__.py
14 | aider/_version.py
15 | aider_advanced/__version__.py
16 | aider_advanced/_version.py
17 | .venv/
18 | .#*
19 | .gitattributes
20 | tmp.benchmarks/
21 | 
22 | aider_advanced.egg-info/
23 | 
24 | .idea/*
25 | 


--------------------------------------------------------------------------------
/.pre-commit-config.yaml:
--------------------------------------------------------------------------------
 1 | repos:
 2 |   - repo: https://github.com/PyCQA/isort
 3 |     rev: 5.12.0
 4 |     hooks:
 5 |       - id: isort
 6 |         args: ["--profile", "black"]
 7 |   - repo: https://github.com/psf/black
 8 |     rev: 23.3.0
 9 |     hooks:
10 |       - id: black
11 |         args: ["--line-length", "100", "--preview"]
12 |   - repo: https://github.com/pycqa/flake8
13 |     rev: 7.1.0
14 |     hooks:
15 |       - id: flake8
16 |         args: ["--show-source"]
17 |   - repo: https://github.com/codespell-project/codespell
18 |     rev: v2.2.6
19 |     hooks:
20 |       - id: codespell
21 |         additional_dependencies:
22 |           - tomli
23 | 


--------------------------------------------------------------------------------
/CNAME:
--------------------------------------------------------------------------------
1 | aider.chat


--------------------------------------------------------------------------------
/MANIFEST.in:
--------------------------------------------------------------------------------
 1 | # This needs to sync with aider/help_pats.py
 2 | 
 3 | global-exclude .DS_Store
 4 | 
 5 | recursive-exclude aider/website/examples *
 6 | recursive-exclude aider/website/_posts *
 7 | 
 8 | exclude aider/website/HISTORY.md
 9 | exclude aider/website/docs/benchmarks*.md
10 | exclude aider/website/docs/ctags.md
11 | exclude aider/website/docs/unified-diffs.md
12 | 
13 | exclude aider/website/install.ps1
14 | exclude aider/website/install.sh
15 | 
16 | recursive-exclude aider/website/docs/leaderboards *
17 | recursive-exclude aider/website/assets *
18 | recursive-exclude aider/website *.js
19 | recursive-exclude aider/website *.html
20 | recursive-exclude aider/website *.yml
21 | 


--------------------------------------------------------------------------------
/aider/__init__.py:
--------------------------------------------------------------------------------
 1 | from packaging import version
 2 | 
 3 | __version__ = "0.76.3.dev"
 4 | safe_version = __version__
 5 | 
 6 | try:
 7 |     from aider._version import __version__
 8 | except Exception:
 9 |     __version__ = safe_version + "+import"
10 | 
11 | if type(__version__) is not str:
12 |     __version__ = safe_version + "+type"
13 | else:
14 |     try:
15 |         if version.parse(__version__) < version.parse(safe_version):
16 |             __version__ = safe_version + "+less"
17 |     except Exception:
18 |         __version__ = safe_version + "+parse"
19 | 
20 | __all__ = [__version__]
21 | 


--------------------------------------------------------------------------------
/aider/__main__.py:
--------------------------------------------------------------------------------
1 | from .main import main
2 | 
3 | if __name__ == "__main__":
4 |     main()
5 | 


--------------------------------------------------------------------------------
/aider/coders/__init__.py:
--------------------------------------------------------------------------------
 1 | from .architect_coder import ArchitectCoder
 2 | from .ask_coder import AskCoder
 3 | from .base_coder import Coder
 4 | from .document_coder import DocumentCoder
 5 | from .editblock_coder import EditBlockCoder
 6 | from .editblock_fenced_coder import EditBlockFencedCoder
 7 | from .editor_editblock_coder import EditorEditBlockCoder
 8 | from .editor_whole_coder import EditorWholeFileCoder
 9 | from .help_coder import HelpCoder
10 | from .planning_coder import PlanningCoder
11 | from .udiff_coder import UnifiedDiffCoder
12 | from .wholefile_coder import WholeFileCoder
13 | 
14 | # from .single_wholefile_func_coder import SingleWholeFileFunctionCoder
15 | 
16 | __all__ = [
17 |     HelpCoder,
18 |     AskCoder,
19 |     Coder,
20 |     EditBlockCoder,
21 |     EditBlockFencedCoder,
22 |     DocumentCoder,
23 |     PlanningCoder,
24 |     WholeFileCoder,
25 |     UnifiedDiffCoder,
26 |     #    SingleWholeFileFunctionCoder,
27 |     ArchitectCoder,
28 |     EditorEditBlockCoder,
29 |     EditorWholeFileCoder,
30 | ]
31 | 


--------------------------------------------------------------------------------
/aider/coders/architect_coder.py:
--------------------------------------------------------------------------------
 1 | from .architect_prompts import ArchitectPrompts
 2 | from .ask_coder import AskCoder
 3 | from .base_coder import Coder
 4 | 
 5 | 
 6 | class ArchitectCoder(AskCoder):
 7 |     edit_format = "architect"
 8 |     gpt_prompts = ArchitectPrompts()
 9 | 
10 |     def reply_completed(self):
11 |         content = self.partial_response_content
12 | 
13 |         if not content or not content.strip():
14 |             return
15 | 
16 |         if not self.io.confirm_ask("Edit the files?"):
17 |             return
18 | 
19 |         kwargs = dict()
20 | 
21 |         # Use the editor_model from the main_model if it exists, otherwise use the main_model itself
22 |         editor_model = self.main_model.editor_model or self.main_model
23 | 
24 |         kwargs["main_model"] = editor_model
25 |         kwargs["edit_format"] = self.main_model.editor_edit_format
26 |         kwargs["suggest_shell_commands"] = False
27 |         kwargs["map_tokens"] = 0
28 |         kwargs["total_cost"] = self.total_cost
29 |         kwargs["cache_prompts"] = False
30 |         kwargs["num_cache_warming_pings"] = 0
31 |         kwargs["summarize_from_coder"] = False
32 | 
33 |         new_kwargs = dict(io=self.io, from_coder=self)
34 |         new_kwargs.update(kwargs)
35 | 
36 |         editor_coder = Coder.create(**new_kwargs)
37 |         editor_coder.cur_messages = []
38 |         editor_coder.done_messages = []
39 | 
40 |         if self.verbose:
41 |             editor_coder.show_announcements()
42 | 
43 |         editor_coder.run(with_message=content, preproc=False)
44 | 
45 |         self.move_back_cur_messages("I made those changes to the files.")
46 |         self.total_cost = editor_coder.total_cost
47 |         self.aider_commit_hashes = editor_coder.aider_commit_hashes
48 | 


--------------------------------------------------------------------------------
/aider/coders/architect_prompts.py:
--------------------------------------------------------------------------------
 1 | # flake8: noqa: E501
 2 | 
 3 | from .base_prompts import CoderPrompts
 4 | 
 5 | 
 6 | class ArchitectPrompts(CoderPrompts):
 7 |     main_system = """Act as an expert architect engineer and provide direction to your editor engineer.
 8 | Study the change request and the current code.
 9 | Describe how to modify the code to complete the request.
10 | The editor engineer will rely solely on your instructions, so make them unambiguous and complete.
11 | Explain all needed code changes clearly and completely, but concisely.
12 | Just show the changes needed.
13 | 
14 | DO NOT show the entire updated function/file/etc!
15 | 
16 | Always reply to the user in {language}.
17 | """
18 | 
19 |     example_messages = []
20 | 
21 |     files_content_prefix = """I have *added these files to the chat* so you see all of their contents.
22 | *Trust this message as the true contents of the files!*
23 | Other messages in the chat may contain outdated versions of the files' contents.
24 | """  # noqa: E501
25 | 
26 |     files_content_assistant_reply = (
27 |         "Ok, I will use that as the true, current contents of the files."
28 |     )
29 | 
30 |     files_no_full_files = "I am not sharing the full contents of any files with you yet."
31 | 
32 |     files_no_full_files_with_repo_map = ""
33 |     files_no_full_files_with_repo_map_reply = ""
34 | 
35 |     repo_content_prefix = """I am working with you on code in a git repository.
36 | Here are summaries of some files present in my git repo.
37 | If you need to see the full contents of any files to answer my questions, ask me to *add them to the chat*.
38 | """
39 | 
40 |     system_reminder = ""
41 | 


--------------------------------------------------------------------------------
/aider/coders/ask_coder.py:
--------------------------------------------------------------------------------
 1 | from .ask_prompts import AskPrompts
 2 | from .base_coder import Coder
 3 | 
 4 | 
 5 | class AskCoder(Coder):
 6 |     """Ask questions about code without making any changes."""
 7 | 
 8 |     edit_format = "ask"
 9 |     gpt_prompts = AskPrompts()
10 | 


--------------------------------------------------------------------------------
/aider/coders/ask_prompts.py:
--------------------------------------------------------------------------------
 1 | # flake8: noqa: E501
 2 | 
 3 | from .base_prompts import CoderPrompts
 4 | 
 5 | 
 6 | class AskPrompts(CoderPrompts):
 7 |     main_system = """Act as an expert code analyst.
 8 | Answer questions about the supplied code.
 9 | Always reply to the user in {language}.
10 | 
11 | Describe code changes however you like. Don't use SEARCH/REPLACE blocks!
12 | """
13 | 
14 |     example_messages = []
15 | 
16 |     files_content_prefix = """I have *added these files to the chat* so you see all of their contents.
17 | *Trust this message as the true contents of the files!*
18 | Other messages in the chat may contain outdated versions of the files' contents.
19 | """  # noqa: E501
20 | 
21 |     files_content_assistant_reply = (
22 |         "Ok, I will use that as the true, current contents of the files."
23 |     )
24 | 
25 |     files_no_full_files = "I am not sharing the full contents of any files with you yet."
26 | 
27 |     files_no_full_files_with_repo_map = ""
28 |     files_no_full_files_with_repo_map_reply = ""
29 | 
30 |     repo_content_prefix = """I am working with you on code in a git repository.
31 | Here are summaries of some files present in my git repo.
32 | If you need to see the full contents of any files to answer my questions, ask me to *add them to the chat*.
33 | """
34 | 
35 |     system_reminder = ""
36 | 


--------------------------------------------------------------------------------
/aider/coders/base_prompts.py:
--------------------------------------------------------------------------------
 1 | class CoderPrompts:
 2 |     system_reminder = ""
 3 | 
 4 |     files_content_gpt_edits = "I committed the changes with git hash {hash} & commit msg: {message}"
 5 | 
 6 |     files_content_gpt_edits_no_repo = "I updated the files."
 7 | 
 8 |     files_content_gpt_no_edits = "I didn't see any properly formatted edits in your reply?!"
 9 | 
10 |     files_content_local_edits = "I edited the files myself."
11 | 
12 |     lazy_prompt = """You are diligent and tireless!
13 | You NEVER leave comments describing code without implementing it!
14 | You always COMPLETELY IMPLEMENT the needed code!
15 | """
16 | 
17 |     example_messages = []
18 | 
19 |     files_content_prefix = """I have *added these files to the chat* so you can go ahead and edit them.
20 | 
21 | *Trust this message as the true contents of these files!*
22 | Any other messages in the chat may contain outdated versions of the files' contents.
23 | """  # noqa: E501
24 | 
25 |     files_content_assistant_reply = "Ok, any changes I propose will be to those files."
26 | 
27 |     files_no_full_files = "I am not sharing any files that you can edit yet."
28 | 
29 |     files_no_full_files_with_repo_map = """Don't try and edit any existing code without asking me to add the files to the chat!
30 | Tell me which files in my repo are the most likely to **need changes** to solve the requests I make, and then stop so I can add them to the chat.
31 | Only include the files that are most likely to actually need to be edited.
32 | Don't include files that might contain relevant context, just files that will need to be changed.
33 | """  # noqa: E501
34 | 
35 |     files_no_full_files_with_repo_map_reply = (
36 |         "Ok, based on your requests I will suggest which files need to be edited and then"
37 |         " stop and wait for your approval."
38 |     )
39 | 
40 |     repo_content_prefix = """Here are summaries of some files present in my git repository.
41 | Do not propose changes to these files, treat them as *read-only*.
42 | If you need to edit any of these files, ask me to *add them to the chat* first.
43 | """
44 | 
45 |     read_only_files_prefix = """Here are some READ ONLY files, provided for your reference.
46 | Do not edit these files!
47 | """
48 | 
49 |     shell_cmd_prompt = ""
50 |     shell_cmd_reminder = ""
51 |     no_shell_cmd_prompt = ""
52 |     no_shell_cmd_reminder = ""
53 | 


--------------------------------------------------------------------------------
/aider/coders/chat_chunks.py:
--------------------------------------------------------------------------------
 1 | from dataclasses import dataclass, field
 2 | from typing import List
 3 | 
 4 | 
 5 | @dataclass
 6 | class ChatChunks:
 7 |     system: List = field(default_factory=list)
 8 |     examples: List = field(default_factory=list)
 9 |     done: List = field(default_factory=list)
10 |     repo: List = field(default_factory=list)
11 |     readonly_files: List = field(default_factory=list)
12 |     chat_files: List = field(default_factory=list)
13 |     cur: List = field(default_factory=list)
14 |     reminder: List = field(default_factory=list)
15 | 
16 |     def all_messages(self):
17 |         return (
18 |             self.system
19 |             + self.examples
20 |             + self.readonly_files
21 |             + self.repo
22 |             + self.done
23 |             + self.chat_files
24 |             + self.cur
25 |             + self.reminder
26 |         )
27 | 
28 |     def add_cache_control_headers(self):
29 |         if self.examples:
30 |             self.add_cache_control(self.examples)
31 |         else:
32 |             self.add_cache_control(self.system)
33 | 
34 |         if self.repo:
35 |             # this will mark both the readonly_files and repomap chunk as cacheable
36 |             self.add_cache_control(self.repo)
37 |         else:
38 |             # otherwise, just cache readonly_files if there are any
39 |             self.add_cache_control(self.readonly_files)
40 | 
41 |         self.add_cache_control(self.chat_files)
42 | 
43 |     def add_cache_control(self, messages):
44 |         if not messages:
45 |             return
46 | 
47 |         content = messages[-1]["content"]
48 |         if type(content) is str:
49 |             content = dict(
50 |                 type="text",
51 |                 text=content,
52 |             )
53 |         content["cache_control"] = {"type": "ephemeral"}
54 | 
55 |         messages[-1]["content"] = [content]
56 | 
57 |     def cacheable_messages(self):
58 |         messages = self.all_messages()
59 |         for i, message in enumerate(reversed(messages)):
60 |             if isinstance(message.get("content"), list) and message["content"][0].get(
61 |                 "cache_control"
62 |             ):
63 |                 return messages[: len(messages) - i]
64 |         return messages
65 | 


--------------------------------------------------------------------------------
/aider/coders/document_coder.py:
--------------------------------------------------------------------------------
 1 | from .document_prompts import DocumentPrompts
 2 | from .editblock_coder import EditBlockCoder
 3 | 
 4 | 
 5 | class DocumentCoder(EditBlockCoder):
 6 |     """A coder that specializes in writing and improving documentation."""
 7 | 
 8 |     edit_format = "document"
 9 |     gpt_prompts = DocumentPrompts()
10 | 
11 |     def __init__(self, *args, **kwargs):
12 |         super().__init__(*args, **kwargs)
13 | 


--------------------------------------------------------------------------------
/aider/coders/editblock_fenced_coder.py:
--------------------------------------------------------------------------------
 1 | from ..dump import dump  # noqa: F401
 2 | from .editblock_coder import EditBlockCoder
 3 | from .editblock_fenced_prompts import EditBlockFencedPrompts
 4 | 
 5 | 
 6 | class EditBlockFencedCoder(EditBlockCoder):
 7 |     """A coder that uses fenced search/replace blocks for code modifications."""
 8 |     edit_format = "diff-fenced"
 9 |     gpt_prompts = EditBlockFencedPrompts()
10 | 


--------------------------------------------------------------------------------
/aider/coders/editblock_fenced_prompts.py:
--------------------------------------------------------------------------------
 1 | # flake8: noqa: E501
 2 | 
 3 | from .editblock_prompts import EditBlockPrompts
 4 | 
 5 | 
 6 | class EditBlockFencedPrompts(EditBlockPrompts):
 7 |     example_messages = [
 8 |         dict(
 9 |             role="user",
10 |             content="Change get_factorial() to use math.factorial",
11 |         ),
12 |         dict(
13 |             role="assistant",
14 |             content="""To make this change we need to modify `mathweb/flask/app.py` to:
15 | 
16 | 1. Import the math package.
17 | 2. Remove the existing factorial() function.
18 | 3. Update get_factorial() to call math.factorial instead.
19 | 
20 | Here are the *SEARCH/REPLACE* blocks:
21 | 
22 | {fence[0]}
23 | mathweb/flask/app.py
24 | <<<<<<< SEARCH
25 | from flask import Flask
26 | =======
27 | import math
28 | from flask import Flask
29 | >>>>>>> REPLACE
30 | {fence[1]}
31 | 
32 | {fence[0]}
33 | mathweb/flask/app.py
34 | <<<<<<< SEARCH
35 | def factorial(n):
36 |     "compute factorial"
37 | 
38 |     if n == 0:
39 |         return 1
40 |     else:
41 |         return n * factorial(n-1)
42 | 
43 | =======
44 | >>>>>>> REPLACE
45 | {fence[1]}
46 | 
47 | {fence[0]}
48 | mathweb/flask/app.py
49 | <<<<<<< SEARCH
50 |     return str(factorial(n))
51 | =======
52 |     return str(math.factorial(n))
53 | >>>>>>> REPLACE
54 | {fence[1]}
55 | <<<<<<< HEAD
56 | """,
57 |         ),
58 |         dict(
59 |             role="user",
60 |             content="Refactor hello() into its own file.",
61 |         ),
62 |         dict(
63 |             role="assistant",
64 |             content="""To make this change we need to modify `main.py` and make a new file `hello.py`:
65 | 
66 | 1. Make a new hello.py file with hello() in it.
67 | 2. Remove hello() from main.py and replace it with an import.
68 | 
69 | Here are the *SEARCH/REPLACE* blocks:
70 | 
71 | {fence[0]}
72 | hello.py
73 | <<<<<<< SEARCH
74 | =======
75 | def hello():
76 |     "print a greeting"
77 | 
78 |     print("hello")
79 | >>>>>>> REPLACE
80 | {fence[1]}
81 | 
82 | {fence[0]}
83 | main.py
84 | <<<<<<< SEARCH
85 | def hello():
86 |     "print a greeting"
87 | 
88 |     print("hello")
89 | =======
90 | from hello import hello
91 | >>>>>>> REPLACE
92 | {fence[1]}
93 | """,
94 |         ),
95 |     ]
96 | 


--------------------------------------------------------------------------------
/aider/coders/editblock_func_prompts.py:
--------------------------------------------------------------------------------
 1 | # flake8: noqa: E501
 2 | 
 3 | from .base_prompts import CoderPrompts
 4 | 
 5 | 
 6 | class EditBlockFunctionPrompts(CoderPrompts):
 7 |     main_system = """Act as an expert software developer.
 8 | Take requests for changes to the supplied code.
 9 | If the request is ambiguous, ask questions.
10 | 
11 | Once you understand the request you MUST use the `replace_lines` function to edit the files to make the needed changes.
12 | """
13 | 
14 |     system_reminder = """
15 | ONLY return code using the `replace_lines` function.
16 | NEVER return code outside the `replace_lines` function.
17 | """
18 | 
19 |     files_content_prefix = "Here is the current content of the files:\n"
20 |     files_no_full_files = "I am not sharing any files yet."
21 | 
22 |     redacted_edit_message = "No changes are needed."
23 | 
24 |     repo_content_prefix = (
25 |         "Below here are summaries of other files! Do not propose changes to these *read-only*"
26 |         " files without asking me first.\n"
27 |     )
28 | 


--------------------------------------------------------------------------------
/aider/coders/editor_editblock_coder.py:
--------------------------------------------------------------------------------
1 | from .editblock_coder import EditBlockCoder
2 | from .editor_editblock_prompts import EditorEditBlockPrompts
3 | 
4 | 
5 | class EditorEditBlockCoder(EditBlockCoder):
6 |     "A coder that uses search/replace blocks, focused purely on editing files."
7 |     edit_format = "editor-diff"
8 |     gpt_prompts = EditorEditBlockPrompts()
9 | 


--------------------------------------------------------------------------------
/aider/coders/editor_editblock_prompts.py:
--------------------------------------------------------------------------------
 1 | # flake8: noqa: E501
 2 | 
 3 | from .editblock_prompts import EditBlockPrompts
 4 | 
 5 | 
 6 | class EditorEditBlockPrompts(EditBlockPrompts):
 7 |     main_system = """Act as an expert software developer who edits source code.
 8 | {lazy_prompt}
 9 | Describe each change with a *SEARCH/REPLACE block* per the examples below.
10 | All changes to files must use this *SEARCH/REPLACE block* format.
11 | ONLY EVER RETURN CODE IN A *SEARCH/REPLACE BLOCK*!
12 | """
13 | 
14 |     shell_cmd_prompt = ""
15 |     no_shell_cmd_prompt = ""
16 |     shell_cmd_reminder = ""
17 | 


--------------------------------------------------------------------------------
/aider/coders/editor_whole_coder.py:
--------------------------------------------------------------------------------
1 | from .editor_whole_prompts import EditorWholeFilePrompts
2 | from .wholefile_coder import WholeFileCoder
3 | 
4 | 
5 | class EditorWholeFileCoder(WholeFileCoder):
6 |     "A coder that operates on entire files, focused purely on editing files."
7 |     edit_format = "editor-whole"
8 |     gpt_prompts = EditorWholeFilePrompts()
9 | 


--------------------------------------------------------------------------------
/aider/coders/editor_whole_prompts.py:
--------------------------------------------------------------------------------
 1 | # flake8: noqa: E501
 2 | 
 3 | from .wholefile_prompts import WholeFilePrompts
 4 | 
 5 | 
 6 | class EditorWholeFilePrompts(WholeFilePrompts):
 7 |     main_system = """Act as an expert software developer and make changes to source code.
 8 | {lazy_prompt}
 9 | Output a copy of each file that needs changes.
10 | """
11 | 


--------------------------------------------------------------------------------
/aider/coders/help_coder.py:
--------------------------------------------------------------------------------
 1 | from ..dump import dump  # noqa: F401
 2 | from .base_coder import Coder
 3 | from .help_prompts import HelpPrompts
 4 | 
 5 | 
 6 | class HelpCoder(Coder):
 7 |     """Interactive help and documentation about aider."""
 8 |     edit_format = "help"
 9 |     gpt_prompts = HelpPrompts()
10 | 
11 |     def get_edits(self, mode="update"):
12 |         return []
13 | 
14 |     def apply_edits(self, edits):
15 |         pass
16 | 


--------------------------------------------------------------------------------
/aider/coders/help_prompts.py:
--------------------------------------------------------------------------------
 1 | # flake8: noqa: E501
 2 | 
 3 | from .base_prompts import CoderPrompts
 4 | 
 5 | 
 6 | class HelpPrompts(CoderPrompts):
 7 |     main_system = """You are an expert on the AI coding tool called Aider.
 8 | Answer the user's questions about how to use aider.
 9 | 
10 | The user is currently chatting with you using aider, to write and edit code.
11 | 
12 | Use the provided aider documentation *if it is relevant to the user's question*.
13 | 
14 | Include a bulleted list of urls to the aider docs that might be relevant for the user to read.
15 | Include *bare* urls. *Do not* make [markdown links](http://...).
16 | For example:
17 | - https://aider.chat/docs/usage.html
18 | - https://aider.chat/docs/faq.html
19 | 
20 | If you don't know the answer, say so and suggest some relevant aider doc urls.
21 | 
22 | If asks for something that isn't possible with aider, be clear about that.
23 | Don't suggest a solution that isn't supported.
24 | 
25 | Be helpful but concise.
26 | 
27 | Unless the question indicates otherwise, assume the user wants to use aider as a CLI tool.
28 | 
29 | Keep this info about the user's system in mind:
30 | {platform}
31 | """
32 | 
33 |     example_messages = []
34 |     system_reminder = ""
35 | 
36 |     files_content_prefix = """These are some files we have been discussing that we may want to edit after you answer my questions:
37 | """
38 | 
39 |     files_no_full_files = "I am not sharing any files with you."
40 | 
41 |     files_no_full_files_with_repo_map = ""
42 |     files_no_full_files_with_repo_map_reply = ""
43 | 
44 |     repo_content_prefix = """Here are summaries of some files present in my git repository.
45 | We may look at these in more detail after you answer my questions.
46 | """
47 | 


--------------------------------------------------------------------------------
/aider/coders/planning_coder.py:
--------------------------------------------------------------------------------
 1 | from .editblock_coder import EditBlockCoder
 2 | from .planning_prompts import PlanningPrompts
 3 | 
 4 | 
 5 | class PlanningCoder(EditBlockCoder):
 6 |     """A coder that specializes in planning and scoping."""
 7 | 
 8 |     edit_format = "plan"
 9 |     gpt_prompts = PlanningPrompts()
10 | 
11 |     def __init__(self, *args, **kwargs):
12 |         super().__init__(*args, **kwargs)
13 | 


--------------------------------------------------------------------------------
/aider/coders/single_wholefile_func_prompts.py:
--------------------------------------------------------------------------------
 1 | # flake8: noqa: E501
 2 | 
 3 | from .base_prompts import CoderPrompts
 4 | 
 5 | 
 6 | class SingleWholeFileFunctionPrompts(CoderPrompts):
 7 |     main_system = """Act as an expert software developer.
 8 | Take requests for changes to the supplied code.
 9 | If the request is ambiguous, ask questions.
10 | 
11 | Once you understand the request you MUST use the `write_file` function to update the file to make the changes.
12 | """
13 | 
14 |     system_reminder = """
15 | ONLY return code using the `write_file` function.
16 | NEVER return code outside the `write_file` function.
17 | """
18 | 
19 |     files_content_prefix = "Here is the current content of the file:\n"
20 |     files_no_full_files = "I am not sharing any files yet."
21 | 
22 |     redacted_edit_message = "No changes are needed."
23 | 
24 |     # TODO: should this be present for using this with gpt-4?
25 |     repo_content_prefix = None
26 | 
27 |     # TODO: fix the chat history, except we can't keep the whole file
28 | 


--------------------------------------------------------------------------------
/aider/coders/wholefile_func_prompts.py:
--------------------------------------------------------------------------------
 1 | # flake8: noqa: E501
 2 | 
 3 | from .base_prompts import CoderPrompts
 4 | 
 5 | 
 6 | class WholeFileFunctionPrompts(CoderPrompts):
 7 |     main_system = """Act as an expert software developer.
 8 | Take requests for changes to the supplied code.
 9 | If the request is ambiguous, ask questions.
10 | 
11 | Once you understand the request you MUST use the `write_file` function to edit the files to make the needed changes.
12 | """
13 | 
14 |     system_reminder = """
15 | ONLY return code using the `write_file` function.
16 | NEVER return code outside the `write_file` function.
17 | """
18 | 
19 |     files_content_prefix = "Here is the current content of the files:\n"
20 |     files_no_full_files = "I am not sharing any files yet."
21 | 
22 |     redacted_edit_message = "No changes are needed."
23 | 
24 |     # TODO: should this be present for using this with gpt-4?
25 |     repo_content_prefix = None
26 | 
27 |     # TODO: fix the chat history, except we can't keep the whole file
28 | 


--------------------------------------------------------------------------------
/aider/coders/wholefile_prompts.py:
--------------------------------------------------------------------------------
 1 | # flake8: noqa: E501
 2 | 
 3 | from .base_prompts import CoderPrompts
 4 | 
 5 | 
 6 | class WholeFilePrompts(CoderPrompts):
 7 |     main_system = """Act as an expert software developer.
 8 | Take requests for changes to the supplied code.
 9 | If the request is ambiguous, ask questions.
10 | 
11 | Always reply to the user in {language}.
12 | 
13 | {lazy_prompt}
14 | Once you understand the request you MUST:
15 | 1. Determine if any code changes are needed.
16 | 2. Explain any needed changes.
17 | 3. If changes are needed, output a copy of each file that needs changes.
18 | """
19 | 
20 |     example_messages = [
21 |         dict(
22 |             role="user",
23 |             content="Change the greeting to be more casual",
24 |         ),
25 |         dict(
26 |             role="assistant",
27 |             content="""Ok, I will:
28 | 
29 | 1. Switch the greeting text from "Hello" to "Hey".
30 | 
31 | show_greeting.py
32 | {fence[0]}
33 | import sys
34 | 
35 | def greeting(name):
36 |     print(f"Hey {{name}}")
37 | 
38 | if __name__ == '__main__':
39 |     greeting(sys.argv[1])
40 | {fence[1]}
41 | """,
42 |         ),
43 |     ]
44 | 
45 |     system_reminder = """To suggest changes to a file you MUST return the entire content of the updated file.
46 | You MUST use this *file listing* format:
47 | 
48 | path/to/filename.js
49 | {fence[0]}
50 | // entire file content ...
51 | // ... goes in between
52 | {fence[1]}
53 | 
54 | Every *file listing* MUST use this format:
55 | - First line: the filename with any originally provided path; no extra markup, punctuation, comments, etc. **JUST** the filename with path.
56 | - Second line: opening {fence[0]}
57 | - ... entire content of the file ...
58 | - Final line: closing {fence[1]}
59 | 
60 | To suggest changes to a file you MUST return a *file listing* that contains the entire content of the file.
61 | *NEVER* skip, omit or elide content from a *file listing* using "..." or by adding comments like "... rest of code..."!
62 | Create a new file you MUST return a *file listing* which includes an appropriate filename, including any appropriate path.
63 | 
64 | {lazy_prompt}
65 | """
66 | 
67 |     redacted_edit_message = "No changes are needed."
68 | 


--------------------------------------------------------------------------------
/aider/copypaste.py:
--------------------------------------------------------------------------------
 1 | import threading
 2 | import time
 3 | 
 4 | import pyperclip
 5 | 
 6 | 
 7 | class ClipboardWatcher:
 8 |     """Watches clipboard for changes and updates IO placeholder"""
 9 | 
10 |     def __init__(self, io, verbose=False):
11 |         self.io = io
12 |         self.verbose = verbose
13 |         self.stop_event = None
14 |         self.watcher_thread = None
15 |         self.last_clipboard = None
16 |         self.io.clipboard_watcher = self
17 | 
18 |     def start(self):
19 |         """Start watching clipboard for changes"""
20 |         self.stop_event = threading.Event()
21 |         self.last_clipboard = pyperclip.paste()
22 | 
23 |         def watch_clipboard():
24 |             while not self.stop_event.is_set():
25 |                 try:
26 |                     current = pyperclip.paste()
27 |                     if current != self.last_clipboard:
28 |                         self.last_clipboard = current
29 |                         self.io.interrupt_input()
30 |                         self.io.placeholder = current
31 |                         if len(current.splitlines()) > 1:
32 |                             self.io.placeholder = "\n" + self.io.placeholder + "\n"
33 | 
34 |                     time.sleep(0.5)
35 |                 except Exception as e:
36 |                     if self.verbose:
37 |                         from aider.dump import dump
38 | 
39 |                         dump(f"Clipboard watcher error: {e}")
40 |                     continue
41 | 
42 |         self.watcher_thread = threading.Thread(target=watch_clipboard, daemon=True)
43 |         self.watcher_thread.start()
44 | 
45 |     def stop(self):
46 |         """Stop watching clipboard for changes"""
47 |         if self.stop_event:
48 |             self.stop_event.set()
49 |         if self.watcher_thread:
50 |             self.watcher_thread.join()
51 |             self.watcher_thread = None
52 |             self.stop_event = None
53 | 
54 | 
55 | def main():
56 |     """Example usage of the clipboard watcher"""
57 |     from aider.io import InputOutput
58 | 
59 |     io = InputOutput()
60 |     watcher = ClipboardWatcher(io, verbose=True)
61 | 
62 |     try:
63 |         watcher.start()
64 |         while True:
65 |             time.sleep(1)
66 |     except KeyboardInterrupt:
67 |         print("\nStopped watching clipboard")
68 |         watcher.stop()
69 | 
70 | 
71 | if __name__ == "__main__":
72 |     main()
73 | 


--------------------------------------------------------------------------------
/aider/dump.py:
--------------------------------------------------------------------------------
 1 | import json
 2 | import traceback
 3 | 
 4 | 
 5 | def cvt(s):
 6 |     if isinstance(s, str):
 7 |         return s
 8 |     try:
 9 |         return json.dumps(s, indent=4)
10 |     except TypeError:
11 |         return str(s)
12 | 
13 | 
14 | def dump(*vals):
15 |     # http://docs.python.org/library/traceback.html
16 |     stack = traceback.extract_stack()
17 |     vars = stack[-2][3]
18 | 
19 |     # strip away the call to dump()
20 |     vars = "(".join(vars.split("(")[1:])
21 |     vars = ")".join(vars.split(")")[:-1])
22 | 
23 |     vals = [cvt(v) for v in vals]
24 |     has_newline = sum(1 for v in vals if "\n" in v)
25 |     if has_newline:
26 |         print("%s:" % vars)
27 |         print(", ".join(vals))
28 |     else:
29 |         print("%s:" % vars, ", ".join(vals))
30 | 


--------------------------------------------------------------------------------
/aider/format_settings.py:
--------------------------------------------------------------------------------
 1 | def scrub_sensitive_info(args, text):
 2 |     # Replace sensitive information with last 4 characters
 3 |     if text and args.openai_api_key:
 4 |         last_4 = args.openai_api_key[-4:]
 5 |         text = text.replace(args.openai_api_key, f"...{last_4}")
 6 |     if text and args.anthropic_api_key:
 7 |         last_4 = args.anthropic_api_key[-4:]
 8 |         text = text.replace(args.anthropic_api_key, f"...{last_4}")
 9 |     return text
10 | 
11 | 
12 | def format_settings(parser, args):
13 |     show = scrub_sensitive_info(args, parser.format_values())
14 |     # clean up the headings for consistency w/ new lines
15 |     heading_env = "Environment Variables:"
16 |     heading_defaults = "Defaults:"
17 |     if heading_env in show:
18 |         show = show.replace(heading_env, "\n" + heading_env)
19 |         show = show.replace(heading_defaults, "\n" + heading_defaults)
20 |     show += "\n"
21 |     show += "Option settings:\n"
22 |     for arg, val in sorted(vars(args).items()):
23 |         if val:
24 |             val = scrub_sensitive_info(args, str(val))
25 |         show += f"  - {arg}: {val}\n"  # noqa: E221
26 |     return show
27 | 


--------------------------------------------------------------------------------
/aider/help_pats.py:
--------------------------------------------------------------------------------
 1 | # This needs to sync with MANIFEST.in
 2 | 
 3 | exclude_website_pats = [
 4 |     "**/.DS_Store",
 5 |     "examples/**",
 6 |     "_posts/**",
 7 |     "HISTORY.md",
 8 |     "docs/benchmarks*md",
 9 |     "docs/ctags.md",
10 |     "docs/unified-diffs.md",
11 |     "docs/leaderboards/index.md",
12 |     "assets/**",
13 | ]
14 | 


--------------------------------------------------------------------------------
/aider/llm.py:
--------------------------------------------------------------------------------
 1 | import importlib
 2 | import os
 3 | import warnings
 4 | 
 5 | from aider.dump import dump  # noqa: F401
 6 | 
 7 | warnings.filterwarnings("ignore", category=UserWarning, module="pydantic")
 8 | 
 9 | AIDER_SITE_URL = "https://aider.chat"
10 | AIDER_APP_NAME = "Aider"
11 | 
12 | os.environ["OR_SITE_URL"] = AIDER_SITE_URL
13 | os.environ["OR_APP_NAME"] = AIDER_APP_NAME
14 | os.environ["LITELLM_MODE"] = "PRODUCTION"
15 | 
16 | # `import litellm` takes 1.5 seconds, defer it!
17 | 
18 | VERBOSE = False
19 | 
20 | 
21 | class LazyLiteLLM:
22 |     _lazy_module = None
23 | 
24 |     def __getattr__(self, name):
25 |         if name == "_lazy_module":
26 |             return super()
27 |         self._load_litellm()
28 |         return getattr(self._lazy_module, name)
29 | 
30 |     def _load_litellm(self):
31 |         if self._lazy_module is not None:
32 |             return
33 | 
34 |         if VERBOSE:
35 |             print("Loading litellm...")
36 | 
37 |         self._lazy_module = importlib.import_module("litellm")
38 | 
39 |         self._lazy_module.suppress_debug_info = True
40 |         self._lazy_module.set_verbose = False
41 |         self._lazy_module.drop_params = True
42 |         self._lazy_module._logging._disable_debugging()
43 | 
44 | 
45 | litellm = LazyLiteLLM()
46 | 
47 | __all__ = [litellm]
48 | 


--------------------------------------------------------------------------------
/aider/queries/tree-sitter-language-pack/csharp-tags.scm:
--------------------------------------------------------------------------------
 1 | ; Based on https://github.com/tree-sitter/tree-sitter-c-sharp/blob/master/queries/tags.scm
 2 | ; MIT License.
 3 | 
 4 | (class_declaration name: (identifier) @name.definition.class) @definition.class
 5 | 
 6 | (class_declaration (base_list (_) @name.reference.class)) @reference.class
 7 | 
 8 | (interface_declaration name: (identifier) @name.definition.interface) @definition.interface
 9 | 
10 | (interface_declaration (base_list (_) @name.reference.interface)) @reference.interface
11 | 
12 | (method_declaration name: (identifier) @name.definition.method) @definition.method
13 | 
14 | (object_creation_expression type: (identifier) @name.reference.class) @reference.class
15 | 
16 | (type_parameter_constraints_clause (identifier) @name.reference.class) @reference.class
17 | 
18 | (type_parameter_constraint (type type: (identifier) @name.reference.class)) @reference.class
19 | 
20 | (variable_declaration type: (identifier) @name.reference.class) @reference.class
21 | 
22 | (invocation_expression function: (member_access_expression name: (identifier) @name.reference.send)) @reference.send
23 | 
24 | (namespace_declaration name: (identifier) @name.definition.module) @definition.module
25 | 
26 | (namespace_declaration name: (identifier) @name.definition.module) @module
27 | 


--------------------------------------------------------------------------------
/aider/queries/tree-sitter-languages/README.md:
--------------------------------------------------------------------------------
 1 | 
 2 | # Credits
 3 | 
 4 | Aider uses modified versions of the tags.scm files from these open source 
 5 | tree-sitter language implementations:
 6 | 
 7 | * [https://github.com/tree-sitter/tree-sitter-c](https://github.com/tree-sitter/tree-sitter-c) — licensed under the MIT License.
 8 | * [https://github.com/tree-sitter/tree-sitter-c-sharp](https://github.com/tree-sitter/tree-sitter-c-sharp) — licensed under the MIT License.
 9 | * [https://github.com/tree-sitter/tree-sitter-cpp](https://github.com/tree-sitter/tree-sitter-cpp) — licensed under the MIT License.
10 | * [https://github.com/Wilfred/tree-sitter-elisp](https://github.com/Wilfred/tree-sitter-elisp) — licensed under the MIT License.
11 | * [https://github.com/elixir-lang/tree-sitter-elixir](https://github.com/elixir-lang/tree-sitter-elixir) — licensed under the Apache License, Version 2.0.
12 | * [https://github.com/elm-tooling/tree-sitter-elm](https://github.com/elm-tooling/tree-sitter-elm) — licensed under the MIT License.
13 | * [https://github.com/tree-sitter/tree-sitter-go](https://github.com/tree-sitter/tree-sitter-go) — licensed under the MIT License.
14 | * [https://github.com/tree-sitter/tree-sitter-java](https://github.com/tree-sitter/tree-sitter-java) — licensed under the MIT License.
15 | * [https://github.com/tree-sitter/tree-sitter-javascript](https://github.com/tree-sitter/tree-sitter-javascript) — licensed under the MIT License.
16 | * [https://github.com/tree-sitter/tree-sitter-ocaml](https://github.com/tree-sitter/tree-sitter-ocaml) — licensed under the MIT License.
17 | * [https://github.com/tree-sitter/tree-sitter-php](https://github.com/tree-sitter/tree-sitter-php) — licensed under the MIT License.
18 | * [https://github.com/tree-sitter/tree-sitter-python](https://github.com/tree-sitter/tree-sitter-python) — licensed under the MIT License.
19 | * [https://github.com/tree-sitter/tree-sitter-ql](https://github.com/tree-sitter/tree-sitter-ql) — licensed under the MIT License.
20 | * [https://github.com/r-lib/tree-sitter-r](https://github.com/r-lib/tree-sitter-r) — licensed under the MIT License.
21 | * [https://github.com/tree-sitter/tree-sitter-ruby](https://github.com/tree-sitter/tree-sitter-ruby) — licensed under the MIT License.
22 | * [https://github.com/tree-sitter/tree-sitter-rust](https://github.com/tree-sitter/tree-sitter-rust) — licensed under the MIT License.
23 | * [https://github.com/tree-sitter/tree-sitter-typescript](https://github.com/tree-sitter/tree-sitter-typescript) — licensed under the MIT License.
24 | 


--------------------------------------------------------------------------------
/aider/queries/tree-sitter-languages/c-tags.scm:
--------------------------------------------------------------------------------
 1 | (struct_specifier name: (type_identifier) @name.definition.class body:(_)) @definition.class
 2 | 
 3 | (declaration type: (union_specifier name: (type_identifier) @name.definition.class)) @definition.class
 4 | 
 5 | (function_declarator declarator: (identifier) @name.definition.function) @definition.function
 6 | 
 7 | (type_definition declarator: (type_identifier) @name.definition.type) @definition.type
 8 | 
 9 | (enum_specifier name: (type_identifier) @name.definition.type) @definition.type
10 | 


--------------------------------------------------------------------------------
/aider/queries/tree-sitter-languages/c_sharp-tags.scm:
--------------------------------------------------------------------------------
 1 | (class_declaration
 2 |  name: (identifier) @name.definition.class
 3 |  ) @definition.class
 4 | 
 5 | (class_declaration
 6 |    bases: (base_list (_) @name.reference.class)
 7 |  ) @reference.class
 8 | 
 9 | (interface_declaration
10 |  name: (identifier) @name.definition.interface
11 |  ) @definition.interface
12 | 
13 | (interface_declaration
14 |  bases: (base_list (_) @name.reference.interface)
15 |  ) @reference.interface
16 | 
17 | (method_declaration
18 |  name: (identifier) @name.definition.method
19 |  ) @definition.method
20 | 
21 | (object_creation_expression
22 |  type: (identifier) @name.reference.class
23 |  ) @reference.class
24 | 
25 | (type_parameter_constraints_clause
26 |  target: (identifier) @name.reference.class
27 |  ) @reference.class
28 | 
29 | (type_constraint
30 |  type: (identifier) @name.reference.class
31 |  ) @reference.class
32 | 
33 | (variable_declaration
34 |  type: (identifier) @name.reference.class
35 |  ) @reference.class
36 | 
37 | (invocation_expression
38 |  function:
39 |   (member_access_expression
40 |     name: (identifier) @name.reference.send
41 |  )
42 | ) @reference.send
43 | 
44 | (namespace_declaration
45 |  name: (identifier) @name.definition.module
46 | ) @definition.module
47 | 


--------------------------------------------------------------------------------
/aider/queries/tree-sitter-languages/cpp-tags.scm:
--------------------------------------------------------------------------------
 1 | (struct_specifier name: (type_identifier) @name.definition.class body:(_)) @definition.class
 2 | 
 3 | (declaration type: (union_specifier name: (type_identifier) @name.definition.class)) @definition.class
 4 | 
 5 | (function_declarator declarator: (identifier) @name.definition.function) @definition.function
 6 | 
 7 | (function_declarator declarator: (field_identifier) @name.definition.function) @definition.function
 8 | 
 9 | (function_declarator declarator: (qualified_identifier scope: (namespace_identifier) @scope name: (identifier) @name.definition.method)) @definition.method
10 | 
11 | (type_definition declarator: (type_identifier) @name.definition.type) @definition.type
12 | 
13 | (enum_specifier name: (type_identifier) @name.definition.type) @definition.type
14 | 
15 | (class_specifier name: (type_identifier) @name.definition.class) @definition.class
16 | 


--------------------------------------------------------------------------------
/aider/queries/tree-sitter-languages/elisp-tags.scm:
--------------------------------------------------------------------------------
1 | ;; defun/defsubst
2 | (function_definition name: (symbol) @name.definition.function) @definition.function
3 | 
4 | ;; Treat macros as function definitions for the sake of TAGS.
5 | (macro_definition name: (symbol) @name.definition.function) @definition.function
6 | 
7 | ;; Match function calls
8 | (list (symbol) @name.reference.function) @reference.function
9 | 


--------------------------------------------------------------------------------
/aider/queries/tree-sitter-languages/elixir-tags.scm:
--------------------------------------------------------------------------------
 1 | ; Definitions
 2 | 
 3 | ; * modules and protocols
 4 | (call
 5 |   target: (identifier) @ignore
 6 |   (arguments (alias) @name.definition.module)
 7 |   (#match? @ignore "^(defmodule|defprotocol)$")) @definition.module
 8 | 
 9 | ; * functions/macros
10 | (call
11 |   target: (identifier) @ignore
12 |   (arguments
13 |     [
14 |       ; zero-arity functions with no parentheses
15 |       (identifier) @name.definition.function
16 |       ; regular function clause
17 |       (call target: (identifier) @name.definition.function)
18 |       ; function clause with a guard clause
19 |       (binary_operator
20 |         left: (call target: (identifier) @name.definition.function)
21 |         operator: "when")
22 |     ])
23 |   (#match? @ignore "^(def|defp|defdelegate|defguard|defguardp|defmacro|defmacrop|defn|defnp)$")) @definition.function
24 | 
25 | ; References
26 | 
27 | ; ignore calls to kernel/special-forms keywords
28 | (call
29 |   target: (identifier) @ignore
30 |   (#match? @ignore "^(def|defp|defdelegate|defguard|defguardp|defmacro|defmacrop|defn|defnp|defmodule|defprotocol|defimpl|defstruct|defexception|defoverridable|alias|case|cond|else|for|if|import|quote|raise|receive|require|reraise|super|throw|try|unless|unquote|unquote_splicing|use|with)$"))
31 | 
32 | ; ignore module attributes
33 | (unary_operator
34 |   operator: "@"
35 |   operand: (call
36 |     target: (identifier) @ignore))
37 | 
38 | ; * function call
39 | (call
40 |   target: [
41 |    ; local
42 |    (identifier) @name.reference.call
43 |    ; remote
44 |    (dot
45 |      right: (identifier) @name.reference.call)
46 |   ]) @reference.call
47 | 
48 | ; * pipe into function call
49 | (binary_operator
50 |   operator: "|>"
51 |   right: (identifier) @name.reference.call) @reference.call
52 | 
53 | ; * modules
54 | (alias) @name.reference.module @reference.module
55 | 


--------------------------------------------------------------------------------
/aider/queries/tree-sitter-languages/elm-tags.scm:
--------------------------------------------------------------------------------
 1 | (value_declaration (function_declaration_left (lower_case_identifier) @name.definition.function)) @definition.function
 2 | 
 3 | (function_call_expr (value_expr (value_qid) @name.reference.function)) @reference.function
 4 | (exposed_value (lower_case_identifier) @name.reference.function) @reference.function
 5 | (type_annotation ((lower_case_identifier) @name.reference.function) (colon)) @reference.function
 6 | 
 7 | (type_declaration ((upper_case_identifier) @name.definition.type)) @definition.type
 8 | 
 9 | (type_ref (upper_case_qid (upper_case_identifier) @name.reference.type)) @reference.type
10 | (exposed_type (upper_case_identifier) @name.reference.type) @reference.type
11 | 
12 | (type_declaration (union_variant (upper_case_identifier) @name.definition.union)) @definition.union
13 | 
14 | (value_expr (upper_case_qid (upper_case_identifier) @name.reference.union)) @reference.union
15 | 
16 | 
17 | (module_declaration
18 |     (upper_case_qid (upper_case_identifier)) @name.definition.module
19 | ) @definition.module
20 | 


--------------------------------------------------------------------------------
/aider/queries/tree-sitter-languages/go-tags.scm:
--------------------------------------------------------------------------------
 1 | (
 2 |   (comment)* @doc
 3 |   .
 4 |   (function_declaration
 5 |     name: (identifier) @name.definition.function) @definition.function
 6 |   (#strip! @doc "^//\\s*")
 7 |   (#set-adjacent! @doc @definition.function)
 8 | )
 9 | 
10 | (
11 |   (comment)* @doc
12 |   .
13 |   (method_declaration
14 |     name: (field_identifier) @name.definition.method) @definition.method
15 |   (#strip! @doc "^//\\s*")
16 |   (#set-adjacent! @doc @definition.method)
17 | )
18 | 
19 | (call_expression
20 |   function: [
21 |     (identifier) @name.reference.call
22 |     (parenthesized_expression (identifier) @name.reference.call)
23 |     (selector_expression field: (field_identifier) @name.reference.call)
24 |     (parenthesized_expression (selector_expression field: (field_identifier) @name.reference.call))
25 |   ]) @reference.call
26 | 
27 | (type_spec
28 |   name: (type_identifier) @name.definition.type) @definition.type
29 | 
30 | (type_identifier) @name.reference.type @reference.type
31 | 


--------------------------------------------------------------------------------
/aider/queries/tree-sitter-languages/hcl-tags.scm:
--------------------------------------------------------------------------------
 1 | ;; Based on https://github.com/tree-sitter-grammars/tree-sitter-hcl/blob/main/make_grammar.js
 2 | ;; Which has Apache 2.0 License
 3 | ;; tags.scm for Terraform (tree-sitter-hcl)
 4 | 
 5 | ; === Definitions: Terraform Blocks ===
 6 | (block 
 7 |   (identifier) @block_type
 8 |   (string_lit (template_literal) @resource_type)
 9 |   (string_lit (template_literal) @name.definition.resource)
10 |   (body) @definition.resource
11 | ) (#eq? @block_type "resource")
12 | 
13 | (block 
14 |   (identifier) @block_type
15 |   (string_lit (template_literal) @name.definition.module)
16 |   (body) @definition.module
17 | ) (#eq? @block_type "module")
18 | 
19 | (block 
20 |   (identifier) @block_type
21 |   (string_lit (template_literal) @name.definition.variable)
22 |   (body) @definition.variable
23 | ) (#eq? @block_type "variable")
24 | 
25 | (block 
26 |   (identifier) @block_type
27 |   (string_lit (template_literal) @name.definition.output)
28 |   (body) @definition.output
29 | ) (#eq? @block_type "output")
30 | 
31 | (block 
32 |   (identifier) @block_type
33 |   (string_lit (template_literal) @name.definition.provider)
34 |   (body) @definition.provider
35 | ) (#eq? @block_type "provider")
36 | 
37 | (block 
38 |   (identifier) @block_type
39 |   (body 
40 |     (attribute 
41 |        (identifier) @name.definition.local 
42 |        (expression) @definition.local
43 |     )+
44 |   )
45 | ) (#eq? @block_type "locals")
46 | 
47 | ; === References: Variables, Locals, Modules, Data, Resources ===
48 | ((variable_expr) @ref_type
49 |   (get_attr (identifier) @name.reference.variable)
50 | ) @reference.variable
51 |  (#eq? @ref_type "var")
52 | 
53 | ((variable_expr) @ref_type
54 |   (get_attr (identifier) @name.reference.local)
55 | ) @reference.local
56 |  (#eq? @ref_type "local")
57 | 
58 | ((variable_expr) @ref_type
59 |   (get_attr (identifier) @name.reference.module)
60 | ) @reference.module
61 |  (#eq? @ref_type "module")
62 | 
63 | ((variable_expr) @ref_type
64 |   (get_attr (identifier) @data_source_type)
65 |   (get_attr (identifier) @name.reference.data)
66 | ) @reference.data
67 |  (#eq? @ref_type "data")
68 | 
69 | ((variable_expr) @resource_type
70 |   (get_attr (identifier) @name.reference.resource)
71 | ) @reference.resource
72 |  (#not-eq? @resource_type "var")
73 |  (#not-eq? @resource_type "local")
74 |  (#not-eq? @resource_type "module")
75 |  (#not-eq? @resource_type "data")
76 |  (#not-eq? @resource_type "provider")
77 |  (#not-eq? @resource_type "output")
78 | 


--------------------------------------------------------------------------------
/aider/queries/tree-sitter-languages/java-tags.scm:
--------------------------------------------------------------------------------
 1 | (class_declaration
 2 |   name: (identifier) @name.definition.class) @definition.class
 3 | 
 4 | (method_declaration
 5 |   name: (identifier) @name.definition.method) @definition.method
 6 | 
 7 | (method_invocation
 8 |   name: (identifier) @name.reference.call
 9 |   arguments: (argument_list) @reference.call)
10 | 
11 | (interface_declaration
12 |   name: (identifier) @name.definition.interface) @definition.interface
13 | 
14 | (type_list
15 |   (type_identifier) @name.reference.implementation) @reference.implementation
16 | 
17 | (object_creation_expression
18 |   type: (type_identifier) @name.reference.class) @reference.class
19 | 
20 | (superclass (type_identifier) @name.reference.class) @reference.class
21 | 


--------------------------------------------------------------------------------
/aider/queries/tree-sitter-languages/kotlin-tags.scm:
--------------------------------------------------------------------------------
 1 | ; Definitions
 2 | 
 3 | (class_declaration
 4 |   (type_identifier) @name.definition.class) @definition.class
 5 | 
 6 | (function_declaration
 7 |   (simple_identifier) @name.definition.function) @definition.function
 8 | 
 9 | (object_declaration
10 |   (type_identifier) @name.definition.object) @definition.object
11 | 
12 | ; References
13 | 
14 | (call_expression
15 |   [
16 |     (simple_identifier) @name.reference.call
17 |     (navigation_expression
18 |       (navigation_suffix
19 |         (simple_identifier) @name.reference.call))
20 |   ]) @reference.call
21 | 
22 | (delegation_specifier
23 |   [
24 |     (user_type) @name.reference.type
25 |     (constructor_invocation
26 |       (user_type) @name.reference.type)
27 |   ]) @reference.type
28 | 


--------------------------------------------------------------------------------
/aider/queries/tree-sitter-languages/php-tags.scm:
--------------------------------------------------------------------------------
 1 | (class_declaration
 2 |   name: (name) @name.definition.class) @definition.class
 3 | 
 4 | (function_definition
 5 |   name: (name) @name.definition.function) @definition.function
 6 | 
 7 | (method_declaration
 8 |   name: (name) @name.definition.function) @definition.function
 9 | 
10 | (object_creation_expression
11 |   [
12 |     (qualified_name (name) @name.reference.class)
13 |     (variable_name (name) @name.reference.class)
14 |   ]) @reference.class
15 | 
16 | (function_call_expression
17 |   function: [
18 |     (qualified_name (name) @name.reference.call)
19 |     (variable_name (name)) @name.reference.call
20 |   ]) @reference.call
21 | 
22 | (scoped_call_expression
23 |   name: (name) @name.reference.call) @reference.call
24 | 
25 | (member_call_expression
26 |   name: (name) @name.reference.call) @reference.call
27 | 


--------------------------------------------------------------------------------
/aider/queries/tree-sitter-languages/python-tags.scm:
--------------------------------------------------------------------------------
 1 | (class_definition
 2 |   name: (identifier) @name.definition.class) @definition.class
 3 | 
 4 | (function_definition
 5 |   name: (identifier) @name.definition.function) @definition.function
 6 | 
 7 | (call
 8 |   function: [
 9 |       (identifier) @name.reference.call
10 |       (attribute
11 |         attribute: (identifier) @name.reference.call)
12 |   ]) @reference.call
13 | 


--------------------------------------------------------------------------------
/aider/queries/tree-sitter-languages/ql-tags.scm:
--------------------------------------------------------------------------------
 1 | (classlessPredicate
 2 |   name: (predicateName) @name.definition.function) @definition.function
 3 | 
 4 | (memberPredicate
 5 |   name: (predicateName) @name.definition.method) @definition.method
 6 | 
 7 | (aritylessPredicateExpr
 8 |   name: (literalId) @name.reference.call) @reference.call
 9 | 
10 | (module
11 |   name: (moduleName) @name.definition.module) @definition.module
12 | 
13 | (dataclass
14 |   name: (className) @name.definition.class) @definition.class
15 | 
16 | (datatype
17 |   name: (className) @name.definition.class) @definition.class
18 | 
19 | (datatypeBranch
20 |   name: (className) @name.definition.class) @definition.class
21 | 
22 | (qualifiedRhs
23 |   name: (predicateName) @name.reference.call) @reference.call
24 | 
25 | (typeExpr
26 |   name: (className) @name.reference.type) @reference.type
27 | 


--------------------------------------------------------------------------------
/aider/queries/tree-sitter-languages/ruby-tags.scm:
--------------------------------------------------------------------------------
 1 | ; Method definitions
 2 | 
 3 | (
 4 |   (comment)* @doc
 5 |   .
 6 |   [
 7 |     (method
 8 |       name: (_) @name.definition.method) @definition.method
 9 |     (singleton_method
10 |       name: (_) @name.definition.method) @definition.method
11 |   ]
12 |   (#strip! @doc "^#\\s*")
13 |   (#select-adjacent! @doc @definition.method)
14 | )
15 | 
16 | (alias
17 |   name: (_) @name.definition.method) @definition.method
18 | 
19 | (setter
20 |   (identifier) @ignore)
21 | 
22 | ; Class definitions
23 | 
24 | (
25 |   (comment)* @doc
26 |   .
27 |   [
28 |     (class
29 |       name: [
30 |         (constant) @name.definition.class
31 |         (scope_resolution
32 |           name: (_) @name.definition.class)
33 |       ]) @definition.class
34 |     (singleton_class
35 |       value: [
36 |         (constant) @name.definition.class
37 |         (scope_resolution
38 |           name: (_) @name.definition.class)
39 |       ]) @definition.class
40 |   ]
41 |   (#strip! @doc "^#\\s*")
42 |   (#select-adjacent! @doc @definition.class)
43 | )
44 | 
45 | ; Module definitions
46 | 
47 | (
48 |   (module
49 |     name: [
50 |       (constant) @name.definition.module
51 |       (scope_resolution
52 |         name: (_) @name.definition.module)
53 |     ]) @definition.module
54 | )
55 | 
56 | ; Calls
57 | 
58 | (call method: (identifier) @name.reference.call) @reference.call
59 | 
60 | (
61 |   [(identifier) (constant)] @name.reference.call @reference.call
62 |   (#is-not? local)
63 |   (#not-match? @name.reference.call "^(lambda|load|require|require_relative|__FILE__|__LINE__)$")
64 | )
65 | 


--------------------------------------------------------------------------------
/aider/queries/tree-sitter-languages/rust-tags.scm:
--------------------------------------------------------------------------------
 1 | ; ADT definitions
 2 | 
 3 | (struct_item
 4 |     name: (type_identifier) @name.definition.class) @definition.class
 5 | 
 6 | (enum_item
 7 |     name: (type_identifier) @name.definition.class) @definition.class
 8 | 
 9 | (union_item
10 |     name: (type_identifier) @name.definition.class) @definition.class
11 | 
12 | ; type aliases
13 | 
14 | (type_item
15 |     name: (type_identifier) @name.definition.class) @definition.class
16 | 
17 | ; method definitions
18 | 
19 | (declaration_list
20 |     (function_item
21 |         name: (identifier) @name.definition.method)) @definition.method
22 | 
23 | ; function definitions
24 | 
25 | (function_item
26 |     name: (identifier) @name.definition.function) @definition.function
27 | 
28 | ; trait definitions
29 | (trait_item
30 |     name: (type_identifier) @name.definition.interface) @definition.interface
31 | 
32 | ; module definitions
33 | (mod_item
34 |     name: (identifier) @name.definition.module) @definition.module
35 | 
36 | ; macro definitions
37 | 
38 | (macro_definition
39 |     name: (identifier) @name.definition.macro) @definition.macro
40 | 
41 | ; references
42 | 
43 | (call_expression
44 |     function: (identifier) @name.reference.call) @reference.call
45 | 
46 | (call_expression
47 |     function: (field_expression
48 |         field: (field_identifier) @name.reference.call)) @reference.call
49 | 
50 | (macro_invocation
51 |     macro: (identifier) @name.reference.call) @reference.call
52 | 
53 | ; implementations
54 | 
55 | (impl_item
56 |     trait: (type_identifier) @name.reference.implementation) @reference.implementation
57 | 
58 | (impl_item
59 |     type: (type_identifier) @name.reference.implementation
60 |     !trait) @reference.implementation
61 | 


--------------------------------------------------------------------------------
/aider/queries/tree-sitter-languages/typescript-tags.scm:
--------------------------------------------------------------------------------
 1 | (function_signature
 2 |   name: (identifier) @name.definition.function) @definition.function
 3 | 
 4 | (method_signature
 5 |   name: (property_identifier) @name.definition.method) @definition.method
 6 | 
 7 | (abstract_method_signature
 8 |   name: (property_identifier) @name.definition.method) @definition.method
 9 | 
10 | (abstract_class_declaration
11 |   name: (type_identifier) @name.definition.class) @definition.class
12 | 
13 | (module
14 |   name: (identifier) @name.definition.module) @definition.module
15 | 
16 | (interface_declaration
17 |   name: (type_identifier) @name.definition.interface) @definition.interface
18 | 
19 | (type_annotation
20 |   (type_identifier) @name.reference.type) @reference.type
21 | 
22 | (new_expression
23 |   constructor: (identifier) @name.reference.class) @reference.class
24 | 
25 | (function_declaration
26 |   name: (identifier) @name.definition.function) @definition.function
27 | 
28 | (method_definition
29 |   name: (property_identifier) @name.definition.method) @definition.method
30 | 
31 | (class_declaration
32 |   name: (type_identifier) @name.definition.class) @definition.class
33 | 
34 | (interface_declaration
35 |   name: (type_identifier) @name.definition.class) @definition.class
36 | 
37 | (type_alias_declaration
38 |   name: (type_identifier) @name.definition.type) @definition.type
39 | 
40 | (enum_declaration
41 |   name: (identifier) @name.definition.enum) @definition.enum
42 | 


--------------------------------------------------------------------------------
/aider/resources/__init__.py:
--------------------------------------------------------------------------------
1 | # This ensures that importlib_resources.files("aider.resources")
2 | # doesn't raise ImportError, even if there are no other files in this
3 | # dir.
4 | 


--------------------------------------------------------------------------------
/aider/sendchat.py:
--------------------------------------------------------------------------------
 1 | from aider.dump import dump  # noqa: F401
 2 | from aider.utils import format_messages
 3 | 
 4 | 
 5 | def sanity_check_messages(messages):
 6 |     """Check if messages alternate between user and assistant roles.
 7 |     System messages can be interspersed anywhere.
 8 |     Also verifies the last non-system message is from the user.
 9 |     Returns True if valid, False otherwise."""
10 |     last_role = None
11 |     last_non_system_role = None
12 | 
13 |     for msg in messages:
14 |         role = msg.get("role")
15 |         if role == "system":
16 |             continue
17 | 
18 |         if last_role and role == last_role:
19 |             turns = format_messages(messages)
20 |             raise ValueError("Messages don't properly alternate user/assistant:\n\n" + turns)
21 | 
22 |         last_role = role
23 |         last_non_system_role = role
24 | 
25 |     # Ensure last non-system message is from user
26 |     return last_non_system_role == "user"
27 | 
28 | 
29 | def ensure_alternating_roles(messages):
30 |     """Ensure messages alternate between 'assistant' and 'user' roles.
31 | 
32 |     Inserts empty messages of the opposite role when consecutive messages
33 |     of the same role are found.
34 | 
35 |     Args:
36 |         messages: List of message dictionaries with 'role' and 'content' keys.
37 | 
38 |     Returns:
39 |         List of messages with alternating roles.
40 |     """
41 |     if not messages:
42 |         return messages
43 | 
44 |     fixed_messages = []
45 |     prev_role = None
46 | 
47 |     for msg in messages:
48 |         current_role = msg.get("role")  # Get 'role', None if missing
49 | 
50 |         # If current role same as previous, insert empty message
51 |         # of the opposite role
52 |         if current_role == prev_role:
53 |             if current_role == "user":
54 |                 fixed_messages.append({"role": "assistant", "content": ""})
55 |             else:
56 |                 fixed_messages.append({"role": "user", "content": ""})
57 | 
58 |         fixed_messages.append(msg)
59 |         prev_role = current_role
60 | 
61 |     return fixed_messages
62 | 


--------------------------------------------------------------------------------
/aider/urls.py:
--------------------------------------------------------------------------------
 1 | website = "https://aider.chat/"
 2 | add_all_files = "https://aider.chat/docs/faq.html#how-can-i-add-all-the-files-to-the-chat"
 3 | edit_errors = "https://aider.chat/docs/troubleshooting/edit-errors.html"
 4 | git = "https://aider.chat/docs/git.html"
 5 | enable_playwright = "https://aider.chat/docs/install/optional.html#enable-playwright"
 6 | favicon = "https://aider.chat/assets/icons/favicon-32x32.png"
 7 | model_warnings = "https://aider.chat/docs/llms/warnings.html"
 8 | token_limits = "https://aider.chat/docs/troubleshooting/token-limits.html"
 9 | llms = "https://aider.chat/docs/llms.html"
10 | large_repos = "https://aider.chat/docs/faq.html#can-i-use-aider-in-a-large-mono-repo"
11 | github_issues = "https://github.com/Aider-AI/aider/issues/new"
12 | git_index_version = "https://github.com/Aider-AI/aider/issues/211"
13 | install_properly = "https://aider.chat/docs/troubleshooting/imports.html"
14 | analytics = "https://aider.chat/docs/more/analytics.html"
15 | release_notes = "https://aider.chat/HISTORY.html#release-notes"
16 | edit_formats = "https://aider.chat/docs/more/edit-formats.html"
17 | models_and_keys = "https://aider.chat/docs/troubleshooting/models-and-keys.html"
18 | 


--------------------------------------------------------------------------------
/aider/watch_prompts.py:
--------------------------------------------------------------------------------
 1 | watch_code_prompt = """
 2 | I've written your instructions in comments in the code and marked them with "ai"
 3 | You can see the "AI" comments shown below (marked with █).
 4 | Find them in the code files I've shared with you, and follow their instructions.
 5 | 
 6 | After completing those instructions, also be sure to remove all the "AI" comments from the code too.
 7 | """
 8 | 
 9 | watch_ask_prompt = """/ask
10 | Find the "AI" comments below (marked with █) in the code files I've shared with you.
11 | They contain my questions that I need you to answer and other instructions for you.
12 | """
13 | 


--------------------------------------------------------------------------------
/aider/website/Gemfile:
--------------------------------------------------------------------------------
1 | source 'https://rubygems.org'
2 | gem 'jekyll'
3 | gem "just-the-docs", "0.8.2"
4 | gem 'jekyll-redirect-from'
5 | gem 'jekyll-sitemap'
6 | gem "webrick"
7 | gem 'github-pages', group: :jekyll_plugins
8 | gem "html-proofer"
9 | 


--------------------------------------------------------------------------------
/aider/website/_config.yml:
--------------------------------------------------------------------------------
 1 | theme: just-the-docs
 2 | url: "https://aider.chat"
 3 | 
 4 | # Analytics configuration
 5 | analytics:
 6 |   enabled: false  # Single switch to control analytics and cookie consent
 7 |   posthog_key: 'phc_99T7muzafUMMZX15H8XePbMSreEUzahHbtWjy3l5Qbv'
 8 |   posthog_host: 'https://us.i.posthog.com'
 9 | 
10 | plugins:
11 |   - jekyll-redirect-from
12 |   - jekyll-sitemap
13 |   - jekyll-feed
14 | 
15 | defaults:
16 |   - scope:
17 |       path: "README.md"
18 |       type: "pages"
19 |     values:
20 |       description: "aider is AI pair programming in your terminal"
21 | 
22 | exclude:
23 |   - "tmp*"
24 |   - "**/tmp*"
25 |   - OLD
26 |   - "**/OLD/**"
27 |   - "OLD/**"
28 |   - vendor
29 |   - feed.xml
30 | 
31 | aux_links:
32 |   "GitHub":
33 |     - "https://github.com/Aider-AI/aider"
34 |   "Discord":
35 |     - "https://discord.gg/Tv2uQnR88V"
36 |   "Blog":
37 |     - "/blog/"
38 | 
39 | nav_external_links:
40 |   - title: "GitHub"
41 |     url: "https://github.com/Aider-AI/aider"
42 |   - title: "Discord"
43 |     url: "https://discord.gg/Tv2uQnR88V"
44 | 
45 | repository: Aider-AI/aider
46 | 
47 | callouts:
48 |   tip:
49 |     title: Tip
50 |     color: green
51 |   note:
52 |     title: Note
53 |     color: yellow
54 |     
55 | 


--------------------------------------------------------------------------------
/aider/website/_includes/get-started.md:
--------------------------------------------------------------------------------
 1 | 
 2 | If you already have python 3.8-3.13 installed, you can get started quickly like this:
 3 | 
 4 | ```bash
 5 | python -m pip install aider-install
 6 | aider-install
 7 | 
 8 | # Change directory into your code base
 9 | cd /to/your/project
10 | 
11 | # Work with DeepSeek via DeepSeek's API
12 | aider --model deepseek --api-key deepseek=your-key-goes-here
13 | 
14 | # Work with Claude 3.7 Sonnet via Anthropic's API
15 | aider --model sonnet --api-key anthropic=your-key-goes-here
16 | 
17 | # Work with GPT-4o via OpenAI's API
18 | aider --model gpt-4o --api-key openai=your-key-goes-here
19 | 
20 | # Work with Sonnet via OpenRouter's API
21 | aider --model openrouter/anthropic/claude-3.7-sonnet --api-key openrouter=your-key-goes-here
22 | 
23 | # Work with DeepSeek via OpenRouter's API
24 | aider --model openrouter/deepseek/deepseek-chat --api-key openrouter=your-key-goes-here
25 | ```
26 | 


--------------------------------------------------------------------------------
/aider/website/_includes/help-tip.md:
--------------------------------------------------------------------------------
1 | {: .tip }
2 | Use `/help <question>` to 
3 | [ask for help about using aider](/docs/troubleshooting/support.html),
4 | customizing settings, troubleshooting, using LLMs, etc.
5 | 
6 | 


--------------------------------------------------------------------------------
/aider/website/_includes/help.md:
--------------------------------------------------------------------------------
 1 | If you need more help, please check our
 2 | [GitHub issues](https://github.com/Aider-AI/aider/issues)
 3 | and file a new issue if your problem isn't discussed.
 4 | Or drop into our
 5 | [Discord](https://discord.gg/Tv2uQnR88V)
 6 | to chat with us.
 7 | 
 8 | When reporting problems, it is very helpful if you can provide:
 9 | 
10 | - Aider version
11 | - LLM model you are using
12 | 
13 | Including the "announcement" lines that
14 | aider prints at startup
15 | is an easy way to share this helpful info.
16 | 
17 | ```
18 | Aider v0.37.1-dev
19 | Models: gpt-4o with diff edit format, weak model gpt-3.5-turbo
20 | Git repo: .git with 243 files
21 | Repo-map: using 1024 tokens
22 | ```
23 | 
24 | {% include help-tip.md %}
25 | 


--------------------------------------------------------------------------------
/aider/website/_includes/keys.md:
--------------------------------------------------------------------------------
1 | {: .tip :}
2 | See the
3 | [API key configuration docs](/docs/config/api-keys.html)
4 | for information on how to configure and store your API keys.
5 | 


--------------------------------------------------------------------------------
/aider/website/_includes/model-warnings.md:
--------------------------------------------------------------------------------
 1 | 
 2 | ## Unknown context window size and token costs
 3 | 
 4 | ```
 5 | Model foobar: Unknown context window size and costs, using sane defaults.
 6 | ```
 7 | 
 8 | If you specify a model that aider has never heard of, you will get
 9 | this warning.
10 | This means aider doesn't know the context window size and token costs
11 | for that model.
12 | Aider will use an unlimited context window and assume the model is free,
13 | so this is not usually a significant problem.
14 | 
15 | See the docs on 
16 | [configuring advanced model settings](/docs/config/adv-model-settings.html)
17 | for details on how to remove this warning.
18 | 
19 | {: .tip }
20 | You can probably ignore the unknown context window size and token costs warning.
21 | 
22 | ## Did you mean?
23 | 
24 | If aider isn't familiar with the model you've specified,
25 | it will suggest similarly named models.
26 | This helps
27 | in the case where you made a typo or mistake when specifying the model name.
28 | 
29 | ```
30 | Model gpt-5o: Unknown context window size and costs, using sane defaults.
31 | Did you mean one of these?
32 | - gpt-4o
33 | ```
34 | 
35 | ## Missing environment variables
36 | 
37 | You need to set the listed environment variables.
38 | Otherwise you will get error messages when you start chatting with the model.
39 | 
40 | ```
41 | Model azure/gpt-4-turbo: Missing these environment variables:
42 | - AZURE_API_BASE
43 | - AZURE_API_VERSION
44 | - AZURE_API_KEY
45 | ```
46 | 
47 | {: .tip }
48 | On Windows, 
49 | if you just set these environment variables using `setx` you may need to restart your terminal or
50 | command prompt for the changes to take effect.
51 | 
52 | 
53 | ## Unknown which environment variables are required
54 | 
55 | ```
56 | Model gpt-5: Unknown which environment variables are required.
57 | ```
58 | 
59 | Aider is unable verify the environment because it doesn't know
60 | which variables are required for the model.
61 | If required variables are missing,
62 | you may get errors when you attempt to chat with the model.
63 | You can look in the [aider's LLM documentation](/docs/llms.html)
64 | or the
65 | [litellm documentation](https://docs.litellm.ai/docs/providers)
66 | to see if the required variables are listed there.
67 | 
68 | 


--------------------------------------------------------------------------------
/aider/website/_includes/multi-line.md:
--------------------------------------------------------------------------------
 1 | You can send long, multi-line messages in the chat in a few ways:
 2 |   - Paste a multi-line message directly into the chat.
 3 |   - Enter `{` alone on the first line to start a multiline message and `}` alone on the last line to end it.
 4 |     - Or, start with `{tag` (where "tag" is any sequence of letters/numbers) and end with `tag}`. This is useful when you need to include closing braces `}` in your message.
 5 |   - Use Meta-ENTER to start a new line without sending the message (Esc+ENTER in some environments).
 6 |   - Use `/paste` to paste text from the clipboard into the chat.
 7 |   - Use the `/editor` command to open your editor to create the next chat message. See [editor configuration docs](/docs/config/editor.html) for more info.
 8 |   - Use multiline-mode, which swaps the function of Meta-Enter and Enter, so that Enter inserts a newline, and Meta-Enter submits your command. To enable multiline mode:
 9 |     - Use the `/multiline-mode` command to toggle it during a session.
10 |     - Use the `--multiline` switch.
11 |   
12 | Example with a tag:
13 | ```
14 | {python
15 | def hello():
16 |     print("Hello}")  # Note: contains a brace
17 | python}
18 | ```
19 | 
20 | {: .note }
21 | People often ask for SHIFT-ENTER to be a soft-newline.
22 | Unfortunately there is no portable way to detect that keystroke in terminals.
23 | 


--------------------------------------------------------------------------------
/aider/website/_includes/nav_footer_custom.html:
--------------------------------------------------------------------------------
1 | <footer class="site-footer">
2 |     Aider is AI pair programming in your terminal.
3 |     Aider is on
4 |     <a href="https://github.com/Aider-AI/aider">GitHub</a>
5 |     and
6 |     <a href="https://discord.gg/Tv2uQnR88V">Discord</a>.
7 | </footer>
8 | 


--------------------------------------------------------------------------------
/aider/website/_includes/python-m-aider.md:
--------------------------------------------------------------------------------
1 | {: .tip }
2 | In some environments you may get "aider command not found" errors.
3 | You can try `python -m aider` or 
4 | [see here for more info](/docs/troubleshooting/aider-not-found.html).
5 | 
6 | 


--------------------------------------------------------------------------------
/aider/website/_includes/replit-pipx.md:
--------------------------------------------------------------------------------
 1 | To use aider with pipx on replit, you can run these commands in the replit shell:
 2 | 
 3 | ```bash
 4 | pip install pipx
 5 | pipx run aider-chat ...normal aider args...
 6 | ```
 7 | 
 8 | If you install aider with pipx on replit and try and run it as just `aider` it will crash with a missing `libstdc++.so.6` library.
 9 | 
10 | 


--------------------------------------------------------------------------------
/aider/website/_includes/works-best.md:
--------------------------------------------------------------------------------
1 | Aider works best with Claude 3.5 Sonnet, DeepSeek R1 & Chat V3, OpenAI o1, o3-mini & GPT-4o. Aider can [connect to almost any LLM, including local models](https://aider.chat/docs/llms.html).
2 | 


--------------------------------------------------------------------------------
/aider/website/_layouts/redirect.html:
--------------------------------------------------------------------------------
 1 | <!DOCTYPE html>
 2 | <html lang="en-US">
 3 |   <meta charset="utf-8">
 4 |   <title>Redirecting&hellip;</title>
 5 |   <link rel="canonical" href="{{ page.redirect.to }}">
 6 |   <script>location="{{ page.redirect.to }}"</script>
 7 |   <meta http-equiv="refresh" content="0; url={{ page.redirect.to }}">
 8 |   <h1>Redirecting&hellip;</h1>
 9 |   <a href="{{ page.redirect.to }}">Click here if you are not redirected.</a>
10 | </html>
11 | 


--------------------------------------------------------------------------------
/aider/website/_posts/2023-05-25-ctags.md:
--------------------------------------------------------------------------------
1 | ../docs/ctags.md


--------------------------------------------------------------------------------
/aider/website/_posts/2023-07-02-benchmarks.md:
--------------------------------------------------------------------------------
1 | ../docs/benchmarks.md


--------------------------------------------------------------------------------
/aider/website/_posts/2023-11-06-benchmarks-1106.md:
--------------------------------------------------------------------------------
1 | ../docs/benchmarks-1106.md


--------------------------------------------------------------------------------
/aider/website/_posts/2023-11-06-benchmarks-speed-1106.md:
--------------------------------------------------------------------------------
1 | ../docs/benchmarks-speed-1106.md


--------------------------------------------------------------------------------
/aider/website/_posts/2023-12-21-unified-diffs.md:
--------------------------------------------------------------------------------
1 | ../docs/unified-diffs.md


--------------------------------------------------------------------------------
/aider/website/_posts/2024-01-25-benchmarks-0125.md:
--------------------------------------------------------------------------------
1 | ../docs/benchmarks-0125.md


--------------------------------------------------------------------------------
/aider/website/_posts/2024-05-02-browser.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | title: Aider in your browser
 3 | excerpt: Aider has an experimental browser UI, allowing you to collaborate with LLMs on code in your local git repo.
 4 | highlight_image: /assets/browser.jpg
 5 | ---
 6 | {% if page.date %}
 7 | <p class="post-date">{{ page.date | date: "%B %d, %Y" }}</p>
 8 | {% endif %}
 9 | 
10 | # Aider in your browser
11 | 
12 | <div class="video-container">
13 |   <video controls loop poster="/assets/browser.jpg">
14 |     <source src="/assets/aider-browser-social.mp4" type="video/mp4">
15 |     <a href="/assets/aider-browser-social.mp4">Aider browser UI demo video</a>
16 |   </video>
17 | </div>
18 | 
19 | <style>
20 | .video-container {
21 |   position: relative;
22 |   padding-bottom: 101.89%; /* 1080 / 1060 = 1.0189 */
23 |   height: 0;
24 |   overflow: hidden;
25 | }
26 | 
27 | .video-container video {
28 |   position: absolute;
29 |   top: 0;
30 |   left: 0;
31 |   width: 100%;
32 |   height: 100%;
33 | }
34 | </style>
35 | 
36 | Use aider's new experimental browser UI to collaborate with LLMs
37 | to edit code in your local git repo.
38 | Aider will directly edit the code in your local source files,
39 | and [git commit the changes](https://aider.chat/docs/git.html)
40 | with sensible commit messages.
41 | You can start a new project or work with an existing git repo.
42 | {% include works-best.md %}
43 | 
44 | Use the `--browser` switch to launch the browser version of aider:
45 | 
46 | ```
47 | python -m pip install -U aider-chat
48 | 
49 | export OPENAI_API_KEY=<key> # Mac/Linux
50 | setx   OPENAI_API_KEY <key> # Windows, restart shell after setx
51 | 
52 | aider --browser
53 | ```
54 | 


--------------------------------------------------------------------------------
/aider/website/_posts/2024-05-22-draft.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | title: A draft post.
 3 | excerpt: With a draft summary.
 4 | highlight_image: /assets/linting.jpg
 5 | draft: true
 6 | nav_exclude: true
 7 | ---
 8 | {% if page.date %}
 9 | <p class="post-date">{{ page.date | date: "%B %d, %Y" }}</p>
10 | {% endif %}
11 | 
12 | # A draft post
13 | 
14 | Content TBD.
15 | 


--------------------------------------------------------------------------------
/aider/website/assets/2024-03-07-claude-3.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/2024-03-07-claude-3.jpg


--------------------------------------------------------------------------------
/aider/website/assets/2024-04-09-gpt-4-turbo-laziness.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/2024-04-09-gpt-4-turbo-laziness.jpg


--------------------------------------------------------------------------------
/aider/website/assets/2024-04-09-gpt-4-turbo.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/2024-04-09-gpt-4-turbo.jpg


--------------------------------------------------------------------------------
/aider/website/assets/2024-07-new-models.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/2024-07-new-models.jpg


--------------------------------------------------------------------------------
/aider/website/assets/aider-browser-social.mp4:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/aider-browser-social.mp4


--------------------------------------------------------------------------------
/aider/website/assets/aider-square.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/aider-square.jpg


--------------------------------------------------------------------------------
/aider/website/assets/aider.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/aider.jpg


--------------------------------------------------------------------------------
/aider/website/assets/architect.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/architect.jpg


--------------------------------------------------------------------------------
/aider/website/assets/benchmarks-0125.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/benchmarks-0125.jpg


--------------------------------------------------------------------------------
/aider/website/assets/benchmarks-1106.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/benchmarks-1106.jpg


--------------------------------------------------------------------------------
/aider/website/assets/benchmarks-speed-1106.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/benchmarks-speed-1106.jpg


--------------------------------------------------------------------------------
/aider/website/assets/benchmarks-udiff.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/benchmarks-udiff.jpg


--------------------------------------------------------------------------------
/aider/website/assets/benchmarks.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/benchmarks.jpg


--------------------------------------------------------------------------------
/aider/website/assets/blame.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/blame.jpg


--------------------------------------------------------------------------------
/aider/website/assets/browser.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/browser.jpg


--------------------------------------------------------------------------------
/aider/website/assets/code-in-json.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/code-in-json.jpg


--------------------------------------------------------------------------------
/aider/website/assets/codespaces.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/codespaces.jpg


--------------------------------------------------------------------------------
/aider/website/assets/codespaces.mp4:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/codespaces.mp4


--------------------------------------------------------------------------------
/aider/website/assets/copypaste.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/copypaste.jpg


--------------------------------------------------------------------------------
/aider/website/assets/copypaste.mp4:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/copypaste.mp4


--------------------------------------------------------------------------------
/aider/website/assets/figure.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/figure.png


--------------------------------------------------------------------------------
/aider/website/assets/icons/android-chrome-192x192.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/icons/android-chrome-192x192.png


--------------------------------------------------------------------------------
/aider/website/assets/icons/android-chrome-384x384.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/icons/android-chrome-384x384.png


--------------------------------------------------------------------------------
/aider/website/assets/icons/apple-touch-icon.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/icons/apple-touch-icon.png


--------------------------------------------------------------------------------
/aider/website/assets/icons/browserconfig.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="utf-8"?>
 2 | <browserconfig>
 3 |     <msapplication>
 4 |         <tile>
 5 |             <square150x150logo src="/assets/icons/mstile-150x150.png"/>
 6 |             <TileColor>#da532c</TileColor>
 7 |         </tile>
 8 |     </msapplication>
 9 | </browserconfig>
10 | 


--------------------------------------------------------------------------------
/aider/website/assets/icons/favicon-16x16.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/icons/favicon-16x16.png


--------------------------------------------------------------------------------
/aider/website/assets/icons/favicon-32x32.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/icons/favicon-32x32.png


--------------------------------------------------------------------------------
/aider/website/assets/icons/favicon.ico:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/icons/favicon.ico


--------------------------------------------------------------------------------
/aider/website/assets/icons/mstile-150x150.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/icons/mstile-150x150.png


--------------------------------------------------------------------------------
/aider/website/assets/icons/safari-pinned-tab.svg:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" standalone="no"?>
 2 | <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 20010904//EN"
 3 |  "http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd">
 4 | <svg version="1.0" xmlns="http://www.w3.org/2000/svg"
 5 |  width="436.000000pt" height="436.000000pt" viewBox="0 0 436.000000 436.000000"
 6 |  preserveAspectRatio="xMidYMid meet">
 7 | <metadata>
 8 | Created by potrace 1.14, written by Peter Selinger 2001-2017
 9 | </metadata>
10 | <g transform="translate(0.000000,436.000000) scale(0.100000,-0.100000)"
11 | fill="#000000" stroke="none">
12 | <path d="M0 2180 l0 -2180 2180 0 2180 0 0 2180 0 2180 -2180 0 -2180 0 0
13 | -2180z m2705 1818 c20 -20 28 -121 30 -398 l2 -305 216 -5 c118 -3 218 -8 222
14 | -12 3 -3 10 -46 15 -95 5 -48 16 -126 25 -172 17 -86 17 -81 -17 -233 -14 -67
15 | -13 -365 2 -438 21 -100 22 -159 5 -247 -24 -122 -24 -363 1 -458 23 -88 23
16 | -213 1 -330 -9 -49 -17 -109 -17 -132 l0 -43 203 0 c111 0 208 -4 216 -9 10
17 | -6 18 -51 27 -148 8 -76 16 -152 20 -168 7 -39 -23 -361 -37 -387 -10 -18 -21
18 | -19 -214 -16 -135 2 -208 7 -215 14 -22 22 -33 301 -21 501 6 102 8 189 5 194
19 | -8 13 -417 12 -431 -2 -12 -12 -8 -146 8 -261 8 -55 8 -95 1 -140 -6 -35 -14
20 | -99 -17 -143 -9 -123 -14 -141 -41 -154 -18 -8 -217 -11 -679 -11 l-653 0 -11
21 | 33 c-31 97 -43 336 -27 533 5 56 6 113 2 128 l-6 26 -194 0 c-211 0 -252 4
22 | -261 28 -12 33 -17 392 -6 522 15 186 -2 174 260 180 115 3 213 8 217 12 4 4
23 | 1 52 -5 105 -7 54 -17 130 -22 168 -7 56 -5 91 11 171 10 55 22 130 26 166 4
24 | 36 10 72 15 79 7 12 128 15 665 19 l658 5 8 30 c5 18 4 72 -3 130 -12 115 -7
25 | 346 11 454 10 61 10 75 -1 82 -8 5 -300 9 -650 9 l-636 0 -27 25 c-18 16 -26
26 | 34 -26 57 0 18 -5 87 -10 153 -10 128 5 449 22 472 5 7 26 13 46 15 78 6 1281
27 | 3 1287 -4z"/>
28 | <path d="M1360 1833 c0 -5 -1 -164 -3 -356 l-2 -347 625 -1 c704 -1 708 -1
29 | 722 7 5 4 7 20 4 38 -29 141 -32 491 -6 595 9 38 8 45 -7 57 -15 11 -139 13
30 | -675 14 -362 0 -658 -3 -658 -7z"/>
31 | </g>
32 | </svg>
33 | 


--------------------------------------------------------------------------------
/aider/website/assets/icons/site.webmanifest:
--------------------------------------------------------------------------------
 1 | {
 2 |     "name": "",
 3 |     "short_name": "",
 4 |     "icons": [
 5 |         {
 6 |             "src": "/assets/icons/android-chrome-192x192.png",
 7 |             "sizes": "192x192",
 8 |             "type": "image/png"
 9 |         },
10 |         {
11 |             "src": "/assets/icons/android-chrome-384x384.png",
12 |             "sizes": "384x384",
13 |             "type": "image/png"
14 |         }
15 |     ],
16 |     "theme_color": "#ffffff",
17 |     "background_color": "#ffffff",
18 |     "display": "standalone"
19 | }
20 | 


--------------------------------------------------------------------------------
/aider/website/assets/install.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/install.jpg


--------------------------------------------------------------------------------
/aider/website/assets/install.mp4:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/install.mp4


--------------------------------------------------------------------------------
/aider/website/assets/leaderboard.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/leaderboard.jpg


--------------------------------------------------------------------------------
/aider/website/assets/linting.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/linting.jpg


--------------------------------------------------------------------------------
/aider/website/assets/llms.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/llms.jpg


--------------------------------------------------------------------------------
/aider/website/assets/models-over-time.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/models-over-time.png


--------------------------------------------------------------------------------
/aider/website/assets/o1-polyglot.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/o1-polyglot.jpg


--------------------------------------------------------------------------------
/aider/website/assets/prompt-caching.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/prompt-caching.jpg


--------------------------------------------------------------------------------
/aider/website/assets/quantization.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/quantization.jpg


--------------------------------------------------------------------------------
/aider/website/assets/qwq.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/qwq.jpg


--------------------------------------------------------------------------------
/aider/website/assets/r1-sonnet-sota.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/r1-sonnet-sota.jpg


--------------------------------------------------------------------------------
/aider/website/assets/robot-ast.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/robot-ast.png


--------------------------------------------------------------------------------
/aider/website/assets/robot-flowchart.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/robot-flowchart.png


--------------------------------------------------------------------------------
/aider/website/assets/screenshot.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/screenshot.png


--------------------------------------------------------------------------------
/aider/website/assets/self-assembly.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/self-assembly.jpg


--------------------------------------------------------------------------------
/aider/website/assets/shell-cmds-small.mp4:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/shell-cmds-small.mp4


--------------------------------------------------------------------------------
/aider/website/assets/shell-cmds.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/shell-cmds.jpg


--------------------------------------------------------------------------------
/aider/website/assets/sonnet-not-lazy.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/sonnet-not-lazy.jpg


--------------------------------------------------------------------------------
/aider/website/assets/sonnet-seems-fine.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/sonnet-seems-fine.jpg


--------------------------------------------------------------------------------
/aider/website/assets/swe_bench.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/swe_bench.jpg


--------------------------------------------------------------------------------
/aider/website/assets/swe_bench_lite.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/swe_bench_lite.jpg


--------------------------------------------------------------------------------
/aider/website/assets/thinking.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/thinking.jpg


--------------------------------------------------------------------------------
/aider/website/assets/udiffs.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/udiffs.jpg


--------------------------------------------------------------------------------
/aider/website/assets/watch.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/watch.jpg


--------------------------------------------------------------------------------
/aider/website/assets/watch.mp4:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/aider/website/assets/watch.mp4


--------------------------------------------------------------------------------
/aider/website/blog/index.html:
--------------------------------------------------------------------------------
 1 | ---
 2 | title: Aider blog
 3 | layout: default
 4 | nav_order: 1000
 5 | ---
 6 | 
 7 | <h1>Aider blog</h1>
 8 | 
 9 | <div class="posts">
10 |     {% for post in site.posts %}
11 |     {% unless post.draft %}
12 |     <article class="post">
13 |       <h2><a href="{{ site.baseurl }}{{ post.url }}">{{ post.title }}</a></h2>
14 |       <div class="entry">
15 |         <div class="post-content">
16 |           {% if post.excerpt %}
17 |           {{ post.excerpt }}
18 |           {% else %}
19 |           {{ post.content | strip_html | truncatewords: 100 }}...
20 |           {% endif %}
21 |           {% if post.highlight_image %}
22 |           <a href="{{ site.baseurl }}{{ post.url }}">
23 |               <div class="post-highlight">
24 |                   <img src="{{ site.baseurl }}{{ post.highlight_image }}" alt="Highlight Image">
25 |               </div>
26 |           </a>
27 |           {% endif %}
28 |         </div>
29 |       </div>
30 | 
31 |       <p class="post-date">
32 |           {{ post.date | date: "%b %-d, %Y" | upcase }}
33 |       </p>
34 |     </article>
35 |     {% endunless %}
36 |     {% endfor %}
37 | </div>
38 | 


--------------------------------------------------------------------------------
/aider/website/docs/benchmarks-0125.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | title: The January GPT-4 Turbo is lazier than the last version
 3 | excerpt: The new `gpt-4-0125-preview` model is quantiatively lazier at coding than previous GPT-4 versions, according to a new "laziness" benchmark.
 4 | highlight_image: /assets/benchmarks-0125.jpg
 5 | nav_exclude: true
 6 | ---
 7 | {% if page.date %}
 8 | <p class="post-date">{{ page.date | date: "%B %d, %Y" }}</p>
 9 | {% endif %}
10 | 
11 | # The January GPT-4 Turbo is lazier than the last version
12 | 
13 | [![benchmark results](/assets/benchmarks-0125.svg)](https://aider.chat/assets/benchmarks-0125.svg)
14 | 
15 | [OpenAI just released a new version of GPT-4 Turbo](https://openai.com/blog/new-embedding-models-and-api-updates).
16 | This new model is intended to reduce the "laziness" that has been widely observed with the previous `gpt-4-1106-preview` model:
17 | 
18 | > Today, we are releasing an updated GPT-4 Turbo preview model, gpt-4-0125-preview. This model completes tasks like code generation more thoroughly than the previous preview model and is intended to reduce cases of “laziness” where the model doesn’t complete a task.
19 | 
20 | With that in mind, I've been benchmarking the new model using
21 | aider's existing
22 | [lazy coding benchmark](https://aider.chat/docs/unified-diffs.html).
23 | 
24 | ## Benchmark results
25 | 
26 | Overall,
27 | the new `gpt-4-0125-preview` model seems lazier
28 | than the November `gpt-4-1106-preview` model:
29 | 
30 | - It gets worse benchmark scores when using the [unified diffs](https://aider.chat/docs/unified-diffs.html) code editing format.
31 | - Using aider's older SEARCH/REPLACE block editing format, the new January model outperforms the older November model. But it still performs worse than both models using unified diffs.
32 | 
33 | ## Related reports
34 | 
35 | This is one in a series of reports
36 | that use the aider benchmarking suite to assess and compare the code
37 | editing capabilities of OpenAI's GPT models.
38 | You can review the other reports
39 | for additional information:
40 | 
41 | - [GPT code editing benchmarks](https://aider.chat/docs/benchmarks.html) evaluates the March and June versions of GPT-3.5 and GPT-4.
42 | - [Code editing benchmarks for OpenAI's "1106" models](https://aider.chat/docs/benchmarks-1106.html).
43 | - [Aider's lazy coding benchmark](https://aider.chat/docs/unified-diffs.html).
44 | 
45 | 
46 | 


--------------------------------------------------------------------------------
/aider/website/docs/config.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | nav_order: 55
 3 | has_children: true
 4 | description: Information on all of aider's settings and how to use them.
 5 | ---
 6 | 
 7 | # Configuration
 8 | 
 9 | Aider has many options which can be set with
10 | command line switches.
11 | Most options can also be set in an `.aider.conf.yml` file
12 | which can be placed in your home directory or at the root of
13 | your git repo. 
14 | Or by setting environment variables like `AIDER_xxx`
15 | either in your shell or a `.env` file.
16 | 
17 | Here are 4 equivalent ways of setting an option. 
18 | 
19 | With a command line switch:
20 | 
21 | ```
22 | $ aider --dark-mode
23 | ```
24 | 
25 | Using a `.aider.conf.yml` file:
26 | 
27 | ```yaml
28 | dark-mode: true
29 | ```
30 | 
31 | By setting an environment variable:
32 | 
33 | ```
34 | export AIDER_DARK_MODE=true
35 | ```
36 | 
37 | Using an `.env` file:
38 | 
39 | ```
40 | AIDER_DARK_MODE=true
41 | ```
42 | 
43 | {% include keys.md %}
44 | 
45 | 


--------------------------------------------------------------------------------
/aider/website/docs/config/api-keys.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Configuration
 3 | nav_order: 5
 4 | description: Setting API keys for API providers.
 5 | ---
 6 | 
 7 | # API Keys
 8 | 
 9 | Aider lets you specify API keys in a few ways:
10 | 
11 | - On the command line
12 | - As environment variables
13 | - In a `.env` file
14 | - In your `.aider.conf.yml` config file
15 | 
16 | ---
17 | 
18 | ## OpenAI and Anthropic
19 | 
20 | Aider has special support for providing
21 | OpenAI and Anthropic API keys
22 | via dedicated switches and configuration options.
23 | Settings keys for other providers works a bit differently, see below.
24 | 
25 | #### Command line
26 | 
27 | You can set OpenAI and Anthropic API keys via
28 | [command line switches](/docs/config/options.html#api-keys-and-settings)
29 | `--openai-api-key` and `--anthropic-api-key`.
30 | 
31 | 
32 | #### Environment variables or .env file
33 | 
34 | You can also store them in environment variables or a 
35 | [.env file](/docs/config/dotenv.html), which also works
36 | for every API provider:
37 | 
38 | ```
39 | OPENAI_API_KEY=<key>
40 | ANTHROPIC_API_KEY=<key>
41 | ```
42 | 
43 | #### Yaml config file
44 | You can also set those API keys via special entries in the
45 | [yaml config file](/docs/config/aider_conf.html), like this:
46 | 
47 | ```yaml
48 | openai-api-key: <key>
49 | anthropic-api-key: <key>
50 | ```
51 | 
52 | 
53 | ---
54 | 
55 | ## Other API providers
56 | 
57 | All other LLM providers can use one of these other methods to set their API keys.
58 | 
59 | #### Command line
60 | {: .no_toc }
61 | 
62 | Use `--api-key provider=<key>` which has the effect of setting the environment variable `PROVIDER_API_KEY=<key>`. So `--api-key gemini=xxx` would set `GEMINI_API_KEY=xxx`.
63 | 
64 | #### Environment variables or .env file
65 | {: .no_toc }
66 | 
67 | You can set API keys in environment variables.
68 | The [.env file](/docs/config/dotenv.html)
69 | is a great place to store your API keys and other provider API environment variables:
70 | 
71 | ```bash
72 | GEMINI_API_KEY=foo
73 | OPENROUTER_API_KEY=bar
74 | DEEPSEEK_API_KEY=baz
75 | ```
76 | 
77 | #### Yaml config file
78 | 
79 | 
80 | You can also set API keys in the 
81 | [`.aider.conf.yml` file](/docs/config/aider_conf.html)
82 | via the `api-key` entry:
83 | 
84 | ```
85 | api-key:
86 | - gemini=foo      # Sets env var GEMINI_API_KEY=foo
87 | - openrouter=bar  # Sets env var OPENROUTER_API_KEY=bar
88 | - deepseek=baz    # Sets env var DEEPSEEK_API_KEY=baz
89 | ```
90 | 
91 | 


--------------------------------------------------------------------------------
/aider/website/docs/install/codespaces.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | title: GitHub Codespaces
 3 | parent: Installation
 4 | nav_order: 900
 5 | ---
 6 | 
 7 | # GitHub Codespaces
 8 | 
 9 | You can use aider in GitHub Codespaces via the built-in Terminal pane.
10 | See below for an example,
11 | but you can just follow the
12 | [main install instructions](/docs/install.html)
13 | inside your codespace terminal.
14 | 
15 | 
16 | <div class="video-container">
17 |   <video controls poster="/assets/codespaces.jpg">
18 |     <source src="/assets/codespaces.mp4" type="video/mp4">
19 |     <a href="/assets/codespaces.mp4">Install aider in GitHub Codespaces</a>
20 |   </video>
21 | </div>
22 | 
23 | <style>
24 | .video-container {
25 |   position: relative;
26 |   padding-bottom: 101.89%; /* 1080 / 1060 = 1.0189 */
27 |   height: 0;
28 |   overflow: hidden;
29 | }
30 | 
31 | .video-container video {
32 |   position: absolute;
33 |   top: 0;
34 |   left: 0;
35 |   width: 100%;
36 |   height: 100%;
37 | }
38 | </style>
39 | 
40 | 


--------------------------------------------------------------------------------
/aider/website/docs/install/docker.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Installation
 3 | nav_order: 100
 4 | ---
 5 | 
 6 | # Aider with docker
 7 | 
 8 | Aider is available as 2 docker images:
 9 | 
10 | - `paulgauthier/aider` installs the aider core, a smaller image that's good to get started quickly.
11 | - `paulgauthier/aider-full` installs aider will all the optional extras.
12 | 
13 | The full image has support for features like interactive help, the
14 | browser GUI and support for using Playwright to scrape web pages.  The
15 | core image can still use these features, but they will need to be
16 | installed the first time you access them. Since containers are
17 | ephemeral, the extras will need to be reinstalled the next time you
18 | launch the aider core container.
19 | 
20 | ### Aider core 
21 | 
22 | ```
23 | docker pull paulgauthier/aider
24 | docker run -it --user $(id -u):$(id -g) --volume $(pwd):/app paulgauthier/aider --openai-api-key $OPENAI_API_KEY [...other aider args...]
25 | ```
26 | 
27 | ### Full version
28 | 
29 | ```
30 | docker pull paulgauthier/aider-full
31 | docker run -it --user $(id -u):$(id -g) --volume $(pwd):/app paulgauthier/aider-full --openai-api-key $OPENAI_API_KEY [...other aider args...]
32 | ```
33 | 
34 | ## How to use it
35 | 
36 | You should run the above commands from the root of your git repo,
37 | since the `--volume` arg maps your current directory into the
38 | docker container.
39 | Given that, you need to be in the root of your git repo for aider to be able to
40 | see the repo and all its files.
41 | 
42 | You should be sure your that
43 | git repo config contains your user name and email, since the
44 | docker container won't have your global git config.
45 | Run these commands while in your git repo, before
46 | you do the `docker run` command:
47 | 
48 | ```
49 | git config user.email "you@example.com"
50 | git config user.name "Your Name"
51 | ```
52 | 
53 | 
54 | ## Limitations
55 | 
56 | - When you use the in-chat `/run` command, it will be running shell commands *inside the docker container*. So those commands won't be running in your local environment, which may make it tricky to `/run` tests, etc for your project.
57 | - The `/voice` command won't work unless you can figure out how to give the docker container access to your host audio device. The container has libportaudio2 installed, so it should work if you can do that.
58 | 


--------------------------------------------------------------------------------
/aider/website/docs/install/replit.md:
--------------------------------------------------------------------------------
1 | ---
2 | parent: Installation
3 | nav_order: 900
4 | ---
5 | 
6 | ### Replit
7 | 
8 | {% include replit-pipx.md %}
9 | 


--------------------------------------------------------------------------------
/aider/website/docs/leaderboards/by-release-date.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | title: Scores by release date
 3 | parent: Aider LLM Leaderboards
 4 | nav_order: 200
 5 | ---
 6 | 
 7 | ## LLM code editing skill by model release date
 8 | 
 9 | [![connecting to many LLMs](/assets/models-over-time.svg)](https://aider.chat/assets/models-over-time.svg)
10 | 
11 | 


--------------------------------------------------------------------------------
/aider/website/docs/leaderboards/contrib.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Aider LLM Leaderboards
 3 | nav_order: 900
 4 | ---
 5 | 
 6 | # Contributing results
 7 | 
 8 | Contributions of benchmark results are welcome!
 9 | See the
10 | [benchmark README](https://github.com/Aider-AI/aider/blob/main/benchmark/README.md)
11 | for information on running aider's code editing benchmarks.
12 | Submit results by opening a PR with edits to the
13 | [benchmark results data files](https://github.com/Aider-AI/aider/blob/main/aider/website/_data/).
14 | 
15 | 


--------------------------------------------------------------------------------
/aider/website/docs/leaderboards/notes.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Aider LLM Leaderboards
 3 | nav_order: 800
 4 | ---
 5 | 
 6 | # Benchmark notes
 7 | 
 8 | ## Notes on pricing
 9 | 
10 | All pricing information is the cost to run the benchmark at the time it was
11 | run.
12 | Providers change their pricing, and every benchmark run ends up with a slightly
13 | different cost.
14 | Pricing is provided on a *best efforts* basis, and may not always be current
15 | or fully accurate.
16 | 
17 | ## Notes on benchmarking results
18 | 
19 | The key benchmarking results are:
20 | 
21 | - **Percent completed correctly** - Measures what percentage of the coding tasks that the LLM completed successfully. To complete a task, the LLM must solve the programming assignment *and* edit the code to implement that solution.
22 | - **Percent using correct edit format** - Measures the percent of coding tasks where the LLM complied with the edit format specified in the system prompt. If the LLM makes edit mistakes, aider will give it feedback and ask for a fixed copy of the edit. The best models can reliably conform to the edit format, without making errors.
23 | 
24 | 
25 | ## Notes on the edit format
26 | 
27 | Aider uses different "edit formats" to collect code edits from different LLMs.
28 | The "whole" format is the easiest for an LLM to use, but it uses a lot of tokens
29 | and may limit how large a file can be edited.
30 | Models which can use one of the diff formats are much more efficient,
31 | using far fewer tokens.
32 | Models that use a diff-like format are able to 
33 | edit larger files with less cost and without hitting token limits.
34 | 
35 | Aider is configured to use the best edit format for the popular OpenAI and Anthropic models
36 | and the [other models recommended on the LLM page](/docs/llms.html).
37 | For lesser known models aider will default to using the "whole" editing format
38 | since it is the easiest format for an LLM to use.
39 | 


--------------------------------------------------------------------------------
/aider/website/docs/llms.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | title: Connecting to LLMs
 3 | nav_order: 40
 4 | has_children: true
 5 | description: Aider can connect to most LLMs for AI pair programming.
 6 | ---
 7 | 
 8 | # Aider can connect to most LLMs
 9 | {: .no_toc }
10 | 
11 | [![connecting to many LLMs](/assets/llms.jpg)](https://aider.chat/assets/llms.jpg)
12 | 
13 | 
14 | ## Best models
15 | {: .no_toc }
16 | 
17 | Aider works best with these models, which are skilled at editing code:
18 | 
19 | - [DeepSeek R1 and V3](/docs/llms/deepseek.html)
20 | - [Claude 3.7 Sonnet](/docs/llms/anthropic.html)
21 | - [OpenAI o1, o3-mini and GPT-4o](/docs/llms/openai.html)
22 | 
23 | 
24 | ## Free models
25 | {: .no_toc }
26 | 
27 | Aider works with a number of **free** API providers:
28 | 
29 | - Google's [Gemini 1.5 Pro](/docs/llms/gemini.html) works with aider, with
30 | code editing capabilities similar to GPT-3.5.
31 | - You can use [Llama 3 70B on Groq](/docs/llms/groq.html) which is comparable to GPT-3.5 in code editing performance.
32 | - Cohere also offers free API access to their [Command-R+ model](/docs/llms/cohere.html), which works with aider as a *very basic* coding assistant.
33 | 
34 | ## Local models
35 | {: .no_toc }
36 | 
37 | Aider can work also with local models, for example using [Ollama](/docs/llms/ollama.html).
38 | It can also access
39 | local models that provide an
40 | [Open AI compatible API](/docs/llms/openai-compat.html).
41 | 
42 | ## Use a capable model
43 | {: .no_toc }
44 | 
45 | Check
46 | [Aider's LLM leaderboards](https://aider.chat/docs/leaderboards/)
47 | to see which models work best with aider.
48 | 
49 | Be aware that aider may not work well with less capable models.
50 | If you see the model returning code, but aider isn't able to edit your files
51 | and commit the changes...
52 | this is usually because the model isn't capable of properly
53 | returning "code edits".
54 | Models weaker than GPT 3.5 may have problems working well with aider.
55 | 
56 | 


--------------------------------------------------------------------------------
/aider/website/docs/llms/anthropic.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Connecting to LLMs
 3 | nav_order: 200
 4 | ---
 5 | 
 6 | # Anthropic
 7 | 
 8 | To work with Anthropic's models, you need to provide your
 9 | [Anthropic API key](https://docs.anthropic.com/claude/reference/getting-started-with-the-api)
10 | either in the `ANTHROPIC_API_KEY` environment variable or
11 | via the `--anthropic-api-key` command line switch.
12 | 
13 | Aider has some built in shortcuts for the most popular Anthropic models and
14 | has been tested and benchmarked to work well with them:
15 | 
16 | ```
17 | python -m pip install -U aider-chat
18 | 
19 | export ANTHROPIC_API_KEY=<key> # Mac/Linux
20 | setx   ANTHROPIC_API_KEY <key> # Windows, restart shell after setx
21 | 
22 | # Aider uses Claude 3.7 Sonnet by default
23 | aider
24 | 
25 | # Claude 3 Opus
26 | aider --model claude-3-opus-20240229
27 | 
28 | # List models available from Anthropic
29 | aider --list-models anthropic/
30 | ```
31 | 
32 | {: .tip }
33 | Anthropic has very low rate limits. 
34 | You can access all the Anthropic models via
35 | [OpenRouter](openrouter.md)
36 | or [Google Vertex AI](vertex.md)
37 | with more generous rate limits.
38 | 
39 | You can use `aider --model <model-name>` to use any other Anthropic model.
40 | For example, if you want to use a specific version of Opus
41 | you could do `aider --model claude-3-opus-20240229`.
42 | 
43 | ## Thinking tokens
44 | 
45 | Aider can work with Sonnet 3.7's new thinking tokens, but does not ask Sonnet to use
46 | thinking tokens by default.
47 | 
48 | Enabling thinking currently requires manual configuration.
49 | You need to add the following to your `.aider.model.settings.yml` 
50 | [model settings file](/docs/config/adv-model-settings.html#model-settings).
51 | Adjust the `budget_tokens` value to change the target number of thinking tokens.
52 | 
53 | ```yaml
54 | - name: anthropic/claude-3-7-sonnet-20250219
55 |   edit_format: diff
56 |   weak_model_name: anthropic/claude-3-5-haiku-20241022
57 |   use_repo_map: true
58 |   examples_as_sys_msg: true
59 |   use_temperature: false
60 |   extra_params:
61 |     extra_headers:
62 |       anthropic-beta: prompt-caching-2024-07-31,pdfs-2024-09-25,output-128k-2025-02-19
63 |     max_tokens: 64000
64 |     thinking:
65 |       type: enabled
66 |       budget_tokens: 32000 # Adjust this number
67 |   cache_control: true
68 |   editor_model_name: anthropic/claude-3-7-sonnet-20250219
69 |   editor_edit_format: editor-diff
70 | ```
71 | 
72 | More streamlined support will be coming soon.
73 | 


--------------------------------------------------------------------------------
/aider/website/docs/llms/azure.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Connecting to LLMs
 3 | nav_order: 500
 4 | ---
 5 | 
 6 | # Azure
 7 | 
 8 | Aider can connect to the OpenAI models on Azure.
 9 | 
10 | ```
11 | python -m pip install -U aider-chat
12 | 
13 | # Mac/Linux:                                           
14 | export AZURE_API_KEY=<key>
15 | export AZURE_API_VERSION=2023-05-15
16 | export AZURE_API_BASE=https://myendpt.openai.azure.com
17 | 
18 | # Windows
19 | setx AZURE_API_KEY <key>
20 | setx AZURE_API_VERSION 2023-05-15
21 | setx AZURE_API_BASE https://myendpt.openai.azure.com
22 | # ... restart your shell after setx commands
23 | 
24 | aider --model azure/<your_deployment_name>
25 | 
26 | # List models available from Azure
27 | aider --list-models azure/
28 | ```
29 | 
30 | Note that aider will also use environment variables
31 | like `AZURE_OPENAI_API_xxx`.
32 | 


--------------------------------------------------------------------------------
/aider/website/docs/llms/cohere.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Connecting to LLMs
 3 | nav_order: 500
 4 | ---
 5 | 
 6 | # Cohere
 7 | 
 8 | Cohere offers *free* API access to their models.
 9 | Their Command-R+ model works well with aider
10 | as a *very basic* coding assistant.
11 | You'll need a [Cohere API key](https://dashboard.cohere.com/welcome/login).
12 | 
13 | To use **Command-R+**:
14 | 
15 | ```
16 | python -m pip install -U aider-chat
17 | 
18 | export COHERE_API_KEY=<key> # Mac/Linux
19 | setx   COHERE_API_KEY <key> # Windows, restart shell after setx
20 | 
21 | aider --model command-r-plus-08-2024
22 | 
23 | # List models available from Cohere
24 | aider --list-models cohere_chat/
25 | ```
26 | 


--------------------------------------------------------------------------------
/aider/website/docs/llms/deepseek.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Connecting to LLMs
 3 | nav_order: 500
 4 | ---
 5 | 
 6 | # DeepSeek
 7 | 
 8 | Aider can connect to the DeepSeek.com API.
 9 | To work with DeepSeek's models, you need to set the `DEEPSEEK_API_KEY` environment variable with your [DeepSeek API key](https://platform.deepseek.com/api_keys).  
10 | The DeepSeek Chat V3 model has a top score on aider's code editing benchmark.
11 | 
12 | ```
13 | python -m pip install -U aider-chat
14 | 
15 | export DEEPSEEK_API_KEY=<key> # Mac/Linux
16 | setx   DEEPSEEK_API_KEY <key> # Windows, restart shell after setx
17 | 
18 | # Use DeepSeek Chat v3
19 | aider --model deepseek/deepseek-chat
20 | ```
21 | 
22 | 


--------------------------------------------------------------------------------
/aider/website/docs/llms/gemini.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Connecting to LLMs
 3 | nav_order: 300
 4 | ---
 5 | 
 6 | # Gemini
 7 | 
 8 | You'll need a [Gemini API key](https://aistudio.google.com/app/u/2/apikey).
 9 | 
10 | ```
11 | python -m pip install -U aider-chat
12 | 
13 | # You may need to install google-generativeai
14 | pip install -U google-generativeai
15 | 
16 | # Or with pipx...
17 | pipx inject aider-chat google-generativeai
18 | 
19 | export GEMINI_API_KEY=<key> # Mac/Linux
20 | setx   GEMINI_API_KEY <key> # Windows, restart shell after setx
21 | 
22 | aider --model gemini/gemini-1.5-pro-latest
23 | 
24 | # List models available from Gemini
25 | aider --list-models gemini/
26 | ```
27 | 
28 | 


--------------------------------------------------------------------------------
/aider/website/docs/llms/groq.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Connecting to LLMs
 3 | nav_order: 400
 4 | ---
 5 | 
 6 | # GROQ
 7 | 
 8 | Groq currently offers *free* API access to the models they host.
 9 | The Llama 3 70B model works
10 | well with aider and is comparable to GPT-3.5 in code editing performance.
11 | You'll need a [Groq API key](https://console.groq.com/keys).
12 | 
13 | To use **Llama3 70B**:
14 | 
15 | ```
16 | python -m pip install -U aider-chat
17 | 
18 | export GROQ_API_KEY=<key> # Mac/Linux
19 | setx   GROQ_API_KEY <key> # Windows, restart shell after setx
20 | 
21 | aider --model groq/llama3-70b-8192
22 | 
23 | # List models available from Groq
24 | aider --list-models groq/
25 | ```
26 | 
27 | 
28 | 


--------------------------------------------------------------------------------
/aider/website/docs/llms/lm-studio.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Connecting to LLMs
 3 | nav_order: 400
 4 | ---
 5 | 
 6 | # LM Studio
 7 | 
 8 | To use LM Studio:
 9 | 
10 | ```
11 | python -m pip install -U aider-chat
12 | 
13 | # Must set a value here even if its a dummy value
14 | export LM_STUDIO_API_KEY=dummy-api-key # Mac/Linux
15 | setx   LM_STUDIO_API_KEY dummy-api-key # Windows, restart shell after setx
16 | 
17 | # LM Studio default server URL is http://localhost:1234/v1
18 | export LM_STUDIO_API_BASE=http://localhost:1234/v1 # Mac/Linux
19 | setx   LM_STUDIO_API_BASE http://localhost:1234/v1 # Windows, restart shell after setx
20 | 
21 | aider --model lm_studio/<your-model-name>
22 | ```
23 | 
24 | **Note:** Even though LM Studio doesn't require an API Key out of the box the `LM_STUDIO_API_KEY` must have a dummy value like `dummy-api-key` set or the client request will fail trying to send an empty `Bearer` token.
25 | 
26 | See the [model warnings](warnings.html)
27 | section for information on warnings which will occur
28 | when working with models that aider is not familiar with.
29 | 


--------------------------------------------------------------------------------
/aider/website/docs/llms/ollama.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Connecting to LLMs
 3 | nav_order: 500
 4 | ---
 5 | 
 6 | # Ollama
 7 | 
 8 | Aider can connect to local Ollama models.
 9 | 
10 | ```
11 | # Pull the model
12 | ollama pull <model>
13 | 
14 | # Start your ollama server
15 | ollama serve
16 | 
17 | # In another terminal window...
18 | python -m pip install -U aider-chat
19 | 
20 | export OLLAMA_API_BASE=http://127.0.0.1:11434 # Mac/Linux
21 | setx   OLLAMA_API_BASE http://127.0.0.1:11434 # Windows, restart shell after setx
22 | 
23 | aider --model ollama_chat/<model>
24 | ```
25 | 
26 | {: .note }
27 | Using `ollama_chat/` is recommended over `ollama/`.
28 | 
29 | 
30 | See the [model warnings](warnings.html)
31 | section for information on warnings which will occur
32 | when working with models that aider is not familiar with.
33 | 
34 | ## API Key
35 | 
36 | If you are using an ollama that requires an API key you can set `OLLAMA_API_KEY`:
37 | 
38 | ```
39 | export OLLAMA_API_KEY=<api-key> # Mac/Linux
40 | setx   OLLAMA_API_KEY <api-key> # Windows, restart shell after setx
41 | ```
42 | 
43 | ## Setting the context window size
44 | 
45 | [Ollama uses a 2k context window by default](https://github.com/ollama/ollama/blob/main/docs/faq.md#how-can-i-specify-the-context-window-size),
46 | which is very small for working with aider.
47 | It also **silently** discards context that exceeds the window. 
48 | This is especially dangerous because many users don't even realize that most of their data
49 | is being discarded by Ollama.
50 |  
51 | By default, aider sets Ollama's context window 
52 | to be large enough for each request you send plus 8k tokens for the reply.
53 | This ensures data isn't silently discarded by Ollama.
54 | 
55 | If you'd like you can configure a fixed sized context window instead
56 | with an
57 | [`.aider.model.settings.yml` file](https://aider.chat/docs/config/adv-model-settings.html#model-settings)
58 | like this:
59 | 
60 | ```
61 | - name: ollama/qwen2.5-coder:32b-instruct-fp16
62 |   extra_params:
63 |     num_ctx: 65536
64 | ```
65 | 
66 | 


--------------------------------------------------------------------------------
/aider/website/docs/llms/openai-compat.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Connecting to LLMs
 3 | nav_order: 500
 4 | ---
 5 | 
 6 | # OpenAI compatible APIs
 7 | 
 8 | Aider can connect to any LLM which is accessible via an OpenAI compatible API endpoint.
 9 | 
10 | ```
11 | python -m pip install aider-install
12 | aider-install
13 | 
14 | # Mac/Linux:
15 | export OPENAI_API_BASE=<endpoint>
16 | export OPENAI_API_KEY=<key>
17 | 
18 | # Windows:
19 | setx OPENAI_API_BASE <endpoint>
20 | setx OPENAI_API_KEY <key>
21 | # ... restart shell after setx commands
22 | 
23 | # Prefix the model name with openai/
24 | aider --model openai/<model-name>
25 | ```
26 | 
27 | See the [model warnings](warnings.html)
28 | section for information on warnings which will occur
29 | when working with models that aider is not familiar with.
30 | 


--------------------------------------------------------------------------------
/aider/website/docs/llms/openai.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Connecting to LLMs
 3 | nav_order: 100
 4 | ---
 5 | 
 6 | # OpenAI
 7 | 
 8 | To work with OpenAI's models, you need to provide your
 9 | [OpenAI API key](https://help.openai.com/en/articles/4936850-where-do-i-find-my-secret-api-key)
10 | either in the `OPENAI_API_KEY` environment variable or
11 | via the `--api-key openai=<key>` command line switch.
12 | 
13 | Aider has some built in shortcuts for the most popular OpenAI models and
14 | has been tested and benchmarked to work well with them:
15 | 
16 | ```
17 | python -m pip install -U aider-chat
18 | 
19 | # o3-mini
20 | aider --model o3-mini --api-key openai=<key>
21 | 
22 | # o1-mini
23 | aider --model o1-mini --api-key openai=<key>
24 | 
25 | # GPT-4o
26 | aider --model gpt-4o --api-key openai=<key>
27 | 
28 | # List models available from OpenAI
29 | aider --list-models openai/
30 | 
31 | # You can also store you API key in environment variables (or .env)
32 | export OPENAI_API_KEY=<key> # Mac/Linux
33 | setx   OPENAI_API_KEY <key> # Windows, restart shell after setx
34 | ```
35 | 
36 | You can use `aider --model <model-name>` to use any other OpenAI model.
37 | For example, if you want to use a specific version of GPT-4 Turbo
38 | you could do `aider --model gpt-4-0125-preview`.
39 | 
40 | ## Reasoning models from other providers
41 | 
42 | Many of OpenAI's 
43 | "reasoning" models have restrictions on streaming and setting the temperature parameter.
44 | Some also support different levels of "reasoning effort".
45 | Aider is configured to work properly with these models
46 | when served through major provider APIs and
47 | has a `--reasoning-effort` setting.
48 | 
49 | You may need to [configure reasoning model settings](/docs/config/reasoning.html)
50 | if you are using them through another provider
51 | and see errors related to temperature or system prompt.
52 | 


--------------------------------------------------------------------------------
/aider/website/docs/llms/vertex.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Connecting to LLMs
 3 | nav_order: 550
 4 | ---
 5 | 
 6 | # Vertex AI
 7 | 
 8 | Aider can connect to models provided by Google Vertex AI.
 9 | You will need to install the
10 | [gcloud CLI](https://cloud.google.com/sdk/docs/install) and [login](https://cloud.google.com/sdk/docs/initializing) with a GCP account
11 | or service account with permission to use the Vertex AI API.
12 | 
13 | With your chosen login method, the gcloud CLI should automatically set the
14 | `GOOGLE_APPLICATION_CREDENTIALS` environment variable which points to the credentials file.
15 | 
16 | To configure Aider to use the Vertex AI API, you need to set `VERTEXAI_PROJECT` (the GCP project ID)
17 | and `VERTEXAI_LOCATION` (the GCP region) [environment variables for Aider](/docs/config/dotenv.html).
18 | 
19 | Note that Claude on Vertex AI is only available in certain GCP regions, 
20 | check [the model card](https://console.cloud.google.com/vertex-ai/publishers/anthropic/model-garden/claude-3-5-sonnet) 
21 | for your model to see which regions are supported.
22 | 
23 | Example `.env` file:
24 | 
25 | ```
26 | VERTEXAI_PROJECT=my-project
27 | VERTEXAI_LOCATION=us-east5
28 | ```
29 | 
30 | Then you can run aider with the `--model` command line switch, like this:
31 | 
32 | ```
33 | aider --model vertex_ai/claude-3-5-sonnet@20240620
34 | ```
35 | 
36 | Or you can use the [yaml config](/docs/config/aider_conf.html) to set the model to any of the 
37 | models supported by Vertex AI.
38 | 
39 | Example `.aider.conf.yml` file:
40 | 
41 | ```yaml
42 | model: vertex_ai/claude-3-5-sonnet@20240620
43 | ```
44 | 


--------------------------------------------------------------------------------
/aider/website/docs/llms/warnings.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Connecting to LLMs
 3 | nav_order: 900
 4 | ---
 5 | 
 6 | # Model warnings
 7 | 
 8 | {% include model-warnings.md %}
 9 | 
10 | 
11 | 


--------------------------------------------------------------------------------
/aider/website/docs/llms/xai.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Connecting to LLMs
 3 | nav_order: 400
 4 | ---
 5 | 
 6 | # xAI
 7 | 
 8 | You'll need a [xAI API key](https://console.x.ai.).
 9 | 
10 | To use xAI:
11 | 
12 | ```
13 | python -m pip install -U aider-chat
14 | 
15 | export XAI_API_KEY=<key> # Mac/Linux
16 | setx   XAI_API_KEY <key> # Windows, restart shell after setx
17 | 
18 | aider --model xai/grok-beta
19 | 
20 | # List models available from xAI
21 | aider --list-models xai/
22 | ```
23 | 
24 | 
25 | 


--------------------------------------------------------------------------------
/aider/website/docs/more-info.md:
--------------------------------------------------------------------------------
1 | ---
2 | has_children: true
3 | nav_order: 85
4 | ---
5 | 
6 | # More info
7 | 
8 | See below for more info about aider, including some advanced topics.
9 | 


--------------------------------------------------------------------------------
/aider/website/docs/troubleshooting.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | nav_order: 60
 3 | has_children: true
 4 | description: How to troubleshoot problems with aider and get help.
 5 | ---
 6 | 
 7 | # Troubleshooting
 8 | 
 9 | Below are some approaches for troubleshooting problems with aider.
10 | 
11 | {% include help.md %}
12 | 


--------------------------------------------------------------------------------
/aider/website/docs/troubleshooting/aider-not-found.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Troubleshooting
 3 | nav_order: 28
 4 | ---
 5 | 
 6 | # Aider not found
 7 | 
 8 | In some environments the `aider` command may not be available
 9 | on your shell path.
10 | This can occur because of permissions/security settings in your OS,
11 | and often happens to Windows users.
12 | 
13 | You may see an error message like this:
14 | 
15 | > aider: The term 'aider' is not recognized as a name of a cmdlet, function, script file, or executable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
16 | 
17 | Below is the most fail safe way to run aider in these situations:
18 | 
19 | ```
20 | python -m aider
21 | ```
22 | 
23 | You should also consider 
24 | [installing aider using aider-install, uv or pipx](/docs/install.html).
25 | 


--------------------------------------------------------------------------------
/aider/website/docs/troubleshooting/imports.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Troubleshooting
 3 | nav_order: 28
 4 | ---
 5 | 
 6 | # Dependency versions
 7 | 
 8 | Aider expects to be installed with the
 9 | correct versions of all of its required dependencies.
10 | 
11 | If you've been linked to this doc from a GitHub issue, 
12 | or if aider is reporting `ImportErrors`
13 | it is likely that your
14 | aider install is using incorrect dependencies.
15 | 
16 | 
17 | ## Avoid package conflicts
18 | 
19 | If you are using aider to work on a python project, sometimes your project will require
20 | specific versions of python packages which conflict with the versions that aider
21 | requires.
22 | If this happens, you may see errors like these when running pip installs:
23 | 
24 | ```
25 | aider-chat 0.23.0 requires somepackage==X.Y.Z, but you have somepackage U.W.V which is incompatible.
26 | ```
27 | 
28 | ## Install with aider-install, uv or pipx
29 | 
30 | If you are having dependency problems you should consider
31 | [installing aider using aider-install, uv or pipx](/docs/install.html).
32 | This will ensure that aider is installed in its own python environment,
33 | with the correct set of dependencies.
34 | 
35 | ## Package managers like Homebrew, AUR, ports
36 | 
37 | Package managers often install aider with the wrong dependencies, leading
38 | to import errors and other problems.
39 | 
40 | It is recommended to
41 | [install aider using aider-install, uv or pipx](/docs/install.html).
42 | 
43 | 
44 | ## Dependency versions matter
45 | 
46 | Aider pins its dependencies and is tested to work with those specific versions.
47 | If you are installing aider directly with pip
48 | you should be careful about upgrading or downgrading the python packages that
49 | aider uses.
50 | 
51 | In particular, be careful with the packages with pinned versions 
52 | noted at the end of
53 | [aider's requirements.in file](https://github.com/Aider-AI/aider/blob/main/requirements/requirements.in).
54 | These versions are pinned because aider is known not to work with the
55 | latest versions of these libraries.
56 | 
57 | Also be wary of upgrading `litellm`, as it changes versions frequently
58 | and sometimes introduces bugs or backwards incompatible changes.
59 | 
60 | ## Replit
61 | 
62 | {% include replit-pipx.md %}
63 | 


--------------------------------------------------------------------------------
/aider/website/docs/troubleshooting/models-and-keys.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Troubleshooting
 3 | nav_order: 28
 4 | ---
 5 | 
 6 | # Models and API keys
 7 | 
 8 | You need to tell aider which LLM to use and provide an API key.
 9 | The easiest way is to use the `--model` and `--api-key`
10 | command line arguments, like this:
11 | 
12 | ```
13 | # Work with DeepSeek via DeepSeek's API
14 | aider --model deepseek --api-key deepseek=your-key-goes-here
15 | 
16 | # Work with Claude 3.7 Sonnet via Anthropic's API
17 | aider --model sonnet --api-key anthropic=your-key-goes-here
18 | 
19 | # Work with o3-mini via OpenAI's API
20 | aider --model o3-mini --api-key openai=your-key-goes-here
21 | 
22 | # Work with Sonnet via OpenRouter's API
23 | aider --model openrouter/anthropic/claude-3.7-sonnet --api-key openrouter=your-key-goes-here
24 | 
25 | # Work with DeepSeek Chat V3 via OpenRouter's API
26 | aider --model openrouter/deepseek/deepseek-chat --api-key openrouter=your-key-goes-here
27 | ```
28 | 
29 | For more information, see the documentation sections:
30 | 
31 | - [Connecting to LLMs](https://aider.chat/docs/llms.html)
32 | - [Configuring API keys](https://aider.chat/docs/config/api-keys.html)
33 | 


--------------------------------------------------------------------------------
/aider/website/docs/troubleshooting/warnings.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Troubleshooting
 3 | nav_order: 20
 4 | ---
 5 | 
 6 | # Model warnings
 7 | 
 8 | {% include model-warnings.md %}
 9 | 
10 | ## More help
11 | 
12 | {% include help.md %}
13 | 


--------------------------------------------------------------------------------
/aider/website/docs/usage/browser.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | title: Aider in your browser
 3 | highlight_image: /assets/browser.jpg
 4 | parent: Usage
 5 | nav_order: 800
 6 | description: Aider can run in your browser, not just on the command line.
 7 | ---
 8 | {% if page.date %}
 9 | <p class="post-date">{{ page.date | date: "%B %d, %Y" }}</p>
10 | {% endif %}
11 | 
12 | # Aider in your browser
13 | 
14 | <div class="video-container">
15 |   <video controls loop poster="/assets/browser.jpg">
16 |     <source src="/assets/aider-browser-social.mp4" type="video/mp4">
17 |     <a href="/assets/aider-browser-social.mp4">Aider browser UI demo video</a>
18 |   </video>
19 | </div>
20 | 
21 | <style>
22 | .video-container {
23 |   position: relative;
24 |   padding-bottom: 101.89%; /* 1080 / 1060 = 1.0189 */
25 |   height: 0;
26 |   overflow: hidden;
27 | }
28 | 
29 | .video-container video {
30 |   position: absolute;
31 |   top: 0;
32 |   left: 0;
33 |   width: 100%;
34 |   height: 100%;
35 | }
36 | </style>
37 | 
38 | Use aider's new experimental browser UI to collaborate with LLMs
39 | to edit code in your local git repo.
40 | Aider will directly edit the code in your local source files,
41 | and [git commit the changes](https://aider.chat/docs/git.html)
42 | with sensible commit messages.
43 | You can start a new project or work with an existing git repo.
44 | Aider works well with 
45 | GPT-4o, Sonnet 3.7, and DeepSeek Chat V3 & R1.
46 | It also supports [connecting to almost any LLM](https://aider.chat/docs/llms.html).
47 | 
48 | Use the `--browser` switch to launch the browser version of aider:
49 | 
50 | ```
51 | python -m pip install -U aider-chat
52 | 
53 | export OPENAI_API_KEY=<key> # Mac/Linux
54 | setx   OPENAI_API_KEY <key> # Windows, restart shell after setx
55 | 
56 | aider --browser
57 | ```
58 | 


--------------------------------------------------------------------------------
/aider/website/docs/usage/caching.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | title: Prompt caching
 3 | highlight_image: /assets/prompt-caching.jpg
 4 | parent: Usage
 5 | nav_order: 750
 6 | description: Aider supports prompt caching for cost savings and faster coding.
 7 | ---
 8 | 
 9 | # Prompt caching
10 | 
11 | Aider supports prompt caching for cost savings and faster coding.
12 | Currently Anthropic provides caching for Sonnet and Haiku,
13 | and DeepSeek provides caching for Chat.
14 | 
15 | Aider organizes the chat history to try and cache:
16 | 
17 | - The system prompt.
18 | - Read only files added with `--read` or `/read-only`.
19 | - The repository map.
20 | - The editable files that have been added to the chat.
21 | 
22 | ![Prompt caching](/assets/prompt-caching.jpg)
23 | 
24 | 
25 | ## Usage
26 | 
27 | Run aider with `--cache-prompts` or add that setting to your 
28 | [configuration files](/docs/config.html).
29 | 
30 | Due to limitations in the provider APIs, caching statistics and costs
31 | are not available when streaming responses.
32 | To turn off streaming, use `--no-stream`.
33 | 
34 | When caching is enabled, it will be noted for the main model when aider launches:
35 | 
36 | ```
37 | Main model: claude-3-5-sonnet-20240620 with diff edit format, prompt cache, infinite output
38 | ```
39 | 
40 | ## Preventing cache expiration
41 | 
42 | Aider can ping the provider to keep your prompt cache warm and prevent
43 | it from expiring.
44 | By default, Anthropic keeps your cache for 5 minutes.
45 | Use `--cache-keepalive-pings N` to tell aider to ping
46 | every 5 minutes to keep the cache warm.
47 | Aider will ping up to `N` times over a period of `N*5` minutes
48 | after each message you send.
49 | 
50 | 


--------------------------------------------------------------------------------
/aider/website/docs/usage/images-urls.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Usage
 3 | nav_order: 700
 4 | description: Add images and web pages to the aider coding chat.
 5 | ---
 6 | 
 7 | # Images & web pages
 8 | 
 9 | You can add images and URLs to the aider chat.
10 | 
11 | ## Images
12 | 
13 | Aider supports working with image files for many vision-capable models
14 | like GPT-4o and Claude 3.7 Sonnet.
15 | Adding images to a chat can be helpful in many situations:
16 | 
17 | - Add screenshots of web pages or UIs that you want aider to build or modify.
18 | - Show aider a mockup of a UI you want to build.
19 | - Screenshot an error message that is otherwise hard to copy & paste as text.
20 | - Etc.
21 | 
22 | You can add images to the chat just like you would
23 | add any other file:
24 | 
25 | - Use `/add <image-filename>` from within the chat
26 | - Use `/paste` to paste an image from your clipboard into the chat.
27 | - Launch aider with image filenames on the command line: `aider <image-filename>` along with any other command line arguments you need.
28 | 
29 | ## Web pages
30 | 
31 | Aider can scrape the text from URLs and add it to the chat.
32 | This can be helpful to:
33 | 
34 | - Include documentation pages for less popular APIs.
35 | - Include the latest docs for libraries or packages that are newer than the model's training cutoff date.
36 | - Etc.
37 | 
38 | To add URLs to the chat:
39 | 
40 | - Use `/web <url>`
41 | - Just paste the URL into the chat and aider will ask if you want to add it.
42 | 
43 | You can also scrape web pages from the command line to see the markdown version that aider produces:
44 | 
45 | 
46 | ```
47 | python -m aider.scrape https://aider.chat/docs/usage/tips.html
48 | ```
49 | 


--------------------------------------------------------------------------------
/aider/website/docs/usage/tutorials.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Usage
 3 | nav_order: 75
 4 | description: Intro and tutorial videos made by aider users.
 5 | ---
 6 | 
 7 | # Tutorial videos
 8 | 
 9 | Here are some tutorial videos made by aider users:
10 | 
11 | - [Using Architect/Editor mode](https://www.youtube.com/watch?v=OPXslklVBZc) -- AICodeKing
12 | - [Using aider to incrementally build a non-trivial app](https://youtu.be/QlUt06XLbJE) -- IndyDevDan
13 | - [Aider and Replit on mobile with your voice](https://x.com/itsPaulAi/status/1830987090617831810) -- Paul Couvert
14 | - [Aider is the OG AI Coding King (Mermaid Diagram AI Agent)](https://www.youtube.com/watch?v=ag-KxYS8Vuw) -- IndyDevDan
15 | - [Installing aider in replit and making a Trello clone](https://x.com/itspaulai/status/1828834199597633724) -- Paul Couvert
16 | - [Step-by-Step Development Environment Setup for AI-Assisted Coding](https://www.youtube.com/watch?v=DnBVgfe6ZQM) -- Coding the Future With AI
17 | - [Generate FULL-STACK Apps with Claude 3.5 Sonnet](https://youtu.be/sKeIZGW8xzg) -- AICodeKing
18 | - [Creating Games with AI from Start-To-End](https://youtu.be/sOd2YYZFMUs) -- AICodeKing
19 | - [Claude 3.5 and aider: Use AI Assistants to Build AI Apps](https://youtu.be/0hIisJ3xAdU) -- Coding the Future With AI
20 | - [Develop a Full-stack App Without Writing ANY Code](https://youtu.be/dzOWn8TI738) -- WorldofAI
21 | - [Generate Games with AI (w/ Local LLMs)](https://youtu.be/DjVJpGzQbSA) -- AICodeKing
22 | - [Aider tips and Example use](https://www.youtube.com/watch?v=OsChkvGGDgw) -- techfren
23 | - [Aider and Claude 3.5: Develop a Full-stack App Without Writing ANY Code!](https://www.youtube.com/watch?v=BtAqHsySdSY) -- Coding the Future With AI
24 | - [Generate application with just one prompt using Aider](https://www.youtube.com/watch?v=Y-_0VkMUiPc&t=78s) -- AICodeKing
25 | - [Aider : the production ready AI coding assistant you've been waiting for](https://www.youtube.com/watch?v=zddJofosJuM) -- Learn Code With JV
26 | - [Holy Grail: FREE Coding Assistant That Can Build From EXISTING CODE BASE](https://www.youtube.com/watch?v=df8afeb1FY8) -- Matthew Berman
27 | - [Aider: This AI Coder Can Create AND Update Git Codebases](https://www.youtube.com/watch?v=EqLyFT78Sig) -- Ian Wootten
28 | 
29 | Thanks to all these great creators for taking the time
30 | to share their experiences coding with aider!
31 | 


--------------------------------------------------------------------------------
/aider/website/examples/asciinema.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Example chat transcripts
 3 | ---
 4 | 
 5 | # Editing an asciinema cast file with aider
 6 | 
 7 | The user needs to make some tedious edits to the escape sequences in an `asciinema` screencast file.
 8 | 
 9 | <div class="chat-transcript" markdown="1">
10 | 
11 | > $ aider hello.cast  
12 | > Added hello.cast to the chat  
13 | 
14 | #### when the "hello.py> " prompt is displayed, it's including some escape codes to add a few blank lines below the prompt and then bringing the cursor back up. remove all that. just show the prompt followed by a space and leave the cursor showing right after that.  
15 | 
16 | ```python
17 | hello.cast
18 | <<<<<<< ORIGINAL
19 | [19.534013, "o", "\u001b[?2004h\u001b[?1l\u001b[?25l\u001b[0m\u001b[?7l\u001b[0m\u001b[J\u001b[0;38;5;28mhello.py>  \u001b[0m\r\r\n\r\r\n\r\r\n\u001b[0;38;5;28m                                                                \r\u001b[64C \r\u001b[3A\u001b[10C\u001b[?7h\u001b[0m\u001b[?12l\u001b[?25h"]
20 | =======
21 | [19.534013, "o", "\u001b[?2004h\u001b[?1l\u001b[?25l\u001b[0m\u001b[?7l\u001b[0m\u001b[J\u001b[0;38;5;28mhello.py> \u001b[0m\u001b[?7h\u001b[0m\u001b[?12l\u001b[?25h"]
22 | >>>>>>> UPDATED
23 | ```
24 | 
25 | > Applied edit to hello.cast  
26 | > Commit a3fa4d2 aider: Removed escape codes to display prompt and cursor correctly.  
27 | 
28 | 
29 | </div>
30 | 


--------------------------------------------------------------------------------
/aider/website/examples/hello.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Example chat transcripts
 3 | ---
 4 | 
 5 | # Hello aider!
 6 | 
 7 | Here is the simplest possible "hello world" example of using aider:
 8 | 
 9 | <br/>
10 | <br/>
11 | <br/>
12 | <div class="chat-transcript" markdown="1">
13 | 
14 | #### change hello to goodbye
15 | 
16 | To change the output from "hello" to "goodbye", we need to modify the `hello.py` file.
17 | 
18 | Here is the change:
19 | 
20 | ```python
21 | hello.py
22 | <<<<<<< ORIGINAL
23 | print("hello")
24 | =======
25 | print("goodbye")
26 | >>>>>>> UPDATED
27 | ```
28 | 
29 | > Applied edit to hello.py  
30 | > Commit 672ae42 aider: Changed output from "hello" to "goodbye" in hello.py.
31 | 
32 | </div>
33 | <br/>
34 | <br/>
35 | <br/>
36 | 


--------------------------------------------------------------------------------
/aider/website/examples/semantic-search-replace.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | parent: Example chat transcripts
 3 | ---
 4 | # Semantic search & replace code with aider
 5 | 
 6 | In this chat transcript, the user asks to modify a series of function calls. 
 7 | 
 8 | Notice that it isn't replacing exact strings.
 9 | Making the change requires dealing with various formatting and semantic differences in the calls that it is updating.
10 | 
11 | Some edits were elided from this transcript for brevity.
12 | 
13 | <div class="chat-transcript" markdown="1">
14 | 
15 | > $ aider aider/coder.py  
16 | > Added aider/coder.py to the chat  
17 | 
18 | #### replace all the self.console.print() calls that contain [red] with calls to self.io.tool_error() with [red] removed from the string
19 | 
20 | ```python
21 | aider/coder.py
22 | <<<<<<< ORIGINAL
23 |             self.console.print(
24 |                 f"[red]This tool will almost certainly fail to work with {main_model}"
25 |             )
26 | =======
27 |             self.io.tool_error(f"This tool will almost certainly fail to work with {main_model}")
28 | >>>>>>> UPDATED
29 | ```
30 | 
31 | ```python
32 | aider/coder.py
33 | <<<<<<< ORIGINAL
34 |             self.console.print("[red]Files are not in a git repo.")
35 | =======
36 |             self.io.tool_error("Files are not in a git repo.")
37 | >>>>>>> UPDATED
38 | ```
39 | 
40 | ```python
41 | aider/coder.py
42 | <<<<<<< ORIGINAL
43 |             self.console.print("[red]Malformed ORIGINAL/UPDATE blocks, retrying...")
44 |             self.console.print("[red]", Text(err))
45 | =======
46 |             self.io.tool_error("Malformed ORIGINAL/UPDATE blocks, retrying...")
47 |             self.io.tool_error(Text(err))
48 | >>>>>>> UPDATED
49 | ```
50 | 
51 | Please note that I couldn't find the `self.io.tool_error()` method in the provided code. You may need to create this method in the appropriate class or provide the correct method name to replace the `self.console.print()` calls.
52 | 
53 | > Applied edit to aider/coder.py  
54 | > Applied edit to aider/coder.py  
55 | > Applied edit to aider/coder.py  
56 | > Commit 919cfc2 aider: Replaced all self.console.print() calls with self.io.tool_error() calls with [red] removed from the string.  
57 | 
58 | 
59 | </div>
60 | 


--------------------------------------------------------------------------------
/benchmark/Dockerfile:
--------------------------------------------------------------------------------
 1 | FROM buildpack-deps:jammy
 2 | 
 3 | # Install Python 3.11
 4 | RUN apt-get update && apt-get install -y \
 5 |     software-properties-common \
 6 |     cmake \
 7 |     libboost-all-dev \
 8 |     && add-apt-repository ppa:deadsnakes/ppa \
 9 |     && apt-get update \
10 |     && apt-get install -y \
11 |     python3.11 \
12 |     python3.11-venv \
13 |     python3.11-dev \
14 |     python3-pip \
15 |     ca-certificates-java \
16 |     openjdk-21-jdk \
17 |     libtbb-dev \
18 |     && rm -rf /var/lib/apt/lists/*
19 | 
20 | # Make python3.11 the default python3
21 | RUN update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 1
22 | 
23 | # Install Go with architecture detection
24 | RUN ARCH=$(uname -m) && \
25 |     if [ "$ARCH" = "x86_64" ]; then \
26 |         GOARCH="amd64"; \
27 |     elif [ "$ARCH" = "aarch64" ]; then \
28 |         GOARCH="arm64"; \
29 |     else \
30 |         false; \
31 |     fi && \
32 |     curl -L "https://golang.org/dl/go1.21.5.linux-$GOARCH.tar.gz" -o go.tar.gz && \
33 |     tar -C /usr/local -xzf go.tar.gz && \
34 |     rm go.tar.gz
35 | ENV PATH="/usr/local/go/bin:${PATH}"
36 | 
37 | # Install Rust
38 | ADD https://sh.rustup.rs /tmp/rustup.sh
39 | RUN chmod +x /tmp/rustup.sh && /tmp/rustup.sh -y && rm /tmp/rustup.sh
40 | ENV PATH="/root/.cargo/bin:${PATH}"
41 | 
42 | # Install Node.js and dependencies
43 | RUN curl -fsSL https://deb.nodesource.com/setup_20.x | bash - && \
44 |     apt-get install -y nodejs && \
45 |     rm -rf /var/lib/apt/lists/* && \
46 |     mkdir -p /npm-install && \
47 |     cd /npm-install && \
48 |     npm init -y && \
49 |     npm install \
50 |     jest \
51 |     @babel/core@7.25.2 \
52 |     @exercism/babel-preset-javascript@0.2.1 \
53 |     @exercism/eslint-config-javascript@0.6.0 \
54 |     @types/jest@29.5.12 \
55 |     @types/node@20.12.12 \
56 |     babel-jest@29.6.4 \
57 |     core-js@3.37.1 \
58 |     eslint@8.49.0
59 | 
60 | COPY . /aider
61 | RUN pip3 install --no-cache-dir --upgrade pip uv
62 | RUN uv pip install --system --no-cache-dir -e /aider[dev]
63 | RUN git config --global --add safe.directory /aider
64 | WORKDIR /aider
65 | 


--------------------------------------------------------------------------------
/benchmark/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/benchmark/__init__.py


--------------------------------------------------------------------------------
/benchmark/clone-exercism.sh:
--------------------------------------------------------------------------------
 1 | #!/bin/bash
 2 | 
 3 | # Create directories if they don't exist
 4 | mkdir -p tmp.benchmarks/exercism
 5 | 
 6 | # Change to the exercism directory
 7 | cd tmp.benchmarks/exercism
 8 | 
 9 | # List of languages to clone
10 | languages=("cpp" "go" "java" "javascript" "python" "rust")
11 | 
12 | # Clone each repository
13 | for lang in "${languages[@]}"; do
14 |     if [ ! -d "$lang" ]; then
15 |         echo "Cloning $lang repository..."
16 |         git clone "https://github.com/exercism/$lang"
17 |     else
18 |         echo "$lang repository already exists"
19 |     fi
20 | done
21 | 


--------------------------------------------------------------------------------
/benchmark/cpp-test.sh:
--------------------------------------------------------------------------------
 1 | #!/bin/bash
 2 | 
 3 | # exit when any command fails
 4 | set -e
 5 | 
 6 | [ ! -d "build" ] && mkdir build
 7 | cd build
 8 | cmake -DEXERCISM_RUN_ALL_TESTS=1 -G "Unix Makefiles" ..
 9 | make
10 | 
11 | 
12 | 


--------------------------------------------------------------------------------
/benchmark/docker.sh:
--------------------------------------------------------------------------------
 1 | #!/bin/bash
 2 | 
 3 | docker run \
 4 |        -it --rm \
 5 |        --memory=25g \
 6 |        --memory-swap=25g \
 7 |        --add-host=host.docker.internal:host-gateway \
 8 |        -v `pwd`:/aider \
 9 |        -v `pwd`/tmp.benchmarks/.:/benchmarks \
10 |        -e OPENAI_API_KEY=$OPENAI_API_KEY \
11 |        -e HISTFILE=/aider/.bash_history \
12 |        -e PROMPT_COMMAND='history -a' \
13 |        -e HISTCONTROL=ignoredups \
14 |        -e HISTSIZE=10000 \
15 |        -e HISTFILESIZE=20000 \
16 |        -e AIDER_DOCKER=1 \
17 |        -e AIDER_BENCHMARK_DIR=/benchmarks \
18 |        aider-benchmark \
19 |        bash
20 | 


--------------------------------------------------------------------------------
/benchmark/docker_build.sh:
--------------------------------------------------------------------------------
1 | #!/bin/bash
2 | 
3 | set -e
4 | 
5 | docker build \
6 |        --file benchmark/Dockerfile \
7 |        -t aider-benchmark \
8 |        .
9 | 


--------------------------------------------------------------------------------
/benchmark/install-docker-ubuntu.sh:
--------------------------------------------------------------------------------
 1 | #!/bin/bash
 2 | 
 3 | # Exit on error
 4 | set -e
 5 | 
 6 | # Update package index
 7 | echo "Updating package index..."
 8 | sudo apt-get update
 9 | 
10 | # Install prerequisites
11 | echo "Installing prerequisites..."
12 | sudo apt-get install -y \
13 |     apt-transport-https \
14 |     ca-certificates \
15 |     curl \
16 |     gnupg \
17 |     lsb-release
18 | 
19 | # Add Docker's official GPG key
20 | echo "Adding Docker's GPG key..."
21 | sudo mkdir -p /etc/apt/keyrings
22 | curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
23 | 
24 | # Set up the repository
25 | echo "Setting up Docker repository..."
26 | echo \
27 |   "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
28 |   $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
29 | 
30 | # Update package index again
31 | sudo apt-get update
32 | 
33 | # Install Docker Engine
34 | echo "Installing Docker Engine..."
35 | sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
36 | 
37 | # Add current user to docker group and verify
38 | echo "Adding current user to docker group..."
39 | sudo usermod -aG docker $USER
40 | 
41 | # Verify group addition
42 | if getent group docker | grep -q "\b${USER}\b"; then
43 |     echo "Successfully added $USER to docker group"
44 | else
45 |     echo "Failed to add $USER to docker group. Retrying..."
46 |     # Force group addition
47 |     sudo gpasswd -a $USER docker
48 | fi
49 | 
50 | # Print success message and instructions
51 | echo "Docker installation completed successfully!"
52 | 
53 | # Start Docker service
54 | echo "Starting Docker service..."
55 | sudo systemctl start docker
56 | sudo systemctl enable docker
57 | 
58 | # Verify Docker installation and service status
59 | echo "Docker version:"
60 | docker --version
61 | 
62 | echo "Docker Compose version:"
63 | docker compose version
64 | 


--------------------------------------------------------------------------------
/benchmark/npm-test.sh:
--------------------------------------------------------------------------------
 1 | #!/bin/bash
 2 | 
 3 | # exit when any command fails
 4 | set -e
 5 | 
 6 | # Create symlinks if they don't exist
 7 | [ ! -e node_modules ] && ln -s /npm-install/node_modules .
 8 | [ ! -e package-lock.json ] && ln -s /npm-install/package-lock.json .
 9 | 
10 | 
11 | sed -i 's/\bxtest(/test(/g' *.spec.js
12 | npm run test
13 | 
14 | 


--------------------------------------------------------------------------------
/benchmark/plot.sh:
--------------------------------------------------------------------------------
 1 | #!/bin/bash
 2 | 
 3 | # exit when any command fails
 4 | set -e
 5 | 
 6 | ./benchmark/benchmark.py --stats \
 7 |       2023-06-29-11-04-31--gpt-3.5-turbo-0301 \
 8 |       2023-06-29-11-17-32--gpt-3.5-turbo-0613 \
 9 |       2023-06-29-22-18-10--diff-func-string-accept-lists \
10 |       2023-06-29-22-33-14--whole-func \
11 |       2023-06-29-22-33-21--whole-func-string \
12 |       2023-06-30-02-39-48--0613-diff \
13 |       2023-06-30-02-59-11--0301-diff \
14 |       2023-06-30-03-53-55--gpt-3.5-turbo-16k-0613-diff \
15 |       2023-06-30-04-34-00--gpt-3.5-turbo-16k-0613-diff-func-string \
16 |       2023-06-30-05-02-45--gpt-3.5-turbo-16k-0613-whole \
17 |       2023-06-30-05-08-40--gpt-3.5-turbo-16k-0613-whole-func \
18 |       2023-06-30-05-31-44--gpt-4-0314-whole \
19 |       2023-06-30-05-43-54--gpt-4-0314-diff \
20 |       2023-06-30-06-06-02--gpt-4-0613-diff-func-string \
21 |       2023-06-30-06-19-22--gpt-4-0613-whole \
22 |       2023-06-30-13-09-51--gpt-4-0613-diff \
23 |       2023-06-30-13-28-09--gpt-4-0613-whole-func \
24 |       2023-06-30-17-05-20--gpt-3.5-0613-whole-repeat-1 \
25 |       2023-06-30-17-17-42--gpt-3.5-0613-whole-repeat-2 \
26 |       2023-06-30-17-27-04--gpt-3.5-0613-whole-repeat-3 \
27 |       2023-06-30-17-35-07--gpt-3.5-0613-whole-repeat-4 \
28 |       2023-06-30-17-46-25--gpt-3.5-0613-whole-repeat-5
29 | 
30 | 


--------------------------------------------------------------------------------
/benchmark/prompts.py:
--------------------------------------------------------------------------------
 1 | instructions_addendum = """
 2 | ####
 3 | 
 4 | Use the above instructions to modify the supplied files: {file_list}
 5 | Don't change the names of existing functions or classes, as they may be referenced from other code like unit tests, etc.
 6 | Only use standard libraries, don't suggest installing any packages.
 7 | """  # noqa: E501
 8 | 
 9 | 
10 | test_failures = """
11 | ####
12 | 
13 | See the testing errors above.
14 | The tests are correct, don't try and change them.
15 | Fix the code in {file_list} to resolve the errors.
16 | """
17 | 


--------------------------------------------------------------------------------
/benchmark/rsync.sh:
--------------------------------------------------------------------------------
 1 | #!/bin/bash
 2 | 
 3 | set -e
 4 | 
 5 | if [ $# -ne 1 ]; then
 6 |     echo "Usage: $0 user@host"
 7 |     exit 1
 8 | fi
 9 | 
10 | DEST="$1"
11 | REPO_ROOT="$(git rev-parse --show-toplevel)"
12 | 
13 | # Create a temporary file for rsync exclude patterns
14 | EXCLUDE_FILE=$(mktemp)
15 | 
16 | # Convert .gitignore patterns to rsync exclude patterns
17 | git -C "$REPO_ROOT" ls-files --exclude-standard --others --ignored --directory > "$EXCLUDE_FILE"
18 | 
19 | # Create remote directory if needed
20 | ssh "$DEST" "mkdir -p ~/aider"
21 | 
22 | sync_repo() {
23 |     # Sync the repository
24 |     rsync -avz --delete \
25 |           --exclude-from="$EXCLUDE_FILE" \
26 |           "$REPO_ROOT/" \
27 |           "$DEST:~/aider/" || sleep 0.1
28 |     
29 |     rsync -av .env .gitignore .aider.model.settings.yml "$DEST:~/aider/." || sleep 0.1
30 | 
31 |     echo Done syncing, waiting.
32 | }
33 |     
34 | sync_repo
35 | 
36 | while true; do
37 |     fswatch -o $REPO_ROOT | while read ; do
38 |         sync_repo
39 |     done
40 | done
41 |                               
42 | 
43 | # Clean up
44 | rm "$EXCLUDE_FILE"
45 | 
46 | 


--------------------------------------------------------------------------------
/benchmark/rungrid.py:
--------------------------------------------------------------------------------
 1 | #!/usr/bin/env python
 2 | 
 3 | import subprocess
 4 | import sys
 5 | 
 6 | from aider.dump import dump  # noqa: F401
 7 | 
 8 | 
 9 | def main():
10 |     models = [
11 |         "gpt-3.5-turbo-0301",
12 |         "gpt-3.5-turbo-0613",
13 |         # "gpt-3.5-turbo-16k-0613",
14 |         "gpt-3.5-turbo-1106",
15 |         # "gpt-4-0314",
16 |         # "gpt-4-0613",
17 |     ]
18 |     edit_formats = [
19 |         "diff",
20 |         # "diff-func",
21 |         # "whole",
22 |         # "whole-func",
23 |     ]
24 | 
25 |     # for repeat in range(1, 2, 1):
26 |     for model in models:
27 |         for edit_format in edit_formats:
28 |             # dump(model, edit_format)
29 | 
30 |             if "-func" in edit_format and "-03" in model:
31 |                 continue
32 | 
33 |             # if (model, edit_format) == ("gpt-3.5-turbo-16k-0613", "whole-func"):
34 |             #    # sublist reliably hangs the API?
35 |             #    continue
36 | 
37 |             dirname = f"rungrid-nov-{model}-{edit_format}"
38 |             # dirname = f"rungrid-{model}-{edit_format}-repeat-{repeat}"
39 |             run(dirname, model, edit_format)
40 | 
41 | 
42 | def run(dirname, model, edit_format):
43 |     cmd = [
44 |         "./benchmark/benchmark.py",
45 |         dirname,
46 |         "--model",
47 |         model,
48 |         "--edit-format",
49 |         edit_format,
50 |         "--threads",
51 |         "10",
52 |         "--cont",
53 |     ]
54 |     print(" ".join(cmd))
55 | 
56 |     subprocess.run(cmd, check=True)
57 | 
58 | 
59 | if __name__ == "__main__":
60 |     status = main()
61 |     sys.exit(status)
62 | 


--------------------------------------------------------------------------------
/benchmark/swe-bench-lite.txt:
--------------------------------------------------------------------------------
1 | 26.3% Aider|GPT-4o|& Opus
2 | 25.0% Aider|GPT-4o
3 | 20.3% Amazon Q|Developer|Agent
4 | 19.0% AutoCode|Rover
5 | 18.0% SWE-|Agent|+ GPT-4
6 | 16.7% Open|Devin
7 | 11.7% SWE-|Agent|+ Opus
8 | 


--------------------------------------------------------------------------------
/benchmark/swe-bench.txt:
--------------------------------------------------------------------------------
1 | 18.9% Aider|GPT-4o|& Opus|(570)
2 | 17.0% Aider|GPT-4o|(570)
3 | 13.9% Devin|(570)
4 | 13.8% Amazon Q|Developer|Agent|(2,294)
5 | 12.5% SWE-|Agent|+ GPT-4|(2,294)
6 | 10.6% Auto|Code|Rover|(2,294)
7 | 10.5% SWE-|Agent|+ Opus|(2,294)
8 | 


--------------------------------------------------------------------------------
/benchmark/test_benchmark.py:
--------------------------------------------------------------------------------
 1 | # flake8: noqa: E501
 2 | 
 3 | import unittest
 4 | 
 5 | from benchmark import cleanup_test_output
 6 | 
 7 | 
 8 | class TestCleanupTestOutput(unittest.TestCase):
 9 |     def test_cleanup_test_output(self):
10 |         # Test case with timing info
11 |         output = "Ran 5 tests in 0.003s\nOK"
12 |         expected = "\nOK"
13 |         self.assertEqual(cleanup_test_output(output), expected)
14 | 
15 |         # Test case without timing info
16 |         output = "OK"
17 |         expected = "OK"
18 |         self.assertEqual(cleanup_test_output(output), expected)
19 | 
20 |     def test_cleanup_test_output_lines(self):
21 |         # Test case with timing info
22 |         output = """F
23 | ======================================================================
24 | FAIL: test_cleanup_test_output (test_benchmark.TestCleanupTestOutput.test_cleanup_test_output)
25 | ----------------------------------------------------------------------
26 | Traceback (most recent call last):
27 |   File "/Users/gauthier/Projects/aider/benchmark/test_benchmark.py", line 14, in test_cleanup_test_output
28 |     self.assertEqual(cleanup_test_output(output), expected)
29 | AssertionError: 'OK' != 'OKx'
30 | - OK
31 | + OKx
32 | ?   +
33 | """
34 | 
35 |         expected = """F
36 | ====
37 | FAIL: test_cleanup_test_output (test_benchmark.TestCleanupTestOutput.test_cleanup_test_output)
38 | ----
39 | Traceback (most recent call last):
40 |   File "/Users/gauthier/Projects/aider/benchmark/test_benchmark.py", line 14, in test_cleanup_test_output
41 |     self.assertEqual(cleanup_test_output(output), expected)
42 | AssertionError: 'OK' != 'OKx'
43 | - OK
44 | + OKx
45 | ?   +
46 | """
47 |         self.assertEqual(cleanup_test_output(output), expected)
48 | 


--------------------------------------------------------------------------------
/decisions/repo_map_content_filtering.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | type: design_decision
 3 | status: open
 4 | priority: high
 5 | story_points: 3
 6 | tags:
 7 |   - repomap
 8 |   - documentation
 9 |   - issues
10 | affected: aider/repomap.py
11 | related:
12 |   - issues/repo_map_issue_summarization.md
13 | subtasks:
14 |   - issues/repo_map_file_filtering.md
15 |   - issues/repo_map_content_prioritization.md
16 | ---
17 | 
18 | # Repo Map Content Filtering Design
19 | 
20 | ## Description
21 | Design and implement a system to allow the repo map to focus on specific file types (like issues or markdown files) while deprioritizing or excluding code files. This would improve the context provided to the AI when working with documentation or issue management tasks.
22 | 
23 | ## Checklist
24 | - [ ] Define filtering criteria for different file types
25 | - [ ] Determine how to prioritize/deprioritize different content types
26 | - [ ] Consider how to handle mixed content repositories
27 | - [ ] Design API for user control of filtering preferences
28 | - [ ] Evaluate impact on token usage and performance
29 | 


--------------------------------------------------------------------------------
/issues/cmd_prioritize_command.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | type: task
 3 | status: open
 4 | priority: high
 5 | story_points: 3
 6 | summary: Create a /prioritize command to analyze and focus on the most important issue
 7 | tags:
 8 |   - commands
 9 |   - productivity
10 | affected: aider/commands.py
11 | related:
12 |   - issues/prioritize_prompt_design.md
13 | subtasks:
14 |   - issues/prioritize_prompt_design.md
15 | ---
16 | 
17 | # Add cmd_prioritize Command
18 | 
19 | ## Description
20 | Create a new `/prioritize` command that will ask the LLM to analyze all open issues, determine which one is most important to tackle next, and automatically focus on that issue.
21 | 
22 | ## Checklist
23 | - [ ] Add `cmd_prioritize` method to the Commands class
24 | - [ ] Get the repomap with include_text_and_md=True, to ensure all the issue files are visible
25 | - [ ] Create a prompt for the LLM to evaluate and prioritize issues
26 | - [ ] Parse the LLM's response to identify the chosen issue
27 | - [ ] Ask the user to confirm the chosen issue and that they would like to /focus on it
28 | - [ ] Automatically execute the `/focus` command on the chosen issue
29 | - [ ] Add command to the help documentation
30 | - [ ] Write tests for the new command
31 | 
32 | ## Open Questions
33 | 1. How should we handle issues without explicit priority in their YAML frontmatter?
34 | 2. Should we consider dependencies between issues (via the `related` field) when prioritizing?
35 | 3. What criteria should the LLM use to determine importance (urgency, impact, complexity)?
36 | 4. Should we allow the user to specify additional prioritization criteria as arguments?
37 | 5. How should we handle the case where there are no open issues?
38 | 6. Should we provide a preview of the LLM's reasoning before automatically focusing on the chosen issue?
39 | 


--------------------------------------------------------------------------------
/issues/failed_attempts_documentation.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | type: task
 3 | status: open
 4 | priority: medium
 5 | story_points: 2
 6 | summary: Create system for documenting failed attempts
 7 | tags:
 8 |   - documentation
 9 |   - git
10 | affected: aider/repo.py
11 | related:
12 |   - decisions/git_backtracking_feature.md
13 | ---
14 | 
15 | # Create System for Documenting Failed Attempts
16 | 
17 | ## Description
18 | 
19 | Develop a system that automatically documents failed approaches when a user requests to backtrack. This will create a structured record in a `failed_attempts/` directory, describing what was attempted and what issues were encountered.
20 | 
21 | ## Checklist
22 | 
23 | - [ ] Create a `failed_attempts/` directory structure
24 | - [ ] Design a markdown template for failed attempt documentation
25 | - [ ] Implement functionality to extract relevant information from the conversation history
26 | - [ ] Develop a mechanism to analyze what went wrong based on error messages and user feedback
27 | - [ ] Create a naming convention for failed attempt documents
28 | - [ ] Add functionality to reference failed attempts in future conversations
29 | - [ ] Ensure failed attempt documentation includes code snippets of what was tried
30 | 


--------------------------------------------------------------------------------
/issues/git_backtracking_implementation.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | type: task
 3 | status: open
 4 | priority: medium
 5 | story_points: 3
 6 | summary: Implement git backtracking functionality
 7 | tags:
 8 |   - git
 9 |   - user_experience
10 | affected: aider/repo.py
11 | related:
12 |   - decisions/git_backtracking_feature.md
13 | subtasks:
14 |   - issues/natural_language_git_commands.md
15 |   - issues/commit_history_analysis.md
16 | ---
17 | 
18 | # Implement Git Backtracking Functionality
19 | 
20 | ## Description
21 | 
22 | Implement the core functionality that allows aider to backtrack through git history based on natural language requests from users. This will enable users to say things like "this isn't working, go back to before we started trying to use foobar" and have aider understand and execute the appropriate git operations.
23 | 
24 | ## Checklist
25 | 
26 | - [ ] Enhance the GitRepo class to support more sophisticated history navigation
27 | - [ ] Implement functionality to identify commits related to specific features or approaches
28 | - [ ] Create a mechanism to analyze commit messages and code changes to understand what was being attempted
29 | - [ ] Develop a safe way to revert to previous states without losing history
30 | - [ ] Add support for natural language parsing of backtracking requests
31 | - [ ] Integrate with the existing undo functionality
32 | 


--------------------------------------------------------------------------------
/issues/natural_language_git_commands.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | type: task
 3 | status: open
 4 | priority: high
 5 | story_points: 2
 6 | summary: Implement natural language parsing for git commands
 7 | tags:
 8 |   - git
 9 |   - natural_language_processing
10 | affected: aider/commands.py
11 | related:
12 |   - issues/git_backtracking_implementation.md
13 | ---
14 | 
15 | # Implement Natural Language Parsing for Git Commands
16 | 
17 | ## Description
18 | 
19 | Develop a system that can interpret natural language requests related to git operations, particularly focusing on backtracking and reverting changes. This will allow users to use phrases like "go back to before we started using X" without needing to know specific git commands.
20 | 
21 | ## Checklist
22 | 
23 | - [ ] Identify common phrases and patterns users might use to request backtracking
24 | - [ ] Create a mapping between natural language patterns and git operations
25 | - [ ] Implement context-aware parsing to understand what features or changes the user is referring to
26 | - [ ] Add confirmation dialogues for potentially destructive operations
27 | - [ ] Develop fallback mechanisms when the intent is unclear
28 | - [ ] Create helpful responses that explain what actions were taken
29 | 


--------------------------------------------------------------------------------
/issues/prioritize_prompt_design.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | type: design_decision
 3 | status: open
 4 | priority: medium
 5 | story_points: 1
 6 | summary: Design an effective prompt for the LLM to evaluate and prioritize open issues
 7 | tags:
 8 |   - commands
 9 |   - prompts
10 | related:
11 |   - issues/cmd_prioritize_command.md
12 | ---
13 | 
14 | # Design Prompt for Issue Prioritization
15 | 
16 | ## Description
17 | Design an effective prompt for the LLM to evaluate and prioritize open issues. The prompt needs to guide the LLM to analyze issue metadata and content to determine which issue is most important to tackle next.
18 | 
19 | ## Checklist
20 | - [ ] Define the criteria for prioritization (urgency, impact, complexity, dependencies)
21 | - [ ] Create a structured format for the LLM to receive issue data
22 | - [ ] Design a response format that clearly identifies the chosen issue and explains the reasoning
23 | - [ ] Include handling for edge cases (no priority field, conflicting priorities)
24 | - [ ] Test the prompt with various issue combinations to ensure consistent results
25 | 
26 | ## Considerations
27 | - The prompt should instruct the LLM to consider:
28 |   - Explicit priority markers in YAML frontmatter
29 |   - Issue type (bug vs. feature vs. design decision)
30 |   - Dependencies between issues
31 |   - Story points (complexity/effort)
32 |   - Tags that might indicate critical areas
33 |   - The actual content/description of the issue
34 | 


--------------------------------------------------------------------------------
/issues/repo_map_content_prioritization.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | type: task
 3 | status: open
 4 | priority: medium
 5 | story_points: 2
 6 | summary: Enhance repo map to prioritize content types with different levels of detail
 7 | tags:
 8 |   - repomap
 9 |   - prioritization
10 | affected: aider/repomap.py
11 | related:
12 |   - decisions/repo_map_content_filtering.md
13 |   - issues/repo_map_file_filtering.md
14 |   - issues/repo_map_issue_summarization.md
15 | ---
16 | 
17 | # Implement Content Prioritization for Repo Map
18 | 
19 | ## Description
20 | Enhance the repo map to prioritize certain content types over others, allowing for more nuanced control than simple filtering. This would allow including both code and non-code files but with different levels of detail or prominence.
21 | 
22 | ## Checklist
23 | - [ ] Design prioritization scoring system
24 | - [ ] Implement content type detection beyond file extensions
25 | - [ ] Create token allocation strategy based on priorities
26 | - [ ] Add user configuration for priority weights
27 | - [ ] Test with mixed repositories containing various file types
28 | 


--------------------------------------------------------------------------------
/issues/repo_map_file_filtering.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | type: task
 3 | status: open
 4 | priority: high
 5 | story_points: 2
 6 | summary: Add file type filtering to repo map for focusing on specific file categories
 7 | tags:
 8 |   - repomap
 9 |   - filtering
10 | affected: aider/repomap.py
11 | related:
12 |   - decisions/repo_map_content_filtering.md
13 |   - issues/repo_map_content_prioritization.md
14 |   - issues/repo_map_issue_summarization.md
15 | ---
16 | 
17 | # Implement File Type Filtering for Repo Map
18 | 
19 | ## Description
20 | Add functionality to filter repo map content based on file types, allowing users to focus on specific file categories (like .md files) while excluding others (like code files).
21 | 
22 | ## Checklist
23 | - [ ] Add configuration options for file type filtering
24 | - [ ] Implement file extension-based filtering logic
25 | - [ ] Create path-based filtering for specific directories
26 | - [ ] Add command-line options to control filtering
27 | - [ ] Update documentation to explain filtering capabilities
28 | 


--------------------------------------------------------------------------------
/issues/repo_map_issue_summarization.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | type: task
 3 | status: open
 4 | priority: medium
 5 | story_points: 2
 6 | summary: Create issue summarization system for concise representation in repo map
 7 | tags:
 8 |   - repomap
 9 |   - issues
10 |   - summarization
11 | affected: aider/history.py
12 | related:
13 |   - decisions/repo_map_content_filtering.md
14 |   - issues/repo_map_content_prioritization.md
15 |   - issues/repo_map_file_filtering.md
16 | ---
17 | 
18 | # Implement Issue Summarization for Repo Map
19 | 
20 | ## Description
21 | Create a summarization system specifically for issue files to allow the repo map to include concise representations of issues rather than full content. This will help manage token usage while maintaining context awareness of project issues.
22 | 
23 | ## Checklist
24 | - [ ] Analyze structure of issue files to identify key components
25 | - [ ] Develop summarization strategy for issue content
26 | - [ ] Implement summarization function for issue files
27 | - [ ] Test summarization with various issue formats
28 | - [ ] Integrate with repo map generation process
29 | 


--------------------------------------------------------------------------------
/personas/game_developer.md:
--------------------------------------------------------------------------------
1 | # Game_Developer Advisor Persona
2 | 
3 | 


--------------------------------------------------------------------------------
/pyproject.toml:
--------------------------------------------------------------------------------
 1 | 
 2 | [project]
 3 | name = "aider-advanced"
 4 | description = "Aider Advanced is an enhanced AI pair programming in your terminal"
 5 | readme = "README.md"
 6 | classifiers = [
 7 |     "Development Status :: 4 - Beta",
 8 |     "Environment :: Console",
 9 |     "Intended Audience :: Developers",
10 |     "License :: OSI Approved :: Apache Software License",
11 |     "Programming Language :: Python :: 3",
12 |     "Programming Language :: Python :: 3.10",
13 |     "Programming Language :: Python :: 3.11",
14 |     "Programming Language :: Python :: 3.12",
15 |     "Programming Language :: Python :: 3.9",
16 |     "Programming Language :: Python",
17 |     "Topic :: Software Development",
18 | ]
19 | requires-python = ">=3.9,<3.13"
20 | dynamic = ["dependencies", "optional-dependencies", "version"]
21 | 
22 | [project.urls]
23 | Homepage = "https://github.com/qemqemqem/aider-advanced"
24 | 
25 | [project.scripts]
26 | aider-advanced = "aider.main:main"
27 | aider = "aider.main:main"  # Keep for backward compatibility
28 | 
29 | [tool.setuptools.dynamic]
30 | dependencies = { file = "requirements.txt" }
31 | 
32 | [tool.setuptools.dynamic.optional-dependencies]
33 | dev = { file = "requirements/requirements-dev.txt" }
34 | help = { file = "requirements/requirements-help.txt" }
35 | browser = { file = "requirements/requirements-browser.txt" }
36 | playwright = { file = "requirements/requirements-playwright.txt" }
37 | 
38 | [tool.setuptools]
39 | include-package-data = true
40 | 
41 | [tool.setuptools.packages.find]
42 | include = ["aider"]
43 | 
44 | [build-system]
45 | requires = ["setuptools>=68", "setuptools_scm[toml]>=8"]
46 | build-backend = "setuptools.build_meta"
47 | 
48 | [tool.setuptools_scm]
49 | write_to = "aider/_version.py"
50 | 
51 | [tool.codespell]
52 | skip = "*.svg,Gemfile.lock"
53 | write-changes = true
54 | 


--------------------------------------------------------------------------------
/pytest.ini:
--------------------------------------------------------------------------------
 1 | [pytest]
 2 | norecursedirs = tmp.* build benchmark _site OLD
 3 | addopts = -p no:warnings
 4 | testpaths =
 5 |     tests/basic
 6 |     tests/help
 7 |     tests/browser
 8 |     tests/scrape
 9 | 
10 | env =
11 |     AIDER_ANALYTICS=false
12 | 
13 | 


--------------------------------------------------------------------------------
/requirements/requirements-browser.in:
--------------------------------------------------------------------------------
1 | streamlit
2 | 


--------------------------------------------------------------------------------
/requirements/requirements-dev.in:
--------------------------------------------------------------------------------
 1 | pytest
 2 | pytest-env
 3 | pip-tools
 4 | lox
 5 | matplotlib
 6 | pandas
 7 | typer
 8 | imgcat
 9 | pre-commit
10 | cogapp
11 | semver
12 | codespell
13 | uv
14 | 


--------------------------------------------------------------------------------
/requirements/requirements-help.in:
--------------------------------------------------------------------------------
1 | llama-index-core
2 | llama-index-embeddings-huggingface
3 | 
4 | # Because sentence-transformers doesn't like >=2
5 | numpy<2
6 | 
7 | # Mac x86 only supports 2.2.2
8 | # https://discuss.pytorch.org/t/why-no-macosx-x86-64-build-after-torch-2-2-2-cp39-none-macosx-10-9-x86-64-whl/204546/2
9 | torch==2.2.2


--------------------------------------------------------------------------------
/requirements/requirements-playwright.in:
--------------------------------------------------------------------------------
1 | playwright
2 | 


--------------------------------------------------------------------------------
/requirements/requirements-playwright.txt:
--------------------------------------------------------------------------------
 1 | # This file was autogenerated by uv via the following command:
 2 | #    uv pip compile --no-strip-extras --constraint=requirements/common-constraints.txt --output-file=requirements/requirements-playwright.txt requirements/requirements-playwright.in
 3 | greenlet==3.1.1
 4 |     # via
 5 |     #   -c requirements/common-constraints.txt
 6 |     #   playwright
 7 | playwright==1.50.0
 8 |     # via
 9 |     #   -c requirements/common-constraints.txt
10 |     #   -r requirements/requirements-playwright.in
11 | pyee==12.1.1
12 |     # via
13 |     #   -c requirements/common-constraints.txt
14 |     #   playwright
15 | typing-extensions==4.12.2
16 |     # via
17 |     #   -c requirements/common-constraints.txt
18 |     #   pyee
19 | 


--------------------------------------------------------------------------------
/requirements/requirements.in:
--------------------------------------------------------------------------------
 1 | pydub
 2 | configargparse
 3 | GitPython
 4 | jsonschema
 5 | rich
 6 | prompt_toolkit
 7 | backoff
 8 | pathspec
 9 | diskcache
10 | grep_ast
11 | packaging
12 | sounddevice
13 | soundfile
14 | beautifulsoup4
15 | PyYAML
16 | diff-match-patch
17 | pypandoc
18 | litellm
19 | flake8
20 | importlib_resources
21 | pyperclip
22 | posthog
23 | mixpanel
24 | pexpect
25 | json5
26 | psutil
27 | watchfiles
28 | socksio
29 | pip
30 | pillow
31 | 
32 | # The proper dependency is networkx[default], but this brings
33 | # in matplotlib and a bunch of other deps
34 | # https://github.com/networkx/networkx/blob/d7132daa8588f653eacac7a5bae1ee85a183fa43/pyproject.toml#L57
35 | # We really only need networkx itself and scipy for the repomap.
36 | # Pin below v3.3 to retain python 3.9 compatibility.
37 | networkx<3.3
38 | 
39 | # This is the one networkx dependency that we need.
40 | # Including it here explicitly because we
41 | # didn't specify networkx[default] above.
42 | # Pin below 1.14 to retain python 3.9 compatibility.
43 | scipy<1.14
44 | 
45 | # GitHub Release action failing on "KeyError: 'home-page'"
46 | # https://github.com/pypa/twine/blob/6fbf880ee60915cf1666348c4bdd78a10415f2ac/twine/__init__.py#L40
47 | # Uses importlib-metadata
48 | importlib-metadata<8.0.0
49 | 


--------------------------------------------------------------------------------
/requirements/tree-sitter.in:
--------------------------------------------------------------------------------
1 |     
2 | tree-sitter==0.23.2; python_version < "3.10"
3 | tree-sitter==0.24.0; python_version >= "3.10"
4 | 


--------------------------------------------------------------------------------
/scripts/Dockerfile.jekyll:
--------------------------------------------------------------------------------
 1 | # Use the official Jekyll image from Docker Hub
 2 | FROM bretfisher/jekyll-serve
 3 | 
 4 | # Set the working directory
 5 | WORKDIR /site
 6 | 
 7 | # Copy the current directory contents into the container at /srv/jekyll
 8 | COPY website /site
 9 | 
10 | RUN apt-get update && apt-get install libcurl4
11 | 
12 | # Install any needed packages specified in Gemfile
13 | RUN bundle install --retry 5 --jobs 20
14 | 
15 | ENTRYPOINT [ "docker-entrypoint.sh" ]
16 | 
17 | # bundle exec jekyll serve --force_polling -H 0.0.0.0 -P 4000
18 | CMD [ "bundle", "exec", "jekyll", "serve", "--verbose", "--trace", "--force_polling", "-H", "0.0.0.0", "-P", "4000" ]
19 | 
20 | 
21 | 


--------------------------------------------------------------------------------
/scripts/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/scripts/__init__.py


--------------------------------------------------------------------------------
/scripts/history_prompts.py:
--------------------------------------------------------------------------------
 1 | history_prompt = """
 2 | Update the history with changes shown in the diffs.
 3 | Describe actual user-facing changes, not every single commit that was made implementing them.
 4 | 
 5 | Only add new items not already listed.
 6 | Do NOT edit or update existing history entries.
 7 | Do NOT add duplicate entries for changes that have existing history entries.
 8 | 
 9 | End each bullet with a period.
10 | 
11 | If the change was made by someone other than Paul Gauthier note it at the end of the bullet point as ", by XXX."
12 | 
13 | Be sure to attribute changes to the proper .x version.
14 | Changes in the .x-dev version should be listed under a "### main branch" heading
15 | 
16 | Start a new "### main branch" section at the top of the file if needed.
17 | 
18 | Also, add this as the last bullet under the "### main branch" section:
19 | {aider_line}
20 | """  # noqa
21 | 


--------------------------------------------------------------------------------
/scripts/jekyll_build.sh:
--------------------------------------------------------------------------------
1 | #!/bin/bash
2 | 
3 | # Build the Docker image
4 | docker build -t my-jekyll-site -f scripts/Dockerfile.jekyll .
5 | 


--------------------------------------------------------------------------------
/scripts/jekyll_run.sh:
--------------------------------------------------------------------------------
 1 | #!/bin/bash
 2 | 
 3 | # Run the Docker container
 4 | docker run \
 5 |        --rm \
 6 |        -v "$PWD/aider/website:/site" \
 7 |        -p 4000:4000 \
 8 |        -e HISTFILE=/site/.bash_history \
 9 |        -it \
10 |        my-jekyll-site
11 | 
12 | #       --entrypoint /bin/bash \
13 | 
14 | 


--------------------------------------------------------------------------------
/scripts/pip-compile.sh:
--------------------------------------------------------------------------------
 1 | #!/bin/bash
 2 | 
 3 | # exit when any command fails
 4 | set -e
 5 | 
 6 | # Add verbosity flag to see more details about dependency resolution
 7 | VERBOSITY="-v"  # Use -v for less detail, -vvv for even more detail
 8 | 
 9 | # First compile the common constraints of the full requirement suite
10 | # to make sure that all versions are mutually consistent across files
11 | uv pip compile \
12 |     $VERBOSITY \
13 |     --no-strip-extras \
14 |     --output-file=requirements/common-constraints.txt \
15 |     requirements/requirements.in \
16 |     requirements/requirements-*.in \
17 |     $1
18 | 
19 | # Compile the base requirements
20 | uv pip compile \
21 |     $VERBOSITY \
22 |     --no-strip-extras \
23 |     --constraint=requirements/common-constraints.txt \
24 |     --output-file=tmp.requirements.txt \
25 |     requirements/requirements.in \
26 |     $1
27 | 
28 | grep -v ^tree-sitter= tmp.requirements.txt \
29 |     | cat - requirements/tree-sitter.in \
30 |     > requirements.txt
31 | 
32 | # Compile additional requirements files
33 | SUFFIXES=(dev help browser playwright)
34 | 
35 | for SUFFIX in "${SUFFIXES[@]}"; do
36 |     uv pip compile \
37 |         $VERBOSITY \
38 |         --no-strip-extras \
39 |         --constraint=requirements/common-constraints.txt \
40 |         --output-file=requirements/requirements-${SUFFIX}.txt \
41 |         requirements/requirements-${SUFFIX}.in \
42 |         $1
43 | done
44 | 


--------------------------------------------------------------------------------
/scripts/update-blame.sh:
--------------------------------------------------------------------------------
1 | #!/bin/bash
2 | 
3 | # exit when any command fails
4 | set -e
5 | 
6 | # Use first argument as version if provided, otherwise default to v0.1.0
7 | VERSION=${1:-v0.1.0}
8 | ./scripts/blame.py "$VERSION" --all --output aider/website/_data/blame.yml
9 | 


--------------------------------------------------------------------------------
/scripts/update-docs.sh:
--------------------------------------------------------------------------------
 1 | #!/bin/bash
 2 | 
 3 | # exit when any command fails
 4 | set -e
 5 | 
 6 | if [ -z "$1" ]; then
 7 |   ARG=-r
 8 | else
 9 |   ARG=$1
10 | fi
11 | 
12 | if [ "$ARG" != "--check" ]; then
13 |   tail -1000 ~/.aider/analytics.jsonl > aider/website/assets/sample-analytics.jsonl
14 |   cog -r aider/website/docs/faq.md
15 | fi
16 | 
17 | # README.md before index.md, because index.md uses cog to include README.md
18 | cog $ARG \
19 |     README.md \
20 |     aider/website/index.md \
21 |     aider/website/HISTORY.md \
22 |     aider/website/docs/usage/commands.md \
23 |     aider/website/docs/languages.md \
24 |     aider/website/docs/config/dotenv.md \
25 |     aider/website/docs/config/options.md \
26 |     aider/website/docs/config/aider_conf.md \
27 |     aider/website/docs/config/adv-model-settings.md \
28 |     aider/website/docs/config/model-aliases.md \
29 |     aider/website/docs/leaderboards/index.md \
30 |     aider/website/docs/leaderboards/edit.md \
31 |     aider/website/docs/leaderboards/refactor.md \
32 |     aider/website/docs/llms/other.md \
33 |     aider/website/docs/more/infinite-output.md \
34 |     aider/website/docs/legal/privacy.md
35 | 


--------------------------------------------------------------------------------
/scripts/yank-old-versions.py:
--------------------------------------------------------------------------------
 1 | import requests
 2 | from packaging import version
 3 | from packaging.specifiers import SpecifierSet
 4 | 
 5 | 
 6 | def get_versions_supporting_python38_or_lower(package_name):
 7 |     url = f"https://pypi.org/pypi/{package_name}/json"
 8 |     response = requests.get(url)
 9 |     if response.status_code != 200:
10 |         print(f"Failed to fetch data for {package_name}")
11 |         return {}
12 | 
13 |     data = response.json()
14 |     compatible_versions = {}
15 | 
16 |     for release, release_data in data["releases"].items():
17 |         if not release_data:  # Skip empty releases
18 |             continue
19 | 
20 |         requires_python = release_data[0].get("requires_python")
21 | 
22 |         if requires_python is None:
23 |             compatible_versions[release] = (
24 |                 "Unspecified (assumed compatible with Python 3.8 and lower)"
25 |             )
26 |         else:
27 |             try:
28 |                 spec = SpecifierSet(requires_python)
29 |                 if version.parse("3.8") in spec:
30 |                     compatible_versions[release] = (
31 |                         f"Compatible with Python 3.8 (spec: {requires_python})"
32 |                     )
33 |             except ValueError:
34 |                 print(f"Invalid requires_python specifier for version {release}: {requires_python}")
35 | 
36 |     return compatible_versions
37 | 
38 | 
39 | def main():
40 |     package_name = "aider-chat"  # Replace with your package name
41 |     compatible_versions = get_versions_supporting_python38_or_lower(package_name)
42 | 
43 |     print(f"Versions of {package_name} compatible with Python 3.8 or lower:")
44 |     for release, support in sorted(
45 |         compatible_versions.items(), key=lambda x: version.parse(x[0]), reverse=True
46 |     ):
47 |         print(f"{release}: {support}")
48 | 
49 | 
50 | if __name__ == "__main__":
51 |     main()
52 | 


--------------------------------------------------------------------------------
/tests/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qemqemqem/aider-advanced/bb56f5881ab16a666197c994170f0aba8c5d18a3/tests/__init__.py


--------------------------------------------------------------------------------
/tests/basic/test_exceptions.py:
--------------------------------------------------------------------------------
 1 | from aider.exceptions import ExInfo, LiteLLMExceptions
 2 | 
 3 | 
 4 | def test_litellm_exceptions_load():
 5 |     """Test that LiteLLMExceptions loads without errors"""
 6 |     ex = LiteLLMExceptions()
 7 |     assert len(ex.exceptions) > 0
 8 | 
 9 | 
10 | def test_exceptions_tuple():
11 |     """Test that exceptions_tuple returns a non-empty tuple"""
12 |     ex = LiteLLMExceptions()
13 |     assert isinstance(ex.exceptions_tuple(), tuple)
14 |     assert len(ex.exceptions_tuple()) > 0
15 | 
16 | 
17 | def test_get_ex_info():
18 |     """Test get_ex_info returns correct ExInfo"""
19 |     ex = LiteLLMExceptions()
20 | 
21 |     # Test with a known exception type
22 |     from litellm import AuthenticationError
23 | 
24 |     auth_error = AuthenticationError(
25 |         message="Invalid API key", llm_provider="openai", model="gpt-4"
26 |     )
27 |     ex_info = ex.get_ex_info(auth_error)
28 |     assert isinstance(ex_info, ExInfo)
29 |     assert ex_info.name == "AuthenticationError"
30 |     assert ex_info.retry is False
31 |     assert "API key" in ex_info.description
32 | 
33 |     # Test with unknown exception type
34 |     class UnknownError(Exception):
35 |         pass
36 | 
37 |     unknown = UnknownError()
38 |     ex_info = ex.get_ex_info(unknown)
39 |     assert isinstance(ex_info, ExInfo)
40 |     assert ex_info.name is None
41 |     assert ex_info.retry is None
42 |     assert ex_info.description is None
43 | 
44 | 
45 | def test_rate_limit_error():
46 |     """Test specific handling of RateLimitError"""
47 |     ex = LiteLLMExceptions()
48 |     from litellm import RateLimitError
49 | 
50 |     rate_error = RateLimitError(message="Rate limit exceeded", llm_provider="openai", model="gpt-4")
51 |     ex_info = ex.get_ex_info(rate_error)
52 |     assert ex_info.retry is True
53 |     assert "rate limited" in ex_info.description.lower()
54 | 
55 | 
56 | def test_context_window_error():
57 |     """Test specific handling of ContextWindowExceededError"""
58 |     ex = LiteLLMExceptions()
59 |     from litellm import ContextWindowExceededError
60 | 
61 |     ctx_error = ContextWindowExceededError(
62 |         message="Context length exceeded", model="gpt-4", llm_provider="openai"
63 |     )
64 |     ex_info = ex.get_ex_info(ctx_error)
65 |     assert ex_info.retry is False
66 | 


--------------------------------------------------------------------------------
/tests/basic/test_linter.py:
--------------------------------------------------------------------------------
 1 | import unittest
 2 | from unittest.mock import MagicMock, patch
 3 | 
 4 | from aider.dump import dump  # noqa
 5 | from aider.linter import Linter
 6 | 
 7 | 
 8 | class TestLinter(unittest.TestCase):
 9 |     def setUp(self):
10 |         self.linter = Linter(encoding="utf-8", root="/test/root")
11 | 
12 |     def test_init(self):
13 |         self.assertEqual(self.linter.encoding, "utf-8")
14 |         self.assertEqual(self.linter.root, "/test/root")
15 |         self.assertIn("python", self.linter.languages)
16 | 
17 |     def test_set_linter(self):
18 |         self.linter.set_linter("javascript", "eslint")
19 |         self.assertEqual(self.linter.languages["javascript"], "eslint")
20 | 
21 |     def test_get_rel_fname(self):
22 |         import os
23 | 
24 |         self.assertEqual(self.linter.get_rel_fname("/test/root/file.py"), "file.py")
25 |         expected_path = os.path.normpath("../../other/path/file.py")
26 |         actual_path = os.path.normpath(self.linter.get_rel_fname("/other/path/file.py"))
27 |         self.assertEqual(actual_path, expected_path)
28 | 
29 |     @patch("subprocess.Popen")
30 |     def test_run_cmd(self, mock_popen):
31 |         mock_process = MagicMock()
32 |         mock_process.returncode = 0
33 |         mock_process.stdout.read.side_effect = ("", None)
34 |         mock_popen.return_value = mock_process
35 | 
36 |         result = self.linter.run_cmd("test_cmd", "test_file.py", "code")
37 |         self.assertIsNone(result)
38 | 
39 |     @patch("subprocess.Popen")
40 |     def test_run_cmd_with_errors(self, mock_popen):
41 |         mock_process = MagicMock()
42 |         mock_process.returncode = 1
43 |         mock_process.stdout.read.side_effect = ("Error message", None)
44 |         mock_popen.return_value = mock_process
45 | 
46 |         result = self.linter.run_cmd("test_cmd", "test_file.py", "code")
47 |         self.assertIsNotNone(result)
48 |         self.assertIn("Error message", result.text)
49 | 
50 | 
51 | if __name__ == "__main__":
52 |     unittest.main()
53 | 


--------------------------------------------------------------------------------
/tests/basic/test_run_cmd.py:
--------------------------------------------------------------------------------
 1 | import pytest  # noqa: F401
 2 | 
 3 | from aider.run_cmd import run_cmd
 4 | 
 5 | 
 6 | def test_run_cmd_echo():
 7 |     command = "echo Hello, World!"
 8 |     exit_code, output = run_cmd(command)
 9 | 
10 |     assert exit_code == 0
11 |     assert output.strip() == "Hello, World!"
12 | 


--------------------------------------------------------------------------------
/tests/basic/test_scripting.py:
--------------------------------------------------------------------------------
 1 | import unittest
 2 | from pathlib import Path
 3 | from unittest.mock import patch
 4 | 
 5 | from aider.coders import Coder
 6 | from aider.models import Model
 7 | from aider.utils import GitTemporaryDirectory
 8 | 
 9 | 
10 | class TestScriptingAPI(unittest.TestCase):
11 |     @patch("aider.coders.base_coder.Coder.send")
12 |     def test_basic_scripting(self, mock_send):
13 |         with GitTemporaryDirectory():
14 |             # Setup
15 |             def mock_send_side_effect(messages, functions=None):
16 |                 coder.partial_response_content = "Changes applied successfully."
17 |                 coder.partial_response_function_call = None
18 |                 return "Changes applied successfully."
19 | 
20 |             mock_send.side_effect = mock_send_side_effect
21 | 
22 |             # Test script
23 |             fname = Path("greeting.py")
24 |             fname.touch()
25 |             fnames = [str(fname)]
26 |             model = Model("gpt-4-turbo")
27 |             coder = Coder.create(main_model=model, fnames=fnames)
28 | 
29 |             result1 = coder.run("make a script that prints hello world")
30 |             result2 = coder.run("make it say goodbye")
31 | 
32 |             # Assertions
33 |             self.assertEqual(mock_send.call_count, 2)
34 |             self.assertEqual(result1, "Changes applied successfully.")
35 |             self.assertEqual(result2, "Changes applied successfully.")
36 | 
37 | 
38 | if __name__ == "__main__":
39 |     unittest.main()
40 | 


--------------------------------------------------------------------------------
/tests/basic/test_special.py:
--------------------------------------------------------------------------------
 1 | import os
 2 | 
 3 | import pytest
 4 | 
 5 | from aider.special import filter_important_files, is_important
 6 | 
 7 | 
 8 | def test_is_important():
 9 |     # Test common important files
10 |     assert is_important("README.md")
11 |     assert is_important(".gitignore")
12 |     assert is_important("requirements.txt")
13 |     assert is_important("setup.py")
14 | 
15 |     # Test files in .github/workflows
16 |     assert is_important(os.path.join(".github", "workflows", "test.yml"))
17 |     assert is_important(os.path.join(".github", "workflows", "deploy.yml"))
18 | 
19 |     # Test files that should not be considered important
20 |     assert not is_important("random_file.txt")
21 |     assert not is_important("src/main.py")
22 |     assert not is_important("tests/test_app.py")
23 | 
24 | 
25 | def test_filter_important_files():
26 |     files = [
27 |         "README.md",
28 |         "src/main.py",
29 |         ".gitignore",
30 |         "tests/test_app.py",
31 |         "requirements.txt",
32 |         ".github/workflows/test.yml",
33 |         "random_file.txt",
34 |     ]
35 | 
36 |     important_files = filter_important_files(files)
37 | 
38 |     assert set(important_files) == {
39 |         "README.md",
40 |         ".gitignore",
41 |         "requirements.txt",
42 |         ".github/workflows/test.yml",
43 |     }
44 | 
45 | 
46 | def test_is_important_case_sensitivity():
47 |     # Test case sensitivity
48 |     assert is_important("README.md")
49 |     assert not is_important("readme.md")
50 |     assert is_important(".gitignore")
51 |     assert not is_important(".GITIGNORE")
52 | 
53 | 
54 | def test_is_important_with_paths():
55 |     # Test with different path formats
56 |     assert not is_important("project/README.md")
57 |     assert is_important("./README.md")
58 |     assert not is_important("/absolute/path/to/README.md")
59 | 
60 | 
61 | @pytest.mark.parametrize(
62 |     "file_path",
63 |     [
64 |         "README",
65 |         "README.txt",
66 |         "README.rst",
67 |         "LICENSE",
68 |         "LICENSE.md",
69 |         "LICENSE.txt",
70 |         "Dockerfile",
71 |         "package.json",
72 |         "pyproject.toml",
73 |     ],
74 | )
75 | def test_is_important_various_files(file_path):
76 |     assert is_important(file_path)
77 | 


--------------------------------------------------------------------------------
/tests/basic/test_urls.py:
--------------------------------------------------------------------------------
 1 | import requests
 2 | 
 3 | from aider import urls
 4 | 
 5 | 
 6 | def test_urls():
 7 |     url_attributes = [
 8 |         attr
 9 |         for attr in dir(urls)
10 |         if not callable(getattr(urls, attr)) and not attr.startswith("__")
11 |     ]
12 |     for attr in url_attributes:
13 |         url = getattr(urls, attr)
14 |         response = requests.get(url)
15 |         assert response.status_code == 200, f"URL {url} returned status code {response.status_code}"
16 | 


--------------------------------------------------------------------------------
/tests/browser/test_browser.py:
--------------------------------------------------------------------------------
 1 | import os
 2 | import unittest
 3 | from unittest.mock import patch
 4 | 
 5 | from aider.main import main
 6 | 
 7 | 
 8 | class TestBrowser(unittest.TestCase):
 9 |     @patch("aider.main.launch_gui")
10 |     def test_browser_flag_imports_streamlit(self, mock_launch_gui):
11 |         os.environ["AIDER_ANALYTICS"] = "false"
12 | 
13 |         # Run main with --browser and --yes flags
14 |         main(["--browser", "--yes"])
15 | 
16 |         # Check that launch_gui was called
17 |         mock_launch_gui.assert_called_once()
18 | 
19 |         # Try to import streamlit
20 |         try:
21 |             import streamlit  # noqa: F401
22 | 
23 |             streamlit_imported = True
24 |         except ImportError:
25 |             streamlit_imported = False
26 | 
27 |         # Assert that streamlit was successfully imported
28 |         self.assertTrue(
29 |             streamlit_imported, "Streamlit should be importable after running with --browser flag"
30 |         )
31 | 
32 | 
33 | if __name__ == "__main__":
34 |     unittest.main()
35 | 


--------------------------------------------------------------------------------
/tests/fixtures/languages/c/test.c:
--------------------------------------------------------------------------------
1 | #include <stdio.h>
2 | 
3 | int main() {
4 |     printf("Hello, World!\n");
5 |     return 0;
6 | }
7 | 


--------------------------------------------------------------------------------
/tests/fixtures/languages/cpp/test.cpp:
--------------------------------------------------------------------------------
1 | #include <iostream>
2 | 
3 | int main() {
4 |     std::cout << "Hello, World!" << std::endl;
5 |     return 0;
6 | }
7 | 


--------------------------------------------------------------------------------
/tests/fixtures/languages/csharp/test.cs:
--------------------------------------------------------------------------------
 1 | using System;
 2 | using System.Collections.Generic;
 3 | 
 4 | namespace Greetings {
 5 |     public interface IGreeter {
 6 |         string Greet(string name);
 7 |     }
 8 | 
 9 |     public class Person {
10 |         public string Name { get; set; }
11 |         public int Age { get; set; }
12 | 
13 |         public Person(string name, int age) {
14 |             Name = name;
15 |             Age = age;
16 |         }
17 |     }
18 | 
19 |     public class FormalGreeter : IGreeter {
20 |         private const string PREFIX = "Good day";
21 |         private static readonly int MAX_AGE = 150;
22 | 
23 |         public string Greet(string name) {
24 |             return $"{PREFIX}, {name}!";
25 |         }
26 | 
27 |         public string GreetPerson(Person person) {
28 |             return $"{PREFIX}, {person.Name} ({person.Age})!";
29 |         }
30 |     }
31 | 
32 |     public class Program {
33 |         static void Main() {
34 |             var greeter = new FormalGreeter();
35 |             var person = new Person("World", 42);
36 |             Console.WriteLine(greeter.GreetPerson(person));
37 |         }
38 |     }
39 | }
40 | 


--------------------------------------------------------------------------------
/tests/fixtures/languages/elisp/test.el:
--------------------------------------------------------------------------------
 1 | (defvar *default-greeting* "Hello")
 2 | (defvar *max-name-length* 50)
 3 | 
 4 | (defstruct person
 5 |   (name "Anonymous")
 6 |   (age 0))
 7 | 
 8 | (defclass greeter ()
 9 |   ((prefix :initarg :prefix
10 |            :accessor greeter-prefix
11 |            :initform *default-greeting*)))
12 | 
13 | (defmethod greet ((g greeter) (p person))
14 |   (format nil "~A, ~A! You are ~D years old."
15 |           (greeter-prefix g)
16 |           (person-name p)
17 |           (person-age p)))
18 | 
19 | (defun create-formal-greeter ()
20 |   (make-instance 'greeter :prefix "Good day"))
21 | 
22 | (defun main ()
23 |   (let ((greeter (create-formal-greeter))
24 |         (person (make-person :name "World" :age 42)))
25 |     (message "%s" (greet greeter person))))
26 | 


--------------------------------------------------------------------------------
/tests/fixtures/languages/elixir/test.ex:
--------------------------------------------------------------------------------
1 | defmodule Greeter do
2 |   def hello(name) do
3 |     IO.puts("Hello, #{name}!")
4 |   end
5 | end
6 | 


--------------------------------------------------------------------------------
/tests/fixtures/languages/elm/test.elm:
--------------------------------------------------------------------------------
 1 | module Main exposing (main, Person, Greeting)
 2 | 
 3 | import Html exposing (Html, div, text)
 4 | import Html.Attributes exposing (class)
 5 | 
 6 | type alias Person =
 7 |     { name : String
 8 |     , age : Int
 9 |     }
10 | 
11 | type Greeting
12 |     = Formal
13 |     | Casual
14 | 
15 | greet : Greeting -> Person -> String
16 | greet style person =
17 |     let
18 |         prefix =
19 |             case style of
20 |                 Formal ->
21 |                     "Good day"
22 | 
23 |                 Casual ->
24 |                     "Hi"
25 |     in
26 |     prefix ++ ", " ++ person.name ++ "!"
27 | 
28 | defaultPerson : Person
29 | defaultPerson =
30 |     { name = "World"
31 |     , age = 42
32 |     }
33 | 
34 | main : Html msg
35 | main =
36 |     div [ class "greeting" ]
37 |         [ text (greet Formal defaultPerson)
38 |         ]
39 | 


--------------------------------------------------------------------------------
/tests/fixtures/languages/go/test.go:
--------------------------------------------------------------------------------
 1 | package main
 2 | 
 3 | import (
 4 |     "fmt"
 5 |     "strings"
 6 | )
 7 | 
 8 | // Person represents someone who can be greeted
 9 | type Person struct {
10 |     Name string
11 |     Age  int
12 | }
13 | 
14 | // Greeter defines greeting behavior
15 | type Greeter interface {
16 |     Greet(p Person) string
17 | }
18 | 
19 | // FormalGreeter implements Greeter with formal style
20 | type FormalGreeter struct {
21 |     Prefix string
22 | }
23 | 
24 | const (
25 |     DefaultName = "World"
26 |     MaxAge     = 150
27 | )
28 | 
29 | func (g FormalGreeter) Greet(p Person) string {
30 |     return fmt.Sprintf("%s, %s! You are %d years old.",
31 |         g.Prefix, p.Name, p.Age)
32 | }
33 | 
34 | func NewFormalGreeter() *FormalGreeter {
35 |     return &FormalGreeter{Prefix: "Good day"}
36 | }
37 | 
38 | func main() {
39 |     greeter := NewFormalGreeter()
40 |     person := Person{Name: DefaultName, Age: 42}
41 |     fmt.Println(greeter.Greet(person))
42 | }
43 | 


--------------------------------------------------------------------------------
/tests/fixtures/languages/hcl/test.tf:
--------------------------------------------------------------------------------
 1 | # Variables
 2 | variable "aws_region" {
 3 |   description = "AWS region for resources"
 4 |   type        = string
 5 |   default     = "us-west-2"
 6 | }
 7 | 
 8 | variable "environment" {
 9 |   description = "Environment name"
10 |   type        = string
11 |   default     = "dev"
12 | }
13 | 
14 | # Provider configuration
15 | provider "aws" {
16 |   region = var.aws_region
17 | }
18 | 
19 | # Resource definitions
20 | resource "aws_vpc" "main" {
21 |   cidr_block           = "10.0.0.0/16"
22 |   enable_dns_hostnames = true
23 |   enable_dns_support   = true
24 | 
25 |   tags = {
26 |     Name        = "${var.environment}-vpc"
27 |     Environment = var.environment
28 |   }
29 | }
30 | 
31 | resource "aws_subnet" "public" {
32 |   vpc_id                  = aws_vpc.main.id
33 |   cidr_block              = "10.0.1.0/24"
34 |   availability_zone       = "${var.aws_region}a"
35 |   map_public_ip_on_launch = true
36 | 
37 |   tags = {
38 |     Name        = "${var.environment}-public-subnet"
39 |     Environment = var.environment
40 |   }
41 | }
42 | 
43 | # Output values
44 | output "vpc_id" {
45 |   description = "ID of the created VPC"
46 |   value       = aws_vpc.main.id
47 | }
48 | 
49 | output "subnet_id" {
50 |   description = "ID of the public subnet"
51 |   value       = aws_subnet.public.id
52 | }
53 | 


--------------------------------------------------------------------------------
/tests/fixtures/languages/java/test.java:
--------------------------------------------------------------------------------
 1 | public interface Greeting {
 2 |     String greet(String name);
 3 | }
 4 | 
 5 | public class Test implements Greeting {
 6 |     private String prefix = "Hello";
 7 | 
 8 |     public String greet(String name) {
 9 |         return prefix + ", " + name + "!";
10 |     }
11 | 
12 |     public static void main(String[] args) {
13 |         Test greeter = new Test();
14 |         System.out.println(greeter.greet("World"));
15 |     }
16 | }
17 | 


--------------------------------------------------------------------------------
/tests/fixtures/languages/javascript/test.js:
--------------------------------------------------------------------------------
 1 | // Class definition
 2 | class Person {
 3 |     constructor(name) {
 4 |         this.name = name;
 5 |     }
 6 | 
 7 |     sayHello() {
 8 |         return `Hello, ${this.name}!`;
 9 |     }
10 | }
11 | 
12 | // Function declaration
13 | function greet(person) {
14 |     return person.sayHello();
15 | }
16 | 
17 | // Variables and constants
18 | const DEFAULT_NAME = 'World';
19 | let currentPerson = new Person(DEFAULT_NAME);
20 | 
21 | // Export for use in other modules
22 | module.exports = {
23 |     Person,
24 |     greet,
25 |     DEFAULT_NAME
26 | };
27 | 


--------------------------------------------------------------------------------
/tests/fixtures/languages/kotlin/test.kt:
--------------------------------------------------------------------------------
 1 | interface Greeting {
 2 |     fun greet(name: String): String
 3 | }
 4 | 
 5 | class Test : Greeting {
 6 |     private val prefix = "Hello"
 7 | 
 8 |     override fun greet(name: String): String {
 9 |         return "$prefix, $name!"
10 |     }
11 | }
12 | 
13 | fun main(args: Array<String>) {
14 |     val greeter = Test()
15 |     println(greeter.greet("World"))
16 | }
17 | 


--------------------------------------------------------------------------------
/tests/fixtures/languages/ocaml/test.ml:
--------------------------------------------------------------------------------
 1 | (* Module definition *)
 2 | module Greeter = struct
 3 |   type person = {
 4 |     name: string;
 5 |     age: int
 6 |   }
 7 | 
 8 |   let create_person name age =
 9 |     {name; age}
10 | 
11 |   let greet person =
12 |     Printf.printf "Hello, %s! You are %d years old.\n"
13 |       person.name person.age
14 | end
15 | 
16 | (* Outside the module *)
17 | let () =
18 |   let person = Greeter.create_person "Alice" 30 in
19 |   Greeter.greet person
20 | 


--------------------------------------------------------------------------------
/tests/fixtures/languages/php/test.php:
--------------------------------------------------------------------------------
1 | <?php
2 | function greet($name) {
3 |     echo "Hello, $name!";
4 | }
5 | ?>
6 | 


--------------------------------------------------------------------------------
/tests/fixtures/languages/python/test.py:
--------------------------------------------------------------------------------
 1 | from typing import List, Optional
 2 | 
 3 | 
 4 | class Person:
 5 |     """A class representing a person."""
 6 | 
 7 |     def __init__(self, name: str, age: Optional[int] = None):
 8 |         self.name = name
 9 |         self.age = age
10 | 
11 |     def greet(self, formal: bool = False) -> str:
12 |         """Generate a greeting."""
13 |         prefix = "Good day" if formal else "Hello"
14 |         return f"{prefix}, {self.name}!"
15 | 
16 | 
17 | def create_greeting_list(people: List[Person]) -> List[str]:
18 |     """Create greetings for a list of people."""
19 |     return [person.greet() for person in people]
20 | 
21 | 
22 | # Constants
23 | DEFAULT_NAME = "World"
24 | MAX_AGE = 150
25 | 
26 | if __name__ == "__main__":
27 |     person = Person(DEFAULT_NAME)
28 |     print(person.greet())
29 | 


--------------------------------------------------------------------------------
/tests/fixtures/languages/ql/test.ql:
--------------------------------------------------------------------------------
1 | predicate greet(string name) {
2 |   name = "World"
3 | }
4 | 


--------------------------------------------------------------------------------
/tests/fixtures/languages/ruby/test.rb:
--------------------------------------------------------------------------------
1 | def greet(name)
2 |   puts "Hello, #{name}!"
3 | end
4 | 


--------------------------------------------------------------------------------
/tests/fixtures/languages/rust/test.rs:
--------------------------------------------------------------------------------
 1 | // Define a trait
 2 | trait Greeting {
 3 |     fn greet(&self) -> String;
 4 | }
 5 | 
 6 | // Define a struct
 7 | struct Person {
 8 |     name: String,
 9 |     age: u32,
10 | }
11 | 
12 | // Implement the trait for Person
13 | impl Greeting for Person {
14 |     fn greet(&self) -> String {
15 |         format!("Hello, {}! You are {} years old.", self.name, self.age)
16 |     }
17 | }
18 | 
19 | // Implementation block for Person
20 | impl Person {
21 |     fn new(name: String, age: u32) -> Self {
22 |         Person { name, age }
23 |     }
24 | }
25 | 
26 | // Constants
27 | const DEFAULT_NAME: &str = "World";
28 | const MAX_AGE: u32 = 150;
29 | 
30 | fn main() {
31 |     let person = Person::new(DEFAULT_NAME.to_string(), 30);
32 |     println!("{}", person.greet());
33 | }
34 | 


--------------------------------------------------------------------------------
/tests/fixtures/languages/tsx/test.tsx:
--------------------------------------------------------------------------------
 1 | import React, { useState, useEffect } from 'react';
 2 | 
 3 | interface UserProps {
 4 |     name: string;
 5 |     age?: number;
 6 | }
 7 | 
 8 | // Component with props interface
 9 | const UserGreeting: React.FC<UserProps> = ({ name, age }) => {
10 |     const [greeting, setGreeting] = useState<string>('');
11 | 
12 |     useEffect(() => {
13 |         setGreeting(`Hello, ${name}${age ? ` (${age})` : ''}!`);
14 |     }, [name, age]);
15 | 
16 |     return <h1>{greeting}</h1>;
17 | };
18 | 
19 | // Custom hook
20 | function useCounter(initial: number = 0) {
21 |     const [count, setCount] = useState(initial);
22 |     const increment = () => setCount(c => c + 1);
23 |     return { count, increment };
24 | }
25 | 
26 | // Constants
27 | const DEFAULT_NAME = 'World';
28 | const MAX_AGE = 150;
29 | 
30 | export { UserGreeting, useCounter, DEFAULT_NAME, MAX_AGE };
31 | 


--------------------------------------------------------------------------------
/tests/fixtures/languages/typescript/test.ts:
--------------------------------------------------------------------------------
1 | function greet(name: string): void {
2 |     console.log(`Hello, ${name}!`);
3 | }
4 | 


--------------------------------------------------------------------------------
/tests/fixtures/sample-code-base-repo-map.txt:
--------------------------------------------------------------------------------
 1 | 
 2 | tests/fixtures/sample-code-base/sample.js:
 3 | ⋮
 4 | │function greet(name) {
 5 | │    return `Hello, ${name}!`;
 6 | ⋮
 7 | │function calculateCircleArea(radius) {
 8 | │    return Math.PI * radius * radius;
 9 | ⋮
10 | │function isPrime(number) {
11 | │    if (number <= 1) return false;
12 | │    for (let i = 2; i <= Math.sqrt(number); i++) {
13 | │        if (number % i === 0) return false;
14 | │    }
15 | │    return true;
16 | ⋮
17 | │function reverseString(str) {
18 | │    return str.split('').reverse().join('');
19 | ⋮
20 | │function getRandomNumber(min, max) {
21 | │    return Math.floor(Math.random() * (max - min + 1)) + min;
22 | ⋮
23 | │function filterEvenNumbers(numbers) {
24 | │    return numbers.filter(num => num % 2 !== 0);
25 | ⋮
26 | │function factorial(n) {
27 | │    if (n === 0 || n === 1) return 1;
28 | │    return n * factorial(n - 1);
29 | ⋮
30 | 
31 | tests/fixtures/sample-code-base/sample.py:
32 | │class Car:
33 | │    def __init__(self, make, model, year):
34 | │        self.make = make
35 | │        self.model = model
36 | │        self.year = year
37 | ⋮
38 | │    def accelerate(self, increment):
39 | ⋮
40 | │    def brake(self, decrement):
41 | ⋮
42 | │    def honk(self):
43 | ⋮
44 | │class Garage:
45 | │    def __init__(self):
46 | ⋮
47 | │    def add_car(self, car):
48 | ⋮
49 | │    def remove_car(self, car):
50 | ⋮
51 | │    def list_cars(self):
52 | ⋮
53 | │def main():
54 | ⋮
55 | 
56 | 


--------------------------------------------------------------------------------
/tests/fixtures/sample-code-base/sample.js:
--------------------------------------------------------------------------------
 1 | // Sample JavaScript script with 7 functions
 2 | 
 3 | // 1. A simple greeting function
 4 | function greet(name) {
 5 |     return `Hello, ${name}!`;
 6 | }
 7 | 
 8 | // 2. A function to calculate the area of a circle
 9 | function calculateCircleArea(radius) {
10 |     return Math.PI * radius * radius;
11 | }
12 | 
13 | // 3. A function to check if a number is prime
14 | function isPrime(number) {
15 |     if (number <= 1) return false;
16 |     for (let i = 2; i <= Math.sqrt(number); i++) {
17 |         if (number % i === 0) return false;
18 |     }
19 |     return true;
20 | }
21 | 
22 | // 4. A function to reverse a string
23 | function reverseString(str) {
24 |     return str.split('').reverse().join('');
25 | }
26 | 
27 | // 5. A function to generate a random number within a range
28 | function getRandomNumber(min, max) {
29 |     return Math.floor(Math.random() * (max - min + 1)) + min;
30 | }
31 | 
32 | // 6. A function to filter out even numbers from an array
33 | function filterEvenNumbers(numbers) {
34 |     return numbers.filter(num => num % 2 !== 0);
35 | }
36 | 
37 | // 7. A function to calculate the factorial of a number
38 | function factorial(n) {
39 |     if (n === 0 || n === 1) return 1;
40 |     return n * factorial(n - 1);
41 | }
42 | 
43 | // Example usage
44 | console.log(greet("Alice"));
45 | console.log(calculateCircleArea(5));
46 | console.log(isPrime(17));
47 | console.log(reverseString("JavaScript"));
48 | console.log(getRandomNumber(1, 100));
49 | console.log(filterEvenNumbers([1, 2, 3, 4, 5, 6, 7, 8, 9, 10]));
50 | console.log(factorial(5));
51 | 


--------------------------------------------------------------------------------
/tests/fixtures/sample-code-base/sample.py:
--------------------------------------------------------------------------------
 1 | class Car:
 2 |     def __init__(self, make, model, year):
 3 |         self.make = make
 4 |         self.model = model
 5 |         self.year = year
 6 |         self.speed = 0
 7 | 
 8 |     def accelerate(self, increment):
 9 |         self.speed += increment
10 |         print(f"{self.make} {self.model} is now going {self.speed} mph.")
11 | 
12 |     def brake(self, decrement):
13 |         self.speed = max(0, self.speed - decrement)
14 |         print(f"{self.make} {self.model} slowed down to {self.speed} mph.")
15 | 
16 |     def honk(self):
17 |         print(f"{self.make} {self.model}: Beep beep!")
18 | 
19 | 
20 | class Garage:
21 |     def __init__(self):
22 |         self.cars = []
23 | 
24 |     def add_car(self, car):
25 |         self.cars.append(car)
26 |         print(f"Added {car.make} {car.model} to the garage.")
27 | 
28 |     def remove_car(self, car):
29 |         if car in self.cars:
30 |             self.cars.remove(car)
31 |             print(f"Removed {car.make} {car.model} from the garage.")
32 |         else:
33 |             print(f"{car.make} {car.model} is not in the garage.")
34 | 
35 |     def list_cars(self):
36 |         if self.cars:
37 |             print("Cars in the garage:")
38 |             for car in self.cars:
39 |                 print(f"- {car.year} {car.make} {car.model}")
40 |         else:
41 |             print("The garage is empty.")
42 | 
43 | 
44 | def main():
45 |     # Create some cars
46 |     car1 = Car("Toyota", "Corolla", 2020)
47 |     car2 = Car("Tesla", "Model 3", 2022)
48 | 
49 |     # Demonstrate car methods
50 |     car1.accelerate(30)
51 |     car1.honk()
52 |     car1.brake(10)
53 | 
54 |     # Create a garage and add cars
55 |     my_garage = Garage()
56 |     my_garage.add_car(car1)
57 |     my_garage.add_car(car2)
58 | 
59 |     # List cars in the garage
60 |     my_garage.list_cars()
61 | 
62 |     # Remove a car and list again
63 |     my_garage.remove_car(car1)
64 |     my_garage.list_cars()
65 | 
66 | 
67 | if __name__ == "__main__":
68 |     main()
69 | 


--------------------------------------------------------------------------------
/tests/fixtures/watch.js:
--------------------------------------------------------------------------------
 1 | // Regular AI comment
 2 | //ai do 1 something
 3 | //AI make 2 this better
 4 | //ai! urgent 3 change needed
 5 | //AI! another 4 urgent one
 6 | // ai with 5 space
 7 | // AI with 6 caps
 8 | // ai! with 7 bang
 9 | // this is not an ai comment
10 | // aider is not an ai! comment
11 | 
12 | function dummyFunction() {
13 |     // ai inside 8 function
14 |     return true;
15 | }
16 | 
17 | class Example {
18 |     constructor() {
19 |         // ai in 9 constructor
20 |         this.value = 42;
21 |     }
22 | 
23 |     method() {
24 |         // ai in 10 method
25 |         return this.value;
26 |     }
27 |   // ai!
28 |   //ai
29 |   //ai!
30 |   // 11-13
31 | 
32 |   method2() { // ai 14
33 |     return 1;
34 |   }
35 | }
36 | // trailing whitespace ai  
37 | // trailing whitespace ai!  
38 | // 15-16
39 | 


--------------------------------------------------------------------------------
/tests/fixtures/watch.py:
--------------------------------------------------------------------------------
 1 | # fmt: off
 2 | # flake8: noqa
 3 | 
 4 | # Regular not AI comment
 5 | #ai 1 do something
 6 | # AI 2 make this better
 7 | # ai! 3 urgent change needed
 8 | #AI! 4 another urgent one
 9 | # this is not an ai comment
10 | # aider is not an ai comment
11 | # not an ai! comment
12 | 
13 | 
14 | def dummy_function():
15 |     #ai inside 5 function
16 |     # final 6 ai!
17 |     # final 7 ai
18 |     # ai
19 |     #ai
20 |     # those are 8+9
21 |     pass  # ai 10
22 | 


--------------------------------------------------------------------------------
/tests/fixtures/watch_question.js:
--------------------------------------------------------------------------------
 1 | // Regular AI comment
 2 | //ai do 1 something
 3 | //AI make 2 this better
 4 | //ai! urgent 3 change needed
 5 | //AI! another 4 urgent one
 6 | // ai with 5 space
 7 | // with questions AI?
 8 | 
 9 | // this is not an ai comment
10 | // aider is not an ai! comment
11 | 
12 | 


--------------------------------------------------------------------------------