Skip to content

Fixes for the common problems: the app won't open, no notifications, an agent refused something you wanted, an agent is stuck paused, a check isn't running.

On this page

The app won't open

Excellent needs a Mac with Apple silicon and macOS 14 or later. Intel Macs can't open it. To check, choose About This Mac in the Apple menu.

I don't see Excellent

It also lives in your menu bar, and it has no Dock icon. If your menu bar is full, its icon may be hidden behind others.

No notifications

Notifications come with Excellent Pro: see Free and Pro. Excellent asks for permission when you turn protection on. If you said no, turn them on in System Settings, under Notifications, Excellent.

Excellent sends notifications only while it's running. Open Excellent at login in Settings keeps it running after a restart.

An agent was refused something I wanted

The refusal names the rule. You can:

  • approve it, when Excellent asked first and your agent shows you the question;
  • tell your agent it's fine, when the agent can't ask (Codex, Cursor, Devin and Gemini CLI get a refusal that tells them to ask you);
  • turn that rule off on the Protection page. Each rule is its own switch.

An agent is stuck

It may be paused. Look under Running now on the Overview, and press Continue or End. See Stop or pause an agent.

Some of your safety checks aren't running

A hook in an agent's settings points at a program that's gone, often a Node version you removed. If Excellent can repair it, the finding has a Repair N hooks button. Otherwise, edit the hook in that agent's settings.

Codex commands weren't checked

Commands sent to a Codex shell that was already running aren't checked. The Protection page explains this under Codex shell coverage.

A past session isn't in the scan

Excellent reads the logs of Claude Code, Codex, Grok Build, GitHub Copilot CLI, Gemini CLI and Qwen Code. It doesn't read Cursor's, Factory Droid's or Devin's yet, or older compressed Codex logs. Press Scan Now (⌘R) to scan again.

Something broke after I turned on the sandbox

A tool may write to a folder your rules closed. Turn the sandbox off on the Sandbox page, change the rule, and turn it on again. See The sandbox.

Still stuck

Email help@excellent.so. Say what you did, what you saw, and your macOS version. Don't send logs or keys.

Was this page helpful?

Something wrong or missing in the docs? Email hello@excellent.so.

Start here

  • StartWhat Excellent does
  • StartInstall Excellent for Mac
  • StartYour first scan
  • StartWhat it finds
  • StartFree and Pro