Browse documentation
← CLI reference

Command

cscale tests check

Check a committed change using installed tools. Comment-only and docstring-only hunks are left out. The target policy determines what blocks. Manual files wait for approval. A passing check can still have findings to review. Without an account, the check exits 1 and the pre-push hook warns and lets the push through

CLI 0.2.11

cscale tests check [OPTIONS]

Examples

Check the committed change with installed tools under the target policy, leaving out comment-only and docstring-only hunks; review findings even when the check passes. A missing account exits 1.

cscale tests check

Compare the committed change against the trusted target branch; list files nothing in the repository could test as not checked.

cscale tests check --base origin/main

Check only the latest commit, using settings from the trusted target branch.

cscale tests check --base origin/main --head HEAD --base-commit HEAD~1

Request two workers for isolated fixtures without copying the checkout's installed state; CPU and disk checks can reduce this.

cscale tests check --isolated --jobs 2

Use a fixed one-hour invocation limit instead of measured experiment deadlines.

cscale tests check --run-timeout-seconds 3600

Allow up to 30 minutes for the check.

cscale tests check --budget-seconds 1800

Run the check in CI and stream events.

cscale tests check --base origin/main --ci --ndjson

Include test selection and risk details in the terminal report.

cscale tests check --verbose

Recheck a saved finding with installed machine state and show model requests with secrets removed.

cscale tests check --finding 0123456789abcdef --show-requests

Options

--base <BASE>

Trusted target branch; defaults to commitscale.target or origin/HEAD

--base-commit <BASE_COMMIT>

Explicit comparison commit; settings still come from the target

--budget-seconds <BUDGET_SECONDS>

Overall deadline, in seconds. No limit unless set in target settings or here

--ci

Run without prompts using CSCALE_CHECK_KEY; report the CI commit, base and settings edits

Default: false

--finding <FINDING>

Recheck a saved finding with installed machine state. A focused result never authorizes a push

--head <HEAD>

Committed head to check. Uncommitted files are excluded

Default: HEAD

--help

Print help (see a summary with '-h')

--isolated

Use disposable copies and the full test selection, without copying the checkout's installed state

Default: false

--jobs <JOBS>

Request concurrent experiments up to CPUs minus one. Automatic jobs use memory and build parallelism; free disk, shared fixtures and the local copy can reduce concurrency

--json

Print JSON, for agents and scripts

Default: false

--ndjson

Emit sequenced version-1 events and a final result

Default: false

--no-browser

Never open a browser: print the page to open instead. Pages that confirm with your passkey, auth login, and web open one

Default: false

Environment: CSCALE_NO_BROWSER

--run-timeout-seconds <RUN_TIMEOUT_SECONDS>

Optional fixed invocation deadline. By default controls are unlimited; experiments scale from the slowest build plus control test time, with one longer timeout retry

--server <SERVER>

The Commitscale server, such as https://commitscale.com

Environment: CSCALE_SERVER

--show-requests

Display exact scrubbed model requests before sending, without credentials

Default: false

--verbose

Include test selection and risk details in the terminal report

Default: false