Linux NixOS Hyprland Configuration Assistant

An Aider configuration designed for maintaining and developing Linux systems based on NixOS with Hyprland window manager and Catppuccin Macchiato theming.

What This Does

This configuration sets up Aider to help you work on NixOS-based Linux configurations with:

Instructions

1. **Initialize the Configuration**

- Copy this content into `.aider.conf.yml` in your project root

- Ensure `CONVENTIONS.md` and `AI_RULES.md` exist in your repository

- Replace `your_api_key` in the api-key section with your actual DeepSeek API key

2. **File Watching and Auto-Commits**

- Auto-commits are disabled to give you full control over git history

- File watching is enabled to monitor changes in real-time

- When you make changes outside Aider, it will detect and reload them

3. **Follow Project Conventions**

- Always read and follow the guidelines in `CONVENTIONS.md`

- Adhere to the rules specified in `AI_RULES.md`

- These files are automatically loaded on every Aider session

4. **Color Scheme (Catppuccin Macchiato)**

- User input: Green (`#A6DA95`)

- Tool output: Light blue (`#CAD3F5`)

- Assistant output: Blue (`#8AADF4`)

- Errors: Red (`#ED8796`)

- Warnings: Yellow (`#EED49F`)

- Completion menu: Cyan/gray theme

5. **Model Configuration**

- Primary model: `deepseek/deepseek-reasoner` for complex reasoning tasks

- Editor model: `deepseek/deepseek-chat` for faster editing operations

- Both models require a DeepSeek API key

6. **Editor Integration**

- Default editor: Helix (`hx`)

- Vim keybindings enabled in Aider

- Architect mode enabled for system-level planning

7. **Best Practices for NixOS Configuration**

- Use declarative configuration patterns

- Test changes with `nixos-rebuild test` before committing

- Keep Hyprland configuration modular and well-documented

- Maintain consistency with Catppuccin Macchiato theme across all components

8. **Working with This Configuration**

- Start Aider from your project root: `aider`

- The configuration will automatically load

- Use `/architect` command for high-level system design discussions

- Use `/watch` to toggle file watching if needed

- Review changes carefully before committing (auto-commits disabled)

Configuration File Reference

```yaml

main settings

auto-commits: false

watch-files: true

read:

- CONVENTIONS.md

- AI_RULES.md

vim: true

cache-prompts: true

editor: hx

architect: true

theme settings

dark-mode: true

code-theme: lightbulb

user-input-color: '#A6DA95'

tool-output-color: '#CAD3F5'

tool-error-color: '#ED8796'

tool-warning-color: '#EED49F'

assistant-output-color: '#8AADF4'

completion-menu-color: '#7DC4E4'

completion-menu-bg-color: '#5B6078'

completion-menu-current-color: '#8087A2'

completion-menu-current-bg-color: '#7DC4E4'

models settings

model: deepseek/deepseek-reasoner

editor-model: deepseek/deepseek-chat

api-key:

- deepseek=your_api_key

```

Notes