gnhf
Before I go to bed, I tell my agents: good night, have fun
gnhf (good night, have fun) is an autonomous orchestrator for AI coding agents that runs unattended iterative development loops while you're away. Inspired by ralph and autoresearch, it executes one small committed change per iteration toward a stated objective, automatically handling failures with rollbacks and retries. Each successful iteration creates a git commit, and runs continue until hitting configured limits or completion conditions. The tool supports multiple agents simultaneously via git worktrees and works with popular coding CLIs including Claude Code, Codex, GitHub Copilot CLI, Pi, Cursor, Rovo Dev, OpenCode, and any ACP-compatible target.
Key Features
Use Cases
- 01Running overnight code refactoring or complexity reduction while you sleep, waking to a branch of committed changes
- 02Launching multiple parallel agents on different features or modules using worktrees for concurrent development
- 03Automating long-running test suite additions or API layer refactoring with bounded token budgets
- 04Continuously improving codebases with auto-push on success for deployed or live-watched branches
- 05Executing multi-hour research or documentation tasks with automatic retry and failure recovery
- 06Running agents during off-hours to maximize Claude API quota usage without manual intervention
Related Agents
View morehermes-agent
The agent that grows with you
agency-agents
A complete AI agency at your fingertips - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specialized expert with personality, processes, and proven deliverables.
openinterpreter
A coding agent for open models like Kimi K3
cline
Autonomous coding agent as an SDK, IDE extension, or CLI assistant.
gnhf — FAQ
What is gnhf and what does it do?+
gnhf is an autonomous orchestrator that runs AI coding agents in long iterative loops, creating one committed change per successful iteration toward your objective. It handles failures, waits out rate limits, and runs unattended so you can wake up to a branch full of completed work.
How do I install the gnhf AI sub-agent?+
Install gnhf globally via npm with 'npm install -g gnhf', or clone the repository and build from source using pnpm. You must also have one of the supported coding agents (Claude Code, Codex, Copilot CLI, Pi, Cursor, Rovo Dev, or OpenCode) installed and authenticated separately.
Which AI clients and agents work with gnhf?+
gnhf works with Claude Code, Codex, GitHub Copilot CLI, Pi, Cursor CLI, Rovo Dev (via acli), OpenCode, and any ACP-compatible target. It orchestrates these agents rather than being a plugin for them.
What are the prerequisites for running gnhf?+
You need a git repository with a clean working tree, Node.js with npm or pnpm, and at least one supported coding agent CLI installed and authenticated. No additional API keys are required for gnhf itself, but your chosen agent needs its own credentials.
Is gnhf free to use?+
Yes, gnhf is free and open source. However, the underlying AI agents it orchestrates (Claude Code, Codex, Copilot, etc.) may require paid subscriptions or API credits depending on which one you choose.
How do I stop or resume a gnhf run?+
Press Ctrl+C once to request graceful stop (lets current iteration finish), twice to force-stop immediately. To resume, run 'gnhf' again from the same gnhf/ branch and it will continue with existing history and iteration numbering.
How do I install gnhf?+
Open the source repository on GitHub and follow its README. gnhf is a agent — MCP Agents Market links you directly to the official repo.
Is gnhf free?+
gnhf is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.