Guide

Link scheme

Any tool, script or automation that can open a link can keep your Mac awake: send hold when the work starts and release when it ends.

On this page

The links

Link What it does
neurova-awake://hold?source=…&session=… Holds the Mac awake for one run of a tool, or renews that hold.
neurova-awake://release?source=…&session=… Ends that hold, after the usual short wait.
neurova-awake://start Starts a session without a time limit, like Keep awake.
neurova-awake://start?minutes=90 Starts a session of 90 minutes (1 minute to 7 days).
neurova-awake://stop Ends the session you started.
neurova-awake://focus/start Starts the focus timer, or resumes it.
neurova-awake://focus/stop Stops the focus timer.

Hold and release

Parameter Used with Meaning
source hold, release Required. A short name for the tool, such as my-build. Letters, digits, -, _, . and :, up to 40 characters, not case-sensitive.
session hold, release An ID for this one run. A hold and a release with the same source and session belong together, so parallel runs never cancel each other. Up to 80 characters. Without it, default.
label hold The name shown under Active holds, up to 60 characters. Without it, the tool’s name or the source.
ttl hold Seconds before the hold runs out if no release comes, up to 24 hours. Without it, the Give up on a silent AI tool after setting (4 hours).
grace release Seconds to wait before the Mac may sleep, up to 1 hour. Without it, the Stay awake after an AI tool finishes setting (3 minutes). grace=0 lets go at once.

Encode spaces in a label as %20.

From Terminal and scripts

Use open -g: it passes the link to the app without bringing it to the front.

id="build-$(date +%s)"
open -g "neurova-awake://hold?source=my-build&session=$id&label=Release%20build"
make release
open -g "neurova-awake://release?source=my-build&session=$id"

Keep the Mac awake for an hour and a half, then let it sleep:

open -g "neurova-awake://start?minutes=90"

How the app treats links

  • A hold starts a hold, or renews it if the same source and session already hold the Mac.
  • A release ends that hold. When nothing is left holding, the app waits the grace period, then lets the Mac sleep.
  • Every hold runs out after its time limit, so a script that crashes before its release can’t keep the Mac awake for ever. For a long job, send hold again now and then, or set ttl.
  • The safety rules always win: below the battery floor, or when the Mac runs seriously hot, holds pause.
  • Links can’t change settings. Links the app doesn’t recognise are ignored, and links never open a window.
  • Without a free week or subscription, links are accepted but don’t keep the Mac awake.

Check it worked

The menu shows the hold under Active holds, with its label. In Terminal, pmset -g assertions lists Neurova Awake is keeping your Mac awake while anything holds it.

Last updated 18 November 2026

Can't find it here? See Support and FAQ or email support@neurova-ai.com. We reply by email, usually within two working days.