Connect your tools to Neurova Awake

How the app knows when each AI agent is working, what it changes on your Mac, and the link scheme for anything else.

Last updated 16 November 2026

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.

Connect a tool in the app

  1. Open Neurova Awake from the menu bar, then Settings, then Connections.
  2. Click Connect next to the tool. A folder picker opens on the tool's settings folder: click Allow. (Mac App Store apps can only touch folders you choose, so this one click is the permission.)
  3. The app saves a backup of the tool's settings file, adds its entry and shows Connected. Click Test to check it.

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.

1. Claude Code

the CLI and the Code tab in the Claude app · hooks: start and end of each run

File~/.claude/settings.json
What it addsUserPromptSubmit starts a hold; Stop and SessionEnd release it. Each entry runs open -g with a neurova-awake link.

2. GitHub Copilot

Copilot CLI · hooks: start and end of each run

File~/.copilot/hooks/neurova-awake.json
What it addsuserPromptSubmitted 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.

3. ChatGPT

the desktop app · while the app 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.

4. Cursor

the editor · hooks: start and end of each run

File~/.cursor/hooks.json
What it addsbeforeSubmitPrompt 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.

5. OpenAI Codex

the Codex CLI · hooks: start and end of each run

File~/.codex/config.toml
What it addsA [hooks] entry holds and releases; older versions use the notify setting. Each entry runs open -g with a neurova-awake link.

6. Claude

the desktop app, for chat and Cowork · while the app is open

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.

7. Gemini CLI

hooks: start and end of each run

File~/.gemini/settings.json
What it addsBeforeAgent 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>
sourceA short name for the tool, shown in the app's menu under Active holds. Letters, digits, hyphens and underscores, for example my-build.
sessionAn 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: