Puck
Linux desktop / Local-first software2026
An Omarchy top-bar companion for little promises, saved links, focus timers, and reminders to step away from the pixels. No account. No separate app.
- My part
- Desktop product / Interface + systems
- Built with
- QML / Quickshell / Bash / Atomic state
The public product preview from the Puck repository.
Keep the little things nearby.
Puck lives inside the Omarchy top bar. A pair of eyes opens a quiet panel for tasks, saved links, timers, and daily care check-ins.
The product does not ask for an account or another application window. Its runtime uses the existing desktop shell and command-line utilities.
Gentle, with a little personality.
Check-ins fill saved progress segments. A quiet blink and a small nod acknowledge actions; a reduced-motion preference removes the extra movement.
Tasks carry over, daily counts follow the local calendar, and timers can notify while the panel is closed. Keyboard shortcuts keep the panel useful without a mouse.
Local-first still needs durable state.
QML owns the interface, while a Bash store owns persistence and reminder logic. Writes use locking and atomic saves; a previous-state backup and damaged-data preservation support recovery.
Reminder eligibility is checked once a minute, and ordinary nudges are spaced at least thirty minutes apart. This keeps several due reminders from arriving as a pile of notifications.
A tool that stays out of the way.
The repository includes an installable Omarchy 4 plugin, documented controls and desktop actions, data regression tests, and a QML smoke check. Its data stays local.