How the app knows when each AI agent is working, what it changes on your Mac, and the link scheme for anything else.
Lid-closed mode needs no setup. Connecting a tool is what lets Neurova Awake stay awake only while that tool is working, and let the Mac sleep the rest of the time.
To undo it, click Disconnect: the app removes its entries and leaves the rest of the file as it was. The tools' own settings files never leave your Mac.
| File | ~/.claude/settings.json |
|---|---|
| What it adds | UserPromptSubmit starts a hold; Stop and SessionEnd release it. Each entry runs open -g with a neurova-awake link. |
| File | ~/.copilot/hooks/neurova-awake.json |
|---|---|
| What it adds | userPromptSubmitted starts a hold; sessionEnd releases it. Each entry runs open -g with a neurova-awake link. |
For agent mode in VS Code, use the app trigger instead: stay awake while VS Code is open.
ChatGPT has no hooks to tell other apps when it's working, so Neurova Awake keeps the Mac awake while the ChatGPT app is open. Click Connect to turn this on; there's no file to change.
Agent tasks and deep research run on OpenAI's servers, not on your Mac, so they don't need it awake.
| File | ~/.cursor/hooks.json |
|---|---|
| What it adds | beforeSubmitPrompt starts a hold; stop releases it. Each entry runs open -g with a neurova-awake link. |
The Cursor CLI's hooks don't fire reliably yet, so the editor is the supported way.
| File | ~/.codex/config.toml |
|---|---|
| What it adds | A [hooks] entry holds and releases; older versions use the notify setting. Each entry runs open -g with a neurova-awake link. |
Claude has no hooks to tell other apps when it's working, so Neurova Awake keeps the Mac awake while the Claude app is open. Click Connect to turn this on; there's no file to change.
The Code tab is covered by the Claude Code connection above.
| File | ~/.gemini/settings.json |
|---|---|
| What it adds | BeforeAgent starts a hold; AfterAgent and SessionEnd release it. Each entry runs open -g with a neurova-awake link. |
Any tool, script or automation that can run a command can hold the Mac awake. Send a
hold link when the work starts and a release link when it ends:
neurova-awake://hold?source=<tool>&session=<id> neurova-awake://release?source=<tool>&session=<id>
source | A short name for the tool, shown in the app's menu under Active holds. Letters, digits, hyphens and underscores, for example my-build. |
|---|---|
session | 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. Use the tool's own session ID if it has one. |
From the command line, use open -g, which 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" make release open -g "neurova-awake://release?source=my-build&session=$id"
How the app treats these links:
hold starts a hold, or renews it if the same source and session already
hold the Mac.release ends that hold. When no holds are left, the app waits a short grace
period, then lets the Mac sleep.About Neurova Awake Support and troubleshooting support@neurova-ai.com