Early adopter setup
A small, safe path for trying Code Mower in a real repository without enabling automatic paid reviewer lanes.
1. Install Code Mower
python3.12 --version pipx install --python python3.12 "git+https://github.com/codemower-ai/code-mower.git@v0.5.0-alpha.8" 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 --preflight --json
--v05 is the equivalent versioned preset for scripts. 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 "git+https://github.com/codemower-ai/code-mower.git@v0.5.0-alpha.8" \ --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 today; cross-team cohort benchmarks are still launch-readiness work. 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 recommendations.
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.