CLI command reference

Shipmoor Team
August 28, 2026
3 min read

One universal Shipmoor 0.10.0 binary serves Free and Pro. Every installation must be authorized to an account before product commands execute.

Product commands

Command familyFreeProGuide
shipmoor scanUnlimitedUnlimitedScanning your code
shipmoor claim-check5 invocations/monthUnlimitedClaim Check CLI
shipmoor review5 invocations/monthUnlimitedCode Review CLI
shipmoor test-evidence5 invocations/monthUnlimitedTest Evidence CLI
shipmoor blast5 invocations/monthUnlimitedBlast Radius CLI
shipmoor harnessUnlimitedUnlimitedAgent Harness
shipmoor skillsUnlimitedUnlimitedAgent Skills

shipmoor rules and shipmoor explain are part of the unlimited Scan workflow. Use each command’s dedicated reference for its verified flags and subcommands; there is no shipmoor verify umbrella command.

Authorization and usage

CommandPurpose
shipmoor loginStart device authorization directly
shipmoor logoutRemove the local device session
shipmoor auth statusShow account, device, and effective plan
shipmoor usageShow all four command allowances and renewal time
shipmoor auth token create --name <name> --scope scanCreate a Scan-only machine token for self-managed CI

An unauthorized interactive product command starts device authorization and resumes after approval. Non-interactive environments fail with SHIPMOOR_TOKEN guidance rather than waiting for a browser.

Help, version, login, logout, and doctor are available before authorization. Setup-only and non-execution subcommands documented by each command do not consume a Free allowance.

Allowance admission

A valid Free metered invocation consumes one unit after argument and configuration validation but before engine, model, runner, evidence collection, or output work. Once admitted, it counts even if the result is blocked, inconclusive, canceled, or failed. A rerun consumes another unit.

User and agent invocations share the same counters. Internal Review or Test Evidence work composed beneath one admitted Claim Check does not consume another bucket. Authentication and allowance messages go to stderr for machine-output commands.

Environment variables

VariablePurpose
SHIPMOOR_TOKENScan-scoped self-managed CI authorization; environment only
SHIPMOOR_VERSIONPin the universal installer, for example 0.10.0
SHIPMOOR_CHANNELSelect a published install channel
SHIPMOOR_INSTALL_DIRSet a custom install location
NO_COLORSuppress color output

Current self-managed CI supports Scan only. SHIPMOOR_TOKEN does not authorize Claim Check, Review, Test Evidence, or Blast Radius in CI.

Last updated on August 28, 2026

Was this article helpful?

Your response is saved on this device.