explaingit

overflowy/herdr-adversarial-review

Analysis updated 2026-05-18

3Audience · developerComplexity · 4/5LicenseSetup · hard

TLDR

A Claude Code skill that spins up an independent GPT-5.6 Sol reviewer in a sandboxed pane and interrogates its findings.

Mindmap

mindmap
  root((Adversarial Review))
    What it does
      Second AI reviewer
      Interrogates findings
      Confirmed or disputed
    Tech stack
      Claude Code skill
      herdr panes
      CLIProxyAPI proxy
    Use cases
      Pre-merge diff review
      Plan red-teaming
      Sandboxed reviewer
    Audience
      Solo developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Get an independent second-model review of a diff before merging it.

USE CASE 2

Red-team a plan by having a separate AI try to poke holes in it.

USE CASE 3

Run a sandboxed adversarial reviewer that can't touch files outside the project.

USE CASE 4

See every review finding classified as Confirmed, Disputed, or Unverified before acting on it.

What is it built with?

Claude CodeherdrCLIProxyAPIagent-safehouseShell

How does it compare?

overflowy/herdr-adversarial-review000madz000/payload-test-api-route-handler0marildo/imago
Stars333
LanguageTypeScriptPython
Setup difficultyhardeasyeasy
Complexity4/52/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires installing and configuring four separate tools: herdr, CLIProxyAPI, agent-safehouse, and a shell function.

Use, modify, and distribute freely, including for commercial purposes, as long as you keep the copyright notice.

In plain English

This is a Claude Code skill that adds a second, independent AI reviewer to check your code changes before you ship them. Instead of asking the same assistant that wrote the code to also review it, this skill spins up a separate model, GPT-5.6 Sol, running in its own live terminal pane, hands it your diff or plan along with a description of what you were trying to achieve, and waits for it to finish reviewing. Once the second reviewer produces its findings, Claude does not simply repeat them back to you. It interrogates each finding against the actual code, pressing the reviewer on anything that seems disputable, and then reports every finding as Confirmed, Disputed, or Unverified. The author notes that the adversarial reviewer is instructed to look for problems and will sometimes overstate or invent issues, so getting a verdict that nothing holds up is treated as a perfectly valid outcome. Setting this up requires several separate tools working together. Herdr is a terminal pane manager that creates the reviewer's pane and tracks whether it is idle, working, or blocked. CLIProxyAPI is a local proxy that lets the standard Claude command line tool talk to a non-Anthropic model by presenting an Anthropic compatible interface backed by an OpenAI login. Agent-safehouse provides sandboxing on macOS so the reviewer, which runs with reduced permission checks, cannot touch anything outside the project folder. Finally, a small shell function called safecodex ties these pieces together with the right environment variables so that typing one command launches the sandboxed second opinion reviewer. After installing all four pieces, the skill itself can be added through Claude Code's plugin system or by copying its files into your skills folder by hand. From there, you trigger a review either with a slash command or just by asking Claude in plain language to poke holes in your diff or get a second opinion before you ship. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Set up herdr, CLIProxyAPI, agent-safehouse, and safecodex for adversarial review.
Prompt 2
Run /adversarial-review on my current diff and interrogate the findings.
Prompt 3
Explain how this skill sandboxes the GPT-5.6 Sol reviewer with agent-safehouse.
Prompt 4
Walk me through troubleshooting a safecodex command not found error.

Frequently asked questions

What is herdr-adversarial-review?

A Claude Code skill that spins up an independent GPT-5.6 Sol reviewer in a sandboxed pane and interrogates its findings.

What license does herdr-adversarial-review use?

Use, modify, and distribute freely, including for commercial purposes, as long as you keep the copyright notice.

How hard is herdr-adversarial-review to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is herdr-adversarial-review for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.