A native macOS GitHub Notifications client built with Swift and SwiftUI, featuring Liquid Glass design.
- 🔔 Real-time Notifications — Sync and display GitHub notifications with local alerts
- 📋 Smart Filters — Filter by repository, reason (review requested, mentioned, assigned, etc.)
- 🏷️ Category Groups — Organize notifications like Apple Reminders smart lists
- ✅ Mark as Read/Done — Archive or mark notifications as read with swipe gestures
- 🔗 Quick Open — Open issues/PRs directly in browser
- 🔍 Search — Full-text search across all notifications
- 🎨 Liquid Glass UI — macOS 26 native design with translucent surfaces
- ⌨️ Keyboard Shortcuts — Full keyboard control for power users
- macOS 26.0 or later
- GitHub account
Download the latest release from the Releases page.
git clone https://github.com/sozercan/kuyruk.git
cd kuyruk
xcodebuild -scheme Kuyruk -destination 'platform=macOS' build| Shortcut | Action |
|---|---|
| ⌘1 | Go to Inbox |
| ⌘2 | Go to Participating |
| ⌘3 | Go to Mentioned |
| ⌘F | Focus Search |
| ⌘K | Open Command Bar |
| Shortcut | Action |
|---|---|
| ⌘R | Refresh |
| ⌘O | Open in Browser |
| ⌘⇧M | Mark as Read |
| ↑↓ | Navigate Notifications |
| ⏎ | Open Selected |
See CONTRIBUTING.md for development setup, architecture, and coding guidelines.
- Architecture — Services, state management, data flow
- API Integration — GitHub API endpoints
- Testing — Test commands and patterns
- ADRs — Architecture Decision Records
MIT License - see LICENSE file for details.