Skip to content

Factory Droid security on your Mac

Excellent for Mac is free to download. With Pro, it checks each action Factory Droid takes in sessions started after that. It doesn't read Factory Droid's logs yet.

Works with Factory Droid

Trademarks belong to their owners; no endorsement implied.

What Excellent sees

Excellent doesn't read Factory Droid's logs yet: their format isn't documented. With Pro's protection on, each action the check blocks or asks about shows up, with Factory Droid's name on it.

Its key finder checks Factory Droid's settings and MCP config for keys.

What it can stop Pro

This needs Excellent Pro. Free and Pro says what each does.

Turn on protection, and Excellent adds one entry where Factory Droid keeps its hooks: ~/.factory/hooks.json, or its settings.json when your hooks are there. It backs the file up first. Factory Droid runs it before each action.

It blocks your email on its way to a website, an API key typed into a command, deleting a folder you marked never-delete, and switching Excellent off.

It asks you first before a force push to main, skipping git hooks, typing your email into a web form, or writing over a file you marked never-delete.

Two more rules are off until you turn them on: asking before reading keys and .env files, and asking before breaking a rule you wrote in CLAUDE.md or AGENTS.md.

You can stop a Factory Droid session from Excellent's menu. Its actions are refused until you press Continue or End. End stops its process and the commands it was running.

Excellent can also pause a session by itself when it breaks one of four rules: sending your email to a website, deleting or moving a never-delete folder, reading a never-open file, or overwriting history on main. Setup asks about this, with all four ticked.

Tested in Factory Droid 1.12.1 on a Mac: the check Turn On adds ran there, refused what it should, and let a harmless command through.

Your rules

Sharing works between Claude Code and Codex. Factory Droid doesn't get your rules from it.

With Pro and Remind agents of my rules on, the check refuses an action that would break a rule you wrote in CLAUDE.md or AGENTS.md once, and quotes your rule. Reminders are off by default.

The sandbox Pro

Excellent's sandbox covers Claude Code and Codex. Factory Droid gets the live check only.

What isn't covered

  • Excellent doesn't read Factory Droid's logs, so what it did before you turned protection on isn't shown.
  • Factory Droid reads its hooks when a session starts. A session that was running when you turned protection on isn't checked until you restart it.
  • With hooksDisabled or allowManagedHooksOnly set, the check doesn't run, and Excellent shows Factory Droid as not protected, with the reason.
  • Excellent's sandbox doesn't cover Factory Droid, so nothing backs the check up there.
  • The check reads what a command says. An agent set on getting around it sometimes can.
  • A script file run by an interpreter, like python3 cleanup.py, isn't read by the check.

Set it up

  • Get the Mac app. It needs an Apple silicon Mac and macOS 14 or later. Protection needs Pro.
  • With Pro, open it and press Protect My Agents. It lists what it will change first, then adds its check to ~/.factory/hooks.json, or its settings.json when your hooks are there. Turn On in the menu does the same later.
  • Restart any Factory Droid session that was already running.

Install the Mac appTurn on protectionStop or pause an agentThe agents it supports

The other agents

Protect Factory Droid on your Mac

Get the Mac app