Code Mower CLI is v1.x; CodeMower.com v1.1 follows an independent release line.
Install Code Mower CLI v1.x
A small, safe path for trying Code Mower CLI v1.x in a real repository. CodeMower.com v1.1 is the independently versioned hosted product.
1. Install Code Mower CLI v1.x
python3.12 --version pipx install --python python3.12 code-mower==1.3.0 code-mower --version
2. Generate local setup
code-mower init --easy code-mower init --easy --apply --output-dir .code-mower.generated
3. Run doctor
code-mower doctor --supervised-pilot --repo OWNER/REPO
--supervised-pilot is the v1.x posture for this repository. --preflight remains the compatibility preset. Fix failures first. Treat warnings as setup guidance, especially for private repositories and paid Actions minutes.
4. Generate a starter value report
If you want to prove the whole first-user path before touching a real repository, run the package-install rehearsal. It installs Code Mower into a clean virtual environment, creates a toy Git repo, runs easy-mode setup, runs doctor, generates a value report, and proves cloud upload/dogfood paths stay dry-run.
code-mower migration package-install-rehearsal \ --package-spec code-mower==1.3.0 \ --python "$(command -v python3.12)" \ --json
The rehearsal leaves inspectable artifacts: calibration evidence, reviewer metrics, lane policy, value report, cloud export bundle, upload dry run, and CodeMower.com dogfood dry run.
For a real pilot repository, generate the starter value report:
code-mower calibration value-report .code-mower.generated/calibration-corpus.json \ --output .code-mower/reviewer-value-report.md
Replace the starter corpus with known-clean and known-blocked PRs before promoting any lane to a merge gate.
5. Optional cloud sharing
Sign in, create or join a team, issue a team token, then store it with the local CLI. Upload remains dry-run first and metadata-only by default. CodeMower.com shows private team signal, and Lane Intelligence derives recommendations only from the selected team and repository; it does not compare customers or teams. Team metadata export is available to team members, and uploaded metadata deletion is available to team owners/admins.
code-mower cloud setup --token-stdin \ --team-id YOUR_TEAM_SLUG \ --install-id your-laptop \ --out ~/.config/code-mower/tokens/your-laptop.env source ~/.config/code-mower/tokens/your-laptop.env code-mower cloud dogfood --json code-mower cloud dogfood --yes --json
Use the dry run to inspect the exact metadata shape first. The confirmed dogfood command is what makes the dashboard useful over time: uploads, repo rollups, provider/lens signal, cost, latency, and repository-specific Lane Intelligence recommendations with visible confidence and sample sizes.
Sign in to CodeMower.com or inspect what data can upload.
Recommended first posture
- Use one low-risk repository first.
- Keep reviewer lanes manual.
- Do not add recurring schedules.
- Do not put hosted reviewers into branch protection yet.
- Promote lanes only after local calibration data supports it.
Public setup docs live in docs/first-user-install-rehearsal.md. The shorter walkthrough is docs/try-in-10-minutes.md.