aider-ce 0.88.20__py3-none-any.whl

aider/website/docs/usage/not-code.md

@@ -0,0 +1,179 @@
+---
+parent: Usage
+nav_order: 901
+description: Use aider to edit configuration files, documentation, and other text-based formats.
+---
+
+
+# Editing config & text files
+
+Aider isn't just for code, it can be very helpful when editing
+almost any text file.
+You can use aider to make changes to your shell & ssh settings, 
+Dockerfiles
+or pretty much any configuration or documentation file.
+
+Here are some practical examples of modifying common config/text files:
+
+## Shell Configuration
+
+<div class="chat-transcript" markdown="1">
+$ aider .bashrc
+
+Added .bashrc to the chat.
+
+
+#### Add an alias 'll' that lists all files, with all details in human readable format. And update PATH to include uv installed tools.
+
+```
++ alias ll='ls -alh'
++ export PATH="$PATH:$HOME/.local/bin:$PATH"
+```
+</div>
+
+## SSH Configurations
+
+<div class="chat-transcript" markdown="1">
+$ aider ~/.ssh/config
+
+Added config to the chat.
+
+#### Create a Host entry 'my-server' using bastion.example.com as JumpHost
+
+```
++ Host my-server
++     HostName 192.168.1.100
++     User deploy
++     Port 2222
++     IdentityFile ~/.ssh/deploy_key
++     ProxyJump bastion.example.com
+```
+</div>
+
+## Docker Setup
+
+<div class="chat-transcript" markdown="1">
+$ aider Dockerfile docker-compose.yml
+
+Added Dockerfile and docker-compose.yml to the chat.
+
+#### Set non-root user and enable healthchecks
+
+```
++ USER appuser
++ HEALTHCHECK --interval=30s --timeout=3s \
++   CMD curl -f http://localhost:8000/health || exit 1
+```
+
+#### Expose port 5432 and add volume for postgres data
+
+```
+  services:
+    postgres:
+      image: postgres:15
++     ports:
++       - "5432:5432"
++     volumes:
++       - pgdata:/var/lib/postgresql/data
+```
+</div>
+
+## Git Configuration
+
+<div class="chat-transcript" markdown="1">
+$ aider .gitconfig
+
+Added .gitconfig to the chat.
+
+#### Set default push behavior to current branch and enable color UI
+
+```
++ [push]
++     default = current
++ [color]
++     ui = auto
+```
+</div>
+
+## System Configuration
+<div class="chat-transcript" markdown="1">
+$ aider /etc/hosts  # May need sudo
+
+Added hosts to the chat.
+
+#### Block tracking domains by pointing them to 127.0.0.1
+
+```
++ 127.0.0.1   ads.example.com
++ 127.0.0.1   track.analytics.co
+```
+</div>
+
+
+## Editor Configs
+<div class="chat-transcript" markdown="1">
+$ aider .vimrc
+
+Added .vimrc to the chat.
+
+#### Enable line numbers and set 4-space tabs for Python
+
+```
++ set number
++ autocmd FileType python set tabstop=4 shiftwidth=4 expandtab
+```
+</div>
+
+## VSCode Configuration
+<div class="chat-transcript" markdown="1">
+$ aider settings.json
+
+Added settings.json to the chat.
+
+#### Enable auto-format on save and set default formatter
+
+```
++ "editor.formatOnSave": true,
++ "editor.defaultFormatter": "esbenp.prettier-vscode"
+```
+</div>
+
+## Markdown Documentation
+<div class="chat-transcript" markdown="1">
+$ aider README.md
+
+Added README.md to the chat.
+
+
+#### Add installation section with brew and pip options
+
+```
++ ## Installation
++ ```
++ # Homebrew
++ brew install cool-app-10k
++ 
++ # PyPI
++ pipx install cool-app-10k
++ ```
+```
+</div>
+
+## XML Configuration
+<div class="chat-transcript" markdown="1">
+$ aider pom.xml
+
+Added pom.xml to the chat.
+#### Add JUnit 5 dependency with test scope
+
+```
++ <dependency>
++     <groupId>org.junit.jupiter</groupId>
++     <artifactId>junit-jupiter-api</artifactId>
++     <version>5.9.2</version>
++     <scope>test</scope>
++ </dependency>
+```
+</div>
+
+

aider/website/docs/usage/notifications.md

