gnhf（Good Night, Have Fun）

这个 Agent 能做什么，适合哪些场景？

gnhf 是一个命令行编排器，把 Claude Code、Codex、GitHub Copilot CLI、Pi、Cursor CLI、Rovo Dev、OpenCode 等编码代理包装成一个持续运行的循环。启动时它校验 Git 工作树是否干净、创建 gnhf/ 分支（或用 --current-branch 留在当前分支）、把目标写入 prompt.md，然后反复构建迭代提示、以非交互模式调用代理。每次成功迭代产生一个独立的 git 提交并把经验追加到 notes.md，失败迭代则通过 git reset --hard 回滚，连续三次失败会中止。运行元数据（prompt、notes、停止条件、end-state.json、gnhf.log）保存在本地 .gnhf/runs/ 目录并被忽略，因此分支上只留下有意的改动。它面向无人值守的夜间运行，提供迭代数、token 上限、sleep 防止、worktree 并行和退出摘要等控制手段。

在 Git 仓库内运行 gnhf "<prompt>" 后，它先检查工作树干净、写入 prompt.md 并建立或复用 gnhf/ 分支；每一轮把目标、notes.md 中累积的上下文和输出 JSON 结构拼成迭代提示，通过非交互模式调用所选代理（例如 claude、codex exec、copilot 的 JSONL 模式、opencode serve、acli rovodev serve，或 acpx 驱动的 acp:<target>）。代理返回结构化结果后，gnhf 判定成功则创建一次无签名提交、把摘要追加到 notes.md，失败则回滚并计数，可重试错误按指数退避，永久错误（如额度不足）直接中止并打印日志路径。遇到 Claude 用量窗口耗尽时，它读取限流事件中的重置时间，等待后自动重试同一迭代，并可用 --max-rate-limit-wait 设置总等待上限。运行时以 --max-iterations、--max-tokens、--stop-when 控制何时结束；交互式 TUI 在终端标题和统计行显示耗时、token 与提交数，Ctrl+C 第一次请求优雅停止、第二次强制停止。结束时输出包含分支、耗时、迭代与 token 总量、分支 diff 统计、notes 与日志路径以及复查命令的摘要，并把完整 JSONL 调试日志写入 .gnhf/runs/<runId>/gnhf.log。

1. 想在睡觉或开会期间让代理推进一个长期目标（例如降低代码复杂度、补齐测试），早上直接审查分支的人。
2. 需要同时在一个仓库上跑多个互不干扰任务时，用 --worktree 为每个代理开独立环境与分支。
3. 希望边跑边部署或本地热更新的松散项目，用 --current-branch --push 让每次成功迭代推送到远端。
4. 已经订阅 Claude Code、Codex 或 Copilot 并希望把闲置额度用满的开发者。
5. 需要通过 ACP 接入 Gemini、Grok 等非原生代理，同时保留统一日志与回滚语义的团队。
6. 想给代理设定硬性预算（迭代数、token 上限、限流等待上限）再放手的成本敏感用户。

如何安装或部署这个 Agent？

需要 Node.js、Git 和已登录的编码代理 CLI；在 Git 仓库内使用。

npm install -g gnhf

从源码安装：

git clone https://github.com/kunchenguid/gnhf.git
cd gnhf
corepack enable
pnpm install
pnpm run build
pnpm link --global

首次运行会在 ~/.gnhf/config.yml 生成默认配置（默认代理为 claude），可按需修改：

agent: claude

maxConsecutiveFailures: 3

preventSleep: true

如何使用这个 Agent？

在干净的 Git 仓库中给出一句话目标即可开始：

$ gnhf "reduce complexity of the codebase without changing functionality"

加上迭代与 token 预算，适合短睡：

$ gnhf "reduce complexity of the codebase without changing functionality" \
    --max-iterations 10 \
    --max-tokens 5000000

并行跑多个任务：

$ gnhf --worktree "implement feature X" &
$ gnhf --worktree "add tests for module Y" &

在当前分支上每次成功迭代后推送：

$ gnhf --current-branch --push "keep improving this app"

切换代理或指定模型：

$ gnhf --agent codex --model gpt-5.4 "fix failing tests"
$ gnhf --agent 'acp:gemini' "polish the docs"

如需关闭匿名遥测：

export GNHF_TELEMETRY=0

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题