Skip to content
M. Alkhatib
Projects
Direct v0.1.0 availablemacOS menu-bar utility

HoldAwake.

A native macOS menu-bar utility for starting focused sleep-prevention sessions from a coffee-cup status item.

HoldAwake Direct v0.1.0 is a Developer ID-signed, Apple-notarized and stapled DMG for Apple silicon Macs running macOS 26 or later. The Mac App Store submission remains deferred.

Closed-lid Prevent Sleep can increase heat and battery use. Read the safety, helper-removal, and manual-recovery instructions below before enabling it.

Why I made it.

I wanted a small, native way to keep a Mac awake during long-running work without turning power management into a permanent system tweak.

Builds, downloads, scripts, automation, and agent tasks can outlast the time I spend actively watching them. Going back to check the Mac—or remembering a shell command every time—was friction I did not need.

That led to a menu-bar utility with an obvious active cup and deliberate start and stop behavior. Timed sessions end predictably, display sleep stays independently controllable, and closed-lid behavior has a conspicuous safety boundary: optional, narrowly scoped, explicitly approved, and isolated in Direct instead of becoming a silent system-wide setting.

HoldAwake engineering notes

Native on purpose

The menu-bar status item and Settings window use native macOS interfaces, keeping system behavior legible and the controls accessible.

Privilege stays separate

The sandboxed App Store build uses public power assertions. The optional privileged helper belongs only to the separate Direct edition.

Safety before convenience

Prevent Sleep is session-bound, while heat, ventilation, recovery, and helper removal are treated as product behavior rather than footnotes.

What it does.

The everyday controls stay short. Edition boundaries, privileged behavior, and recovery stay explicit.

BUILT IN

  • Start and stop a session from the coffee-cup status item, with a clear active state
  • Indefinite and timed presets with remaining-time feedback and deliberate session replacement
  • Independent display-sleep, Start at Login, and Activate on Launch settings
  • Native keyboard-accessible status and Settings interfaces with textual feedback
  • A sandboxed App Store build using IOKit and a notarized Direct release using local caffeinate
  • Optional administrator-approved Prevent Sleep in Direct, with explicit helper removal and recovery guidance

LEFT OUT

  • Accounts, advertising, analytics, telemetry, tracking, or cloud services
  • A bundled updater or third-party runtime
  • Silent, automatic, or permanent closed-lid power changes
  • Privileged code or Prevent Sleep in the App Store edition
  • Helper installation or approval without an explicit user action
  • General power or battery tuning, Intel Macs, or macOS versions below 26

The interface stays native.

Session state, duration, and preferences remain visible in the same macOS surfaces where the action happens.

The menu capture shows the shared coffee-cup status control and complete duration menu. The Settings captures show the shared native experience without relying on the images to explain the controls.

The Activation and About captures explicitly show the App Store edition. They do not show HoldAwake Direct's helper controls.

HoldAwake duration menu expanded beneath the coffee-cup status item.
Menu-bar duration presets
HoldAwake General settings showing an inactive session and the two launch toggles.
General settings: session status and launch behavior
HoldAwake App Store edition Activation settings showing duration, display sleep, and closed-lid information.
Activation settings: duration, display sleep, and the App Store closed-lid boundary
HoldAwake About window showing the app icon and App Store edition identity.
About HoldAwake: App Store edition, version, repository, and license

Two editions, one focused job.

The codebase produces two independently installable editions with the same native menu-bar experience. Their power-management boundaries and release states stay deliberately separate.

Submission deferred

HoldAwake — App Store Edition

A sandboxed build composed entirely around public macOS power-management APIs.

Bundle ID
online.alkhatib.HoldAwake
Sandbox
Enabled
Wake method
Public IOKit power assertions
Availability
Mac App Store submission remains deferred

This edition contains no privileged helper and no Prevent Sleep support. It is not presented here as a released download.

Direct v0.1.0 available

HoldAwake Direct

The public Developer ID release, with optional closed-lid support behind explicit administrator approval.

Bundle ID
online.alkhatib.HoldAwake.Direct
Distribution
Developer ID-signed, notarized DMG
Wake method
Local /usr/bin/caffeinate
Closed lid
Optional administrator-approved helper

Prevent Sleep applies only to the current session, is never persisted as an app preference, and must be enabled deliberately.

Control it from the menu bar.

The coffee cup is both the status indicator and the shortest path to a session.

  • Start or stop from the cup

    Left-click the coffee-cup status item to start the configured default session. Click it again to stop the session HoldAwake owns.

  • Choose a duration

    Right-click or Control-click to open the native menu, then start or replace the current session with any preset.

  • Keep the display independent

    Allow Display to Sleep keeps the system awake while letting the display turn off normally. Changing it safely replaces an active session.

Duration presets

  • Indefinitely
  • 5 minutes
  • 10 minutes
  • 15 minutes
  • 30 minutes
  • 1 hour
  • 2 hours
  • 5 hours

Launch behavior

Start at Login and Activate on Launch are independent native settings. Both are off by default.

Accessibility and privacy highlights

Native and accessible

Native macOS menus and Settings provide keyboard-accessible controls and VoiceOver labels. Status and setup feedback are communicated with text rather than color alone.

Private by default

HoldAwake has no accounts, advertising, analytics, telemetry, tracking, updater, or cloud service. Preferences stay on the Mac, and the app has no bundled third-party runtime.

Read the HoldAwake privacy policy

Open source, with credit.

HoldAwake is an independent implementation available under the MIT License.

HoldAwake was inspired by KeepingYouAwake by Marcel Dierkes and caffeinate-disablesleep by Demiao Chen. It copies no upstream source or artwork.

© 2026 Mohamad Alkhatib.

Download HoldAwake Direct.

Direct v0.1.0 is the public release for Apple silicon Macs running macOS 26 or later. Read the source or download the signed, notarized DMG from GitHub.

SHA-256: cff34e93dd7aafe516b876ed5799fe9cf207b8c26c66eb99379d43f09f4e1f1c