# Agent-Managed Coding Runs

Starts, steers and reviews unattended coding runs with GNHF.

- Repository: https://github.com/kunchenguid/gnhf (4245 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-10-03
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add kunchenguid/gnhf --skill gnhf -g -a claude-code -y`
Codex: `npx skills add kunchenguid/gnhf --skill gnhf -g -a codex -y`
Cursor: `npx skills add kunchenguid/gnhf --skill gnhf -g -a cursor -y`
Gemini CLI: `npx skills add kunchenguid/gnhf --skill gnhf -g -a gemini-cli -y`

## Description

Use when the user asks to run GNHF, says they are going to sleep or leaving and wants an agent-managed coding run, asks to supervise, steer, or review an active GNHF run, or gives feedback on GNHF results.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# GNHF

## Overview

GNHF is an agent orchestrator: it repeatedly calls another coding agent until a natural-language stop condition is met. This skill teaches the host agent to prepare one durable run and, in Companion mode, steer or review it.

Core rule: the host agent orchestrates; GNHF executes. Do not manually implement inside the same scope while a GNHF worker is responsible for it unless the user explicitly changes the delegation.

In Companion mode, GNHF completion is not user acceptance. "Stop condition met" only means the worker stopped; the host still compares the result to the user's latest requirements and fresh verification.

## Modes

Choose exactly one mode for the run.

### Hands-Off

Use when the task is bounded, verification is clear, and the user wants one configured run to proceed without steering.

- Prepare a precise prompt with constraints, non-goals, verification, and stop condition.
- Launch GNHF and wait for completion.
- Intervene early only for hard failure, runaway scope, destructive behavior, or impossible prerequisites.
- Report the final GNHF status after exit.

Examples:

- English: "I'm going to bed. Use GNHF with Copilot to keep working on this branch and stop when the test suite passes."
- Chinese: "我要睡了。用 GNHF 接着跑这个分支，测试都过了就停。"

### Companion

Use when the task is uncertain, exploratory, design-heavy, research-heavy, or likely to need course correction.

Default to Companion when the user asks to iterate until satisfied, requests multi-round work, provides review findings, asks for design/skill/documentation improvement, or asks for supervision.

The rest: https://github.com/kunchenguid/gnhf/blob/HEAD/skills/gnhf/SKILL.md