On This Page

hs Commands

Everyday

Command	What it does
hs	Where you are and what to do next.
hs claim	Take the task: bind your key, clone the source at the pinned commit, write the submission skeleton.
hs arm-a	Run Arm A. Always first.
hs arm-b	Run Arm B. Refuses until Arm A has run.
hs submit --push --pr	Validate and push what is done so far; opens the pull request the first time. Run after every step. --dry-run shows what would happen.
hs diff arm-a\|arm-b	What the agent changed. Works mid-session. --full prints the whole patch.
hs open arm-a\|arm-b	Show the workspace in your editor.
hs issue arm-a\|arm-b	Record a behavioral issue while the arm runs; the form shows it pre-filled.

hs
hs claim
hs arm-a
hs issue arm-a
hs submit --push --pr
hs arm-b
hs diff arm-a --full
hs open arm-b
hs submit --push --pr --dry-run
hs submit --push --pr

When something goes wrong

Command	What it does
hs status	Key, arms, and progress.
hs doctor	Check Docker, git, the registry, and local state.
hs annotate	Reopen the grading form.
hs collect A\|B	Re-collect an export into the submission.
hs validate	Run the CI check on its own. submit does this for you.
hs finish	Release the key without submitting (only if you abandon the task).

hs status
hs doctor
hs annotate
hs collect A
hs validate
hs finish   # only if you abandon the task

Managing the tool

Command	What it does
hs update	Install the latest release. --check reports only. --from <file> uses a file you downloaded.
hs install	Copy a downloaded binary onto your PATH (run from the downloaded file).
hs uninstall	Remove the tool. --purge also deletes ~/.hs.
hs --version	Print the version.

hs update --check
hs update
./claude-harness-4.0.2-darwin-arm64 install
hs uninstall
hs --version

Flags and variables

Flag or variable	Applies to	What it does
--task <id>	any	Pick a task when the repo has more than one.
--reason "..."	arm-a, arm-b	Why an arm is being rerun; asked for if omitted.
--full	diff	Print the whole patch.
--dry-run	submit	Show what would happen without making changes.
--no-open	any	Do not open an editor or browser.
--verbose	any	Show Docker build and tool output.
--yes	any	Take the default on every confirmation.

Do not set HS_* environment variables. The tool's configuration is pinned.