shwrk harness

Install

Bootstrap the harness into any git repository:

curl -sSL https://harness.shwrk.com/install | bash

Pin a specific harness version with ?v=:

curl -sSL "https://harness.shwrk.com/install?v=0.1.0" | bash

What the script does

The installer is deliberately dumb, idempotent, and safe to re-run. It runs set -euo pipefail and:

  1. Detects your OS (informational).
  2. Refuses to run outside a git repository — cd into your repo (or git init) first.
  3. Installs APM if it is missing (the official https://aka.ms/apm-unix installer) and verifies apm --version.
  4. Creates a minimal apm.yml only if one does not already exist (name taken from the repo directory, version 0.1.0).
  5. Adds nshiffer/harness to dependencies only if absent — pinned to your requested ?v=, otherwise tracking latest ("*").
  6. Runs apm install.
  7. Prints the next step.

It never touches any file other than apm.yml. Re-running it is safe.

Next step

Open the repo in Claude Code and run the harness skill. It scaffolds or merges the Makefile, AGENTS.md, the /health handler, git hooks, and .claude/settings.json — non-destructively — after which make check is your gate.

Getting the version list

The published versions are available as JSON:

curl -sSL https://harness.shwrk.com/versions