Moonlight

Moonlight is a Rust and React behavior comparer plus project-check evaluator for validating new implementations against known-good baselines.

Install

Install the Rust CLI:

cargo install moonlight-cli --locked
moonlight run --primary 'printf "{\"value\":42}\n"' --candidate 'printf "{\"value\":43}\n"'

Run it through npm:

npx @moritzbrantner/moonlight run \
  --primary 'printf "{\"value\":42}\n"' \
  --candidate 'printf "{\"value\":43}\n"'

Run it through Bun:

bunx @moritzbrantner/moonlight run \
  --primary 'printf "{\"value\":42}\n"' \
  --candidate 'printf "{\"value\":43}\n"'

Evaluate a coding-agent patch against an existing project:

git diff --binary main > agent.patch
moonlight eval run --project moonlight.eval.toml --candidate-patch agent.patch --format markdown

Agent Workflow

For coding-agent goals, create an Agent Goal issue and follow AGENTS.md. Before handoff, run:

bun run agent:check

Moonlight can also evaluate an agent branch or patch against the baseline:

bun run agent:eval -- --candidate-ref <branch-or-sha>

The GitHub Pages site explains the repository layout and shows the latest HTTP and CLI benchmark reports:

https://moritzbrantner.github.io/moonlight/?page=overview

For detailed local usage, see docs/moonlight/README.md.

A local self-dogfood regression harness compares the published CLI against the current source build; see tests/selfdogfood/README.md.