Modus/AGENTS.md

AGENTS.md - Modus Desktop Environment

Project Overview

• Technology: Python desktop environment using Fabric framework (GTK/PyGObject)
• Purpose: Wayland desktop environment with launcher, panel, dock, notifications
• Entry Point: main.py - starts all components

Build/Test Commands

• Run Application: python main.py
• Test Icon Browser: python test.py
• Install Dependencies: pip install -r requirements.txt
• No formal test suite exists - test by running components directly

Code Style Guidelines

• Imports: Standard library first, third-party second, local modules last with blank lines between groups
• Formatting: Follow PEP 8, use 4 spaces for indentation
• Naming: snake_case for functions/variables, PascalCase for classes, UPPER_CASE for constants
• Type Hints: Use typing imports for List, Optional, Tuple annotations
• Error Handling: Use try/except blocks, log errors with print statements or loguru logger
• Comments: Minimal docstrings for classes, no inline comments unless complex logic
• Constants: Define module-level constants at top (e.g., SEARCH_DEBOUNCE_MS = 50)
• Properties: Use @Property decorator with type hints for Fabric service properties
• Signals: Use @Signal decorator for event handling in services
• Widget Structure: Inherit from appropriate Fabric widgets (Window, Box, Entry, etc.)
• GTK Integration: Use gi.repository imports for GTK, GLib functionality