gnhf 0.1.5 → 0.1.7

package/README.md

@@ -42,15 +42,22 @@
 gnhf is a [ralph](https://ghuntley.com/ralph/), [autoresearch](https://github.com/karpathy/autoresearch)-style orchestrator that keeps your agents running while you sleep — each iteration makes one small, committed, documented change towards an objective.
 You wake up to a branch full of clean work and a log of everything that happened.
 
-- **Dead simple** — one command starts an autonomous loop that runs until you Ctrl+C
+- **Dead simple** — one command starts an autonomous loop that runs until you Ctrl+C or a configured runtime cap is reached
 - **Long running** — each iteration is committed on success, rolled back on failure, with sensible retries and exponential backoff
-- **Agent-agnostic** — works with Claude Code or Codex out of the box
+- **Agent-agnostic** — works with Claude Code, Codex, Rovo Dev, or OpenCode out of the box
 
 ## Quick Start
 
 ```sh
 $ gnhf "reduce complexity of the codebase without changing functionality"
-# go to sleep
+# have a good sleep
+```
+
+```sh
+$ gnhf "reduce complexity of the codebase without changing functionality" \
+    --max-iterations 10 \
+    --max-tokens 5000000
+# have a good nap
 ```
 
 Run `gnhf` from inside a Git repository with a clean working tree. If you are starting from a plain directory, run `git init` first.
@@ -73,6 +80,10 @@ npm run build
 npm link
 ```
 
+If you want to run `gnhf --agent rovodev`, install Atlassian's `acli` and authenticate it with Rovo Dev first.
+
+If you want to run `gnhf --agent opencode`, install `opencode` and authenticate at least one provider first.
+
 ## How It Works
 
 ```
@@ -118,6 +129,7 @@ npm link
 ```
 
 - **Incremental commits** — each successful iteration is a separate git commit, so you can cherry-pick or revert individual changes
+- **Runtime caps** — `--max-iterations` stops before the next iteration begins, while `--max-tokens` can abort mid-iteration once reported usage reaches the cap; uncommitted work is rolled back in either case
 - **Shared memory** — the agent reads `notes.md` (built up from prior iterations) to communicate across iterations
 - **Local run metadata** — gnhf stores prompt, notes, and resume metadata under `.gnhf/runs/` and ignores it locally, so your branch only contains intentional work
 - **Resume support** — run `gnhf` while on an existing `gnhf/` branch to pick up where a previous run left off
@@ -133,17 +145,19 @@ npm link
 
 ### Flags
 
-| Flag              | Description                        | Default                |
-| ----------------- | ---------------------------------- | ---------------------- |
-| `--agent <agent>` | Agent to use (`claude` or `codex`) | config file (`claude`) |
-| `--version`       | Show version                       |                        |
+| Flag                   | Description                                                | Default                |
+| ---------------------- | ---------------------------------------------------------- | ---------------------- |
+| `--agent <agent>`      | Agent to use (`claude`, `codex`, `rovodev`, or `opencode`) | config file (`claude`) |
+| `--max-iterations <n>` | Abort after `n` total iterations                           | unlimited              |
+| `--max-tokens <n>`     | Abort after `n` total input+output tokens                  | unlimited              |
+| `--version`            | Show version                                               |                        |
 
 ## Configuration
 
 Config lives at `~/.gnhf/config.yml`:
 
 ```yaml
-# Agent to use by default
+# Agent to use by default (claude, codex, rovodev, or opencode)
 agent: claude
 
 # Abort after this many consecutive failures
@@ -152,7 +166,11 @@ maxConsecutiveFailures: 3
 
 If the file does not exist yet, `gnhf` creates it on first run using the resolved defaults.
 
-CLI flags override config file values.
+CLI flags override config file values. The iteration and token caps are runtime-only flags and are not persisted in `config.yml`.
+
+When using `agent: rovodev`, `gnhf` starts a local `acli rovodev serve --disable-session-token <port>` process automatically in the repo workspace. That requires `acli` to be installed and already authenticated for Rovo Dev.
+
+When using `agent: opencode`, `gnhf` starts a local `opencode serve --hostname 127.0.0.1 --port <port> --print-logs` process automatically, creates a per-run session for the target workspace, and applies a blanket `{"permission":"*","pattern":"*","action":"allow"}` rule so tool calls do not block on prompts. That requires the `opencode` CLI to be installed and already configured with a usable model provider.
 
 ## Development