kunchenguid/gnhf

寝る前に、私はエージェントにこう伝えます: おやすみ、楽しんでね

手ぶらで目覚めるな。

GNHFはRalphの自動調査スタイルのオーケストレーターで、眠っている間もエージェントを稼働させ続けます。各イテレーションごとに、目標に向けて小さく、コミットした、文書化された変更が一つずつ行われます。 目を覚ますと、きれいな仕事が積まれた枝と、起こったすべての記録がある。

• 非常にシンプル - 1つのコマンドが自律的なループを開始し、停止を要求するか設定されたランタイム上限に達するまで実行されます
• 長期実行 - 各反復は成功時にコミットされ、失敗時にはロールバックされ、合理的なリトライがあります。How It Worksには完全な失敗処理ルールがあります
• ライブ端末タイトル - インタラクティブ実行は、端末タイトルにライブステータス、トークン合計、コミット数を更新し、終了時に端末のサポートに応じてクリアまたは復元します。~で始まるトークン合計は推定値です
• 終了サマリー - すべての実行は経過時間、分岐、反復、トークン、分岐差分統計、ローカルノート/ログパス、レビューコマンドを含む恒久的な要約で終了します

Before I go to bed, I tell my agents: good night, have fun

<a href=“https://www.npmjs.com/package/gnhf” > <a href=“https://github.com/kunchenguid/gnhf/actions/workflows/ci.yml” > <a href=“https://github.com/kunchenguid/gnhf/actions/workflows/release-please.yml” > <a href=“https://img.shields.io/badge/platform-macOS | Linux | Windows-blue?style=flat-square” > <a href=“https://x.com/kunchenguid” > <a href=“https://discord.gg/Wsy2NpnZDu” >

Never wake up empty-handed.

gnhf is a ralph, 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 request stop or a configured runtime cap is reached
• Long running - each iteration is committed on success and rolled back on failure, with sensible retries; How It Works has the full failure-handling rules
• 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 the popular coding agent CLIs plus any ACP target out of the box; see Agents for the roster

Quick Start

$ gnhf "reduce complexity of the codebase without changing functionality"
# have a good sleep

$ gnhf "reduce complexity of the codebase without changing functionality" \
    --max-iterations 10 \
    --max-tokens 5000000
# have a good nap