gnhf 0.1.35 → 0.1.37

package/README.md

@@ -45,7 +45,7 @@ gnhf is a [ralph](https://ghuntley.com/ralph/), [autoresearch](https://github.co
 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 request stop or a configured runtime cap is reached
-- **Long running** — each iteration is committed on success, rolled back on failure, with sensible retries; retryable hard agent errors back off exponentially while agent-reported failures continue immediately
+- **Long running** — each iteration is committed on success, rolled back on failure except commit failures preserved for repair, with sensible retries; retryable hard agent errors back off exponentially while agent-reported failures continue immediately
 - **Live terminal title** — interactive runs keep your terminal title updated with live status, token totals, and commit count, then clear or restore it on exit depending on terminal support; token totals prefixed with `~` are estimates
 - **Exit summary**: every run ends with a permanent summary covering elapsed time, branch, iterations, tokens, branch diff stats, local notes/log paths, and review commands
 - **Agent-agnostic**: works with Claude Code, Codex, Rovo Dev, OpenCode, GitHub Copilot CLI, Pi, or ACP targets out of the box
@@ -71,6 +71,11 @@ $ gnhf --worktree "add tests for module Y" &
 $ gnhf --worktree "refactor the API layer" &
 ```
 
+```sh
+# Commit directly on the current branch and push after each successful iteration
+$ gnhf --current-branch --push "keep improving this app"
+```
+
 Run `gnhf` from inside a Git repository with a clean working tree. If you are starting from a plain directory, run `git init` first.
 `gnhf` supports macOS, Linux, and Windows.
 
@@ -101,7 +106,7 @@ npm link
                            ▼
                 ┌──────────────────────┐
                 │  validate clean git  │
-                │  create gnhf/ branch │
+                │  create or use branch │
                 │  write prompt.md     │
                 └──────────┬───────────┘
                            ▼
@@ -121,8 +126,8 @@ npm link
                   yes  │      │  no                        │
                        ▼      ▼                            │
               ┌──────────┐  ┌───────────┐                  │
-              │  commit  │  │ git reset │                  │
-              │  append  │  │  --hard   │                  │
+              │  commit  │  │ reset or  │                  │
+              │  append  │  │  repair   │                  │
               │ notes.md │  │ maybe wait│                  │
               └────┬─────┘  └─────┬─────┘                  │
                    │              │                        │
@@ -138,9 +143,9 @@ npm link
                     └──────────────────────────────────────┘
 ```
 
-- **Incremental commits** - each successful iteration is a separate unsigned git commit, so you can cherry-pick or revert individual changes without GPG or SSH signing prompts blocking the run; if the first commit attempt fails, gnhf re-stages changes and retries with `--no-verify` so hook-mutated work is not stranded
-- **Failure handling** - all failed iterations are rolled back with `git reset --hard`; agent-reported failures proceed to the next iteration immediately, retryable hard agent errors use exponential backoff, and permanent agent errors such as Claude low credit balance abort immediately and print the run log path. Complete no-op iterations are reported as failures and count toward the consecutive-failure abort limit.
-- **Runtime caps** - `--max-iterations` stops before the next iteration begins, `--max-tokens` can abort mid-iteration once reported usage reaches the cap, and `--stop-when` ends the loop after an iteration whose agent output reports the natural-language condition is met; resumed runs reuse the saved stop condition unless you pass a new value, or `--stop-when ""` to clear it; uncommitted work is rolled back in either case, and in the interactive TUI the final state remains visible until you press Ctrl+C to exit
+- **Incremental commits** - each successful iteration is a separate unsigned git commit, so you can cherry-pick or revert individual changes without GPG or SSH signing prompts blocking the run; if `git commit` fails, gnhf preserves the uncommitted work and asks the next agent iteration to repair it
+- **Failure handling** - failed iterations are rolled back with `git reset --hard` except commit failures, which preserve uncommitted work for repair; agent-reported failures proceed to the next iteration immediately, retryable hard agent errors use exponential backoff, and permanent agent errors such as Claude low credit balance abort immediately and print the run log path. Complete no-op iterations are reported as failures and count toward the consecutive-failure abort limit. If the run exits with a pending commit failure, the exit summary warns that uncommitted changes were left for repair.
+- **Runtime caps** - `--max-iterations` stops before the next iteration begins, `--max-tokens` can abort mid-iteration once reported usage reaches the cap, and `--stop-when` ends the loop after an iteration whose agent output reports the natural-language condition is met unless a commit failure needs repair first; resumed runs reuse the saved stop condition unless you pass a new value, or `--stop-when ""` to clear it; pending commit-failure repair work is preserved and other uncommitted work is rolled back, and in the interactive TUI the final state remains visible until you press Ctrl+C to exit
 - **Iteration finalization** - agents are expected to finish validation, stop any background processes they started, and only then emit the final JSON result for the iteration
 - **Graceful interrupts** - in the interactive TUI, the first Ctrl+C requests a graceful stop and lets the current iteration finish (or ends backoff early), the second Ctrl+C force-stops immediately, and `SIGTERM` also force-stops immediately
 - **Exit summary** - after shutdown cleanup, gnhf prints a permanent stdout summary with the final branch, elapsed time, iteration and token totals, branch diff stats, notes/debug-log paths, and review commands
@@ -148,6 +153,17 @@ npm link
 - **Local run metadata** — gnhf stores prompt, notes, stop conditions, and commit-message convention 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; if you provide a different prompt, gnhf asks whether to update the saved prompt and continue with the existing history, start a new branch, or quit. New runs whose generated branch already exists use a numeric suffix such as `gnhf/<slug>-1`.
 
+### Live Branch Mode
+
+Pass `--current-branch` to run on the branch you are already on instead of creating a `gnhf/` branch.
+Pass `--push` to push the current branch after each successful iteration.
+Together, `--current-branch --push` is useful for loose projects where you want a deployed or locally watched branch to update throughout the run.
+
+- Push failures abort the run after preserving the successful local commit.
+- gnhf never force-pushes or auto-pulls for this mode.
+- `--push` also works with the default `gnhf/` branch mode and sets `origin` as the upstream when needed.
+- Do not combine `--current-branch` with `--worktree`; gnhf exits with an error because those modes choose different working directories.
+
 ### Worktree Mode
 
 Pass `--worktree` to run each agent in an isolated [git worktree](https://git-scm.com/docs/git-worktree). This lets you launch multiple agents on the same repo simultaneously — each gets its own working directory and branch without interfering with the others or your main checkout.
@@ -161,7 +177,7 @@ Pass `--worktree` to run each agent in an isolated [git worktree](https://git-sc
 
 - Worktrees with commits are **preserved** after the run so you can review, merge, or cherry-pick the work. gnhf prints the path and cleanup command.
 - Re-running the same prompt with `--worktree` resumes a preserved matching worktree when possible; otherwise gnhf creates a suffixed worktree such as `<run-slug>-1` if the original name is unavailable.
-- Worktrees with **no commits** are automatically removed on exit.
+- Worktrees with **no commits** are automatically removed on exit unless a pending commit failure left uncommitted work to inspect or repair.
 - `--worktree` must be run from a non-gnhf branch (typically `main`).
 
 ## CLI Reference
@@ -182,9 +198,12 @@ If you run `gnhf` on an existing `gnhf/` branch with a different prompt, gnhf as
 | `--agent <agent>`        | Agent to use (`claude`, `codex`, `rovodev`, `opencode`, `copilot`, `pi`, or `acp:<target-or-command>`) | config file (`claude`) |
 | `--max-iterations <n>`   | Abort after `n` total iterations                                                                       | unlimited              |
 | `--max-tokens <n>`       | Abort after `n` total input+output tokens                                                              | unlimited              |
-| `--stop-when <cond>`     | End the loop when the agent reports this condition; persists across resume                             | unlimited              |
+| `--stop-when <cond>`     | End when the agent reports this condition, after any commit-failure repair; persists across resume     | unlimited              |
 | `--prevent-sleep <mode>` | Prevent system sleep during the run (`on`/`off` or `true`/`false`)                                     | config file (`on`)     |
 | `--worktree`             | Run in a separate git worktree (enables multiple agents concurrently)                                  | `false`                |
+| `--current-branch`       | Run on the current branch instead of creating a `gnhf/` branch                                         | `false`                |
+| `--push`                 | Push the current branch after each successful iteration                                                | `false`                |
+| `--meteor-frequency <n>` | Set TUI meteor frequency from 0 to 5 (`0` disables meteors)                                            | `3`                    |
 | `--version`              | Show version                                                                                           |                        |
 
 ## Configuration

package/dist/cli.mjs

@@ -416,6 +416,33 @@ const NOT_GIT_REPOSITORY_MESSAGE = "This command must be run inside a Git reposi
 function translateGitError(error) {
 	return error instanceof Error ? error : new Error(String(error));
 }
+function outputText(value) {
+	if (typeof value === "string") return value;
+	if (Buffer.isBuffer(value)) return value.toString("utf-8");
+	if (value instanceof Uint8Array) return Buffer.from(value).toString("utf-8");
+	return "";
+}
+function formatGitError(error) {
+	const parts = [
+		error instanceof Error ? error.message : String(error),
+		outputText(error.stdout),
+		outputText(error.stderr)
+	].map((part) => part.trim()).filter(Boolean);
+	return [...new Set(parts)].join("\n");
+}
+function firstLine(text) {
+	return text.split("\n").find((line) => line.trim())?.trim() ?? text;
+}
+var CommitFailedError = class extends Error {
+	detail;
+	constructor(error) {
+		const detail = formatGitError(error);
+		super(`git commit failed: ${firstLine(detail)}`);
+		this.name = "CommitFailedError";
+		this.detail = detail;
+		this.cause = error;
+	}
+};
 function git(args, cwd, options = {}) {
 	const env = {
 		...options.env ?? process.env,
@@ -572,18 +599,52 @@ function commitAll(message, cwd) {
 		message
 	];
 	git(["add", "-A"], cwd);
-	let firstError;
 	try {
-		git(commitArgs, cwd);
+		git([
+			"diff",
+			"--cached",
+			"--quiet"
+		], cwd);
 		return;
+	} catch {}
+	try {
+		git(commitArgs, cwd);
 	} catch (error) {
-		firstError = error;
+		const commitError = new CommitFailedError(error);
+		appendDebugLog("git:commit:failed", {
+			error: serializeError(error),
+			detail: commitError.detail
+		});
+		throw commitError;
 	}
-	git(["add", "-A"], cwd);
+}
+function pushCurrentBranch(cwd) {
+	let hasUpstream = true;
 	try {
-		git([...commitArgs, "--no-verify"], cwd);
-		appendDebugLog("git:commit:no-verify-fallback", { firstError: serializeError(firstError) });
-	} catch {}
+		git([
+			"rev-parse",
+			"--abbrev-ref",
+			"--symbolic-full-name",
+			"@{upstream}"
+		], cwd);
+	} catch {
+		hasUpstream = false;
+	}
+	if (hasUpstream) {
+		git(["push"], cwd);
+		return;
+	}
+	git([
+		"remote",
+		"get-url",
+		"origin"
+	], cwd);
+	git([
+		"push",
+		"-u",
+		"origin",
+		"HEAD"
+	], cwd);
 }
 function resetHard(cwd) {
 	git([
@@ -16387,6 +16448,7 @@ var Orchestrator = class extends EventEmitter {
 	activeIterationPromise = null;
 	activeAbortController = null;
 	pendingAbortReason = null;
+	pendingCommitFailure = null;
 	activeIterationTokensEstimated = false;
 	loopDone = false;
 	stoppedEventEmitted = false;
@@ -16423,7 +16485,8 @@ var Orchestrator = class extends EventEmitter {
 		return {
 			...this.state,
 			tokensEstimated: this.state.tokensEstimated || this.activeIterationTokensEstimated,
-			interruptHint: getInterruptHint(this.state)
+			interruptHint: getInterruptHint(this.state),
+			hasPendingCommitFailure: this.pendingCommitFailure !== null
 		};
 	}
 	requestGracefulStop() {
@@ -16476,6 +16539,7 @@ var Orchestrator = class extends EventEmitter {
 				await iterationPromise;
 			} else await this.closeAgent();
 			resetHard(this.cwd);
+			this.pendingCommitFailure = null;
 			this.state.status = "stopped";
 			this.emit("state", this.getState());
 			this.emitStopped();
@@ -16491,6 +16555,7 @@ var Orchestrator = class extends EventEmitter {
 			startIteration: this.state.currentIteration,
 			maxIterations: this.limits.maxIterations,
 			maxTokens: this.limits.maxTokens,
+			push: this.limits.push === true,
 			maxConsecutiveFailures: this.config.maxConsecutiveFailures,
 			baseCommit: this.runInfo.baseCommit,
 			initialCommitCount: this.state.commitCount
@@ -16507,13 +16572,14 @@ var Orchestrator = class extends EventEmitter {
 				this.state.status = "running";
 				this.emit("iteration:start", this.state.currentIteration);
 				this.emit("state", this.getState());
-				const iterationPrompt = buildIterationPrompt({
+				const baseIterationPrompt = buildIterationPrompt({
 					n: this.state.currentIteration,
 					runId: this.runInfo.runId,
 					prompt: this.prompt,
 					stopWhen: this.limits.stopWhen,
 					commitMessage: this.config.commitMessage
 				});
+				const iterationPrompt = this.pendingCommitFailure ? this.buildCommitRepairPrompt(baseIterationPrompt) : baseIterationPrompt;
 				appendDebugLog("iteration:start", {
 					iteration: this.state.currentIteration,
 					promptLength: iterationPrompt.length,
@@ -16560,6 +16626,10 @@ var Orchestrator = class extends EventEmitter {
 					tokensEstimated: this.state.tokensEstimated,
 					commitCount: this.state.commitCount
 				});
+				if (result.abortReason) {
+					this.abort(result.abortReason);
+					break;
+				}
 				if (this.stopForGracefulShutdown()) break;
 				if (this.limits.stopWhen !== void 0 && result.shouldFullyStop) {
 					this.abort("stop condition met");
@@ -16669,11 +16739,16 @@ var Orchestrator = class extends EventEmitter {
 			});
 			if (this.stopRequested) return { type: "stopped" };
 			const shouldFullyStop = result.output.should_fully_stop === true;
-			if (result.output.success) return {
-				type: "completed",
-				record: this.recordSuccess(result.output),
-				shouldFullyStop
-			};
+			if (result.output.success) {
+				const record = this.recordSuccess(result.output);
+				const abortReason = record.success && this.limits.push === true ? this.pushAfterSuccess() : void 0;
+				return {
+					type: "completed",
+					record,
+					shouldFullyStop: record.success ? shouldFullyStop : false,
+					...abortReason === void 0 ? {} : { abortReason }
+				};
+			}
 			return {
 				type: "completed",
 				record: this.recordFailure(`[FAIL] ${result.output.summary}`, result.output.summary, toStringArray(result.output.key_learnings), "reported"),
@@ -16691,7 +16766,7 @@ var Orchestrator = class extends EventEmitter {
 					elapsedMs,
 					reason: this.pendingAbortReason
 				});
-				resetHard(this.cwd);
+				if (this.pendingCommitFailure === null) resetHard(this.cwd);
 				return {
 					type: "aborted",
 					reason: this.pendingAbortReason
@@ -16710,7 +16785,7 @@ var Orchestrator = class extends EventEmitter {
 				error: serializeError(err)
 			});
 			if (err instanceof PermanentAgentError) {
-				resetHard(this.cwd);
+				if (this.pendingCommitFailure === null) resetHard(this.cwd);
 				this.state.lastAgentError = err.detail;
 				return {
 					type: "aborted",
@@ -16729,8 +16804,16 @@ var Orchestrator = class extends EventEmitter {
 		}
 	}
 	recordSuccess(output) {
-		appendNotes(this.runInfo.notesPath, this.state.currentIteration, output.summary, toStringArray(output.key_changes_made), toStringArray(output.key_learnings));
-		commitAll(buildCommitMessage(this.config.commitMessage, output, { iteration: this.state.currentIteration }), this.cwd);
+		const keyChanges = toStringArray(output.key_changes_made);
+		const keyLearnings = toStringArray(output.key_learnings);
+		try {
+			commitAll(buildCommitMessage(this.config.commitMessage, output, { iteration: this.state.currentIteration }), this.cwd);
+		} catch (error) {
+			if (error instanceof CommitFailedError) return this.recordCommitFailure(error);
+			throw error;
+		}
+		this.pendingCommitFailure = null;
+		appendNotes(this.runInfo.notesPath, this.state.currentIteration, output.summary, keyChanges, keyLearnings);
 		this.state.commitCount = getBranchCommitCount(this.runInfo.baseCommit, this.cwd);
 		this.state.successCount++;
 		this.state.consecutiveFailures = 0;
@@ -16740,14 +16823,60 @@ var Orchestrator = class extends EventEmitter {
 			number: this.state.currentIteration,
 			success: true,
 			summary: output.summary,
-			keyChanges: toStringArray(output.key_changes_made),
-			keyLearnings: toStringArray(output.key_learnings),
+			keyChanges,
+			keyLearnings,
 			timestamp: /* @__PURE__ */ new Date()
 		};
 	}
+	buildCommitRepairPrompt(basePrompt) {
+		return `${basePrompt}
+
+## Previous Commit Failure
+
+The previous iteration made workspace changes, but gnhf could not commit them because git commit failed.
+Do not start unrelated work.
+Inspect and fix the existing uncommitted changes so the commit can pass, then report success.
+
+Git commit output:
+
+\`\`\`
+${this.pendingCommitFailure}
+\`\`\``;
+	}
+	recordCommitFailure(error) {
+		this.pendingCommitFailure = error.detail;
+		const summary = "git commit failed; asking agent to repair the workspace";
+		appendNotes(this.runInfo.notesPath, this.state.currentIteration, `[ERROR] ${summary}`, [], [error.detail]);
+		this.state.failCount++;
+		this.state.consecutiveFailures++;
+		this.state.consecutiveErrors = 0;
+		this.state.lastAgentError = error.detail;
+		return {
+			number: this.state.currentIteration,
+			success: false,
+			summary,
+			keyChanges: [],
+			keyLearnings: [error.detail],
+			timestamp: /* @__PURE__ */ new Date()
+		};
+	}
+	pushAfterSuccess() {
+		try {
+			pushCurrentBranch(this.cwd);
+			appendDebugLog("git:push:success", { iteration: this.state.currentIteration });
+			return;
+		} catch (err) {
+			appendDebugLog("git:push:error", {
+				iteration: this.state.currentIteration,
+				error: serializeError(err)
+			});
+			return `push failed: ${err instanceof Error ? err.message : String(err)}`;
+		}
+	}
 	recordFailure(notesSummary, recordSummary, learnings, kind) {
+		const hadPendingCommitFailure = this.pendingCommitFailure !== null;
 		appendNotes(this.runInfo.notesPath, this.state.currentIteration, notesSummary, [], toStringArray(learnings));
-		resetHard(this.cwd);
+		if (!hadPendingCommitFailure) resetHard(this.cwd);
 		this.state.failCount++;
 		this.state.consecutiveFailures++;
 		if (kind === "error") {
@@ -16961,7 +17090,7 @@ function renderExitSummary(options) {
 	const title = stopped ? `${s.red("×")} ${s.bold("gnhf stopped")}` : `${s.cyan("✦")} ${s.bold("gnhf wrapped")}`;
 	const subtitle = stopped ? `${s.cyan(options.agentName)} ran for ${s.yellow(elapsed)} before: ${options.abortReason ?? options.status}` : `${s.cyan(options.agentName)} worked for ${s.yellow(elapsed)} on ${s.magenta(options.branchName)}`;
 	const cardWidth = resolveCardWidth([title, `  ${subtitle}`], options.terminalColumns);
-	const rolledBack = `${options.failCount} rolled back`;
+	const failed = `${options.failCount} failed`;
 	const inputTokens = formatTokenCount$1(options.totalInputTokens, "in", options.tokensEstimated);
 	const outputTokens = formatTokenCount$1(options.totalOutputTokens, "out", options.tokensEstimated);
 	const commits = plural(options.commitCount, "commit");
@@ -16976,7 +17105,7 @@ function renderExitSummary(options) {
 		metricLine(s.dim("iterations"), [
 			`${s.bold(String(options.iterations))} total`,
 			s.green(`${options.successCount} good`),
-			stopped ? s.red(rolledBack) : s.yellow(rolledBack)
+			stopped ? s.red(failed) : s.yellow(failed)
 		]),
 		metricLine(s.dim("tokens"), [s.bold(inputTokens), s.bold(outputTokens)]),
 		metricLine(s.dim("branch diff"), [
@@ -16992,6 +17121,7 @@ function renderExitSummary(options) {
 		"",
 		commandLine(s.dim("notes"), options.notesPath),
 		commandLine(s.dim("debug log"), options.logPath),
+		...options.hasPendingCommitFailure ? [commandLine(s.yellow("uncommitted"), "commit failed; changes were left for repair")] : [],
 		"",
 		commandLine(s.dim("next steps"), s.cyan(`git log --oneline ${options.baseRef}..HEAD`)),
 		continuationLine(s.cyan(`git diff --stat ${options.baseRef}..HEAD`)),
@@ -17157,6 +17287,7 @@ const STAR_CHARS = [
 	"°",
 	"°"
 ];
+const MIN_METEOR_START_GAP_MS = 500;
 function generateStarField(width, height, density, seed) {
 	const stars = [];
 	let s = seed;
@@ -17191,6 +17322,47 @@ function getStarState(star, now) {
 	if (t > .025) return "bright";
 	return "dim";
 }
+function generateMeteorShower(width, height, count, seed) {
+	if (width <= 0 || height <= 0 || count <= 0) return [];
+	const meteors = [];
+	let s = seed % 2147483647;
+	if (s <= 0) s += 2147483646;
+	const rand = () => {
+		s = s * 16807 % 2147483647;
+		return s / 2147483647;
+	};
+	for (let i = 0; i < count; i++) {
+		const length = Math.min(height, 2 + (i + Math.floor(rand() * 6)) % 6);
+		const xMax = Math.max(1, width - length);
+		const yMin = Math.max(0, length - 1);
+		const yMaxExclusive = Math.max(yMin + 1, Math.ceil(height * .75));
+		const ySpan = Math.max(1, yMaxExclusive - yMin);
+		const period = 16e3 + rand() * 2e4;
+		const duration = count >= 8 ? 3e3 + rand() * 600 : 900 + rand() * 500;
+		meteors.push({
+			x: Math.floor(rand() * xMax),
+			y: yMin + Math.floor(rand() * ySpan),
+			length,
+			phase: i === 0 ? 0 : i * (MIN_METEOR_START_GAP_MS + 80) + rand() * 60,
+			period,
+			duration
+		});
+	}
+	return meteors;
+}
+function getMeteorTrail(meteor, now) {
+	const cycleTime = ((now - meteor.phase) % meteor.period + meteor.period) % meteor.period;
+	if (cycleTime >= meteor.duration) return [];
+	const step = Math.floor(cycleTime / 120);
+	const cells = [];
+	for (let i = 0; i < meteor.length; i++) cells.push({
+		x: meteor.x - step + i,
+		y: meteor.y + step - i,
+		state: i === 0 ? "bright" : "dim",
+		char: "╱"
+	});
+	return cells;
+}
 //#endregion
 //#region src/utils/moon.ts
 const MOON_PHASES = [
@@ -17414,6 +17586,8 @@ const CONTENT_WIDTH = 63;
 const MAX_PROMPT_LINES = 3;
 const BASE_CONTENT_ROWS = 24;
 const STAR_DENSITY = .035;
+const DEFAULT_METEOR_FREQUENCY = 3;
+const METEOR_SEED_OFFSET = 101;
 const TICK_MS = 200;
 const MOONS_PER_ROW = 30;
 const MOON_PHASE_PERIOD = 1600;
@@ -17517,6 +17691,17 @@ function starStyle(state) {
 	if (state === "dim") return "dim";
 	return "normal";
 }
+function meteorCountForFrequency(frequency) {
+	if (frequency <= 0) return 0;
+	if (frequency === 1) return 1;
+	if (frequency === 2) return 2;
+	if (frequency === 3) return 4;
+	if (frequency === 4) return 6;
+	return 28;
+}
+function meteorsStartingBefore(meteors, rowOffset, maxStartRow) {
+	return meteors.filter((meteor) => rowOffset + meteor.y < maxStartRow);
+}
 function placeStarsInCells(cells, stars, row, xMin, xMax, xOffset, now) {
 	for (const star of stars) {
 		if (star.y !== row || star.x < xMin || star.x >= xMax) continue;
@@ -17533,15 +17718,28 @@ function placeStarsInCells(cells, stars, row, xMin, xMax, xOffset, now) {
 		};
 	}
 }
-function renderStarLineCells(stars, width, y, now) {
+function placeMeteorsInCells(cells, meteors, row, xMin, xMax, xOffset, now) {
+	for (const meteor of meteors) for (const trail of getMeteorTrail(meteor, now)) {
+		if (trail.y !== row || trail.x < xMin || trail.x >= xMax) continue;
+		const localX = trail.x - xOffset;
+		cells[localX] = {
+			char: trail.char,
+			style: trail.state === "bright" ? "bold" : "dim",
+			width: 1
+		};
+	}
+}
+function renderStarLineCells(stars, meteors, width, y, now) {
 	const cells = emptyCells(width);
 	placeStarsInCells(cells, stars, y, 0, width, 0, now);
+	placeMeteorsInCells(cells, meteors, y, 0, width, 0, now);
 	return cells;
 }
-function renderSideStarsCells(stars, rowIndex, xOffset, sideWidth, now) {
+function renderSideStarsCells(stars, meteors, rowIndex, xOffset, sideWidth, now) {
 	if (sideWidth <= 0) return [];
 	const cells = emptyCells(sideWidth);
 	placeStarsInCells(cells, stars, rowIndex, xOffset, xOffset + sideWidth, xOffset, now);
+	placeMeteorsInCells(cells, meteors, rowIndex, xOffset, xOffset + sideWidth, xOffset, now);
 	return cells;
 }
 function clampCellsToWidth(content, width) {
@@ -17658,7 +17856,7 @@ function buildContentCells(prompt, agentName, state, elapsed, now, availableHeig
 	}
 	return rows;
 }
-function buildFrameCells(prompt, agentName, state, topStars, bottomStars, sideStars, now, terminalWidth, terminalHeight) {
+function buildFrameCells(prompt, agentName, state, topStars, bottomStars, sideStars, now, terminalWidth, terminalHeight, topMeteors = [], bottomMeteors = [], sideMeteors = []) {
 	const elapsed = formatElapsed(now - state.startTime.getTime());
 	const availableHeight = Math.max(0, terminalHeight - 2);
 	const contentRows = buildContentCells(prompt, agentName, state, elapsed, now, availableHeight);
@@ -17667,20 +17865,24 @@ function buildFrameCells(prompt, agentName, state, topStars, bottomStars, sideSt
 	const remaining = Math.max(0, availableHeight - contentCount);
 	const topHeight = Math.max(0, Math.ceil(remaining / 2));
 	const bottomHeight = remaining - topHeight;
+	const maxMeteorStartRow = Math.ceil(availableHeight * .75);
+	const visibleTopMeteors = meteorsStartingBefore(topMeteors, 0, maxMeteorStartRow);
+	const visibleSideMeteors = meteorsStartingBefore(sideMeteors, topHeight, maxMeteorStartRow);
+	const visibleBottomMeteors = meteorsStartingBefore(bottomMeteors, topHeight + contentCount, maxMeteorStartRow);
 	const sideWidth = Math.max(0, Math.floor((terminalWidth - CONTENT_WIDTH) / 2));
 	const frame = [];
-	for (let y = 0; y < topHeight; y++) frame.push(renderStarLineCells(topStars, terminalWidth, y, now));
+	for (let y = 0; y < topHeight; y++) frame.push(renderStarLineCells(topStars, visibleTopMeteors, terminalWidth, y, now));
 	for (let i = 0; i < contentRows.length; i++) {
-		const left = renderSideStarsCells(sideStars, i, 0, sideWidth, now);
+		const left = renderSideStarsCells(sideStars, visibleSideMeteors, i, 0, sideWidth, now);
 		const center = centerLineCells(contentRows[i], CONTENT_WIDTH);
-		const right = renderSideStarsCells(sideStars, i, terminalWidth - sideWidth, sideWidth, now);
+		const right = renderSideStarsCells(sideStars, visibleSideMeteors, i, terminalWidth - sideWidth, sideWidth, now);
 		frame.push([
 			...left,
 			...center,
 			...right
 		]);
 	}
-	for (let y = 0; y < bottomHeight; y++) frame.push(renderStarLineCells(bottomStars, terminalWidth, y, now));
+	for (let y = 0; y < bottomHeight; y++) frame.push(renderStarLineCells(bottomStars, visibleBottomMeteors, terminalWidth, y, now));
 	frame.push(renderResumeHintCells(terminalWidth, state.interruptHint));
 	frame.push(emptyCells(terminalWidth));
 	return frame;
@@ -17696,8 +17898,11 @@ var Renderer = class {
 	topStars = [];
 	bottomStars = [];
 	sideStars = [];
+	topMeteors = [];
+	bottomMeteors = [];
 	cachedWidth = 0;
 	cachedHeight = 0;
+	meteorFrequency;
 	prevCells = [];
 	prevTitle = null;
 	titleSaved = false;
@@ -17716,11 +17921,12 @@ var Renderer = class {
 	handleStopped = () => {
 		this.stop("stopped");
 	};
-	constructor(orchestrator, prompt, agentName, onInterrupt) {
+	constructor(orchestrator, prompt, agentName, onInterrupt, options = {}) {
 		this.orchestrator = orchestrator;
 		this.prompt = prompt;
 		this.agentName = agentName;
 		this.onInterrupt = onInterrupt;
+		this.meteorFrequency = Math.max(0, Math.floor(options.meteorFrequency ?? DEFAULT_METEOR_FREQUENCY));
 		this.state = orchestrator.getState();
 		this.seedTop = Math.floor(Math.random() * 2147483646) + 1;
 		this.seedBottom = Math.floor(Math.random() * 2147483646) + 1;
@@ -17773,6 +17979,7 @@ var Renderer = class {
 			const availableHeight = Math.max(0, h - 2);
 			const remaining = Math.max(0, availableHeight - BASE_CONTENT_ROWS);
 			const topHeight = Math.max(0, Math.ceil(remaining / 2));
+			const bottomHeight = Math.max(0, remaining - topHeight);
 			const proximityRows = 8;
 			const shrinkBig = (s, nearContentRow) => {
 				if (!nearContentRow || s.x < contentStart || s.x >= contentEnd) return s;
@@ -17788,6 +17995,8 @@ var Renderer = class {
 			this.topStars = generateStarField(w, h, STAR_DENSITY, this.seedTop).map((s) => shrinkBig(s, s.y >= topHeight - proximityRows));
 			this.bottomStars = generateStarField(w, h, STAR_DENSITY, this.seedBottom).map((s) => shrinkBig(s, s.y < proximityRows));
 			this.sideStars = generateStarField(w, Math.max(BASE_CONTENT_ROWS, availableHeight), STAR_DENSITY, this.seedSide);
+			this.topMeteors = generateMeteorShower(w, topHeight, topHeight > 0 ? meteorCountForFrequency(this.meteorFrequency) : 0, this.seedTop + METEOR_SEED_OFFSET);
+			this.bottomMeteors = generateMeteorShower(w, bottomHeight, bottomHeight > 0 ? meteorCountForFrequency(this.meteorFrequency) : 0, this.seedBottom + METEOR_SEED_OFFSET);
 			return true;
 		}
 		return false;
@@ -17798,7 +18007,7 @@ var Renderer = class {
 		const h = process$1.stdout.rows || 24;
 		const resized = this.ensureStarFields(w, h);
 		this.updateTerminalTitle(now);
-		const nextCells = buildFrameCells(this.prompt, this.agentName, this.state, this.topStars, this.bottomStars, this.sideStars, now, w, h);
+		const nextCells = buildFrameCells(this.prompt, this.agentName, this.state, this.topStars, this.bottomStars, this.sideStars, now, w, h, this.topMeteors, this.bottomMeteors);
 		if (this.isFirstFrame || resized) {
 			process$1.stdout.write("\x1B[H" + nextCells.map(rowToString).join("\n"));
 			this.isFirstFrame = false;
@@ -17829,6 +18038,7 @@ function slugifyPrompt(prompt) {
 //#region src/cli.ts
 const packageVersion = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8")).version;
 const FORCE_EXIT_TIMEOUT_MS = 5e3;
+const MAX_METEOR_FREQUENCY = 5;
 const GNHF_REEXEC_STDIN_PROMPT = "GNHF_REEXEC_STDIN_PROMPT";
 const GNHF_REEXEC_STDIN_PROMPT_FILE = "GNHF_REEXEC_STDIN_PROMPT_FILE";
 const GNHF_REEXEC_STDIN_PROMPT_DIR_PREFIX = "gnhf-stdin-";
@@ -17847,6 +18057,11 @@ function parseNonNegativeInteger(value) {
 	if (!Number.isSafeInteger(parsed)) throw new InvalidArgumentError("must be a safe integer");
 	return parsed;
 }
+function parseMeteorFrequency(value) {
+	const parsed = parseNonNegativeInteger(value);
+	if (parsed > MAX_METEOR_FREQUENCY) throw new InvalidArgumentError(`must be between 0 and ${MAX_METEOR_FREQUENCY}`);
+	return parsed;
+}
 function parseOnOffBoolean(value) {
 	if (value === "on" || value === "true") return true;
 	if (value === "off" || value === "false") return false;
@@ -17923,6 +18138,11 @@ function initializeNewBranch(prompt, cwd, schemaOptions) {
 	const runId = createBranchWithSuffix(slugifyPrompt(prompt), cwd).split("/")[1];
 	return setupRun(runId, prompt, baseCommit, cwd, schemaOptions);
 }
+function initializeCurrentBranchRun(prompt, cwd, schemaOptions) {
+	ensureCleanWorkingTree(cwd);
+	const baseCommit = getHeadCommit(cwd);
+	return setupRun(createRunIdWithSuffix(slugifyPrompt(prompt).split("/")[1], cwd), prompt, baseCommit, cwd, schemaOptions);
+}
 function branchNameWithSuffix(branchName, suffix) {
 	return suffix === 0 ? branchName : `${branchName}-${suffix}`;
 }
@@ -17942,6 +18162,16 @@ function createBranchWithSuffix(branchName, cwd) {
 	}
 	throw new Error(`Unable to create a unique branch name for ${branchName}`);
 }
+function runIdWithSuffix(runId, suffix) {
+	return suffix === 0 ? runId : `${runId}-${suffix}`;
+}
+function createRunIdWithSuffix(runId, cwd) {
+	for (let suffix = 0; suffix < 100; suffix += 1) {
+		const candidate = runIdWithSuffix(runId, suffix);
+		if (!existsSync(join(cwd, ".gnhf", "runs", candidate))) return candidate;
+	}
+	throw new Error(`Unable to create a unique run id for ${runId}`);
+}
 function initializeWorktreeRun(prompt, cwd, schemaOptions, resumeSchemaOptions) {
 	const repoRoot = getRepoRootDir(cwd);
 	const baseCommit = getHeadCommit(cwd);
@@ -18119,13 +18349,13 @@ function readReexecStdinPrompt(env) {
 	}
 }
 const program = new Command();
-program.name("gnhf").description("Before I go to bed, I tell my agents: good night, have fun").version(packageVersion).argument("[prompt]", "The objective for the coding agent").option("--agent <agent>", `Agent to use (${AGENT_NAMES.join(", ")}, or acp:<target-or-command>)`).option("--max-iterations <n>", "Abort after N total iterations", parseNonNegativeInteger).option("--max-tokens <n>", "Abort after N total input+output tokens", parseNonNegativeInteger).option("--stop-when <condition>", "End when the agent reports this condition; resumes reuse it, pass a new value to overwrite or \"\" to clear").option("--prevent-sleep <mode>", "Prevent system sleep during the run (\"on\" or \"off\")", parseOnOffBoolean).option("--worktree", "Run in a separate git worktree (enables multiple agents on the same repo)", false).option("--mock", "", false).action(async (promptArg, options) => {
+program.name("gnhf").description("Before I go to bed, I tell my agents: good night, have fun").version(packageVersion).argument("[prompt]", "The objective for the coding agent").option("--agent <agent>", `Agent to use (${AGENT_NAMES.join(", ")}, or acp:<target-or-command>)`).option("--max-iterations <n>", "Abort after N total iterations", parseNonNegativeInteger).option("--max-tokens <n>", "Abort after N total input+output tokens", parseNonNegativeInteger).option("--stop-when <condition>", "End when the agent reports this condition, after any commit-failure repair; resumes reuse it, pass a new value to overwrite or \"\" to clear").option("--prevent-sleep <mode>", "Prevent system sleep during the run (\"on\" or \"off\")", parseOnOffBoolean).option("--worktree", "Run in a separate git worktree (enables multiple agents on the same repo)", false).option("--current-branch", "Run on the current branch instead of creating a gnhf branch", false).option("--push", "Push the current branch after each successful iteration", false).option("--meteor-frequency <n>", "Meteor frequency from 0 to 5 (0 disables, 3 is default)", parseMeteorFrequency, 3).option("--mock", "", false).action(async (promptArg, options) => {
 	if (options.mock) {
 		const mock = new MockOrchestrator();
 		enterAltScreen();
-		const renderer = new Renderer(mock, "let's minimize app startup latency without sacrificing any functionality", "claude", () => {
+		const renderer = new Renderer(mock, "let's minimize app startup latency without sacrificing any functionality", "codex", () => {
 			mock.handleInterrupt();
-		});
+		}, { meteorFrequency: options.meteorFrequency });
 		renderer.start();
 		mock.start();
 		await renderer.waitUntilExit();
@@ -18168,6 +18398,10 @@ program.name("gnhf").description("Before I go to bed, I tell my agents: good nig
 	let worktreeCleanup = null;
 	const currentBranch = getCurrentBranch(cwd);
 	const onGnhfBranch = currentBranch.startsWith("gnhf/");
+	if (options.currentBranch && options.worktree) {
+		console.error("Cannot combine --current-branch and --worktree.");
+		process$1.exit(1);
+	}
 	const cliStopWhen = options.stopWhen === "" ? void 0 : options.stopWhen;
 	let effectiveStopWhen = cliStopWhen;
 	let effectiveCommitMessage = config.commitMessage;
@@ -18204,6 +18438,12 @@ program.name("gnhf").description("Before I go to bed, I tell my agents: good nig
 				if (worktreeCleanup === exitCleanup) exitCleanup();
 			});
 		}
+	} else if (options.currentBranch) {
+		if (!prompt) {
+			program.help();
+			return;
+		}
+		runInfo = initializeCurrentBranchRun(prompt, cwd, schemaOptions);
 	} else if (onGnhfBranch) {
 		const existingRunId = currentBranch.slice(5);
 		const existingMetadata = peekRunMetadata(existingRunId, cwd);
@@ -18260,7 +18500,7 @@ program.name("gnhf").description("Before I go to bed, I tell my agents: good nig
 			if (!reexeced) persistedPrompt?.cleanup();
 		}
 	}
-	const runMode = options.worktree ? "worktree" : startIteration > 0 ? "resume" : "new";
+	const runMode = options.worktree ? "worktree" : options.currentBranch ? "current-branch" : startIteration > 0 ? "resume" : "new";
 	const telemetryAgent = getTelemetryAgent(config.agent);
 	telemetry.pageview("/run", {
 		agent: telemetryAgent,
@@ -18283,6 +18523,8 @@ program.name("gnhf").description("Before I go to bed, I tell my agents: good nig
 		agentArgsOverride: getNativeAgentName(config.agent) ? config.agentArgsOverride?.[getNativeAgentName(config.agent)] : void 0,
 		worktree: options.worktree,
 		worktreePath,
+		currentBranch: options.currentBranch,
+		push: options.push,
 		platform: process$1.platform,
 		nodeVersion: process$1.version,
 		gnhfVersion: packageVersion
@@ -18298,7 +18540,8 @@ program.name("gnhf").description("Before I go to bed, I tell my agents: good nig
 	}, agent, runInfo, prompt, effectiveCwd, startIteration, {
 		maxIterations: options.maxIterations,
 		maxTokens: options.maxTokens,
-		stopWhen: effectiveStopWhen
+		stopWhen: effectiveStopWhen,
+		...options.push ? { push: true } : {}
 	});
 	let shutdownSignal = null;
 	let forceShutdownRequested = false;
@@ -18329,7 +18572,7 @@ program.name("gnhf").description("Before I go to bed, I tell my agents: good nig
 		requestForceShutdown("SIGTERM");
 	};
 	enterAltScreen();
-	const renderer = new Renderer(orchestrator, prompt, config.agent, handleSigInt);
+	const renderer = new Renderer(orchestrator, prompt, config.agent, handleSigInt, { meteorFrequency: options.meteorFrequency });
 	renderer.start();
 	process$1.on("SIGINT", handleSigInt);
 	process$1.on("SIGTERM", handleSigTerm);
@@ -18390,7 +18633,8 @@ program.name("gnhf").description("Before I go to bed, I tell my agents: good nig
 			baseRef: runInfo.baseCommit.slice(0, 12) || runInfo.baseCommit,
 			diffStats,
 			color: shouldUseColor(),
-			terminalColumns: process$1.stdout.columns
+			terminalColumns: process$1.stdout.columns,
+			hasPendingCommitFailure: finalState.hasPendingCommitFailure
 		});
 		appendDebugLog("run:complete", {
 			signal: shutdownSignal,
@@ -18416,12 +18660,13 @@ program.name("gnhf").description("Before I go to bed, I tell my agents: good nig
 			total_output_tokens: finalState.totalOutputTokens,
 			duration_ms: Date.now() - runStartedAt,
 			prevent_sleep: config.preventSleep === true,
+			push_each_iteration: options.push === true,
 			commit_message_preset: effectiveCommitMessage?.preset ?? "default",
 			stop_when_set: effectiveStopWhen !== void 0
 		});
 		await telemetry.close(1e3);
 		if (finalState.status === "aborted") console.error(`\n  gnhf: Run log: ${runInfo.logPath}\n`);
-		if (worktreePath) if (finalState.commitCount > 0) {
+		if (worktreePath) if (finalState.commitCount > 0 || finalState.hasPendingCommitFailure) {
 			worktreeCleanup = null;
 			console.error(`\n  gnhf: worktree preserved at ${worktreePath}\n  gnhf: merge the branch and remove with: git worktree remove "${worktreePath}"\n`);
 		} else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gnhf",
-  "version": "0.1.35",
+  "version": "0.1.37",
   "description": "Before I go to bed, I tell my agents: good night, have fun",
   "type": "module",
   "bin": {