Reference
The Commitscale CLI.
Commands, options and examples from the CLI you install.
CLI 0.2.11
Commands
These commands are included by Free or Pro. Each command's help explains its sign-in and permission requirements.
- CLI cscale auth
Log in, log out, and connect Git - CLI cscale auth login
Log in: approve in your browser, signed in any way the server offers; or from a link sent to your email; or with a token on standard input. Open the emailed link and type the terminal's code. Email links last 15 minutes. The success line includes your email when available - CLI cscale auth logout
Revoke this computer's token - CLI cscale auth revoke
Revoke one of your CLI logins or browser sessions, by its ID from `cscale auth tokens` - CLI cscale auth setup-git
Let Git use your Commitscale login when it talks to the server - CLI cscale auth status
Show the saved login - CLI cscale auth tokens
List your CLI logins and browser sessions, to revoke any you no longer use or trust - CLI cscale billing
Open your Billing page, or show your plan and seats as JSON - CLI cscale init
Sign in, install local integration, add a policy if needed and start a background check - CLI cscale key
Create, list, rename and revoke your check-only keys using your personal sign-in - CLI cscale key create
Create a check-only key: save it privately, or export it once with --print. Requires your passkey when the layer is on - CLI cscale key list
List your check-only keys in a table using your personal sign-in. Use --json for scripts - CLI cscale key rename
Rename one of your check-only keys - CLI cscale key revoke
Revoke a key immediately, using your personal sign-in - CLI cscale mcp
Serve Commitscale's commands as tools for coding agents, over the Model Context Protocol on standard input and output. For Claude Code: claude mcp add commitscale -- cscale mcp - CLI cscale org
Organizations: namespaces that people share, with owners and members - CLI cscale org create
Create an organization. You become its first owner - CLI cscale org list
List the organizations you belong to - CLI cscale org member
Add, remove, and list an organization's members - CLI cscale org member add
Invite a person by their handle, or change a member's role. They join when they accept the invite - CLI cscale org member list
List the members and their roles - CLI cscale org member remove
Remove a person, or leave with your own handle. They lose access to the organization at once, and so do their agents - CLI cscale org show
Show an organization's effective plan, members, teams, and settings - CLI cscale record
The record each repository carries in Git, at refs/commitscale/record - CLI cscale record verify
Check the record in a clone: every event's hash, signature, and link, every envelope's signature and checksum, and every checkpoint of the log; and in the record's history, that it is one line of commits, and that no checkpoint, and no event a checkpoint covers, was changed or removed. The clone remembers the commit it verified at each ref, and the next check there fails if the record no longer holds it, names another server, or no longer lists a key it did. Check each server's record at a ref of its own. Fetch it first: git fetch origin refs/commitscale/record:refs/commitscale/record - CLI cscale server
Show what the server supports: its version and the options `git push -o` takes there. Check before relying on a push option - CLI cscale signup
Create an account and save a check-only key after one email click - CLI cscale skill
The skill that teaches agents to work on Commitscale: install it in a repository for Claude Code and Codex, or print it - CLI cscale skill install
Install the skill in this repository, for Claude Code or Codex: how to work here, filled in with the repository and the agent, and a hook that starts each session with the agent's state - CLI cscale skill show
Print the skill, filled in, to hand to an agent another way - CLI cscale support
Reach support. With no message, show the email address and how to send one - CLI cscale tests
Check whether tests protect a committed change, on this machine - CLI cscale tests accept
Accept a finding from a saved check without rerunning it. Finds the comparison by ID, or takes --base-commit. Uses the agent by default, or your passkey if passkey confirmation is enabled. Use --json for the record as JSON - CLI cscale tests cache
Show or clear the local check's private copies - CLI 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 cscale tests consent
Read training consent, withdraw it, or opt in with your personal sign-in - CLI cscale tests status
Show the latest background local check, including whether it is incomplete - CLI cscale tests usage
Show this month's model checks, the cap and its UTC reset time - CLI cscale usage
What a namespace used, day by day: Git and API traffic, Git's time, and what it stores. For its owners - CLI cscale web
Open Commitscale in your browser, already signed in - CLI cscale whoami
Show the sign-in and account used for test checks, with the owner's email when available
Options
--helpPrint help (see a summary with '-h')
--jsonPrint JSON, for agents and scripts
Default:
false--no-browserNever open a browser: print the page to open instead. Pages that confirm with your passkey,
auth login, andwebopen oneDefault:
falseEnvironment:
CSCALE_NO_BROWSER--server <SERVER>The Commitscale server, such as https://commitscale.com
Environment:
CSCALE_SERVER--versionPrint version
Examples
Show the current account as JSON.
cscale whoami --jsonSign in by opening the printed page on another device.
cscale --server https://commitscale.com --no-browser auth loginShow the installed CLI version.
cscale --versionRead the local test check help.
cscale help tests check