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

## 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](https://www.excellent.so/docs/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](https://www.excellent.so/docs/stop-and-pause).

## 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](https://www.excellent.so/docs/sandbox).

## Still stuck

Email [help@excellent.so](mailto:help@excellent.so). Say what you did, what you saw, and your macOS version. Don't send
logs or keys.

Source: https://www.excellent.so/docs/troubleshooting
