harness

AI project initializer.

Init

Initialize the current project:

npx @sha3/harness@latest init

Run the same command again to re-initialize an existing project. It refreshes the harness-managed files and scripts.

Managed agent files and MCP config are written under .claude/.

Init also runs Biome with --write after refreshing the config so existing supported files are formatted and receive safe fixes. Harness requires Biome 2.x and installs version 2.4.14 when the project does not already declare a compatible version.

Apply unsafe fixes explicitly:

npx @sha3/harness@latest init --unsafe

Preview changes without writing files:

npx @sha3/harness@latest init --dry-run

Check whether the managed files are up to date. The command exits with code 1 when changes are required:

npx @sha3/harness@latest init --check

Scripts

The initializer recreates every package.json script prefixed with harness:. The init script is pinned to the installed harness version:

{
  "harness:init": "npx @sha3/harness@<installed-version> init",
  "harness:open-chrome-canary": "node scripts/open-chrome-canary.mjs",
  "harness:check": "biome check --config-path=biome/biome.json .",
  "harness:spec-check": "node scripts/spec-tree-check.mjs"
}

harness:spec-check validates the project's SPEC.md tree, including required sections, node states, dependency references, and dependency cycles.