@@ -0,0 +1,87 @@
+---
+title: Notifications
+highlight_image: /assets/notifications.jpg
+parent: Usage
+nav_order: 760
+description: Aider can notify you when it's waiting for your input.
+---
+
+# Notifications
+
+Aider can notify you when it's done working and is
+waiting for your input. 
+This is especially useful for long-running operations or when you're multitasking.
+
+## Usage
+
+Enable notifications with the `--notifications` flag:
+
+```bash
+aider --notifications
+```
+
+When enabled, aider will notify you when the LLM has finished generating a response and is waiting for your input.
+
+## OS-Specific Notifications
+
+Aider automatically detects your operating system and uses an appropriate notification method:
+
+- **macOS**: Uses `terminal-notifier` if available, falling back to AppleScript notifications
+- **Linux**: Uses `notify-send` or `zenity` if available
+- **Windows**: Uses PowerShell to display a message box
+
+## Custom Notification Commands
+
+You can specify a custom notification command with `--notifications-command`:
+
+```bash
+aider --notifications-command "your-custom-command"
+```
+
+For example, on macOS you might use:
+
+```bash
+aider --notifications-command "say 'Aider is ready'"
+```
+
+### Remote Notifications
+
+For remote notifications you could use [Apprise](https://github.com/caronc/apprise),
+which is a cross-platform Python library for sending notifications to various services.
+
+We can use Apprise to send notifications to Slack
+
+```bash
+aider --notifications-command "apprise -b 'Aider is ready' 'slack://your-slack-webhook-token'"
+```
+
+or Discord
+```bash
+aider --notifications-command "apprise -b 'Aider is ready' 'discord://your-discord-webhook-token'"
+```
+
+or even to your phone via Pushbullet
+```bash
+aider --notifications-command "apprise -b 'Aider is ready' 'pbul://your-pushbullet-access-token'"
+```
+
+Check more how to use and configure Apprise on their GitHub page.
+
+## Configuration
+
+You can add these settings to your configuration file:
+
+```yaml
+# Enable notifications
+notifications: true
+
+# Optional custom notification command
+notifications_command: "your-custom-command"
+```
+
+Or in your `.env` file:
+
+```
+AIDER_NOTIFICATIONS=true
+AIDER_NOTIFICATIONS_COMMAND=your-custom-command
+```

aider/website/docs/usage/tips.md

@@ -0,0 +1,79 @@
+---
+parent: Usage
+nav_order: 25
+description: Tips for AI pair programming with aider.
+---
+
+# Tips
+
+## Just add the files that need to be changed to the chat
+
+Take a moment and think about which files will need to be changed.
+Aider can often figure out which files to edit all by itself, but the most efficient approach is for you to add the files to the chat.
+
+## Don't add lots of files to the chat
+
+Just add the files you think need to be edited.
+Too much irrelevant code will distract and confuse the LLM.
+Aider uses a [map of your entire git repo](https://aider.chat/docs/repomap.html)
+so is usually aware of relevant classes/functions/methods elsewhere in your code base.
+It's ok to add 1-2 highly relevant files that don't need to be edited,
+but be selective.
+
+## Break your goal down into bite sized steps
+
+Do them one at a time. 
+Adjust the files added to the chat as you go: `/drop` files that don't need any more changes, `/add` files that need changes for the next step.
+
+## For complex changes, discuss a plan first
+
+Use the [`/ask` command](modes.html) to make a plan with aider.
+Once you are happy with the approach, just say "go ahead" without the `/ask` prefix.
+
+## If aider gets stuck
+
+- Use `/clear` to discard the chat history and make a fresh start.
+- Can you `/drop` any extra files?
+- Use `/ask` to discuss a plan before aider starts editing code.
+- Use the [`/model` command](commands.html) to switch to a different model and try again. Switching between GPT-4o and Sonnet will often get past problems.
+- If aider is hopelessly stuck,
+just code the next step yourself and try having aider code some more after that.
+Take turns and pair program with aider.
+
+## Creating new files
+
+If you want aider to create a new file, add it to the repository first with `/add <file>`.
+This way aider knows this file exists and will write to it. 
+Otherwise, aider might write the changes to an existing file.
+This can happen even if you ask for a new file, as LLMs tend to focus a lot
+on the existing information in their contexts.
+
+## Fixing bugs and errors
+
+If your code is throwing an error, 
+use the [`/run` command](commands.html)
+to share the error output with the aider.
+Or just paste the errors into the chat. Let the aider figure out how to fix the bug.
+
+If test are failing, use the [`/test` command](lint-test.html)
+to run tests and
+share the error output with the aider.
+
+## Providing docs
+
+LLMs know about a lot of standard tools and libraries, but may get some of the fine details wrong about API versions and function arguments.
+
+You can provide up-to-date documentation in a few ways:
+
+- Paste doc snippets into the chat.
+- Include a URL to docs in your chat message
+and aider will scrape and read it. For example: `Add a submit button like this https://ui.shadcn.com/docs/components/button`. 
+- Use the [`/read` command](commands.html) to read doc files into the chat from anywhere on your filesystem.
+- If you have coding conventions or standing instructions you want aider to follow, consider using a [conventions file](conventions.html).
+
+## Interrupting & inputting
+
+Use Control-C to interrupt aider if it isn't providing a useful response. The partial response remains in the conversation, so you can refer to it when you reply with more information or direction.
+
+{% include multi-line.md %}
+

aider/website/docs/usage/tutorials.md

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

aider/website/docs/usage/voice.md

@@ -0,0 +1,121 @@
+---
+parent: Usage
+nav_order: 100
+description: Speak with aider about your code!
+---
+
+# Voice-to-code with aider
+
+Speak with aider about your code! Request new features, test cases or bug fixes using your voice and let aider do the work of editing the files in your local git repo. As with all of aider's capabilities, you can use voice-to-code with an existing repo or to start a new project.
+
+Voice support fits quite naturally into aider's AI pair programming
+chat interface. Now you can fluidly switch between voice and text chat
+when you ask aider to edit your code.
+
+## How to use voice-to-code
+
+Use the in-chat `/voice` command to start recording,
+and press `ENTER` when you're done speaking.
+Your voice coding instructions will be transcribed, 
+as if you had  typed them into
+the aider chat session.
+
+See the [installation instructions](https://aider.chat/docs/install/optional.html#enable-voice-coding) for
+information on how to enable the `/voice` command.
+
+<br/>
+<div class="chat-transcript" markdown="1">
+
+> Aider v0.11.2-dev  
+> Added app.py to the chat.  
+
+#### /voice
+
+<blockquote>
+<div class="recording-line">
+    <p style="display: inline;">Recording, press ENTER when done... <span id="timer">3.5</span>sec</p>
+    <div id="progress-bar">
+        <div id="progress"></div>
+    </div>
+</div>
+</blockquote>
+
+<style>
+    .recording-line > * {
+        display: inline-block;
+        vertical-align: middle;
+    }
+    #progress-bar {
+        width: 100px;
+        height: 20px;
+        background-color: #333;
+        margin-left: 10px;
+    }
+    #progress {
+        height: 100%;
+        background-color: #f0f0f0;
+        animation: progress 3s infinite;
+    }
+    @keyframes progress {
+        0% { width: 10%; }
+        20% { width: 90%; }
+        50% { width: 30%; }
+        60% { width: 90%; }
+        80% { width: 20%; }
+        100% { width: 10%; }
+
+    }
+</style>
+
+<script>
+window.onload = function() {
+    var counter = 0;
+    var timer = document.getElementById('timer');
+    setInterval(function() {
+        counter = (counter + 0.1) % 9;
+        timer.textContent = counter.toFixed(1);
+    }, 100);
+}
+</script>
+
+<div style="display: inline-block; position: relative; width: 200px; background-color: #f0f0f0; border-radius: 10px; padding: 10px; color: #333; font-family: 'Comic Sans MS', 'Comic Sans', 'Marker Felt', sans-serif;">
+<span style="position: absolute; top: 0; left: 50%; transform: translate(-50%, -100%); width: 0; height: 0; border-left: 10px solid transparent; border-right: 10px solid transparent; border-bottom: 10px solid #f0f0f0;"></span>
+“&nbsp;add a factorial endpoint that uses math factorial&nbsp;”
+</div>
+
+#### Add a factorial endpoint that uses math.factorial.
+
+To add a factorial endpoint to the Flask application, we need to modify the `app.py` file.
+
+Here are the steps:
+
+1. Add a new route `/fact/<int:x>` to the Flask application.
+2. In the function for this route, call `math.factorial(x)` and return the result as a string.
+
+Here is the *edit block* for these changes:
+
+```python
+app.py
+<<<<<<< HEAD
+if __name__ == '__main__':
+    print("Starting...")
+    app.run()
+=======
+@app.route('/fact/<int:x>')
+def factorial(x):
+    result = math.factorial(x)
+    return str(result)
+
+if __name__ == '__main__':
+    print("Starting...")
+    app.run()
+>>>>>>> updated
+```
+
+> Applied edit to app.py  
+> Commit ef9e3e7 aider: Add a factorial endpoint that uses math.factorial.  
+
+</div>
+<br/>
+<br/>
+<br/>