Skip to content

docs: describe Harness² CLI; status shows whether a run is going - #18

Merged
3ae3ae merged 2 commits into
general-clifrom
wp/docs2
Oct 19, 2026
Merged

3ae3ae merged 2 commits into
general-clifrom
wp/docs2

Conversation

@3ae3ae

@3ae3ae 3ae3ae commented Oct 19, 2026

Copy link
Copy Markdown
Owner

Summary

  • README presents the fork as Harness² CLI, the general-purpose version of Harness²:
    • a comparison table with google-research/harness2
    • the run → diff → (eval) → apply flow around one final harness
    • subscriptions as the default way to reach models
    • a section on driving it from an AI agent (--json, --detach, stop, guide)
    • a CI badge and the new install URL
  • docs/configuration.md documents claude-login / chatgpt-login, what is and is not kept out of runs, and usage limits. The provider × CLI table gains the two login types.
  • docs/cli.md covers stop, eval, guide, runs rm, run --detach, JSON errors, the final-harness step of run, and the new files in a run directory.
  • docs/how-it-works.md gets "One harness for the project", which explains what the CLI adds to the paper's method.
  • New CHANGELOG.md (Keep a Changelog); CONTRIBUTING and the plugin README are updated for the new name.
  • harness2 status shows whether the run's process is alive (and its pid), and says when a run stopped without finishing.

Test plan

  • 153 core tests pass
  • ruff

🤖 Generated with Claude Code

3ae3ae and others added 2 commits October 19, 2026 21:58
The README now presents the fork as Harness² CLI: what it adds to the
original release (a comparison table), the run -> diff -> eval -> apply
flow around one final harness, subscriptions as the default way to
reach models, and how AI agents drive it (--json, --detach, stop,
guide). The configuration guide documents claude-login and
chatgpt-login, what is and is not isolated, and usage limits; the
command reference covers stop, eval, guide, runs rm, --detach, JSON
errors and the new run files; How it works explains the final harness
step that the CLI adds to the paper's method. Adds a changelog.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
`harness2 status` (and its --json) now reports whether the run's
process is alive and its pid, and says when a run stopped without
finishing, for example after being killed, so the user knows to resume
it.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
@3ae3ae
3ae3ae merged commit 0cae0f7 into general-cli Oct 19, 2026
@3ae3ae
3ae3ae deleted the wp/docs2 branch October 19, 2026 13:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant