The two distributions
For install steps and the full matrix, see ChatGPT and Codex Plugin.
What it looks like
A clean email, checked before it sends (ChatGPT). The assistant had rewritten a flagged draft as neutral market commentary. The user said “check with zerodrift before sending”. ChatGPT ran a validation and a pre-send check on the final email, and both returned “ZeroDrift: Passed — no issues found”, with 0 policy violations and a job ID for each. It then started the Gmail send.

Hooks version
Applies to the hooks version only. Setup: run/hooks in Codex and trust the ZeroDrift hooks. Codex asks again when an update changes them. Until you trust the hooks, Gmail actions are not checked before they run.
What happens:
- Covered actions. Gmail send, draft, draft update and forward in Codex are checked before the action runs.
- Flagged. A do-not-send finding shows as
Blockedand the action is stopped. This flow was tested on the hooks version. - Passed or Warned. The action goes through.
- Plain text. The body of a Gmail action must be plain text, and the hooks require a
subjectfield. If a body is multipart or base64, the hook asks Codex to resend it as plain text before the check runs. - Slack and other tools. Not checked automatically. On request only.
OpenAI directory plugin (no hooks)
Applies to the directory distribution only (package version 0.1.9). This package has no hooks. Only the hooks version includes hooks. This package includes a skill that tells the assistant to validate the final email, subject and body, before it sends. Nothing at runtime enforces the block. What the skill tells the assistant to do:- Flagged. Withhold the send and let you decide. In testing, the skill withheld a flagged send in both ChatGPT chat and ChatGPT Work.
- Passed or Warned. Proceed, and show any warnings with the send.
- Cannot be checked. Withhold the send and report that it was not checked. This was tested for the case where the service is unreachable.
ZeroDriftAI/zerodrift-codex-plugin.
Ordinary emails without a check request
The plugin does not call ZeroDrift when you ask for an ordinary note and do not request a check. In testing, asking for a thank-you note did not call ZeroDrift. A check runs when you ask for one, or when the assistant is about to send an email and the skill directs a check first.Limits
- A guardrail, not a security boundary. An assistant with other tools can send content some other way.
- Attachments. ZeroDrift validates text, not files directly. To check an attachment, ask ChatGPT to extract and format its contents for validation. Only the text ChatGPT sends is checked.
- Original message of a forward, and saved drafts sent as-is. See the matrix on ChatGPT and Codex Plugin for how each distribution handles them.
- ZeroDrift does not rewrite. “Revise” means the assistant revises. ZeroDrift checks the new version only when you ask.

