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
holdstarts a hold, or renews it if the same source and session already hold the Mac. - A
releaseends 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
holdagain now and then, or setttl. - 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.