Troubleshooting
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.