chatmcp-cli 0.1.0__py3-none-any.whl

aider/website/docs/git.md

@@ -0,0 +1,76 @@
+---
+parent: More info
+nav_order: 100
+description: Aider is tightly integrated with git.
+---
+
+# Git integration
+
+Aider works best with code that is part of a git repo.
+Aider is tightly integrated with git, which makes it easy to:
+
+  - Use the `/undo` command to instantly undo any AI changes that you don't like.
+  - Go back in the git history to review the changes that aider made to your code
+  - Manage a series of aider's changes on a git branch
+
+Aider uses git in these ways:
+
+- It asks to create a git repo if you launch it in a directory without one.
+- Whenever aider edits a file, it commits those changes with a descriptive commit message. This makes it easy to undo or review aider's changes. 
+- Aider takes special care before editing files that already have uncommitted changes (dirty files). Aider will first commit any preexisting changes with a descriptive commit message. 
+This keeps your edits separate from aider's edits, and makes sure you never lose your work if aider makes an inappropriate change.
+
+## In-chat commands
+
+Aider also allows you to use 
+[in-chat commands](/docs/usage/commands.html)
+to perform git operations:
+
+- `/diff` will show all the file changes since the last message you sent.
+- `/undo` will undo and discard the last change.
+- `/commit` to commit all dirty changes with a sensible commit message.
+- `/git` will let you run raw git commands to do more complex management of your git history.
+
+You can also manage your git history outside of aider with your preferred git tools.
+
+## Disabling git integration
+
+While it is not recommended, you can disable aider's use of git in a few ways:
+
+  - `--no-auto-commits` will stop aider from git committing each of its changes.
+  - `--no-dirty-commits` will stop aider from committing dirty files before applying its edits.
+  - `--no-git` will completely stop aider from using git on your files. You should ensure you are keeping sensible backups of the files you are working with.
+  - `--git-commit-verify` will run pre-commit hooks when making git commits. By default, aider skips pre-commit hooks by using the `--no-verify` flag (`--git-commit-verify=False`).
+
+## Commit messages
+
+Aider sends the `--weak-model` a copy of the diffs and the chat history
+and asks it to produce a commit message.
+By default, aider creates commit messages which follow
+[Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/).
+
+You can customize the
+[commit prompt](https://github.com/Aider-AI/aider/blob/main/aider/prompts.py#L5)
+with the `--commit-prompt` option.
+You can place that on the command line, or 
+[configure it via a config file or environment variables](https://aider.chat/docs/config.html).
+
+
+## Commit attribution
+
+Aider marks commits that it either authored or committed.
+
+- If aider authored the changes in a commit, they will have "(aider)" appended to the git author and git committer name metadata.
+- If aider simply committed changes (found in dirty files), the commit will have "(aider)" appended to the git committer name metadata.
+
+You can use `--no-attribute-author` and `--no-attribute-committer` to disable
+modification of the git author and committer name fields.
+
+Additionally, you can use the following options to prefix commit messages:
+
+- `--attribute-commit-message-author`: Prefix commit messages with 'aider: ' if aider authored the changes.
+- `--attribute-commit-message-committer`: Prefix all commit messages with 'aider: ', regardless of whether aider authored the changes or not.
+
+Finally, you can use `--attribute-co-authored-by` to have aider append a Co-authored-by trailer to the end of the commit string. 
+This will disable appending `(aider)` to the git author and git committer unless you have explicitly enabled those settings.
+

aider/website/docs/index.md

@@ -0,0 +1,47 @@
+---
+nav_exclude: true
+---
+
+# Aider Documentation
+
+Aider is AI pair programming in your terminal. This documentation will help you get the most out of aider.
+
+<div class="toc">
+{% assign pages_list = site.html_pages | sort: "nav_order" %}
+
+<ul>
+{% for page in pages_list %}
+  {% if page.title and page.url != "/" and page.parent == nil and page.nav_exclude != true %}
+    <li>
+      <a href="{{ page.url | absolute_url }}">{{ page.title }}</a>{% if page.description %} <span style="font-size: 0.9em; font-style: italic;">— {{ page.description }}</span>{% endif %}
+      
+      {% assign children = site.html_pages | where: "parent", page.title | sort: "nav_order" %}
+      {% if children.size > 0 %}
+        <ul>
+        {% for child in children %}
+          {% if child.title %}
+            <li>
+              <a href="{{ child.url | absolute_url }}">{{ child.title }}</a>{% if child.description %} <span style="font-size: 0.9em; font-style: italic;">— {{ child.description }}</span>{% endif %}
+              
+              {% assign grandchildren = site.html_pages | where: "parent", child.title | sort: "nav_order" %}
+              {% if grandchildren.size > 0 %}
+                <ul>
+                {% for grandchild in grandchildren %}
+                  {% if grandchild.title %}
+                    <li>
+                      <a href="{{ grandchild.url | absolute_url }}">{{ grandchild.title }}</a>{% if grandchild.description %} <span style="font-size: 0.9em; font-style: italic;">— {{ grandchild.description }}</span>{% endif %}
+                    </li>
+                  {% endif %}
+                {% endfor %}
+                </ul>
+              {% endif %}
+            </li>
+          {% endif %}
+        {% endfor %}
+        </ul>
+      {% endif %}
+    </li>
+  {% endif %}
+{% endfor %}
+</ul>
+</div>

aider/website/docs/install/codespaces.md

@@ -0,0 +1,39 @@
+---
+title: GitHub Codespaces
+parent: Installation
+nav_order: 900
+---
+
+# GitHub Codespaces
+
+You can use aider in GitHub Codespaces via the built-in Terminal pane.
+See below for an example,
+but you can just follow the
+[main install instructions](/docs/install.html)
+inside your codespace terminal.
+
+
+<div class="video-container">
+  <video controls poster="/assets/codespaces.jpg">
+    <source src="/assets/codespaces.mp4" type="video/mp4">
+    <a href="/assets/codespaces.mp4">Install aider in GitHub Codespaces</a>
+  </video>
+</div>
+
+<style>
+.video-container {
+  position: relative;
+  padding-bottom: 101.89%; /* 1080 / 1060 = 1.0189 */
+  height: 0;
+  overflow: hidden;
+}
+
+.video-container video {
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+}
+</style>
+

aider/website/docs/install/docker.md

@@ -0,0 +1,57 @@
+---
+parent: Installation
+nav_order: 100
+---
+
+# Aider with docker
+
+Aider is available as 2 docker images:
+
+- `paulgauthier/aider` installs the aider core, a smaller image that's good to get started quickly.
+- `paulgauthier/aider-full` installs aider will all the optional extras.
+
+The full image has support for features like interactive help, the
+browser GUI and support for using Playwright to scrape web pages.  The
+core image can still use these features, but they will need to be
+installed the first time you access them. Since containers are
+ephemeral, the extras will need to be reinstalled the next time you
+launch the aider core container.
+
+### Aider core 
+
+```
+docker pull paulgauthier/aider
+docker run -it --user $(id -u):$(id -g) --volume $(pwd):/app paulgauthier/aider --openai-api-key $OPENAI_API_KEY [...other aider args...]
+```
+
+### Full version
+
+```
+docker pull paulgauthier/aider-full
+docker run -it --user $(id -u):$(id -g) --volume $(pwd):/app paulgauthier/aider-full --openai-api-key $OPENAI_API_KEY [...other aider args...]
+```
+
+## How to use it
+
+You should run the above commands from the root of your git repo,
+since the `--volume` arg maps your current directory into the
+docker container.
+Given that, you need to be in the root of your git repo for aider to be able to
+see the repo and all its files.
+
+You should be sure your that
+git repo config contains your user name and email, since the
+docker container won't have your global git config.
+Run these commands while in your git repo, before
+you do the `docker run` command:
+
+```
+git config user.email "you@example.com"
+git config user.name "Your Name"
+```
+
+
+## Limitations
+
+- 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.
+- 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.

aider/website/docs/install/optional.md

@@ -0,0 +1,100 @@
+---
+parent: Installation
+nav_order: 20
+---
+
+# Optional steps
+{: .no_toc }
+
+The steps below are completely optional.
+
+- TOC
+{:toc}
+
+## Install git
+
+Aider works best if you have git installed.
+Here are
+[instructions for installing git in various environments](https://github.com/git-guides/install-git).
+
+## Setup an API key
+
+You need an key from an API provider to work with most models:
+
+- [OpenAI](https://help.openai.com/en/articles/4936850-where-do-i-find-my-secret-api-key) provides o1, o3-mini, gpt-4o and other models. Note that paying for an API key is different than being a "ChatGPT" subscriber.
+- [Anthropic](https://docs.anthropic.com/claude/reference/getting-started-with-the-api) provides Claude 3.7 Sonnet and Haiku.
+- [DeepSeek](https://platform.deepseek.com/api_keys) provides DeepSeek R1 and DeepSeek Chat V3.
+- [OpenRouter](https://openrouter.ai/keys) allows you to access models from many providers using a single key.
+
+You can [store your api keys in configuration or env files](/docs/config/api-keys.html)
+and they will be loaded automatically whenever you run aider.
+
+## Enable Playwright 
+
+Aider supports adding web pages to the chat with the `/web <url>` command.
+When you add a url to the chat, aider fetches the page and scrapes its
+content.
+
+By default, aider uses the `httpx` library to scrape web pages, but this only
+works on a subset of web pages.
+Some sites explicitly block requests from tools like httpx.
+Others rely heavily on javascript to render the page content,
+which isn't possible using only httpx.
+
+Aider works best with all web pages if you install
+Playwright's chromium browser and its dependencies:
+
+```
+playwright install --with-deps chromium
+```
+
+See the
+[Playwright for Python documentation](https://playwright.dev/python/docs/browsers#install-system-dependencies)
+for additional information.
+
+
+## Enable voice coding 
+
+Aider supports 
+[coding with your voice](https://aider.chat/docs/usage/voice.html)
+using the in-chat `/voice` command.
+Aider uses the [PortAudio](http://www.portaudio.com) library to
+capture audio.
+Installing PortAudio is completely optional, but can usually be accomplished like this:
+
+- For Windows, there is no need to install PortAudio.
+- For Mac, do `brew install portaudio`
+- For Linux, do `sudo apt-get install libportaudio2`
+  - Some linux environments may also need `sudo apt install libasound2-plugins`
+
+## Add aider to your IDE/editor
+
+You can use 
+[aider's `--watch-files` mode](https://aider.chat/docs/usage/watch.html)
+to integrate with any IDE or editor.
+
+There are a number of 3rd party aider plugins for various IDE/editors.
+It's not clear how well they are tracking the latest
+versions of aider,
+so it may be best to just run the latest
+aider in a terminal alongside your editor and use `--watch-files`.
+
+### NeoVim
+
+[joshuavial](https://github.com/joshuavial) provided a NeoVim plugin for aider:
+
+[https://github.com/joshuavial/aider.nvim](https://github.com/joshuavial/aider.nvim)
+
+### VS Code
+
+You can run aider inside a VS Code terminal window.
+There are a number of 3rd party 
+[aider plugins for VSCode](https://marketplace.visualstudio.com/search?term=aider%20-kodu&target=VSCode&category=All%20categories&sortBy=Relevance).
+
+### Other editors
+
+If you are interested in creating an aider plugin for your favorite editor,
+please let us know by opening a
+[GitHub issue](https://github.com/Aider-AI/aider/issues).
+
+

aider/website/docs/install/replit.md

@@ -0,0 +1,8 @@
+---
+parent: Installation
+nav_order: 900
+---
+
+### Replit
+
+{% include replit-pipx.md %}

aider/website/docs/install.md

@@ -0,0 +1,115 @@
+---
+title: Installation
+has_children: true
+nav_order: 20
+description: How to install and get started pair programming with aider.
+---
+
+# Installation
+{: .no_toc }
+
+
+## Get started quickly with aider-install
+
+{% include get-started.md %}
+
+This will install aider in its own separate python environment.
+If needed, 
+aider-install will also install a separate version of python 3.12 to use with aider.
+
+Once aider is installed,
+there are also some [optional install steps](/docs/install/optional.html).
+
+See the [usage instructions](https://aider.chat/docs/usage.html) to start coding with aider.
+
+## One-liners
+
+These one-liners will install aider, along with python 3.12 if needed.
+They are based on the 
+[uv installers](https://docs.astral.sh/uv/getting-started/installation/).
+
+#### Mac & Linux
+
+Use curl to download the script and execute it with sh:
+
+```bash
+curl -LsSf https://aider.chat/install.sh | sh
+```
+
+If your system doesn't have curl, you can use wget:
+
+```bash
+wget -qO- https://aider.chat/install.sh | sh
+```
+
+#### Windows
+
+```powershell
+powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"
+```
+
+
+## Install with uv
+
+You can install aider with uv:
+
+```bash
+python -m pip install uv  # If you need to install uv
+uv tool install --force --python python3.12 --with pip aider-chat@latest
+```
+
+This will install uv using your existing python version 3.8-3.13,
+and use it to install aider.
+If needed, 
+uv will automatically install a separate python 3.12 to use with aider.
+
+Also see the
+[docs on other methods for installing uv itself](https://docs.astral.sh/uv/getting-started/installation/).
+
+## Install with pipx
+
+You can install aider with pipx:
+
+```bash
+python -m pip install pipx  # If you need to install pipx
+pipx install aider-chat
+```
+
+You can use pipx to install aider with python versions 3.9-3.12.
+
+Also see the
+[docs on other methods for installing pipx itself](https://pipx.pypa.io/stable/installation/).
+
+## Other install methods
+
+You can install aider with the methods described below, but one of the above
+methods is usually safer.
+
+#### Install with pip
+
+If you install with pip, you should consider
+using a 
+[virtual environment](https://docs.python.org/3/library/venv.html)
+to keep aider's dependencies separated.
+
+
+You can use pip to install aider with python versions 3.9-3.12.
+
+```bash
+python -m pip install -U --upgrade-strategy only-if-needed aider-chat
+```
+
+{% include python-m-aider.md %}
+
+#### Installing with package managers
+
+It's best to install aider using one of methods
+recommended above.
+While aider is available in a number of system package managers,
+they often install aider with incorrect dependencies.
+
+## Next steps...
+
+There are some [optional install steps](/docs/install/optional.html) you could consider.
+See the [usage instructions](https://aider.chat/docs/usage.html) to start coding with aider.
+