Support

Email tony@noodledragon.studio. One person reads it, and that person made the app. Expect a reply within two working days.

Before you write, the answers to what gets asked most.

“An agent shows Idle or Not connected while it's working.”

Hook-connected agents hear about Awakado through a small hook it adds to the agent's settings. Turn on Agent mode and choose Connect, and Awakado adds it. An agent that was already running picks it up at its next step. Codex also asks you to trust new hooks once: run /hooks in Codex and approve Awakado. Agents followed from activity need no setup; they show as Open, not working while they're idle.

“My Mac was asleep when I came back.”

It was most likely locked, not asleep. Awakado keeps the Mac and your agents running, but by default the screen still turns off and locks after a few minutes, like any Mac left alone, so you need your password to get back in. Your agents carried on the whole time. If you'd rather the screen stayed on, turn on Keep the screen on in the menu or in Settings > Screen.

“My agent isn't in the list.”

Awakado follows 21 agents. Claude Code, Codex, Gemini CLI, Cursor, Copilot CLI, Qwen Code, Factory Droid and Antigravity connect through hooks and report exactly what they're doing. OpenCode, Amp, Goose, Crush, Kimi, Auggie, Grok, Continue, OpenHands, Kilo Code, Devin CLI, Cline and Aider are followed from their live activity: they show as working while they, and the builds and tests they start, are busy. Missing one you use? Email and say which.

“I connected an agent but Awakado doesn't see it.”

Some agents need one step of their own before Awakado's hooks run. Awakado shows it in the menu and in the Agents tab until the agent reports in:

• Codex: approve the hooks. In the ChatGPT app's Codex mode, click the hooks button under the message box and choose Allow all. In the Codex CLI, type /hooks and trust them. Then quit the ChatGPT app and open it again, or start a new CLI session: Codex loads hooks when it starts.
• Gemini CLI and Copilot CLI: restart them. They read hooks when they start.
• Qwen Code: type /hooks once, or start a new session.
• Factory Droid: type /hooks to review the change, then start a new session.
• Claude Code and Cursor: nothing to do. They pick the hooks up by themselves.

Awakado checks each step for you and ticks it off, so you can see what's left. Installed a new agent later? Open Awakado > Agents and click Connect.

“Gemini shows as Closed, but it's open.”

Awakado supports Gemini CLI, the coding agent that runs in Terminal. The Gemini chat app doesn't report what it's doing, so Awakado can't see it.

“It stayed awake a few minutes after the agent finished.”

That's the cool-down: after the last agent finishes, Awakado keeps the Mac up briefly (5 minutes by default) so a follow-up prompt doesn't land on a sleeping Mac. Change or turn it off in Settings, under “After the last agent finishes”.

“My Mac never sleeps, even with Awakado off.”

Another app is keeping it awake. Awakado names it in the menu and on Home ("Your Mac won't sleep on its own"). A common one is the Claude app: turn off Keep computer awake in Claude's settings and let Awakado decide instead.

“Lid-closed mode asks for approval.”

macOS always sleeps when the lid closes. Keeping it awake needs a small helper with system rights, and macOS asks you to switch it on once: in System Settings > General > Login Items & Extensions, scroll down to Allow in the Background and turn on Awakado. That page also lists login items, but this doesn't make Awakado open at login. Awakado brings you back to its Lid closed page as soon as you turn it on. If you move or reinstall the app, macOS can ask again: open Lid closed and choose Set up.

“My external display stays on when I close the lid.”

With a display connected, closing the lid hands everything over to that display, so macOS keeps it on. With Pro, Awakado can turn it off for you: in Awakado › Lid closed, turn on Turn external displays off. A few seconds after the lid closes, the display goes dark while your agents keep running, and it comes straight back on when you open the lid (Awakado 1.0.9 or later). It stays on while you're using its keyboard or mouse.

Without Pro, or in the App Store version, you can still turn the display off without stopping anything:

• Put the displays to sleep now: press Control-Shift-Power (the Touch ID button) on your keyboard, or set a Hot Corner to Put Display to Sleep in System Settings > Desktop & Dock > Hot Corners, then move the pointer into that corner.
• Or just leave it: the display turns off by itself after the time in System Settings > Lock Screen > Turn display off when inactive, as long as Keep the screen on is off in Awakado.

Moving the mouse or pressing a key brings the display back. Some displays, like Apple's Studio Display, have no power button, so one of these is the way to turn them off.

“I can't see Awakado in the menu bar.”

On a MacBook with a full menu bar, icons can hide behind the camera notch. Quit another menu-bar app, or hold ⌘ and drag icons to make room. Opening Awakado from Applications or Spotlight always brings up its window.

“The Mac went to sleep in the middle of a run.”

Open Awakado and look at Activity: every sleep has a reason. Most often it's the battery floor or the temperature limit, which you can change in Settings. The Activity log shows them as Safety stop.

Licences

A Pro licence works on up to 3 Macs. To move it, open License on the old Mac and choose Deactivate this Mac, then activate on the new one. Your key is in your receipt email from Polar, and Polar's customer portal, linked from that email, shows it again.

Refunds

Pro comes with a 14-day refund, no questions asked. Email within 14 days of buying and it's done. Pro is sold through Polar, so the refund goes back to how you paid. If something's wrong with your purchase after that, email anyway and I'll sort it out.

Found a bug?

A report is most useful with the version from Settings, and the log from Activity > Export. The log only holds what Awakado did and why, with battery and lid state.