Skip to content
/ nudge Public

Folders and files

NameName
Last commit message
Last commit date

Latest commit

82a5786 · · Aug 7, 2026

History

16 Commits
May 30, 2026
May 30, 2026
Aug 6, 2026
Aug 7, 2026
Aug 1, 2026
Aug 6, 2026
Aug 1, 2026
Jun 16, 2026
Aug 1, 2026
Jun 16, 2026
Jun 16, 2026
May 30, 2026
May 30, 2026
Jun 16, 2026

Repository files navigation

Nudge icon

Nudge

A friendly desktop companion that helps you stay balanced while you work

The problem

It's easy to lock in at your computer for hours without noticing how quickly time passes. Timers and notifications are easy to ignore since they're repetative and easy to dismiss.

Nudge makes the time spent on your computer tangible. A desktop companion gets visibly more tired the longer you work and nudges you to rest. When you actually take a break, it the companion recovers.

Features

  • Visual progression: character animation depends on time spent on computer without a break
  • Taking a break will restore the character: resting long enough to compensate for time spent without break will recover the companion
  • App awareness: detects focused window and maps animation to a category (Developer tools -> companion is typing)ng)
  • Context-aware phrases: says phrases based on what you're doing (coding, gaming, social, etc.) and how tired the companion is
  • Configurable reminders, screen position, monitor, per-app categories
  • Activity summary: time per category, breaks taken/interrupted, longest stretch, ~31 days of history
  • Customizable global pause shortcut: hides overlay

Challenges

  • Overlay window that stays out of the way: ignoring mouse events until you hover or click on character
  • Mac-specific apis (focused app detection, idle-input monitoring, cursor tracking) not implemented on windows (cuz i only got a mac)
  • Break awareness: watching for keyboard/mouse activity to end break early
  • Character progression: needed to draw frames for different app categories + different faces based on how long user was working

The future

  • Smoother character transitions (idle -> moving to an app with enter/exit animations)ns)
  • More art - different characters, polish, more categories/different appearance for time spent on computer, accesories
  • Launch at login
  • Windows support
  • Better actvity insights and more powerful break reminders

Installation

Requirements: macOS, Node.js, Rust, and Tauri prerequisites.

Note: Not tested on Windows.

# dependencies
git clone [repo url]

cd nudge
npm install



# run in dev
npm run tauri dev



# or build a release bundle
npm run tauri buildd

TO ADD:

  • weird thing on back (setting backdrop)
  • change color of stat hover based on background
  • adding notes for it to tell you on next timeevent
  • onboarding
  • no text select on settings popup