cross-review

cross-review.tlelabs.com · npm

Cross-model review skills for Claude Code and OpenAI Codex CLI: the agent you work with orchestrates, and a second model reviews its plans, code and reasoning. The reviewer is the Codex CLI by default; Claude Code (claude) and Antigravity (agy) can review too. The runner drives each reviewer CLI through its own adapter (scripts/lib/reviewers/).

!A review session in the dashboard: the reviewer's rounds, the agent's replies, the issue ledger

Six skills (Claude Code: /name, Codex: $name):

• loop-plan — write a phased, code-grounded implementation plan for large, multi-feature work
• loop-implement — execute an approved loop plan phase by phase with TDD, checkpoint reviews, and commits
• review-plan — debate implementation plans before coding
• review-impl — review uncommitted changes, unpushed commits, or a branch before commit/push/merge
• review-think — peer reasoning/debate on technical topics
• review-pr — review someone else's PR as a peer (correctness, description, merge readiness); your own PR goes through review-impl

Requirements

• Node.js >= 22 and npm
• Claude Code CLI and/or Codex CLI
• At least one reviewer CLI in PATH, signed in:

Install

npx @tlelabs/cross-review

From GitHub instead: npx github:lploc94/cross-review.

What it does

1. Installs the skills for Claude Code into ~/.claude/skills/ and for Codex into ~/.agents/skills/
2. Installs the shared runtime (runner, MCP server, and its dependencies from the lock file) into ~/.claude/skills/cross-review/
3. Renders each SKILL.md with the shared review protocol and the absolute runner path
4. Registers the cross-review MCP server with Claude Code (user scope) and Codex
5. Swaps directories atomically with rollback on failure; removes the old codex-review pack and this pack's copies in ~/.codex/skills
6. Writes the cross-review command to ~/.local/bin/cross-review (macOS and Linux), a small script that runs the installed runner. A file of that name the installer did not write is left alone. When ~/.local/bin is not on your PATH, the installer says so

Verify

node ~/.claude/skills/cross-review/scripts/review-runner.js version   # 15
claude mcp get cross-review
codex mcp get cross-review

Reinstall / Update

npx @tlelabs/cross-review@latest

Automatic reviews (optional)

npx @tlelabs/cross-review --auto

Usage

• loop-plan writes a loop-plan/v1 plan with review checkpoints into /.cross-review/plans/; it is approved by review-plan or by you.
• loop-implement executes the approved plan, ticks each acceptance criterion it meets (- [x]), and runs review-impl at the plan's checkpoints.
• The review skills use the MCP tools review_begin, review_wait, review_reply, review_end. Without MCP, or in a mode that refuses the tools, they run the same verbs through the CLI: node ~/.claude/skills/cross-review/scripts/review-runner.js begin|wait|reply|end.
• Review sessions and plans live in /.cross-review/, which ignores itself in git. Plans stay out of git too unless you turn on Plans in git (below).

Choosing the reviewer (optional)

Codex reviews unless you choose another reviewer:

• for one review, name it when you ask ("review this with Claude Code"); the skill passes reviewer (codex, claude or agy) to review_begin, and the session keeps it for every round;
• as a default, set "reviewer" in ~/.cross-review/config.json or /.cross-review/config.json, or pick it in the dashboard's Settings.

{
  "reviewer": "claude",
  "reviewers": {
    "codex": { "model": "<codex model>", "effort": "high" },
    "claude": { "model": "opus", "effort": "max", "skills": { "review-pr": { "effort": "high" } } },
    "agy": { "model": "<agy model family>", "effort": "low" }
  }
}

• Codex: the models codex debug models lists; effort as Codex names it.
• Claude Code: the aliases (opus, sonnet, …) or a full model name; effort low, medium, high, xhigh or max.
• Antigravity: agy models lists one model per effort (-low, -high, …). Pick the family and an effort, and the runner passes both to agy (--model --effort ); a model listed without levels takes no effort. A level the family lacks fails before the review starts.

A reviewer never starts a review of its own: the runner marks the reviewer's environment (CROSS_REVIEW_REVIEWER), and a begin inside it fails with NESTED_REVIEW. This matters most when Claude Code reviews, since the cross-review skills are installed for it too.

Choose a model (optional)

Name a model or effort when you ask for a review (or in a plan's review checkpoint). The skill passes it to review_begin; the runner stores it and reuses it for every later round. Without one, the runner applies the dashboard settings (below) for the chosen reviewer, else the reviewer CLI's default model and effort high.

Dashboard

cross-review dashboard                             # the command the installer writes to ~/.local/bin
npx @tlelabs/cross-review dashboard               # without installing, and on Windows

!Sessions: reviews in progress and the history

| Plans: a plan's progress | Settings | | --- | --- | | !A plan's phases, criteria and progress log | !Reviewer, model and effort per level and per skill |

Starts a local web page and opens it in your browser. It lists the review sessions and plans in the folder you start it from and up to 3 levels below. Options: --root