Installation

Global install is recommended for teams that run commands frequently across multiple repositories. Use npx if you prefer zero-maintenance upgrades or are doing a one-off setup.

Prerequisites

Node.js 18+ installed.
Git repository initialized in your project.
Network access for package fetch on first run.

Option 1: Install globally

Install CLI globally

Initialize after global install

Recommended for repeated daily usage across multiple repositories.

Option 2: Run without global install

Run init

Useful for one-off setups or when you want the newest CLI without managing global upgrades.

Verify setup

After the wizard completes, verify that harness files were generated and no baseline drift is detected.

Check harness status

Expected artifacts after init

harness.json (tracked harness state).
CLAUDE.md and AGENTS.md (baseline guidance).
Bundle-specific artifacts (rules, skills, hooks, MCP config) based on your selection.

After installation

Commit the baseline generated by init.
Add one high-value bundle (for example tdd).
Run status again with either npx or your global install and commit the incremental diff.

If something fails, check Troubleshooting for quick symptom-to-fix guidance.