SECURITY REVIEW / Trail of Bits
TU compiler analyzer
Pins the zeroize-audit per-file compiler analyzer that stops without compile flags, refuses a finding that lacks the evidence it names, and deletes that unit's temporary artifacts.
“A per-file compiler analyzer that stops without compile flags, refuses a finding that lacks its required compiler evidence, and still deletes temporary artifacts.”
01 / THE REASONING
Why this made the selection.
- The agents index has no entry for plugins/zeroize-audit/agents/3-tu-compiler-analyzer.md.
- The file stops when compile flags cannot be extracted, refuses an optimized-away or assembly finding without the evidence it names, and deletes that unit's temporary compiler artifacts even on partial failure.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- plugins/zeroize-audit/agents/3-tu-compiler-analyzer.md
- plugins/zeroize-audit/README.md
- README.md
- LICENSE
Our findings
- If compile-flag extraction exits non-zero, the agent writes an error and stops. The error section also writes empty arrays and exits.
- An optimized-away wipe requires an IR diff. The file says never to emit that finding from source alone.
- Stack retention and register spill require assembly evidence. The file says never to emit either from source or IR alone.
- Assembly, semantic IR, and CFG each run only when their enable flag is true. Those three flags are inputs in the file's parameter table.
- Temporary compiler artifacts for that translation unit are removed even on partial failure. An IR emission failure writes an empty IR array, skips assembly and semantic IR, and can still continue to CFG.
Not established by this review
- The resource was not executed and its tools were not called.
- No translation unit or compile database was supplied.
- The referenced flag-stripping and IR-analysis notes were not opened, and the cleanup was not run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Use the role in your project.
DOCUMENTED COMMAND
/plugin marketplace add trailofbits/skills Copying does not execute this command. It may retrieve a newer version than the reviewed source.
- The README's Claude Code section is that line, then /plugin menu to browse plugins.
- The same README names zeroize-audit as the plugin for missing or compiler-eliminated secret zeroization in C, C++, and Rust. The marketplace command does not install that plugin or this agent by itself.
- The Codex section uses codex plugin marketplace add trailofbits/skills and a placeholder plugin name, so that line is not install.command.
Before you start
- Claude Code or Codex marketplace support
- The orchestrator inputs named in the file, including one translation unit, its compile database, and the three enable flags
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- 3-tu-compiler-analyzer ↗Checked
https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/zeroize-audit/agents/3-tu-compiler-analyzer.md
Supports: stop without flags, evidence refusals, enable-flag skips, and cleanup on partial failure
- zeroize-audit README ↗Checked
https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/zeroize-audit/README.md
Supports: this agent is the per-translation-unit C and C++ compiler pass
- Repository README ↗Checked
https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/README.md
Supports: marketplace install line, Codex compatibility, and the zeroize-audit row
- Repository LICENSE ↗Checked
https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE
Supports: Attribution-ShareAlike 4.0 International