What problem does it solve? Code changes from an AI coding agent often land without independent review, letting bugs and convention violations slip through. revshell inserts a mandatory review gate inside the same session: the host agent implements a change, then drives a REVIEWER as a blocking subprocess that inspects the diff before it lands. ## Core Features & Use Cases - Shared review contract across backends: One identical contract (inlined diff, severity-tagged findings, parseable VERDICT line) works with Codex CLI, a Claude subagent, Qwen Code (local MLX or API), and DeepSeek Coder (local Ollama, findings-only). - Reviewer direct-edit mandate: The reviewer fixes every mechanically fixable finding itself and tags each edit in a REVIEWER EDITS block so the implementer can verify changes with git diff before landing. - Hardened concurrent drivers: Per-invocation IDs, stderr heartbeats, buffered output, and timeout escalation let multiple review rounds run concurrently without lock contention or stalled pipes. - Use Case: After implementing a feature on a temp branch, run the Codex review driver against the merge-base diff; the reviewer corrects issues in the working tree, returns a verdict, and only a 'ready to ship' verdict proceeds to curated commits and a single memory commit. ## Quick Start Ask the agent to review the current uncommitted changes with revshell using the Codex backend against the merge-base of the target branch.
