🖥️ KeganOS - Personal Productivity Dashboard

A dark-themed productivity command center that integrates with KEGOMODORO Pomodoro timer and Pixe.la habit tracking to help you stay focused and visualize your progress.

---

✨ Features

🎯 Focus Management

• KEGOMODORO Integration - Launch your Pomodoro timer directly from the dashboard
• 25/5 Work Sessions - Proven time-boxing technique for deep work
• Journal Tracking - Log your thoughts and accomplishments

📊 Visual Progress

• Pixe.la Heatmap - GitHub-style contribution graph for your focus hours
• Real-time Stats - Today, Week, and Total hours at a glance
• Click-to-Navigate - Click the heatmap to view detailed stats on Pixe.la

👤 Multi-Profile Support

• Profile Selection - Switch between different user profiles
• Per-user Settings - Each profile has its own journal and Pixe.la graph
• Auto Registration - New users are automatically registered on Pixe.la

🎨 Beautiful Dark UI

• Terminal Aesthetic - Hacker-style interface with ASCII-inspired design
• Custom Title Bar - Seamless integration with Windows
• WebView2 Rendering - Modern Edge-based heatmap display

---

🏗️ Architecture

KeganOS/
├── Core/                    # Domain layer (interfaces & models)
│   ├── Interfaces/          # Service contracts
│   └── Models/              # Domain entities
├── Infrastructure/          # Implementation layer
│   ├── AI/                  # Gemini AI integration
│   ├── Data/                # SQLite database
│   └── Services/            # Service implementations
└── Views/                   # WPF UI layer

Key Principles

• ✅ SOLID Architecture - Interface-based dependency injection
• ✅ Clean Separation - Core has no dependencies on Infrastructure
• ✅ Serilog Logging - Comprehensive logging in all components
• ✅ Error Handling - Try-catch patterns with user feedback

---

🚀 Getting Started

Prerequisites

• .NET 9.0 SDK
• Python 3.10+ (for KEGOMODORO)
• Windows 10/11 (WPF requirement)

Installation

1. Clone the repository

   git clone https://github.com/yourusername/personal-os.git
   cd personal-os

2. Install Python dependencies (for KEGOMODORO)

   cd personal-os/kegomodoro
   pip install -r requirements.txt

3. Build and run KeganOS

   cd personal-os/KeganOS
   dotnet run

4. Create your profile

   • Click "Create Profile"
   • Enter your display name and symbol
   • Select or create a journal file
   • Your Pixe.la account is auto-created!

---

📁 Project Structure

Component	Description
KeganOS/	WPF dashboard application (.NET 9)
kegomodoro/	Python Pomodoro timer with Pixe.la integration

---

🔧 Configuration

Pixe.la Integration

KeganOS automatically:

• Registers new users on Pixe.la
• Creates a "focus" graph for tracking hours
• Displays your heatmap with dark theme

Journal Files

• Located in kegomodoro/dependencies/texts/
• Plain text format with date + time entries
• Auto-parsed for stats display

---

📸 Screenshots

Click to expand

Profile Selection

Select or create user profiles with custom symbols.

Main Dashboard

Dark-themed command center with timer and stats.

Pixe.la Heatmap

Interactive contribution graph showing your focus history.

---

🛣️ Roadmap

• Profile management with SQLite
• Pixe.la heatmap integration
• KEGOMODORO launcher
• WebView2 for modern rendering
• Gemini AI motivational messages
• KEGOMODORO settings from dashboard
• Unit test coverage
• PyInstaller bundle for faster startup

---

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🙏 Acknowledgments

• Pixe.la - Habit tracking API
• Serilog - Structured logging
• WebView2 - Modern web rendering

---

Made with ❤️ for productivity enthusiasts