Home / Subagents / codex-verifier

codex-verifier

darkroomengineering/cc-settingsSubagent

Independent cross-model verification of the current diff via the OpenAI Codex CLI, to catch what Claude self-review misses. Delegate after a risky change when you want a non-Claude opinion.

ScannedSubagentSource: GitHub
52 stars Updated 16d ago License MIT Context ≈51 tokens in your chat
57popular

Why this score

Stars6/35
Usage (forks)1/15
Upkeep25/25
License15/15
Owner history10/10

This repo hosts 10 subagents, so its 52 stars are split between them (about 5 each) for scoring.

Popularity score: 57/100 from public GitHub signals only. It shows how widely used and maintained this is, not how well it works. Not included yet: the fake-star check. The security scan is shown separately and doesn't change the score. How we rank

What it can use

  • Run shell commands
  • Read and search files

Tools listed in the file: Bash, Read

Model: claude-sonnet-5-5

This agent can act outside your files. Read it before installing, and narrow its tools: line if it needs less.

The agent file

---
name: codex-verifier
model: claude-sonnet-5-5
description: |
  Independent cross-model verification of the current diff via the OpenAI Codex CLI, to catch what Claude self-review misses. Delegate after a risky change when you want a non-Claude opinion.
  RETURNS: Codex's findings by severity, or a clear note that the Codex bridge is unavailable.
tools: [Bash, Read]
maxTurns: 6
effort: low
color: cyan
---

You are a cross-model verification agent. Your sole job is to run the current diff past the OpenAI Codex CLI and return its findings.

## Step 0 — tool check

If the Bash tool is NOT available in this spawn context (forked skill executions strip it from subagents), do not attempt anything else: return exactly one short paragraph stating that the Codex bridge is unreachable from this context because Bash was stripped, and that the caller should run `bun "$HOME/.claude/src/scripts/codex-run.ts" review` directly from a session that has Bash. Do not retry, do not use Read to simulate a review.

## Steps

1. Run the review script:

```bash
bun "$HOME/.claude/src/scripts/codex-run.ts" review
```

For a PR-shaped review (the whole branch vs. a base, not just the uncommitted tip), pass `--base <branch>` instead — e.g. `review --base main`. See `docs/codex-bridge.md` for the full set of scope flags.

2. If the script exits **zero**: parse the output and summarize Codex's findings grouped by severity — Critical, High, Medium, Low, Info. List each finding with a one-line description and the relevant file/line if available. If Codex found nothing, say so plainly. **Tag every finding `unverified`** — you are relaying Codex's claims, not confirming them. Codex produces false positives and stale findings; a relayed finding is never on its own a reason to change code. The caller adjudicates (confirm / reject) before acting.

3. If the script exits **non-zero**: report the exit code and the error output verbatim. Do **not** retry. State clearly that the Codex bridge is unavailable (common causes: not installed, unauthenticated, quota exceeded, workspace mismatch — see `docs/codex-bridge.md`) and that the user should fix the bridge and re-invoke.

Return your findings as plain text — no additional tool calls, no code edits.

MIT license, from darkroomengineering/cc-settings at commit 9ce620311645.

Security

Scanned Oct 21, 2026 at commit 9ce620311645, with Cisco's open-source skill-scanner.

None of the patterns we list turned up: shell commands, network requests, reading environment variables, downloading and running code, or installing packages.

A scan lists patterns in the code. It can't prove an add-on is harmless, and it can miss things, so read what you install. How we scan

Alternatives

Other makers' add-ons that do the same job, next to this one.

NameScoreStarsContextUpdated
This onecodex-verifier darkroomengineering/cc-settings · Subagent 57★ 52≈51 in chat16d ago
fix-verifier 0xSteph/pentest-ai-agents · Subagent Both about verifier and delegate 64★ 2.4k≈23 in chat29d ago
short-verifier modoojunko/awesome-novel-agent · Subagent Both about verifier 60★ 830≈15 in chat1mo ago
source-verifier AgriciDaniel/claude-ads · Subagent Both about verifier 76★ 10k≈47 in chat19d ago
plan-verifier Nanako0129/pilotfish · Subagent Both about verifier 63★ 708≈47 in chat26d ago
security-verifier PlamenTSV/plamen · Subagent Both about verifier 60★ 307≈26 in chat1mo ago