Skip to content

CODEX_CLAUDE_REVIEW_GUIDE.md

Latest commit

 

History

History
116 lines (78 loc) · 2.87 KB

CODEX_CLAUDE_REVIEW_GUIDE.md

File metadata and controls

116 lines (78 loc) · 2.87 KB

Codex + Claude Reviewer Guide

Run ARIS with:

  • Codex as the main executor
  • Claude Code CLI as the reviewer
  • the local claude-review MCP bridge as the transport layer

This guide is additive to the upstream Codex-native path. It does not replace skills/skills-codex/.

Architecture

  • Base skill set: skills/skills-codex/
  • Reviewer override layer: skills/skills-codex-claude-review/
  • Reviewer bridge: mcp-servers/claude-review/

The install order matters:

  1. install skills/skills-codex/*
  2. install skills/skills-codex-claude-review/*
  3. register claude-review MCP

Install

git clone https://github.com/wanshuiyin/Auto-claude-code-research-in-sleep.git
cd Auto-claude-code-research-in-sleep

mkdir -p ~/.codex/skills
cp -a skills/skills-codex/* ~/.codex/skills/
cp -a skills/skills-codex-claude-review/* ~/.codex/skills/

mkdir -p ~/.codex/mcp-servers/claude-review
cp mcp-servers/claude-review/server.py ~/.codex/mcp-servers/claude-review/server.py
codex mcp add claude-review -- python3 ~/.codex/mcp-servers/claude-review/server.py

If your Claude login depends on a shell helper such as claude-aws, use the wrapper:

cp mcp-servers/claude-review/run_with_claude_aws.sh ~/.codex/mcp-servers/claude-review/run_with_claude_aws.sh
chmod +x ~/.codex/mcp-servers/claude-review/run_with_claude_aws.sh
codex mcp add claude-review -- ~/.codex/mcp-servers/claude-review/run_with_claude_aws.sh

Optional reviewer model override:

codex mcp remove claude-review
codex mcp add claude-review --env CLAUDE_REVIEW_MODEL=claude-opus-4-1 -- python3 ~/.codex/mcp-servers/claude-review/server.py

Verify

  1. Check MCP registration:
codex mcp list
  1. Check Claude CLI login:
claude -p "Reply with exactly READY" --output-format json --tools ""
  1. Start Codex in your project:
codex -C /path/to/your/project

What gets overridden

The overlay only replaces review-heavy skills:

  • research-review
  • novelty-check
  • research-refine
  • auto-review-loop
  • paper-plan
  • paper-figure
  • paper-write
  • auto-paper-improvement-loop

Everything else still comes from the upstream skills/skills-codex/ package.

Async reviewer flow

For long paper or project reviews, use:

  • review_start
  • review_reply_start
  • review_status

Why: in this host path, the review hop is:

Codex -> claude-review MCP -> local Claude CLI -> Claude backend

That extra local CLI hop is what makes long synchronous reviewer calls more likely to hit the observed Codex-hosted MCP timeout.

Project config

No special project config file is required for this path.

  • keep using your existing CLAUDE.md
  • keep your current project layout
  • only switch the installed Codex skill files and MCP registration

Maintenance

Regenerate the overlay package with:

python3 tools/generate_codex_claude_review_overrides.py
⚡