Reference

Troubleshooting

What to check when the Mac sleeps when it shouldn't, stays awake when it should sleep, or a tool won't connect.

On this page

The Mac sleeps when I close the lid

  1. Open the menu. The status should say Awake with Lid can be closed. If it says Normal sleep, nothing is holding the Mac: start a session, or check your AI tool is connected.
  2. If it says Paused: …, a safety rule applies: the battery is at or below the floor, the Mac is too warm, or you chose to stay awake only on the charger.
  3. Check Keep running with the lid closed is on.
  4. If you’ve just plugged the charger in or out with the lid closed, open the lid, wait a few seconds and close it again.
  5. Check your free week or subscription is active. Without it, the menu shows the subscribe panel.

A connected tool doesn’t keep the Mac awake

  • Restart the tool. Tools that were already open when you connected only load the new hooks after a restart. GitHub Copilot CLI always needs one.
  • Codex: type /hooks in Codex once and trust the Neurova Awake hooks.
  • Check Connections. Open Settings, then Connections. An orange message next to the tool says what’s wrong; click Reconnect after fixing it.
  • Test it. Click Test: the tool should appear under Active holds for two minutes. If the test works but real runs don’t, the tool may have rewritten its settings file. Click Reconnect.
  • Restarted Neurova Awake in the middle of a run? The tool holds the Mac again at its next prompt.

Messages next to a tool

Message (shortened) What to do
…couldn’t find your .claude folder / doesn’t exist yet Open the tool once so it creates its folder, then click Reconnect.
That doesn’t look like your .claude folder Click Reconnect and choose that folder in your home folder.
settings.json isn’t valid JSON (or contains comments) Fix the file (remove comments), then click Reconnect. The app left it untouched.
“hooks” isn’t in the format Neurova Awake expects The file’s hooks section has an unusual shape. Fix it, or email us the file’s hooks section.
Your config.toml defines hooks inline (hooks = …) Rewrite them as [[hooks.…]] tables, then click Reconnect.
Hooks are turned off in your config.toml Set hooks = true under [features], then click Reconnect.
The Neurova Awake section in config.toml is incomplete Delete the lines between the neurova-awake markers, then click Reconnect.
The Neurova Awake hooks are no longer in settings.json Something rewrote the file. Click Reconnect.
Neurova Awake lost access to your .claude folder Click Reconnect and click Allow again.

Before every change the app saves the old file as <file>.neurova-awake-backup next to it.

The Mac stays awake after my agent finished

That’s usually the short wait after a tool stops: Stay awake after an AI tool finishes, 3 minutes by default, so a quick follow-up prompt carries straight on. The tool shows finishing under Active holds meanwhile.

If it stays awake for longer, open the menu and look at Active holds. It lists everything that’s holding the Mac: a session you started, a tool, a trigger such as On the charger, or the focus timer. End it there, or switch the trigger off.

A very long agent run lost its hold

A tool’s hold ends after Give up on a silent AI tool after, 4 hours by default, counted from the start of each prompt. If one prompt often runs longer, raise it in Settings, then Lid & safety (up to 24 hours).

Do Not Disturb doesn’t turn on

The shortcuts must be named exactly Neurova Focus On and Neurova Focus Off, including capitals and spaces. Open Settings, then Focus timer, click Set Up… and Test again, then Yes, it worked. The app only runs the shortcuts after a successful test. Do Not Disturb setup.

No focus notifications

Check Notify me when a phase ends is on, and that notifications are allowed for Neurova Awake in System Settings, then Notifications.

I subscribed, but the app asks me to subscribe again

Open Settings, then Subscription, and click Restore purchases, signed in to the App Store with the Apple Account you subscribed with. If the subscription ended or a payment didn’t go through, the App Store shows it under Account Settings, then Subscriptions. Free week and subscription.

See what macOS is doing

In Terminal:

pmset -g assertions

shows Neurova Awake is keeping your Mac awake while a session runs, and Neurova Awake lid-closed mode when lid-closed mode is on. To check that a closed lid didn’t put the Mac to sleep:

pmset -g log | grep -i "clamshell"

Still stuck?

Email support@neurova-ai.com with your Mac model, your macOS version and what you expected to happen. We reply by email, usually within two working days.

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.