Aider Configuration (Linux NixOS Hyprland)
Aider AI coding assistant configuration from the `XNM1/linux-nixos-hyprland-config-dotfiles` repository. This setup provides a complete Aider configuration for Linux systems using NixOS, Hyprland, and the Catppuccin Macchiato color theme.
Configuration Features
This configuration provides:
**Auto-commits disabled** for manual control over version history**File watching enabled** to track changes in real-time**Convention files**: Reads `CONVENTIONS.md` and `AI_RULES.md` for project-specific guidelines**Vim mode enabled** for efficient keyboard navigation**Prompt caching** for improved performance**Helix editor** (`hx`) as the default editor**Architect mode** enabled for high-level design discussions**Catppuccin Macchiato theme** with custom colors for all UI elements**DeepSeek models**: `deepseek-reasoner` for main tasks, `deepseek-chat` for editor tasksInstructions
When using this configuration:
1. **Review the settings** and ensure they match your workflow preferences
2. **Replace the API key placeholder** (`your_api_key`) with your actual DeepSeek API key
3. **Create convention files** (`CONVENTIONS.md`, `AI_RULES.md`) in your project root if they don't exist
4. **Verify Helix editor** is installed (`hx` command available)
5. **Enable dark mode** in your terminal for optimal theme appearance
Main Settings
**auto-commits**: `false` - Changes are not automatically committed; you retain full control**watch-files**: `true` - Aider monitors file changes in real-time**read**: Always reads `CONVENTIONS.md` and `AI_RULES.md` for project context**vim**: `true` - Vim keybindings enabled in the Aider interface**cache-prompts**: `true` - Caches prompts to improve response times**editor**: `hx` - Uses Helix as the default text editor**architect**: `true` - Enables architect mode for system design discussionsTheme Settings (Catppuccin Macchiato)
All colors are set to match the Catppuccin Macchiato theme:
**User input**: `#A6DA95` (green)**Tool output**: `#CAD3F5` (text)**Tool error**: `#ED8796` (red)**Tool warning**: `#EED49F` (yellow)**Assistant output**: `#8AADF4` (blue)**Completion menu**: `#7DC4E4` (sapphire) on `#5B6078` (surface2)**Completion menu current item**: `#8087A2` (overlay2) on `#7DC4E4` (sapphire)**Code theme**: `lightbulb`Model Configuration
**Primary model**: `deepseek/deepseek-reasoner` - For complex reasoning and main tasks**Editor model**: `deepseek/deepseek-chat` - For quick edits and suggestions**API key**: Configure with your DeepSeek API key (replace `your_api_key`)Usage Examples
```bash
Start Aider with this configuration (ensure .aider.conf.yml is in your project root)
aider
The configuration automatically:
- Reads CONVENTIONS.md and AI_RULES.md on startup
- Watches files for changes
- Uses DeepSeek models with your API key
- Applies Catppuccin Macchiato theme
- Enables vim mode and architect mode
```
Important Notes
**API Key Security**: Replace the placeholder API key before using. Consider using environment variables (`DEEPSEEK_API_KEY`) instead of hardcoding**Convention Files**: Create `CONVENTIONS.md` and `AI_RULES.md` in your project root to provide project-specific context to the AI**Editor Requirement**: Helix editor (`hx`) must be installed and available in PATH**Theme Compatibility**: Colors are optimized for dark mode terminals**Model Availability**: Ensure you have access to DeepSeek models through their API**NixOS Context**: This configuration is optimized for NixOS systems but works on any Linux distribution