Skip to content

StayUp 1.0

Choose a tag to compare

@NongKnot NongKnot released this 04 Jun 08:04
· 27 commits to 5d163a2dc4c7c7be7e52d65f2400f9fa7c7e91f6 since this release

StayUp 1.0

First public release.

StayUp is a free Apple Silicon Mac menu-bar Duck that keeps local work alive
when macOS would rather sleep. It is built for long-running local AI agents,
model servers, renders, downloads, and local server work.

Highlights

  • Manual On / Off. Click the menu-bar Duck to keep the Mac awake now, then
    click again to let it sleep normally.
  • Auto mode. Trusted local Activity Sources can prove work is still alive.
    StayUp keeps the Mac awake while selected sources are active, waits through a
    grace period when they go quiet, then stands down.
  • Battery + lid-closed Helper path. The hard case uses a readable root
    helper daemon registered through SMAppService to run
    pmset disablesleep on/off. No sudoers installer.
  • Layered sleep prevention. StayUp combines Apple's caffeinate, IOKit
    assertions, a closed-lid assertion, optional virtual display support for
    remote GUI workflows, and the Helper path.
  • Virtual display for remote GUI availability. If no real external monitor
    exists, StayUp can create a small virtual display so screen-sharing style
    tools have a display-shaped surface. This is not the hard sleep guarantee;
    the Helper owns that.
  • Don't Die. StayUp can disengage before low battery so the Mac is not kept
    awake forever.
  • Walking Duck. On Apple Silicon MacBooks with the right motion hardware,
    the menu-bar Duck walks when you carry the Mac. The sensor is local-only and
    only active while StayUp is engaged.
  • First-launch setup. The welcome window surfaces Launch at Login, Helper
    setup, and optional update checks.
  • Settings. General, Advanced, Walk, Look, and About tabs keep the controls
    compact.
  • Sparkle updates. Signed update checks are opt-in or manually requested.
  • No telemetry. No analytics, accounts, crash reporting, or normal-operation
    network calls.

Notes

  • Direct-distribution only. The hard-case Helper and private virtual display
    API do not fit the Mac App Store sandbox.
  • The Helper is required for the battery + lid-closed promise.
  • Do not keep a closed MacBook running in a bag, drawer, or other poorly
    ventilated place.
  • Code is MIT licensed. The StayUp name and Duck artwork are reserved.