branch: elpa/aidermacs
commit 02f8f3ea6ab6c5b7c554c81dd4eb729762ad6910
Author: Mingde (Matthew) Zeng <matthew...@posteo.net>
Commit: Mingde (Matthew) Zeng <matthew...@posteo.net>
docs: Add common issues section to README.md
Fixes #145 #146
---
README.md | 23 +++++++++++++++++++++++
1 file changed, 23 insertions(+)
diff --git a/README.md b/README.md
index b6be47ac1e..71abbfd9b9 100644
--- a/README.md
+++ b/README.md
@@ -541,6 +541,29 @@ And adjust aidermacs program with below config.
(setq aidermacs-program (expand-file-name "~/.local/bin/aider"))
```
+### Local models prefer English, even if the prompt language is different
+
+Some local models in aider may default to English, even if you use a different
language in your prompt. To ensure the chat language matches your preference
(e.g., Russian), add the following to your Emacs configuration:
+
+```emacs-lisp
+(add-to-list 'aidermacs-extra-args "--chat-language ru")
+```
+
+This will instruct aider to use Russian for chat interactions.
+
+### Aidermacs or Aider ignores command-line arguments and prompts for provider
selection when using Ollama
+
+If the `~/.aider` directory exists (even if empty), Aidermacs or Aider may
silently ignore command-line arguments and unexpectedly prompt for provider
selection (e.g., forcing OpenRouter), even if your configuration is correct for
Ollama or other providers.
+
+**Workaround:**
+Remove the existing aider directory and restart Emacs:
+
+```bash
+rm -rf ~/.aider*
+```
+
+After this, Aidermacs should start as expected with your configured provider
(e.g., Ollama).
+
### Aidermacs vs Aider CLI vs aider.el?
Aidermacs is designed to provide a more Emacs-native experience while
integrating with [Aider CLI](https://github.com/paul-gauthier/aider). It began
as a fork of `aider.el`, but has since diverged significantly to prioritize
Emacs workflow integration, built by Emacser, for Emacser.
