Skip to content

Installation

Requirements

  • PHP 8.3+ (8.4 and 8.5 are tested in CI).
  • Composer for dependency management.
  • At least one supported reviewer CLI on PATH and authenticated. See Reviewers for setup recipes.

Install

  1. Clone the repository:

    Terminal window
    git clone https://github.com/albertoarena/llm-review-panel.git
    cd llm-review-panel
  2. Install dependencies:

    Terminal window
    composer install
  3. Verify the CLI:

    Terminal window
    bin/llm-review-panel list

    You should see the review and init commands listed.

Scaffold the config

Terminal window
bin/llm-review-panel init

This writes config.json plus the default config/rubric.md and config/synthesis.md into the current directory. It never overwrites an existing file unless you pass --force, and it takes an optional target directory (init path/to/dir).

If you prefer, copy the example by hand instead:

Terminal window
cp config.example.json config.json

Either way, edit config.json to enable the reviewers you have installed. Only the reviewers with "enabled": true will run.

Sanity check with --dry-run

Terminal window
bin/llm-review-panel review path/to/plan.md --dry-run

This resolves every enabled reviewer’s command, checks each binary is on PATH, and exits without spawning anything. Use this before every first run on a new machine.

If any binary is missing, the output shows NOT FOUND on PATH and the exit code is non-zero.