Skip to content

Excellent finds the rules you wrote for Claude Code and Codex, shows which reach only one of them, shares them on your OK, and can remind an agent of a rule before it breaks it.

On this page

You write rules for your agents in files like CLAUDE.md and AGENTS.md. Claude Code reads one, Codex reads the other. A rule written for one often never reaches the other.

Where Excellent looks

It reads your own instruction files, those in the folders your agents worked in, and those at the top of projects in common folders such as ~/Sites, ~/code and ~/Developer.

See which rules reach only one

The menu lists them under Not told to every agent. With Pro, when you write a new rule that reaches only one, you get a notification: A new rule reaches only Claude Code (or only Codex).

Share them

Press Share… in the menu, on the Rules page, or in Settings under Rules. Excellent shows you exactly what it will write before it writes anything. On your OK, it adds one marked block with the missing rules to the file the other agent reads:

  • for Codex, your own ~/.codex/AGENTS.md, or each repository's AGENTS.md if you choose that in Settings;
  • for Claude Code, your own ~/.claude/CLAUDE.md, or each repository's CLAUDE.md.

It backs up each file first. Take Shared Rules Out… in Settings takes the block back out.

Sharing works between Claude Code and Codex. The other agents the check runs in don't get your rules from it.

Remind agents of your rules

Reminders need Excellent Pro: they run in its live check. See Free and Pro.

With Remind agents of my rules on, Excellent watches for an agent about to break a rule you wrote. It refuses that action once, with your rule in your words. If the agent tries the same thing again, the normal check decides. It reminds an agent of the same rule at most three times a session.

Reminders are off by default, and they need protection on. Turn them on in Settings, or on the Protection page under the written-rules row.

A reminder quotes your rule and names the file it's in. It becomes part of the agent's conversation, which goes to its provider like the rest of it.

Never-delete and never-open

When your rules say a folder must never be deleted, or a file never opened, Excellent's check protects it. A few folders are protected from the start: ~/.ssh, ~/.aws, ~/.gnupg and your keychains, with everything in them, and your home, Documents and Desktop folders themselves. For a check that holds however a command is written, turn your rules into the sandbox.

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