init
mnmx init [--config PATH]Create a starter config in a Git project with a commit. Choose an unused config path. The starter keeps its signing keys and audit repository in the common Git directory.
mnmx reads goals and submits changes to a project engine. mnmx-harness builds from a goal bundle and runs the checks you supply.
The starter runs npm test in a clean checkout of HEAD. Commit the test script and any changes you want it to check.
mnmx init
mnmx read demo
mnmx check demo
The default config, ./mnmx.config.mjs, runs as JavaScript. Load only a config you trust.
Export an adapter with an engine, or a factory that takes the mnmx API and returns the adapter. The factory can be async. For check and submit, supply adapter.submission(goal) to build the request.
Results from read, check, and submit are JSON. Success exits 0. A usage, configuration, or execution error exits 2.
initmnmx init [--config PATH]Create a starter config in a Git project with a commit. Choose an unused config path. The starter keeps its signing keys and audit repository in the common Git directory.
readmnmx read GOAL [--config PATH]Show the goal, its holds, and its latest record without preparing a submission.
checkmnmx check GOAL [--config PATH]Preview the decision without landing the change. A verdict of fail or unknown exits 1.
submitmnmx submit GOAL [--config PATH]Prepare fresh evidence and attempt to land the change, even if you already ran check. A rejection exits 1.
setupmnmx setup [DIRECTORY] [--dry-run] [--model MODEL] [--codex PATH]Create or update AGENTS.md using your authenticated Codex CLI. DIRECTORY defaults to the current directory. --dry-run still calls the model and prints the proposed text. --model defaults to gpt-6.1-sol. --codex selects the executable.
pilot initmnmx pilot init STATECreate the CI recorder’s audit repository and keys in a new directory. Readers need the repository and trusted public.json. Keep private.json on the recorder.
pilot recordmnmx pilot record STATE LOCAL_REPO COMMIT RUN pass|fail|unknownRecord the supplied CI verdict for the full SHA-1 commit ID. Reuse RUN when retrying the same observation. The command exits 0 once it records the verdict, even when CI failed.
pilot replaymnmx pilot replay AUDIT.git PUBLIC.json GOAL COMMIT RUNVerify the saved evidence and reproduce the decision using public keys. GOAL is pilot.ci for CI receipts or demo for the starter. A verified rejection exits 0.
--helpmnmx --helpAlso available as -h or by running mnmx without arguments.
--versionmnmx --versionPrint the installed engine package version. The short form is -v.
Set the goal bundle and checks in mnmx-harness.json. To continue a saved run, use resume with its output directory.
mnmx-harness run mnmx-harness.json --output runs/first
mnmx-harness status runs/first
mnmx-harness report runs/first
Codex, Pi, and Claude Code start fresh sessions. In a command adapter, {request} expands to the request file path.
For run, resume, and report, status pass exits 0 and evidence-incomplete exits 2. Other reported outcomes exit 1. Configuration and execution errors exit 2.
runmnmx-harness run CONFIG.json --output RUN_DIRECTORYChoose a new output directory for the frozen goals and checks. The harness saves each candidate there with its plan and review evidence.
resumemnmx-harness resume RUN_DIRECTORYContinue from the last completed stage using the original inputs. Logs from interrupted attempts stay in the run directory.
statusmnmx-harness status RUN_DIRECTORYShow the run status and attached diagnostics. Reading a failed run’s status still exits 0.
reportmnmx-harness report RUN_DIRECTORYShow each attempt’s verdict and which cases it fixed or broke compared with the previous attempt.
comparemnmx-harness compare LEFT_RUN RIGHT_RUN --output NEW_DIRECTORYRerun reviewer probes on the original and both final candidates. Both runs must be finished (pass or exhausted) and pin identical originals, goal bundles, and checks. Use a new output directory outside the runs and their inputs.
attach-diagnosticsmnmx-harness attach-diagnostics RUN_DIRECTORY SUITE TARGET_SUMMARY.jsonAttach new case results to the saved attempt whose number and file hashes match the summary. The original verdict stays on record.
scope-exportmnmx-harness scope-export RUN_DIRECTORY --output NEW_LEDGER.jsonExport the expectations that count toward acceptance. The run must have scopeLedger enabled.
scope-revisemnmx-harness scope-revise LEDGER.json GOALS_DIRECTORY REVISION.json --output NEW_LEDGER.jsonApply the reviewed changes to the ledger for this goal bundle. Use the output ledger in a new run.
--helpmnmx-harness --helpAlso available as -h or by running mnmx-harness without arguments.