Skip to content
MergeRay/ docs

Search documentation

Local documentation search Tab to navigate · Esc to close

Command line

Review committed revisions with the mergeray CLI.

On this page InstallationCore optionsBefore submitting sourceExit codes

Installation

The package name and executable are both mergeray. Install the current release from npm.

Analysis requires a trusted service endpoint, repository enrollment, authorization to transfer source and your own CLI token from Manage → CLI tokens in the dashboard, supplied through MERGERAY_TOKEN. Do not substitute a GitHub token.

Terminal
npm install --global mergeray
mergeray --version
Plain textRead-only

Core options

The CLI reads Git objects at immutable commits, not uncommitted working-tree edits.

OptionPurpose
--base <revision>Required exact baseline commit or trusted local ref.
--head <revision>Raw Head commit or trusted local ref; defaults to HEAD.
--repository <id>Service-registered repository identity.
--service <https-url>Trusted, authorized service endpoint.
--config <path>Explicit declarative JSON policy.
--jsonValidated findings, source locations and coverage.

Before submitting source

Source counts and frozen revision identifiers are printed before submission. This is informational: there is no confirmation prompt or dry-run mode. Transfer only authorized source to a trusted service.

The default service endpoint is https://source.mergeray.com.

Review source processing

Exit codes

CLI exit codes
0    Complete pass, or help/version
1    Proven gating failure
2    Inconclusive comparison
3    Input, auth, service or protocol failure
130  Cancellation
Plain textRead-only