/ask-for-review

Automated code review between your Claude Code session and an independent reviewer session. Use Claude or Codex as the reviewer.

How it works

Implementor finishes work

You invoke /ask-for-review or /ask-for-review codex in your Claude Code session.

Context is captured

Intent, collected context, and all changes are written to a review file with file:line references.

Reviewer launches in a new terminal

A fresh reviewer session opens in a new terminal — Claude by default, or Codex if you pass the flag. Not a subagent.

They talk through a shared file

Turn-based protocol via the filesystem. Reviewer writes findings, implementor addresses them, reviewer verifies fixes.

Review completes

When the reviewer is satisfied: Review completed, no more findings.

Why not a subagent?

Subagents get a constrained context and tool subset. They don't perform at the same level as a full session. This tool launches a real, independent Claude Code session with the full model, full tools, and full context window — the same quality you get when you talk to Claude directly.

Install

Quick setup

  1. Clone the repo: 
    git clone https://github.com/suleymanozkeskin/claude-ask-for-review.git
  2. Run the installer: 
    cd claude-ask-for-review && bash install.sh
  3. Add to your ~/.claude/settings.json under permissions.allow:

These let the review loop run without permission prompts:

// ~/.claude/settings.json → permissions.allow
"Bash(bash ~/.claude/review-protocol/init-review.sh)",
"Bash(bash ~/.claude/review-protocol/wait-turn.sh:*)",
"Bash(bash ~/.claude/review-protocol/set-turn.sh:*)",
"Bash(bash ~/.claude/review-protocol/launch-reviewer.sh:*)",
"Read(~/.claude/review-protocol/**)",
"Write(ask-for-review/**)",
"Edit(ask-for-review/**)"

Usage

# After making changes in your Claude Code session:
/ask-for-review

/ask-for-review codex

# That's it. The implementor handles the rest automatically:
# → writes context to ask-for-review/{date}/{id}/review.md
# → opens reviewer in a new Terminal.app window
# → waits for findings, addresses them, repeats
# → summarizes what changed when the review is done

/ask-for-review codex requires the codex CLI to be installed and available on your PATH.

Add ask-for-review/ to your project's .gitignore.